From 692617a6eea5e47e71e221c9e73f5f2d5534e3bf Mon Sep 17 00:00:00 2001
From: Jon Wayne Parrott <jonwayne@google.com>
Date: Fri, 6 Jan 2017 09:58:29 -0800
Subject: [PATCH] Release v1.6.0 (#324)

* Update version and changelog for v1.6.0
* Update docs
---
 CHANGELOG                                     |    21 +
 README.md                                     |     4 +-
 docs/dyn/adexchangebuyer_v1_3.creatives.html  |     8 +-
 docs/dyn/adexchangebuyer_v1_4.accounts.html   |    18 +-
 docs/dyn/adexchangebuyer_v1_4.creatives.html  |    20 +-
 ...adexchangebuyer_v1_4.marketplacedeals.html |    12 +-
 ...exchangebuyer_v1_4.pretargetingConfig.html |   128 +-
 docs/dyn/adexchangebuyer_v1_4.products.html   |     2 +
 docs/dyn/adexchangebuyer_v1_4.proposals.html  |     4 +-
 docs/dyn/adsense_v1_3.accounts.adunits.html   |     4 +-
 ..._v1_3.accounts.customchannels.adunits.html |     2 +-
 .../adsense_v1_3.accounts.savedadstyles.html  |     4 +-
 docs/dyn/adsense_v1_3.adunits.html            |     4 +-
 .../adsense_v1_3.customchannels.adunits.html  |     2 +-
 docs/dyn/adsense_v1_3.savedadstyles.html      |     4 +-
 docs/dyn/adsense_v1_4.accounts.adunits.html   |     4 +-
 ..._v1_4.accounts.customchannels.adunits.html |     2 +-
 .../adsense_v1_4.accounts.savedadstyles.html  |     4 +-
 docs/dyn/adsense_v1_4.adunits.html            |     4 +-
 .../adsense_v1_4.customchannels.adunits.html  |     2 +-
 docs/dyn/adsense_v1_4.savedadstyles.html      |     4 +-
 .../adsensehost_v4_1.accounts.adunits.html    |    18 +-
 docs/dyn/analytics_v3.management.uploads.html |     5 +-
 docs/dyn/analyticsreporting_v4.reports.html   |     2 +
 .../dyn/androidenterprise_v1.enterprises.html |    15 +-
 ...droidenterprise_v1.serviceaccountkeys.html |     9 +-
 docs/dyn/androidenterprise_v1.users.html      |     6 +-
 docs/dyn/androidpublisher_v2.edits.apks.html  |     5 +-
 ...publisher_v2.edits.deobfuscationfiles.html |     5 +-
 ...roidpublisher_v2.edits.expansionfiles.html |     5 +-
 .../dyn/androidpublisher_v2.edits.images.html |     5 +-
 docs/dyn/androidpublisher_v2.purchases.html   |     5 +
 ...ublisher_v2.purchases.voidedpurchases.html |   117 +
 docs/dyn/androidpublisher_v2.reviews.html     |    42 +-
 docs/dyn/appengine_v1.apps.html               |   133 +-
 docs/dyn/appengine_v1.apps.locations.html     |     8 +-
 docs/dyn/appengine_v1.apps.operations.html    |    20 +-
 docs/dyn/appengine_v1.apps.services.html      |    40 +-
 .../appengine_v1.apps.services.versions.html  |   352 +-
 ...e_v1.apps.services.versions.instances.html |    95 +-
 docs/dyn/appengine_v1.html                    |     5 -
 docs/dyn/appengine_v1beta4.apps.html          |   102 +-
 .../dyn/appengine_v1beta4.apps.locations.html |     8 +-
 docs/dyn/appengine_v1beta4.apps.modules.html  |    40 +-
 ...pengine_v1beta4.apps.modules.versions.html |   316 +-
 ...beta4.apps.modules.versions.instances.html |    95 +-
 .../appengine_v1beta4.apps.operations.html    |    20 +-
 docs/dyn/appengine_v1beta5.apps.html          |   102 +-
 .../dyn/appengine_v1beta5.apps.locations.html |     8 +-
 .../appengine_v1beta5.apps.operations.html    |    20 +-
 docs/dyn/appengine_v1beta5.apps.services.html |    40 +-
 ...engine_v1beta5.apps.services.versions.html |   326 +-
 ...eta5.apps.services.versions.instances.html |    93 +-
 docs/dyn/appsactivity_v1.activities.html      |    18 +-
 docs/dyn/bigquery_v2.jobs.html                |   101 +-
 docs/dyn/bigquery_v2.tables.html              |   184 +-
 docs/dyn/books_v1.notification.html           |     1 +
 docs/dyn/books_v1.series.html                 |     2 +-
 docs/dyn/cloudbuild_v1.operations.html        |    44 +
 docs/dyn/cloudbuild_v1.projects.builds.html   |    72 +-
 docs/dyn/cloudbuild_v1.projects.triggers.html |   108 +-
 ...rrorreporting_v1beta1.projects.events.html |    22 +-
 ...reporting_v1beta1.projects.groupStats.html |    20 +-
 .../clouderrorreporting_v1beta1.projects.html |     3 +-
 .../cloudresourcemanager_v1.operations.html   |    98 +-
 ...cloudresourcemanager_v1.organizations.html |   378 +-
 .../dyn/cloudresourcemanager_v1.projects.html |  1002 +-
 ...resourcemanager_v1beta1.organizations.html |   457 +-
 ...cloudresourcemanager_v1beta1.projects.html |   969 +-
 docs/dyn/compute_alpha.addresses.html         |    12 +-
 docs/dyn/compute_alpha.autoscalers.html       |     8 +-
 docs/dyn/compute_alpha.backendBuckets.html    |    50 +-
 docs/dyn/compute_alpha.backendServices.html   |   200 +-
 docs/dyn/compute_alpha.commitments.html       |   713 +
 docs/dyn/compute_alpha.diskTypes.html         |    18 +-
 docs/dyn/compute_alpha.disks.html             |    10 +-
 docs/dyn/compute_alpha.firewalls.html         |   103 +-
 docs/dyn/compute_alpha.forwardingRules.html   |    70 +-
 docs/dyn/compute_alpha.globalAddresses.html   |    10 +-
 .../compute_alpha.globalForwardingRules.html  |    54 +-
 docs/dyn/compute_alpha.globalOperations.html  |     6 +-
 docs/dyn/compute_alpha.healthChecks.html      |    18 +-
 docs/dyn/compute_alpha.hosts.html             |   382 +-
 docs/dyn/compute_alpha.html                   |     5 +
 docs/dyn/compute_alpha.httpHealthChecks.html  |     8 +-
 docs/dyn/compute_alpha.httpsHealthChecks.html |     8 +-
 docs/dyn/compute_alpha.images.html            |    70 +-
 .../compute_alpha.instanceGroupManagers.html  |   642 +-
 docs/dyn/compute_alpha.instanceGroups.html    |    10 +-
 docs/dyn/compute_alpha.instanceTemplates.html |    55 +-
 docs/dyn/compute_alpha.instances.html         |   167 +-
 docs/dyn/compute_alpha.licenses.html          |     4 +-
 docs/dyn/compute_alpha.machineTypes.html      |    18 +-
 docs/dyn/compute_alpha.networks.html          |   171 +-
 docs/dyn/compute_alpha.projects.html          |    18 +-
 docs/dyn/compute_alpha.regionAutoscalers.html |     8 +-
 .../compute_alpha.regionBackendServices.html  |   168 +-
 docs/dyn/compute_alpha.regionDiskTypes.html   |    12 +-
 docs/dyn/compute_alpha.regionDisks.html       |    14 +-
 ...ute_alpha.regionInstanceGroupManagers.html |   532 +-
 .../compute_alpha.regionInstanceGroups.html   |     2 +-
 docs/dyn/compute_alpha.regionOperations.html  |     4 +-
 docs/dyn/compute_alpha.regions.html           |    12 +-
 docs/dyn/compute_alpha.routers.html           |    10 +-
 docs/dyn/compute_alpha.routes.html            |     7 +-
 docs/dyn/compute_alpha.snapshots.html         |     4 +-
 docs/dyn/compute_alpha.sslCertificates.html   |    10 +-
 docs/dyn/compute_alpha.subnetworks.html       |    50 +-
 docs/dyn/compute_alpha.targetHttpProxies.html |     6 +-
 .../dyn/compute_alpha.targetHttpsProxies.html |     8 +-
 docs/dyn/compute_alpha.targetInstances.html   |     4 +-
 docs/dyn/compute_alpha.targetPools.html       |    14 +-
 docs/dyn/compute_alpha.targetSslProxies.html  |    10 +-
 docs/dyn/compute_alpha.targetTcpProxies.html  |     8 +-
 docs/dyn/compute_alpha.targetVpnGateways.html |     4 +-
 docs/dyn/compute_alpha.urlMaps.html           |    10 +-
 docs/dyn/compute_alpha.vpnTunnels.html        |     4 +-
 docs/dyn/compute_alpha.zoneOperations.html    |     4 +-
 docs/dyn/compute_alpha.zones.html             |    12 +-
 docs/dyn/compute_beta.addresses.html          |     4 +-
 docs/dyn/compute_beta.autoscalers.html        |     8 +-
 docs/dyn/compute_beta.backendBuckets.html     |   455 +
 docs/dyn/compute_beta.backendServices.html    |    56 +-
 docs/dyn/compute_beta.diskTypes.html          |    18 +-
 docs/dyn/compute_beta.disks.html              |    10 +-
 docs/dyn/compute_beta.firewalls.html          |     8 +-
 docs/dyn/compute_beta.forwardingRules.html    |     6 +-
 docs/dyn/compute_beta.globalAddresses.html    |     4 +-
 .../compute_beta.globalForwardingRules.html   |     6 +-
 docs/dyn/compute_beta.globalOperations.html   |     6 +-
 docs/dyn/compute_beta.healthChecks.html       |    83 +-
 docs/dyn/compute_beta.html                    |     5 +
 docs/dyn/compute_beta.httpHealthChecks.html   |     8 +-
 docs/dyn/compute_beta.httpsHealthChecks.html  |     8 +-
 docs/dyn/compute_beta.images.html             |    70 +-
 .../compute_beta.instanceGroupManagers.html   |    42 +-
 docs/dyn/compute_beta.instanceGroups.html     |    10 +-
 docs/dyn/compute_beta.instanceTemplates.html  |    34 +-
 docs/dyn/compute_beta.instances.html          |   154 +-
 docs/dyn/compute_beta.machineTypes.html       |    18 +-
 docs/dyn/compute_beta.networks.html           |     6 +-
 docs/dyn/compute_beta.projects.html           |   131 +-
 docs/dyn/compute_beta.regionAutoscalers.html  |     8 +-
 .../compute_beta.regionBackendServices.html   |    48 +-
 ...pute_beta.regionInstanceGroupManagers.html |    47 +-
 .../compute_beta.regionInstanceGroups.html    |     2 +-
 docs/dyn/compute_beta.regionOperations.html   |     4 +-
 docs/dyn/compute_beta.regions.html            |    12 +-
 docs/dyn/compute_beta.routers.html            |     8 +-
 docs/dyn/compute_beta.routes.html             |     4 +-
 docs/dyn/compute_beta.snapshots.html          |     4 +-
 docs/dyn/compute_beta.sslCertificates.html    |    10 +-
 docs/dyn/compute_beta.subnetworks.html        |   320 +-
 docs/dyn/compute_beta.targetHttpProxies.html  |     6 +-
 docs/dyn/compute_beta.targetHttpsProxies.html |     8 +-
 docs/dyn/compute_beta.targetInstances.html    |     4 +-
 docs/dyn/compute_beta.targetPools.html        |    14 +-
 docs/dyn/compute_beta.targetSslProxies.html   |    10 +-
 docs/dyn/compute_beta.targetVpnGateways.html  |     4 +-
 docs/dyn/compute_beta.urlMaps.html            |    11 +-
 docs/dyn/compute_beta.vpnTunnels.html         |     4 +-
 docs/dyn/compute_beta.zoneOperations.html     |     4 +-
 docs/dyn/compute_beta.zones.html              |    12 +-
 docs/dyn/compute_v1.addresses.html            |     4 +-
 docs/dyn/compute_v1.autoscalers.html          |     8 +-
 docs/dyn/compute_v1.backendServices.html      |   159 +-
 docs/dyn/compute_v1.diskTypes.html            |    18 +-
 docs/dyn/compute_v1.disks.html                |     8 +-
 docs/dyn/compute_v1.firewalls.html            |     8 +-
 docs/dyn/compute_v1.forwardingRules.html      |    82 +-
 docs/dyn/compute_v1.globalAddresses.html      |     4 +-
 .../dyn/compute_v1.globalForwardingRules.html |    63 +-
 docs/dyn/compute_v1.globalOperations.html     |     6 +-
 docs/dyn/compute_v1.healthChecks.html         |    53 +-
 docs/dyn/compute_v1.html                      |    20 +
 docs/dyn/compute_v1.httpHealthChecks.html     |     8 +-
 docs/dyn/compute_v1.httpsHealthChecks.html    |     8 +-
 docs/dyn/compute_v1.images.html               |    72 +-
 .../dyn/compute_v1.instanceGroupManagers.html |    24 +-
 docs/dyn/compute_v1.instanceGroups.html       |    10 +-
 docs/dyn/compute_v1.instanceTemplates.html    |    34 +-
 docs/dyn/compute_v1.instances.html            |    87 +-
 docs/dyn/compute_v1.machineTypes.html         |    18 +-
 docs/dyn/compute_v1.networks.html             |    65 +-
 docs/dyn/compute_v1.projects.html             |     8 +-
 docs/dyn/compute_v1.regionAutoscalers.html    |   621 +
 .../dyn/compute_v1.regionBackendServices.html |   821 +
 ...ompute_v1.regionInstanceGroupManagers.html |   854 +
 docs/dyn/compute_v1.regionInstanceGroups.html |   351 +
 docs/dyn/compute_v1.regionOperations.html     |     4 +-
 docs/dyn/compute_v1.regions.html              |    12 +-
 docs/dyn/compute_v1.routers.html              |     8 +-
 docs/dyn/compute_v1.routes.html               |     4 +-
 docs/dyn/compute_v1.snapshots.html            |     2 +-
 docs/dyn/compute_v1.sslCertificates.html      |    10 +-
 docs/dyn/compute_v1.subnetworks.html          |    73 +-
 docs/dyn/compute_v1.targetHttpProxies.html    |     6 +-
 docs/dyn/compute_v1.targetHttpsProxies.html   |     8 +-
 docs/dyn/compute_v1.targetInstances.html      |     4 +-
 docs/dyn/compute_v1.targetPools.html          |    14 +-
 docs/dyn/compute_v1.targetSslProxies.html     |    10 +-
 docs/dyn/compute_v1.targetVpnGateways.html    |     4 +-
 docs/dyn/compute_v1.urlMaps.html              |    11 +-
 docs/dyn/compute_v1.vpnTunnels.html           |     4 +-
 docs/dyn/compute_v1.zoneOperations.html       |     4 +-
 docs/dyn/compute_v1.zones.html                |    12 +-
 .../consumersurveys_v2.mobileapppanels.html   |    56 +-
 docs/dyn/consumersurveys_v2.results.html      |     6 +-
 docs/dyn/consumersurveys_v2.surveys.html      |   752 +-
 docs/dyn/content_v2.accounts.html             |    24 +-
 docs/dyn/content_v2.accountshipping.html      |    16 +-
 docs/dyn/content_v2.accountstatuses.html      |     8 +-
 docs/dyn/content_v2.accounttax.html           |    16 +-
 docs/dyn/content_v2.datafeeds.html            |    24 +-
 docs/dyn/content_v2.datafeedstatuses.html     |     8 +-
 docs/dyn/content_v2.inventory.html            |    16 +-
 docs/dyn/content_v2.orders.html               |    72 +-
 docs/dyn/content_v2.products.html             |    20 +-
 docs/dyn/content_v2.productstatuses.html      |    12 +-
 docs/dyn/content_v2.shippingsettings.html     |    16 +-
 docs/dyn/content_v2sandbox.orders.html        |    72 +-
 docs/dyn/dataflow_v1b3.projects.html          |     5 +
 docs/dyn/dataflow_v1b3.projects.jobs.html     |    40 +-
 .../dataflow_v1b3.projects.jobs.messages.html |     5 +-
 ...dataflow_v1b3.projects.jobs.workItems.html |     8 +-
 .../dyn/dataflow_v1b3.projects.locations.html |    82 +
 ...dataflow_v1b3.projects.locations.jobs.html |  1052 +
 ...v1b3.projects.locations.jobs.messages.html |   129 +
 ...1b3.projects.locations.jobs.workItems.html |  1097 +
 .../dyn/dataflow_v1b3.projects.templates.html |     9 +
 ...dataproc_v1.projects.regions.clusters.html |   355 +-
 .../dataproc_v1.projects.regions.jobs.html    |   172 +-
 ...taproc_v1.projects.regions.operations.html |    20 +-
 docs/dyn/dataproc_v1alpha1.operations.html    |    12 +-
 ...oc_v1alpha1.projects.regions.clusters.html |    71 +-
 ...taproc_v1alpha1.projects.regions.jobs.html |    15 +
 docs/dyn/dataproc_v1beta1.operations.html     |    16 +-
 .../dataproc_v1beta1.projects.clusters.html   |    85 +-
 docs/dyn/dataproc_v1beta1.projects.jobs.html  |    24 +-
 docs/dyn/datastore_v1.projects.html           |     1 +
 docs/dyn/datastore_v1beta3.projects.html      |     1 +
 .../dyn/deploymentmanager_v2.deployments.html |    81 +-
 docs/dyn/deploymentmanager_v2.manifests.html  |     9 +-
 docs/dyn/deploymentmanager_v2.operations.html |    13 +-
 docs/dyn/deploymentmanager_v2.resources.html  |     9 +-
 docs/dyn/deploymentmanager_v2.types.html      |    11 +-
 ...dfareporting_v2_5.accountUserProfiles.html |     4 +-
 docs/dyn/dfareporting_v2_5.accounts.html      |     4 +-
 docs/dyn/dfareporting_v2_5.ads.html           |    36 +-
 .../dfareporting_v2_5.advertiserGroups.html   |     4 +-
 docs/dyn/dfareporting_v2_5.advertisers.html   |     4 +-
 ...ing_v2_5.campaignCreativeAssociations.html |     4 +-
 docs/dyn/dfareporting_v2_5.campaigns.html     |     4 +-
 docs/dyn/dfareporting_v2_5.changeLogs.html    |     5 +-
 .../dfareporting_v2_5.contentCategories.html  |     4 +-
 docs/dyn/dfareporting_v2_5.conversions.html   |     4 +-
 .../dyn/dfareporting_v2_5.creativeAssets.html |     5 +-
 ...dfareporting_v2_5.creativeFieldValues.html |     4 +-
 .../dyn/dfareporting_v2_5.creativeFields.html |     4 +-
 .../dyn/dfareporting_v2_5.creativeGroups.html |     4 +-
 docs/dyn/dfareporting_v2_5.creatives.html     |     4 +-
 ...areporting_v2_5.directorySiteContacts.html |     4 +-
 .../dyn/dfareporting_v2_5.directorySites.html |     4 +-
 ...fareporting_v2_5.floodlightActivities.html |     4 +-
 ...porting_v2_5.floodlightActivityGroups.html |     4 +-
 .../dyn/dfareporting_v2_5.inventoryItems.html |     4 +-
 .../dyn/dfareporting_v2_5.orderDocuments.html |     4 +-
 docs/dyn/dfareporting_v2_5.orders.html        |     4 +-
 .../dfareporting_v2_5.placementGroups.html    |     4 +-
 ...dfareporting_v2_5.placementStrategies.html |     4 +-
 docs/dyn/dfareporting_v2_5.placements.html    |     4 +-
 docs/dyn/dfareporting_v2_5.projects.html      |     4 +-
 .../dfareporting_v2_5.remarketingLists.html   |     4 +-
 docs/dyn/dfareporting_v2_5.sites.html         |     4 +-
 docs/dyn/dfareporting_v2_5.subaccounts.html   |     4 +-
 ...rting_v2_5.targetableRemarketingLists.html |     4 +-
 docs/dyn/dfareporting_v2_5.userRoles.html     |     4 +-
 ...porting_v2_5beta1.accountUserProfiles.html |     4 +-
 docs/dyn/dfareporting_v2_5beta1.accounts.html |     4 +-
 docs/dyn/dfareporting_v2_5beta1.ads.html      |    36 +-
 ...areporting_v2_5beta1.advertiserGroups.html |     4 +-
 .../dfareporting_v2_5beta1.advertisers.html   |     4 +-
 ...2_5beta1.campaignCreativeAssociations.html |     4 +-
 .../dyn/dfareporting_v2_5beta1.campaigns.html |     4 +-
 .../dfareporting_v2_5beta1.changeLogs.html    |     5 +-
 ...reporting_v2_5beta1.contentCategories.html |     4 +-
 .../dfareporting_v2_5beta1.conversions.html   |     4 +-
 ...dfareporting_v2_5beta1.creativeAssets.html |     5 +-
 ...porting_v2_5beta1.creativeFieldValues.html |     4 +-
 ...dfareporting_v2_5beta1.creativeFields.html |     4 +-
 ...dfareporting_v2_5beta1.creativeGroups.html |     4 +-
 .../dyn/dfareporting_v2_5beta1.creatives.html |     4 +-
 ...rting_v2_5beta1.directorySiteContacts.html |     4 +-
 ...dfareporting_v2_5beta1.directorySites.html |     4 +-
 ...orting_v2_5beta1.floodlightActivities.html |     4 +-
 ...ng_v2_5beta1.floodlightActivityGroups.html |     4 +-
 ...dfareporting_v2_5beta1.inventoryItems.html |     4 +-
 ...dfareporting_v2_5beta1.orderDocuments.html |     4 +-
 docs/dyn/dfareporting_v2_5beta1.orders.html   |     4 +-
 ...fareporting_v2_5beta1.placementGroups.html |     4 +-
 ...porting_v2_5beta1.placementStrategies.html |     4 +-
 .../dfareporting_v2_5beta1.placements.html    |     4 +-
 docs/dyn/dfareporting_v2_5beta1.projects.html |     4 +-
 ...areporting_v2_5beta1.remarketingLists.html |     4 +-
 docs/dyn/dfareporting_v2_5beta1.sites.html    |     4 +-
 .../dfareporting_v2_5beta1.subaccounts.html   |     4 +-
 ..._v2_5beta1.targetableRemarketingLists.html |     4 +-
 .../dyn/dfareporting_v2_5beta1.userRoles.html |     4 +-
 ...dfareporting_v2_6.accountUserProfiles.html |     4 +-
 docs/dyn/dfareporting_v2_6.accounts.html      |     4 +-
 docs/dyn/dfareporting_v2_6.ads.html           |    36 +-
 .../dfareporting_v2_6.advertiserGroups.html   |     4 +-
 docs/dyn/dfareporting_v2_6.advertisers.html   |     4 +-
 ...ing_v2_6.campaignCreativeAssociations.html |     4 +-
 docs/dyn/dfareporting_v2_6.campaigns.html     |     4 +-
 docs/dyn/dfareporting_v2_6.changeLogs.html    |     5 +-
 .../dfareporting_v2_6.contentCategories.html  |     4 +-
 docs/dyn/dfareporting_v2_6.conversions.html   |     4 +-
 .../dyn/dfareporting_v2_6.creativeAssets.html |     5 +-
 ...dfareporting_v2_6.creativeFieldValues.html |     4 +-
 .../dyn/dfareporting_v2_6.creativeFields.html |     4 +-
 .../dyn/dfareporting_v2_6.creativeGroups.html |     4 +-
 docs/dyn/dfareporting_v2_6.creatives.html     |     4 +-
 ...areporting_v2_6.directorySiteContacts.html |     4 +-
 .../dyn/dfareporting_v2_6.directorySites.html |     4 +-
 ...fareporting_v2_6.floodlightActivities.html |     4 +-
 ...porting_v2_6.floodlightActivityGroups.html |     4 +-
 .../dyn/dfareporting_v2_6.inventoryItems.html |     4 +-
 .../dyn/dfareporting_v2_6.orderDocuments.html |     4 +-
 docs/dyn/dfareporting_v2_6.orders.html        |     4 +-
 .../dfareporting_v2_6.placementGroups.html    |     4 +-
 ...dfareporting_v2_6.placementStrategies.html |     4 +-
 docs/dyn/dfareporting_v2_6.placements.html    |     4 +-
 docs/dyn/dfareporting_v2_6.projects.html      |     4 +-
 .../dfareporting_v2_6.remarketingLists.html   |     4 +-
 docs/dyn/dfareporting_v2_6.sites.html         |     4 +-
 docs/dyn/dfareporting_v2_6.subaccounts.html   |     4 +-
 ...rting_v2_6.targetableRemarketingLists.html |     4 +-
 .../dfareporting_v2_6.targetingTemplates.html |     4 +-
 docs/dyn/dfareporting_v2_6.userRoles.html     |     4 +-
 ...porting_v2_7.accountActiveAdSummaries.html |   101 +
 ...eporting_v2_7.accountPermissionGroups.html |   124 +
 .../dfareporting_v2_7.accountPermissions.html |   142 +
 ...dfareporting_v2_7.accountUserProfiles.html |   677 +
 docs/dyn/dfareporting_v2_7.accounts.html      |   856 +
 docs/dyn/dfareporting_v2_7.ads.html           |  2958 +
 .../dfareporting_v2_7.advertiserGroups.html   |   263 +
 docs/dyn/dfareporting_v2_7.advertisers.html   |   475 +
 docs/dyn/dfareporting_v2_7.browsers.html      |   106 +
 ...ing_v2_7.campaignCreativeAssociations.html |   155 +
 docs/dyn/dfareporting_v2_7.campaigns.html     |  1131 +
 docs/dyn/dfareporting_v2_7.changeLogs.html    |   232 +
 docs/dyn/dfareporting_v2_7.cities.html        |   113 +
 .../dfareporting_v2_7.connectionTypes.html    |   124 +
 .../dfareporting_v2_7.contentCategories.html  |   263 +
 docs/dyn/dfareporting_v2_7.conversions.html   |   170 +
 docs/dyn/dfareporting_v2_7.countries.html     |   128 +
 .../dyn/dfareporting_v2_7.creativeAssets.html |   210 +
 ...dfareporting_v2_7.creativeFieldValues.html |   261 +
 .../dyn/dfareporting_v2_7.creativeFields.html |   344 +
 .../dyn/dfareporting_v2_7.creativeGroups.html |   364 +
 docs/dyn/dfareporting_v2_7.creatives.html     |  3149 +
 .../dfareporting_v2_7.dimensionValues.html    |   144 +
 ...areporting_v2_7.directorySiteContacts.html |   169 +
 .../dyn/dfareporting_v2_7.directorySites.html |   590 +
 ...fareporting_v2_7.dynamicTargetingKeys.html |   164 +
 docs/dyn/dfareporting_v2_7.eventTags.html     |   493 +
 docs/dyn/dfareporting_v2_7.files.html         |   205 +
 ...fareporting_v2_7.floodlightActivities.html |  1045 +
 ...porting_v2_7.floodlightActivityGroups.html |   488 +
 ...porting_v2_7.floodlightConfigurations.html |   514 +
 docs/dyn/dfareporting_v2_7.html               |   398 +
 .../dyn/dfareporting_v2_7.inventoryItems.html |   250 +
 docs/dyn/dfareporting_v2_7.landingPages.html  |   247 +
 docs/dyn/dfareporting_v2_7.languages.html     |   104 +
 docs/dyn/dfareporting_v2_7.metros.html        |   107 +
 .../dyn/dfareporting_v2_7.mobileCarriers.html |   128 +
 ...eporting_v2_7.operatingSystemVersions.html |   142 +
 .../dfareporting_v2_7.operatingSystems.html   |   128 +
 .../dyn/dfareporting_v2_7.orderDocuments.html |   199 +
 docs/dyn/dfareporting_v2_7.orders.html        |   223 +
 .../dfareporting_v2_7.placementGroups.html    |   977 +
 ...dfareporting_v2_7.placementStrategies.html |   263 +
 docs/dyn/dfareporting_v2_7.placements.html    |  1656 +
 docs/dyn/dfareporting_v2_7.platformTypes.html |   124 +
 docs/dyn/dfareporting_v2_7.postalCodes.html   |   128 +
 docs/dyn/dfareporting_v2_7.projects.html      |   197 +
 docs/dyn/dfareporting_v2_7.regions.html       |   106 +
 ...areporting_v2_7.remarketingListShares.html |   183 +
 .../dfareporting_v2_7.remarketingLists.html   |   532 +
 ...porting_v2_7.reports.compatibleFields.html |   551 +
 docs/dyn/dfareporting_v2_7.reports.files.html |   203 +
 docs/dyn/dfareporting_v2_7.reports.html       |  2795 +
 docs/dyn/dfareporting_v2_7.sites.html         |   683 +
 docs/dyn/dfareporting_v2_7.sizes.html         |   165 +
 docs/dyn/dfareporting_v2_7.subaccounts.html   |   274 +
 ...rting_v2_7.targetableRemarketingLists.html |   187 +
 .../dfareporting_v2_7.targetingTemplates.html |  1523 +
 docs/dyn/dfareporting_v2_7.userProfiles.html  |   133 +
 ...porting_v2_7.userRolePermissionGroups.html |   124 +
 ...dfareporting_v2_7.userRolePermissions.html |   129 +
 docs/dyn/dfareporting_v2_7.userRoles.html     |   361 +
 docs/dyn/dfareporting_v2_7.videoFormats.html  |   140 +
 docs/dyn/dns_v2beta1.dnskeys.html             |     2 +-
 docs/dyn/dns_v2beta1.html                     |     4 +-
 docs/dyn/drive_v2.changes.html                |    62 +-
 docs/dyn/drive_v2.files.html                  |   425 +-
 docs/dyn/drive_v2.permissions.html            |    32 +-
 docs/dyn/drive_v2.realtime.html               |     5 +-
 docs/dyn/drive_v3.changes.html                |     5 +-
 docs/dyn/drive_v3.files.html                  |    50 +-
 .../firebasedynamiclinks_v1.shortLinks.html   |     3 -
 ...fitness_v1.users.dataSources.datasets.html |     6 +-
 docs/dyn/fitness_v1.users.dataset.html        |     2 +-
 docs/dyn/fusiontables_v1.table.html           |    10 +-
 docs/dyn/fusiontables_v2.table.html           |    15 +-
 ...n_v1configuration.imageConfigurations.html |     5 +-
 docs/dyn/genomics_v1.operations.html          |     2 +-
 docs/dyn/genomics_v1alpha2.operations.html    |     2 +-
 docs/dyn/genomics_v1alpha2.pipelines.html     |     5 +-
 docs/dyn/gmail_v1.users.drafts.html           |    47 +-
 docs/dyn/gmail_v1.users.history.html          |    20 +-
 .../gmail_v1.users.messages.attachments.html  |     4 +-
 docs/dyn/gmail_v1.users.messages.html         |    90 +-
 docs/dyn/gmail_v1.users.settings.html         |     6 +-
 docs/dyn/gmail_v1.users.settings.sendAs.html  |    32 +-
 docs/dyn/gmail_v1.users.threads.html          |    22 +-
 docs/dyn/groupsmigration_v1.archive.html      |     5 +-
 docs/dyn/identitytoolkit_v3.relyingparty.html |    14 +-
 docs/dyn/language_v1.documents.html           |   505 +
 docs/dyn/language_v1.html                     |   103 +
 docs/dyn/language_v1beta1.documents.html      |   206 +-
 docs/dyn/logging_v2.billingAccounts.html      |     5 +
 docs/dyn/logging_v2.billingAccounts.logs.html |    72 +-
 .../dyn/logging_v2.billingAccounts.sinks.html |   312 +
 docs/dyn/logging_v2.entries.html              |   372 +-
 docs/dyn/logging_v2.folders.html              |    87 +
 docs/dyn/logging_v2.folders.logs.html         |   153 +
 docs/dyn/logging_v2.folders.sinks.html        |   312 +
 docs/dyn/logging_v2.html                      |     5 +
 ...gging_v2.monitoredResourceDescriptors.html |    50 +-
 docs/dyn/logging_v2.organizations.logs.html   |    72 +-
 docs/dyn/logging_v2.organizations.sinks.html  |   407 +-
 docs/dyn/logging_v2.projects.logs.html        |    72 +-
 docs/dyn/logging_v2.projects.metrics.html     |   182 +-
 docs/dyn/logging_v2.projects.sinks.html       |   407 +-
 .../logging_v2beta1.billingAccounts.logs.html |    72 +-
 docs/dyn/logging_v2beta1.entries.html         |   372 +-
 ..._v2beta1.monitoredResourceDescriptors.html |    50 +-
 .../logging_v2beta1.organizations.logs.html   |    72 +-
 docs/dyn/logging_v2beta1.projects.logs.html   |    72 +-
 .../dyn/logging_v2beta1.projects.metrics.html |   182 +-
 docs/dyn/logging_v2beta1.projects.sinks.html  |   407 +-
 docs/dyn/manufacturers_v1.accounts.html       |    82 +
 .../manufacturers_v1.accounts.products.html   |   404 +
 docs/dyn/manufacturers_v1.html                |   103 +
 docs/dyn/mirror_v1.timeline.attachments.html  |     5 +-
 docs/dyn/mirror_v1.timeline.html              |    10 +-
 docs/dyn/ml_v1beta1.projects.jobs.html        |    12 +-
 ...toring_v3.projects.collectdTimeSeries.html |    44 +-
 docs/dyn/monitoring_v3.projects.groups.html   |    52 +-
 ...monitoring_v3.projects.groups.members.html |    18 +-
 ...itoring_v3.projects.metricDescriptors.html |   112 +-
 ...projects.monitoredResourceDescriptors.html |    28 +-
 .../monitoring_v3.projects.timeSeries.html    |    62 +-
 docs/dyn/plusDomains_v1.media.html            |     5 +-
 docs/dyn/pubsub_v1.projects.snapshots.html    |   279 +-
 .../dyn/pubsub_v1.projects.subscriptions.html |   787 +-
 docs/dyn/pubsub_v1.projects.topics.html       |   410 +-
 ...bsub_v1.projects.topics.subscriptions.html |    18 +-
 docs/dyn/pubsub_v1beta1a.subscriptions.html   |   369 +-
 docs/dyn/pubsub_v1beta1a.topics.html          |   145 +-
 ...pubsub_v1beta2.projects.subscriptions.html |   728 +-
 docs/dyn/pubsub_v1beta2.projects.topics.html  |   383 +-
 ...v1beta2.projects.topics.subscriptions.html |    11 +-
 ...untimeconfig_v1beta1.projects.configs.html |   522 +-
 ...g_v1beta1.projects.configs.operations.html |    33 +
 ...ig_v1beta1.projects.configs.variables.html |   113 +-
 ...nfig_v1beta1.projects.configs.waiters.html |    50 +-
 docs/dyn/servicecontrol_v1.services.html      |    35 +-
 ...servicemanagement_v1.services.configs.html |  1726 +-
 docs/dyn/servicemanagement_v1.services.html   |   531 +-
 docs/dyn/sheets_v4.spreadsheets.html          | 48692 ++++++++++------
 docs/dyn/sheets_v4.spreadsheets.sheets.html   |     8 +-
 docs/dyn/sheets_v4.spreadsheets.values.html   |   168 +-
 docs/dyn/slides_v1.html                       |   103 +
 docs/dyn/slides_v1.presentations.html         | 17934 ++++++
 docs/dyn/slides_v1.presentations.pages.html   |  1902 +
 docs/dyn/speech_v1beta1.speech.html           |    12 +-
 docs/dyn/sqladmin_v1beta3.tiers.html          |     2 +-
 docs/dyn/sqladmin_v1beta4.instances.html      |    88 +
 docs/dyn/sqladmin_v1beta4.tiers.html          |     2 +-
 docs/dyn/storage_v1.objects.html              |    28 +-
 docs/dyn/storage_v1beta1.objects.html         |    10 +-
 docs/dyn/storage_v1beta2.objects.html         |    10 +-
 docs/dyn/surveys_v2.surveys.html              |    32 +-
 docs/dyn/vision_v1.images.html                |   255 +-
 docs/dyn/youtubeAnalytics_v1.html             |    10 -
 docs/dyn/youtubeAnalytics_v1beta1.html        |    10 -
 docs/dyn/youtube_v3.captions.html             |    10 +-
 docs/dyn/youtube_v3.channelBanners.html       |     5 +-
 docs/dyn/youtube_v3.channels.html             |     3 -
 docs/dyn/youtube_v3.commentThreads.html       |    10 -
 docs/dyn/youtube_v3.comments.html             |     5 -
 docs/dyn/youtube_v3.playlistItems.html        |    19 +-
 docs/dyn/youtube_v3.thumbnails.html           |     5 +-
 docs/dyn/youtube_v3.videos.html               |    70 +-
 docs/dyn/youtube_v3.watermarks.html           |     5 +-
 docs/epy/api-objects.txt                      |     6 +
 docs/epy/class-tree.html                      |     2 +-
 docs/epy/googleapiclient-module.html          |     5 +-
 docs/epy/googleapiclient-pysrc.html           |     4 +-
 .../googleapiclient.NullHandler-class.html    |    44 +-
 docs/epy/googleapiclient._auth-module.html    |   294 +
 docs/epy/googleapiclient._auth-pysrc.html     |   201 +
 docs/epy/googleapiclient.channel-module.html  |     2 +-
 docs/epy/googleapiclient.channel-pysrc.html   |     2 +-
 ...googleapiclient.channel.Channel-class.html |    10 +-
 ...eapiclient.channel.Notification-class.html |     6 +-
 .../epy/googleapiclient.discovery-module.html |     9 +-
 docs/epy/googleapiclient.discovery-pysrc.html |  2245 +-
 ...gleapiclient.discovery.Resource-class.html |    10 +-
 ...covery.ResourceMethodParameters-class.html |     8 +-
 ...lient.discovery._BytesGenerator-class.html |     4 +-
 ...oogleapiclient.discovery_cache-module.html |     2 +-
 ...googleapiclient.discovery_cache-pysrc.html |     2 +-
 ...overy_cache.appengine_memcache-module.html |     2 +-
 ...covery_cache.appengine_memcache-pysrc.html |     2 +-
 ..._cache.appengine_memcache.Cache-class.html |    14 +-
 ...apiclient.discovery_cache.base-module.html |     2 +-
 ...eapiclient.discovery_cache.base-pysrc.html |     2 +-
 ...ient.discovery_cache.base.Cache-class.html |    10 +-
 ...ent.discovery_cache.file_cache-module.html |     2 +-
 ...ient.discovery_cache.file_cache-pysrc.html |     2 +-
 ...iscovery_cache.file_cache.Cache-class.html |    14 +-
 docs/epy/googleapiclient.errors-module.html   |     2 +-
 docs/epy/googleapiclient.errors-pysrc.html    |     2 +-
 ...ogleapiclient.errors.BatchError-class.html |    40 +-
 .../googleapiclient.errors.Error-class.html   |    36 +-
 ...oogleapiclient.errors.HttpError-class.html |    38 +-
 ...nt.errors.InvalidChunkSizeError-class.html |    38 +-
 ...iclient.errors.InvalidJsonError-class.html |    38 +-
 ...errors.InvalidNotificationError-class.html |    38 +-
 ...ent.errors.MediaUploadSizeError-class.html |    38 +-
 ...ent.errors.ResumableUploadError-class.html |    40 +-
 ...rrors.UnacceptableMimeTypeError-class.html |    38 +-
 ...ient.errors.UnexpectedBodyError-class.html |    38 +-
 ...nt.errors.UnexpectedMethodError-class.html |    38 +-
 ....errors.UnknownApiNameOrVersion-class.html |    38 +-
 ...piclient.errors.UnknownFileType-class.html |    38 +-
 ...piclient.errors.UnknownLinkType-class.html |    38 +-
 docs/epy/googleapiclient.http-module.html     |     2 +-
 docs/epy/googleapiclient.http-pysrc.html      |  1454 +-
 ...apiclient.http.BatchHttpRequest-class.html |    10 +-
 .../googleapiclient.http.HttpMock-class.html  |     8 +-
 ...apiclient.http.HttpMockSequence-class.html |     8 +-
 ...oogleapiclient.http.HttpRequest-class.html |    16 +-
 ...eapiclient.http.HttpRequestMock-class.html |     8 +-
 ...ient.http.MediaDownloadProgress-class.html |     8 +-
 ...eapiclient.http.MediaFileUpload-class.html |    30 +-
 ...client.http.MediaInMemoryUpload-class.html |    28 +-
 ...client.http.MediaIoBaseDownload-class.html |     8 +-
 ...piclient.http.MediaIoBaseUpload-class.html |    26 +-
 ...oogleapiclient.http.MediaUpload-class.html |    22 +-
 ...client.http.MediaUploadProgress-class.html |     8 +-
 ...iclient.http.RequestMockBuilder-class.html |     8 +-
 ...ogleapiclient.http._StreamSlice-class.html |     8 +-
 .../epy/googleapiclient.mimeparse-module.html |     2 +-
 docs/epy/googleapiclient.mimeparse-pysrc.html |     2 +-
 docs/epy/googleapiclient.model-module.html    |     2 +-
 docs/epy/googleapiclient.model-pysrc.html     |     2 +-
 ...googleapiclient.model.BaseModel-class.html |    22 +-
 ...googleapiclient.model.JsonModel-class.html |    26 +-
 ...oogleapiclient.model.MediaModel-class.html |    28 +-
 .../googleapiclient.model.Model-class.html    |     8 +-
 ...lient.model.ProtocolBufferModel-class.html |    26 +-
 .../googleapiclient.model.RawModel-class.html |    28 +-
 .../googleapiclient.sample_tools-module.html  |     2 +-
 .../googleapiclient.sample_tools-pysrc.html   |     2 +-
 docs/epy/googleapiclient.schema-module.html   |     2 +-
 docs/epy/googleapiclient.schema-pysrc.html    |     2 +-
 .../googleapiclient.schema.Schemas-class.html |    12 +-
 ...piclient.schema._SchemaToStruct-class.html |    18 +-
 docs/epy/help.html                            |     2 +-
 docs/epy/identifier-index.html                |   192 +-
 docs/epy/module-tree.html                     |     3 +-
 docs/epy/redirect.html                        |     2 +-
 docs/epy/toc-everything.html                  |    15 +
 .../epy/toc-googleapiclient._auth-module.html |    46 +
 docs/epy/toc.html                             |     5 +-
 docs/epy/uml_class_diagram_for_googleap.gif   |   Bin 12528 -> 14673 bytes
 .../epy/uml_class_diagram_for_googleap_10.gif |   Bin 12210 -> 14292 bytes
 .../epy/uml_class_diagram_for_googleap_11.gif |   Bin 8578 -> 10246 bytes
 .../epy/uml_class_diagram_for_googleap_12.gif |   Bin 10677 -> 13072 bytes
 .../epy/uml_class_diagram_for_googleap_13.gif |   Bin 9904 -> 11800 bytes
 .../epy/uml_class_diagram_for_googleap_14.gif |   Bin 9642 -> 11434 bytes
 .../epy/uml_class_diagram_for_googleap_15.gif |   Bin 9814 -> 11780 bytes
 .../epy/uml_class_diagram_for_googleap_16.gif |   Bin 9925 -> 11858 bytes
 .../epy/uml_class_diagram_for_googleap_17.gif |   Bin 11911 -> 12836 bytes
 .../epy/uml_class_diagram_for_googleap_18.gif |   Bin 10254 -> 12338 bytes
 .../epy/uml_class_diagram_for_googleap_19.gif |   Bin 10868 -> 13296 bytes
 docs/epy/uml_class_diagram_for_googleap_2.gif |   Bin 4675 -> 5407 bytes
 .../epy/uml_class_diagram_for_googleap_20.gif |   Bin 10654 -> 13092 bytes
 .../epy/uml_class_diagram_for_googleap_21.gif |   Bin 10681 -> 12351 bytes
 .../epy/uml_class_diagram_for_googleap_22.gif |   Bin 9705 -> 11503 bytes
 .../epy/uml_class_diagram_for_googleap_23.gif |   Bin 9711 -> 11514 bytes
 .../epy/uml_class_diagram_for_googleap_24.gif |   Bin 4352 -> 5488 bytes
 .../epy/uml_class_diagram_for_googleap_25.gif |   Bin 4778 -> 5976 bytes
 .../epy/uml_class_diagram_for_googleap_26.gif |   Bin 4680 -> 5660 bytes
 .../epy/uml_class_diagram_for_googleap_27.gif |   Bin 7942 -> 10398 bytes
 .../epy/uml_class_diagram_for_googleap_28.gif |   Bin 3054 -> 3756 bytes
 .../epy/uml_class_diagram_for_googleap_29.gif |   Bin 3280 -> 3740 bytes
 docs/epy/uml_class_diagram_for_googleap_3.gif |   Bin 2937 -> 3258 bytes
 .../epy/uml_class_diagram_for_googleap_30.gif |   Bin 12957 -> 15670 bytes
 .../epy/uml_class_diagram_for_googleap_31.gif |   Bin 13867 -> 16007 bytes
 .../epy/uml_class_diagram_for_googleap_32.gif |   Bin 4235 -> 4782 bytes
 .../epy/uml_class_diagram_for_googleap_33.gif |   Bin 10494 -> 12543 bytes
 .../epy/uml_class_diagram_for_googleap_34.gif |   Bin 5138 -> 6315 bytes
 .../epy/uml_class_diagram_for_googleap_35.gif |   Bin 3196 -> 3710 bytes
 .../epy/uml_class_diagram_for_googleap_36.gif |   Bin 5249 -> 6732 bytes
 .../epy/uml_class_diagram_for_googleap_37.gif |   Bin 2836 -> 3081 bytes
 .../epy/uml_class_diagram_for_googleap_38.gif |   Bin 8184 -> 9445 bytes
 .../epy/uml_class_diagram_for_googleap_39.gif |   Bin 10392 -> 12553 bytes
 docs/epy/uml_class_diagram_for_googleap_4.gif |   Bin 4756 -> 5551 bytes
 .../epy/uml_class_diagram_for_googleap_40.gif |   Bin 11503 -> 14387 bytes
 .../epy/uml_class_diagram_for_googleap_41.gif |   Bin 3683 -> 4403 bytes
 .../epy/uml_class_diagram_for_googleap_42.gif |   Bin 10416 -> 12749 bytes
 .../epy/uml_class_diagram_for_googleap_43.gif |   Bin 11542 -> 14325 bytes
 .../epy/uml_class_diagram_for_googleap_44.gif |   Bin 4001 -> 4699 bytes
 .../epy/uml_class_diagram_for_googleap_45.gif |   Bin 4946 -> 6055 bytes
 docs/epy/uml_class_diagram_for_googleap_5.gif |   Bin 3195 -> 3891 bytes
 docs/epy/uml_class_diagram_for_googleap_6.gif |   Bin 1358 -> 1250 bytes
 docs/epy/uml_class_diagram_for_googleap_7.gif |   Bin 4690 -> 5409 bytes
 docs/epy/uml_class_diagram_for_googleap_8.gif |   Bin 2590 -> 2662 bytes
 docs/epy/uml_class_diagram_for_googleap_9.gif |   Bin 4690 -> 5409 bytes
 googleapiclient/__init__.py                   |     2 +-
 636 files changed, 107934 insertions(+), 28791 deletions(-)
 create mode 100644 docs/dyn/androidpublisher_v2.purchases.voidedpurchases.html
 create mode 100644 docs/dyn/compute_alpha.commitments.html
 create mode 100644 docs/dyn/compute_beta.backendBuckets.html
 create mode 100644 docs/dyn/compute_v1.regionAutoscalers.html
 create mode 100644 docs/dyn/compute_v1.regionBackendServices.html
 create mode 100644 docs/dyn/compute_v1.regionInstanceGroupManagers.html
 create mode 100644 docs/dyn/compute_v1.regionInstanceGroups.html
 create mode 100644 docs/dyn/dataflow_v1b3.projects.locations.html
 create mode 100644 docs/dyn/dataflow_v1b3.projects.locations.jobs.html
 create mode 100644 docs/dyn/dataflow_v1b3.projects.locations.jobs.messages.html
 create mode 100644 docs/dyn/dataflow_v1b3.projects.locations.jobs.workItems.html
 create mode 100644 docs/dyn/dfareporting_v2_7.accountActiveAdSummaries.html
 create mode 100644 docs/dyn/dfareporting_v2_7.accountPermissionGroups.html
 create mode 100644 docs/dyn/dfareporting_v2_7.accountPermissions.html
 create mode 100644 docs/dyn/dfareporting_v2_7.accountUserProfiles.html
 create mode 100644 docs/dyn/dfareporting_v2_7.accounts.html
 create mode 100644 docs/dyn/dfareporting_v2_7.ads.html
 create mode 100644 docs/dyn/dfareporting_v2_7.advertiserGroups.html
 create mode 100644 docs/dyn/dfareporting_v2_7.advertisers.html
 create mode 100644 docs/dyn/dfareporting_v2_7.browsers.html
 create mode 100644 docs/dyn/dfareporting_v2_7.campaignCreativeAssociations.html
 create mode 100644 docs/dyn/dfareporting_v2_7.campaigns.html
 create mode 100644 docs/dyn/dfareporting_v2_7.changeLogs.html
 create mode 100644 docs/dyn/dfareporting_v2_7.cities.html
 create mode 100644 docs/dyn/dfareporting_v2_7.connectionTypes.html
 create mode 100644 docs/dyn/dfareporting_v2_7.contentCategories.html
 create mode 100644 docs/dyn/dfareporting_v2_7.conversions.html
 create mode 100644 docs/dyn/dfareporting_v2_7.countries.html
 create mode 100644 docs/dyn/dfareporting_v2_7.creativeAssets.html
 create mode 100644 docs/dyn/dfareporting_v2_7.creativeFieldValues.html
 create mode 100644 docs/dyn/dfareporting_v2_7.creativeFields.html
 create mode 100644 docs/dyn/dfareporting_v2_7.creativeGroups.html
 create mode 100644 docs/dyn/dfareporting_v2_7.creatives.html
 create mode 100644 docs/dyn/dfareporting_v2_7.dimensionValues.html
 create mode 100644 docs/dyn/dfareporting_v2_7.directorySiteContacts.html
 create mode 100644 docs/dyn/dfareporting_v2_7.directorySites.html
 create mode 100644 docs/dyn/dfareporting_v2_7.dynamicTargetingKeys.html
 create mode 100644 docs/dyn/dfareporting_v2_7.eventTags.html
 create mode 100644 docs/dyn/dfareporting_v2_7.files.html
 create mode 100644 docs/dyn/dfareporting_v2_7.floodlightActivities.html
 create mode 100644 docs/dyn/dfareporting_v2_7.floodlightActivityGroups.html
 create mode 100644 docs/dyn/dfareporting_v2_7.floodlightConfigurations.html
 create mode 100644 docs/dyn/dfareporting_v2_7.html
 create mode 100644 docs/dyn/dfareporting_v2_7.inventoryItems.html
 create mode 100644 docs/dyn/dfareporting_v2_7.landingPages.html
 create mode 100644 docs/dyn/dfareporting_v2_7.languages.html
 create mode 100644 docs/dyn/dfareporting_v2_7.metros.html
 create mode 100644 docs/dyn/dfareporting_v2_7.mobileCarriers.html
 create mode 100644 docs/dyn/dfareporting_v2_7.operatingSystemVersions.html
 create mode 100644 docs/dyn/dfareporting_v2_7.operatingSystems.html
 create mode 100644 docs/dyn/dfareporting_v2_7.orderDocuments.html
 create mode 100644 docs/dyn/dfareporting_v2_7.orders.html
 create mode 100644 docs/dyn/dfareporting_v2_7.placementGroups.html
 create mode 100644 docs/dyn/dfareporting_v2_7.placementStrategies.html
 create mode 100644 docs/dyn/dfareporting_v2_7.placements.html
 create mode 100644 docs/dyn/dfareporting_v2_7.platformTypes.html
 create mode 100644 docs/dyn/dfareporting_v2_7.postalCodes.html
 create mode 100644 docs/dyn/dfareporting_v2_7.projects.html
 create mode 100644 docs/dyn/dfareporting_v2_7.regions.html
 create mode 100644 docs/dyn/dfareporting_v2_7.remarketingListShares.html
 create mode 100644 docs/dyn/dfareporting_v2_7.remarketingLists.html
 create mode 100644 docs/dyn/dfareporting_v2_7.reports.compatibleFields.html
 create mode 100644 docs/dyn/dfareporting_v2_7.reports.files.html
 create mode 100644 docs/dyn/dfareporting_v2_7.reports.html
 create mode 100644 docs/dyn/dfareporting_v2_7.sites.html
 create mode 100644 docs/dyn/dfareporting_v2_7.sizes.html
 create mode 100644 docs/dyn/dfareporting_v2_7.subaccounts.html
 create mode 100644 docs/dyn/dfareporting_v2_7.targetableRemarketingLists.html
 create mode 100644 docs/dyn/dfareporting_v2_7.targetingTemplates.html
 create mode 100644 docs/dyn/dfareporting_v2_7.userProfiles.html
 create mode 100644 docs/dyn/dfareporting_v2_7.userRolePermissionGroups.html
 create mode 100644 docs/dyn/dfareporting_v2_7.userRolePermissions.html
 create mode 100644 docs/dyn/dfareporting_v2_7.userRoles.html
 create mode 100644 docs/dyn/dfareporting_v2_7.videoFormats.html
 create mode 100644 docs/dyn/language_v1.documents.html
 create mode 100644 docs/dyn/language_v1.html
 create mode 100644 docs/dyn/logging_v2.billingAccounts.sinks.html
 create mode 100644 docs/dyn/logging_v2.folders.html
 create mode 100644 docs/dyn/logging_v2.folders.logs.html
 create mode 100644 docs/dyn/logging_v2.folders.sinks.html
 create mode 100644 docs/dyn/manufacturers_v1.accounts.html
 create mode 100644 docs/dyn/manufacturers_v1.accounts.products.html
 create mode 100644 docs/dyn/manufacturers_v1.html
 create mode 100644 docs/dyn/slides_v1.html
 create mode 100644 docs/dyn/slides_v1.presentations.html
 create mode 100644 docs/dyn/slides_v1.presentations.pages.html
 create mode 100644 docs/epy/googleapiclient._auth-module.html
 create mode 100644 docs/epy/googleapiclient._auth-pysrc.html
 create mode 100644 docs/epy/toc-googleapiclient._auth-module.html

diff --git a/CHANGELOG b/CHANGELOG
index c0a66935a94..3a754d11efb 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,3 +1,24 @@
+v1.6.0
+  Version 1.6.0
+
+  Release to drop support for Python 2.6 and add support for google-auth.
+
+  - Support for Python 2.6 has been dropped. (#319)
+  - The credentials argument to discovery.build and discovery.build_from_document
+    can be either oauth2client credentials or google-auth credentials. (#319)
+  - discovery.build and discovery.build_from_document now unambiguously use the
+    http argument to make all requests, including the request for the discovery
+    document. (#319)
+  - The http and credentials arguments to discovery.build and
+    discovery.build_from_document are now mutually exclusive, eliminating a
+    buggy edge case. (#319)
+  - If neither http or credentials is specified to discovery.build and
+    discovery.build_from_document, then Application Default Credentials will
+    be used. The library prefers google-auth for this if it is available, but
+    can also use oauth2client's implementation. (#319)
+  - Fixed resumable upload failure when receiving a 308 response. (#312)
+  - Clarified the support versions of Python 3. (#316)
+
 v1.5.5
   Version 1.5.5
 
diff --git a/README.md b/README.md
index 03bdf8c9ff8..9d11c67a8ae 100644
--- a/README.md
+++ b/README.md
@@ -16,9 +16,7 @@ $ easy_install --upgrade google-api-python-client
 See the [Developers Guide](https://developers.google.com/api-client-library/python/start/get_started) for more detailed instructions and additional documentation.
 
 # Python Version
-Python 2.6 or 2.7 are fully supported.
-
-Python 3.3 and 3.4 are supported and tested. This library may work on later versions of 3, but we do not currently run tests against those versions.
+Python 2.7, 3.3, and 3.4 are fully supported and tested. This library may work on later versions of 3, but we do not currently run tests against those versions.
 
 # Third Party Libraries and Dependencies
 The following libraries will be installed when you install the client library:
diff --git a/docs/dyn/adexchangebuyer_v1_3.creatives.html b/docs/dyn/adexchangebuyer_v1_3.creatives.html
index 348d2b9954e..02e8f6bffe4 100644
--- a/docs/dyn/adexchangebuyer_v1_3.creatives.html
+++ b/docs/dyn/adexchangebuyer_v1_3.creatives.html
@@ -111,7 +111,7 @@ <h3>Method Details</h3>
         "A String",
       ],
       "accountId": 42, # Account id.
-      "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set.
+      "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set.
       "clickThroughUrl": [ # The set of destination urls for the snippet.
         "A String",
       ],
@@ -212,7 +212,7 @@ <h3>Method Details</h3>
       "A String",
     ],
     "accountId": 42, # Account id.
-    "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set.
+    "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set.
     "clickThroughUrl": [ # The set of destination urls for the snippet.
       "A String",
     ],
@@ -308,7 +308,7 @@ <h3>Method Details</h3>
         "A String",
       ],
       "accountId": 42, # Account id.
-      "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set.
+      "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set.
       "clickThroughUrl": [ # The set of destination urls for the snippet.
         "A String",
       ],
@@ -422,7 +422,7 @@ <h3>Method Details</h3>
             "A String",
           ],
           "accountId": 42, # Account id.
-          "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set.
+          "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set.
           "clickThroughUrl": [ # The set of destination urls for the snippet.
             "A String",
           ],
diff --git a/docs/dyn/adexchangebuyer_v1_4.accounts.html b/docs/dyn/adexchangebuyer_v1_4.accounts.html
index bab5f56bd7b..8870a0cf1ed 100644
--- a/docs/dyn/adexchangebuyer_v1_4.accounts.html
+++ b/docs/dyn/adexchangebuyer_v1_4.accounts.html
@@ -110,10 +110,11 @@ <h3>Method Details</h3>
               # - US_EAST
               # - US_WEST
           "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
-          "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.3 right now. Allowed values:
+          "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.4 right now. Allowed values:
               # - PROTOCOL_ADX
               # - PROTOCOL_OPENRTB_2_2
               # - PROTOCOL_OPENRTB_2_3
+              # - PROTOCOL_OPENRTB_2_4
               # - PROTOCOL_OPENRTB_PROTOBUF
         },
       ],
@@ -148,10 +149,11 @@ <h3>Method Details</h3>
                   # - US_EAST
                   # - US_WEST
               "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
-              "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.3 right now. Allowed values:
+              "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.4 right now. Allowed values:
                   # - PROTOCOL_ADX
                   # - PROTOCOL_OPENRTB_2_2
                   # - PROTOCOL_OPENRTB_2_3
+                  # - PROTOCOL_OPENRTB_2_4
                   # - PROTOCOL_OPENRTB_PROTOBUF
             },
           ],
@@ -187,10 +189,11 @@ <h3>Method Details</h3>
             # - US_EAST
             # - US_WEST
         "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
-        "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.3 right now. Allowed values:
+        "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.4 right now. Allowed values:
             # - PROTOCOL_ADX
             # - PROTOCOL_OPENRTB_2_2
             # - PROTOCOL_OPENRTB_2_3
+            # - PROTOCOL_OPENRTB_2_4
             # - PROTOCOL_OPENRTB_PROTOBUF
       },
     ],
@@ -218,10 +221,11 @@ <h3>Method Details</h3>
               # - US_EAST
               # - US_WEST
           "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
-          "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.3 right now. Allowed values:
+          "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.4 right now. Allowed values:
               # - PROTOCOL_ADX
               # - PROTOCOL_OPENRTB_2_2
               # - PROTOCOL_OPENRTB_2_3
+              # - PROTOCOL_OPENRTB_2_4
               # - PROTOCOL_OPENRTB_PROTOBUF
         },
       ],
@@ -254,10 +258,11 @@ <h3>Method Details</h3>
             # - US_EAST
             # - US_WEST
         "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
-        "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.3 right now. Allowed values:
+        "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.4 right now. Allowed values:
             # - PROTOCOL_ADX
             # - PROTOCOL_OPENRTB_2_2
             # - PROTOCOL_OPENRTB_2_3
+            # - PROTOCOL_OPENRTB_2_4
             # - PROTOCOL_OPENRTB_PROTOBUF
       },
     ],
@@ -285,10 +290,11 @@ <h3>Method Details</h3>
               # - US_EAST
               # - US_WEST
           "maximumQps": 42, # The maximum queries per second the Ad Exchange will send.
-          "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.3 right now. Allowed values:
+          "bidProtocol": "A String", # The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.4 right now. Allowed values:
               # - PROTOCOL_ADX
               # - PROTOCOL_OPENRTB_2_2
               # - PROTOCOL_OPENRTB_2_3
+              # - PROTOCOL_OPENRTB_2_4
               # - PROTOCOL_OPENRTB_PROTOBUF
         },
       ],
diff --git a/docs/dyn/adexchangebuyer_v1_4.creatives.html b/docs/dyn/adexchangebuyer_v1_4.creatives.html
index babdfbc7420..5b9bb56f88f 100644
--- a/docs/dyn/adexchangebuyer_v1_4.creatives.html
+++ b/docs/dyn/adexchangebuyer_v1_4.creatives.html
@@ -132,7 +132,7 @@ <h3>Method Details</h3>
         "A String",
       ],
       "accountId": 42, # Account id.
-      "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above.
+      "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is different from resource.native_ad.video_url above.
       "clickThroughUrl": [ # The set of destination urls for the snippet.
         "A String",
       ],
@@ -144,7 +144,7 @@ <h3>Method Details</h3>
         "body": "A String", # A long description of the ad.
         "advertiser": "A String",
         "store": "A String", # The URL to the app store to purchase/download the promoted app.
-        "videoURL": "A String",
+        "videoURL": "A String", # The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url.
         "headline": "A String", # A short title for the ad.
         "image": { # A large image.
           "url": "A String",
@@ -168,6 +168,7 @@ <h3>Method Details</h3>
         ],
         "price": "A String", # The price of the promoted app including the currency info.
         "clickTrackingUrl": "A String", # The URL to use for click tracking.
+        "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
       },
       "version": 42, # The version for this creative. Read-only. This field should not be set in requests.
       "apiUploadTimestamp": "A String", # The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
@@ -275,7 +276,7 @@ <h3>Method Details</h3>
       "A String",
     ],
     "accountId": 42, # Account id.
-    "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above.
+    "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is different from resource.native_ad.video_url above.
     "clickThroughUrl": [ # The set of destination urls for the snippet.
       "A String",
     ],
@@ -287,7 +288,7 @@ <h3>Method Details</h3>
       "body": "A String", # A long description of the ad.
       "advertiser": "A String",
       "store": "A String", # The URL to the app store to purchase/download the promoted app.
-      "videoURL": "A String",
+      "videoURL": "A String", # The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url.
       "headline": "A String", # A short title for the ad.
       "image": { # A large image.
         "url": "A String",
@@ -311,6 +312,7 @@ <h3>Method Details</h3>
       ],
       "price": "A String", # The price of the promoted app including the currency info.
       "clickTrackingUrl": "A String", # The URL to use for click tracking.
+      "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
     },
     "version": 42, # The version for this creative. Read-only. This field should not be set in requests.
     "apiUploadTimestamp": "A String", # The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
@@ -413,7 +415,7 @@ <h3>Method Details</h3>
         "A String",
       ],
       "accountId": 42, # Account id.
-      "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above.
+      "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is different from resource.native_ad.video_url above.
       "clickThroughUrl": [ # The set of destination urls for the snippet.
         "A String",
       ],
@@ -425,7 +427,7 @@ <h3>Method Details</h3>
         "body": "A String", # A long description of the ad.
         "advertiser": "A String",
         "store": "A String", # The URL to the app store to purchase/download the promoted app.
-        "videoURL": "A String",
+        "videoURL": "A String", # The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url.
         "headline": "A String", # A short title for the ad.
         "image": { # A large image.
           "url": "A String",
@@ -449,6 +451,7 @@ <h3>Method Details</h3>
         ],
         "price": "A String", # The price of the promoted app including the currency info.
         "clickTrackingUrl": "A String", # The URL to use for click tracking.
+        "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
       },
       "version": 42, # The version for this creative. Read-only. This field should not be set in requests.
       "apiUploadTimestamp": "A String", # The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
@@ -576,7 +579,7 @@ <h3>Method Details</h3>
             "A String",
           ],
           "accountId": 42, # Account id.
-          "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above.
+          "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is different from resource.native_ad.video_url above.
           "clickThroughUrl": [ # The set of destination urls for the snippet.
             "A String",
           ],
@@ -588,7 +591,7 @@ <h3>Method Details</h3>
             "body": "A String", # A long description of the ad.
             "advertiser": "A String",
             "store": "A String", # The URL to the app store to purchase/download the promoted app.
-            "videoURL": "A String",
+            "videoURL": "A String", # The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url.
             "headline": "A String", # A short title for the ad.
             "image": { # A large image.
               "url": "A String",
@@ -612,6 +615,7 @@ <h3>Method Details</h3>
             ],
             "price": "A String", # The price of the promoted app including the currency info.
             "clickTrackingUrl": "A String", # The URL to use for click tracking.
+            "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
           },
           "version": 42, # The version for this creative. Read-only. This field should not be set in requests.
           "apiUploadTimestamp": "A String", # The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
diff --git a/docs/dyn/adexchangebuyer_v1_4.marketplacedeals.html b/docs/dyn/adexchangebuyer_v1_4.marketplacedeals.html
index 5c4a11cbd50..5d7142ba9d3 100644
--- a/docs/dyn/adexchangebuyer_v1_4.marketplacedeals.html
+++ b/docs/dyn/adexchangebuyer_v1_4.marketplacedeals.html
@@ -121,7 +121,7 @@ <h3>Method Details</h3>
         "isRfpTemplate": True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
         "webPropertyCode": "A String",
         "proposalId": "A String",
-        "inventoryDescription": "A String", # Description for the deal terms. (updatable)
+        "inventoryDescription": "A String", # Description for the deal terms. (buyer-readonly)
         "productId": "A String", # The product-id from which this deal was created. (readonly, except on create)
         "deliveryControl": { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
           "frequencyCaps": [
@@ -346,7 +346,7 @@ <h3>Method Details</h3>
         "isRfpTemplate": True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
         "webPropertyCode": "A String",
         "proposalId": "A String",
-        "inventoryDescription": "A String", # Description for the deal terms. (updatable)
+        "inventoryDescription": "A String", # Description for the deal terms. (buyer-readonly)
         "productId": "A String", # The product-id from which this deal was created. (readonly, except on create)
         "deliveryControl": { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
           "frequencyCaps": [
@@ -566,7 +566,7 @@ <h3>Method Details</h3>
         "isRfpTemplate": True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
         "webPropertyCode": "A String",
         "proposalId": "A String",
-        "inventoryDescription": "A String", # Description for the deal terms. (updatable)
+        "inventoryDescription": "A String", # Description for the deal terms. (buyer-readonly)
         "productId": "A String", # The product-id from which this deal was created. (readonly, except on create)
         "deliveryControl": { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
           "frequencyCaps": [
@@ -793,7 +793,7 @@ <h3>Method Details</h3>
         "isRfpTemplate": True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
         "webPropertyCode": "A String",
         "proposalId": "A String",
-        "inventoryDescription": "A String", # Description for the deal terms. (updatable)
+        "inventoryDescription": "A String", # Description for the deal terms. (buyer-readonly)
         "productId": "A String", # The product-id from which this deal was created. (readonly, except on create)
         "deliveryControl": { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
           "frequencyCaps": [
@@ -1017,7 +1017,7 @@ <h3>Method Details</h3>
         "isRfpTemplate": True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
         "webPropertyCode": "A String",
         "proposalId": "A String",
-        "inventoryDescription": "A String", # Description for the deal terms. (updatable)
+        "inventoryDescription": "A String", # Description for the deal terms. (buyer-readonly)
         "productId": "A String", # The product-id from which this deal was created. (readonly, except on create)
         "deliveryControl": { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
           "frequencyCaps": [
@@ -1301,7 +1301,7 @@ <h3>Method Details</h3>
         "isRfpTemplate": True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
         "webPropertyCode": "A String",
         "proposalId": "A String",
-        "inventoryDescription": "A String", # Description for the deal terms. (updatable)
+        "inventoryDescription": "A String", # Description for the deal terms. (buyer-readonly)
         "productId": "A String", # The product-id from which this deal was created. (readonly, except on create)
         "deliveryControl": { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
           "frequencyCaps": [
diff --git a/docs/dyn/adexchangebuyer_v1_4.pretargetingConfig.html b/docs/dyn/adexchangebuyer_v1_4.pretargetingConfig.html
index 337b688b2c0..000600fafff 100644
--- a/docs/dyn/adexchangebuyer_v1_4.pretargetingConfig.html
+++ b/docs/dyn/adexchangebuyer_v1_4.pretargetingConfig.html
@@ -154,6 +154,12 @@ <h3>Method Details</h3>
           "type": "A String", # The type of the placement.
         },
       ],
+      "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
+        {
+          "width": "A String", # Width in pixels.
+          "height": "A String", # Height in pixels.
+        },
+      ],
       "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
       "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
         "A String",
@@ -165,16 +171,14 @@ <h3>Method Details</h3>
         "A String",
       ],
       "isActive": True or False, # Whether this config is active. Required for all requests.
-      "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
-        {
-          "width": "A String", # Width in pixels.
-          "height": "A String", # Height in pixels.
-        },
-      ],
+      "minimumViewabilityDecile": 42, # Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.
       "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
       "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
         "A String",
       ],
+      "userIdentifierDataRequired": [ # Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.
+        "A String",
+      ],
       "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
         "A String",
       ],
@@ -242,6 +246,12 @@ <h3>Method Details</h3>
         "type": "A String", # The type of the placement.
       },
     ],
+    "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
+      {
+        "width": "A String", # Width in pixels.
+        "height": "A String", # Height in pixels.
+      },
+    ],
     "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
     "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
       "A String",
@@ -253,16 +263,14 @@ <h3>Method Details</h3>
       "A String",
     ],
     "isActive": True or False, # Whether this config is active. Required for all requests.
-    "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
-      {
-        "width": "A String", # Width in pixels.
-        "height": "A String", # Height in pixels.
-      },
-    ],
+    "minimumViewabilityDecile": 42, # Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.
     "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
     "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
       "A String",
     ],
+    "userIdentifierDataRequired": [ # Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.
+      "A String",
+    ],
     "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
       "A String",
     ],
@@ -324,6 +332,12 @@ <h3>Method Details</h3>
           "type": "A String", # The type of the placement.
         },
       ],
+      "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
+        {
+          "width": "A String", # Width in pixels.
+          "height": "A String", # Height in pixels.
+        },
+      ],
       "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
       "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
         "A String",
@@ -335,16 +349,14 @@ <h3>Method Details</h3>
         "A String",
       ],
       "isActive": True or False, # Whether this config is active. Required for all requests.
-      "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
-        {
-          "width": "A String", # Width in pixels.
-          "height": "A String", # Height in pixels.
-        },
-      ],
+      "minimumViewabilityDecile": 42, # Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.
       "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
       "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
         "A String",
       ],
+      "userIdentifierDataRequired": [ # Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.
+        "A String",
+      ],
       "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
         "A String",
       ],
@@ -415,6 +427,12 @@ <h3>Method Details</h3>
               "type": "A String", # The type of the placement.
             },
           ],
+          "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
+            {
+              "width": "A String", # Width in pixels.
+              "height": "A String", # Height in pixels.
+            },
+          ],
           "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
           "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
             "A String",
@@ -426,16 +444,14 @@ <h3>Method Details</h3>
             "A String",
           ],
           "isActive": True or False, # Whether this config is active. Required for all requests.
-          "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
-            {
-              "width": "A String", # Width in pixels.
-              "height": "A String", # Height in pixels.
-            },
-          ],
+          "minimumViewabilityDecile": 42, # Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.
           "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
           "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
             "A String",
           ],
+          "userIdentifierDataRequired": [ # Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.
+            "A String",
+          ],
           "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
             "A String",
           ],
@@ -507,6 +523,12 @@ <h3>Method Details</h3>
         "type": "A String", # The type of the placement.
       },
     ],
+    "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
+      {
+        "width": "A String", # Width in pixels.
+        "height": "A String", # Height in pixels.
+      },
+    ],
     "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
     "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
       "A String",
@@ -518,16 +540,14 @@ <h3>Method Details</h3>
       "A String",
     ],
     "isActive": True or False, # Whether this config is active. Required for all requests.
-    "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
-      {
-        "width": "A String", # Width in pixels.
-        "height": "A String", # Height in pixels.
-      },
-    ],
+    "minimumViewabilityDecile": 42, # Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.
     "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
     "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
       "A String",
     ],
+    "userIdentifierDataRequired": [ # Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.
+      "A String",
+    ],
     "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
       "A String",
     ],
@@ -589,6 +609,12 @@ <h3>Method Details</h3>
           "type": "A String", # The type of the placement.
         },
       ],
+      "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
+        {
+          "width": "A String", # Width in pixels.
+          "height": "A String", # Height in pixels.
+        },
+      ],
       "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
       "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
         "A String",
@@ -600,16 +626,14 @@ <h3>Method Details</h3>
         "A String",
       ],
       "isActive": True or False, # Whether this config is active. Required for all requests.
-      "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
-        {
-          "width": "A String", # Width in pixels.
-          "height": "A String", # Height in pixels.
-        },
-      ],
+      "minimumViewabilityDecile": 42, # Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.
       "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
       "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
         "A String",
       ],
+      "userIdentifierDataRequired": [ # Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.
+        "A String",
+      ],
       "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
         "A String",
       ],
@@ -678,6 +702,12 @@ <h3>Method Details</h3>
         "type": "A String", # The type of the placement.
       },
     ],
+    "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
+      {
+        "width": "A String", # Width in pixels.
+        "height": "A String", # Height in pixels.
+      },
+    ],
     "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
     "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
       "A String",
@@ -689,16 +719,14 @@ <h3>Method Details</h3>
       "A String",
     ],
     "isActive": True or False, # Whether this config is active. Required for all requests.
-    "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
-      {
-        "width": "A String", # Width in pixels.
-        "height": "A String", # Height in pixels.
-      },
-    ],
+    "minimumViewabilityDecile": 42, # Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.
     "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
     "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
       "A String",
     ],
+    "userIdentifierDataRequired": [ # Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.
+      "A String",
+    ],
     "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
       "A String",
     ],
@@ -760,6 +788,12 @@ <h3>Method Details</h3>
           "type": "A String", # The type of the placement.
         },
       ],
+      "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
+        {
+          "width": "A String", # Width in pixels.
+          "height": "A String", # Height in pixels.
+        },
+      ],
       "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
       "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
         "A String",
@@ -771,16 +805,14 @@ <h3>Method Details</h3>
         "A String",
       ],
       "isActive": True or False, # Whether this config is active. Required for all requests.
-      "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
-        {
-          "width": "A String", # Width in pixels.
-          "height": "A String", # Height in pixels.
-        },
-      ],
+      "minimumViewabilityDecile": 42, # Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.
       "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
       "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
         "A String",
       ],
+      "userIdentifierDataRequired": [ # Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.
+        "A String",
+      ],
       "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
         "A String",
       ],
diff --git a/docs/dyn/adexchangebuyer_v1_4.products.html b/docs/dyn/adexchangebuyer_v1_4.products.html
index 177e22899e1..22293957d50 100644
--- a/docs/dyn/adexchangebuyer_v1_4.products.html
+++ b/docs/dyn/adexchangebuyer_v1_4.products.html
@@ -318,6 +318,7 @@ <h3>Method Details</h3>
     "lastUpdateTimeMs": "A String", # Time of last update in ms. since epoch (readonly)
     "legacyOfferId": "A String", # Optional legacy offer id if this offer is a preferred deal offer.
     "kind": "adexchangebuyer#product", # Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#product".
+    "marketplacePublisherProfileId": "A String", # Marketplace publisher profile Id. This Id differs from the regular publisher_profile_id in that 1. This is a new id, the old Id will be deprecated in 2017. 2. This id uniquely identifies a publisher profile by itself.
     "name": "A String", # The name for this product as set by the seller. (buyer-readonly)
     "syndicationProduct": "A String", # The syndication product associated with the deal. (readonly, except on create)
     "flightStartTimeMs": "A String", # Inventory availability dates. (times are in ms since epoch) The granularity is generally in the order of seconds. (buyer-readonly)
@@ -564,6 +565,7 @@ <h3>Method Details</h3>
         "lastUpdateTimeMs": "A String", # Time of last update in ms. since epoch (readonly)
         "legacyOfferId": "A String", # Optional legacy offer id if this offer is a preferred deal offer.
         "kind": "adexchangebuyer#product", # Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#product".
+        "marketplacePublisherProfileId": "A String", # Marketplace publisher profile Id. This Id differs from the regular publisher_profile_id in that 1. This is a new id, the old Id will be deprecated in 2017. 2. This id uniquely identifies a publisher profile by itself.
         "name": "A String", # The name for this product as set by the seller. (buyer-readonly)
         "syndicationProduct": "A String", # The syndication product associated with the deal. (readonly, except on create)
         "flightStartTimeMs": "A String", # Inventory availability dates. (times are in ms since epoch) The granularity is generally in the order of seconds. (buyer-readonly)
diff --git a/docs/dyn/adexchangebuyer_v1_4.proposals.html b/docs/dyn/adexchangebuyer_v1_4.proposals.html
index 5dc6e4ebc98..c061cfd1834 100644
--- a/docs/dyn/adexchangebuyer_v1_4.proposals.html
+++ b/docs/dyn/adexchangebuyer_v1_4.proposals.html
@@ -335,7 +335,7 @@ <h3>Method Details</h3>
       propose - 
       proposeAndAccept - 
       unknownAction - 
-      updateFinalized - 
+      updateNonTerms - 
   body: object, The request body. (required)
     The object takes the form of:
 
@@ -577,7 +577,7 @@ <h3>Method Details</h3>
       propose - 
       proposeAndAccept - 
       unknownAction - 
-      updateFinalized - 
+      updateNonTerms - 
   body: object, The request body. (required)
     The object takes the form of:
 
diff --git a/docs/dyn/adsense_v1_3.accounts.adunits.html b/docs/dyn/adsense_v1_3.accounts.adunits.html
index 2451880fc33..eeaeb711a19 100644
--- a/docs/dyn/adsense_v1_3.accounts.adunits.html
+++ b/docs/dyn/adsense_v1_3.accounts.adunits.html
@@ -138,7 +138,7 @@ <h3>Method Details</h3>
       "size": "A String", # Size of this ad unit.
     },
     "customStyle": { # Custom style information specific to this ad unit.
-      "corners": "A String", # The style of the corners in the ad.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -224,7 +224,7 @@ <h3>Method Details</h3>
           "size": "A String", # Size of this ad unit.
         },
         "customStyle": { # Custom style information specific to this ad unit.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_3.accounts.customchannels.adunits.html b/docs/dyn/adsense_v1_3.accounts.customchannels.adunits.html
index b0bf524d6ee..e16c863c069 100644
--- a/docs/dyn/adsense_v1_3.accounts.customchannels.adunits.html
+++ b/docs/dyn/adsense_v1_3.accounts.customchannels.adunits.html
@@ -133,7 +133,7 @@ <h3>Method Details</h3>
           "size": "A String", # Size of this ad unit.
         },
         "customStyle": { # Custom style information specific to this ad unit.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_3.accounts.savedadstyles.html b/docs/dyn/adsense_v1_3.accounts.savedadstyles.html
index 12ccac8cb7c..b33d862dc06 100644
--- a/docs/dyn/adsense_v1_3.accounts.savedadstyles.html
+++ b/docs/dyn/adsense_v1_3.accounts.savedadstyles.html
@@ -98,7 +98,7 @@ <h3>Method Details</h3>
     {
     "kind": "adsense#savedAdStyle", # Kind of resource this is, in this case adsense#savedAdStyle.
     "adStyle": { # The AdStyle itself.
-      "corners": "A String", # The style of the corners in the ad.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -135,7 +135,7 @@ <h3>Method Details</h3>
       {
         "kind": "adsense#savedAdStyle", # Kind of resource this is, in this case adsense#savedAdStyle.
         "adStyle": { # The AdStyle itself.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_3.adunits.html b/docs/dyn/adsense_v1_3.adunits.html
index 010c9aba39e..13df0d1e98f 100644
--- a/docs/dyn/adsense_v1_3.adunits.html
+++ b/docs/dyn/adsense_v1_3.adunits.html
@@ -137,7 +137,7 @@ <h3>Method Details</h3>
       "size": "A String", # Size of this ad unit.
     },
     "customStyle": { # Custom style information specific to this ad unit.
-      "corners": "A String", # The style of the corners in the ad.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -221,7 +221,7 @@ <h3>Method Details</h3>
           "size": "A String", # Size of this ad unit.
         },
         "customStyle": { # Custom style information specific to this ad unit.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_3.customchannels.adunits.html b/docs/dyn/adsense_v1_3.customchannels.adunits.html
index 973aeb28269..73bd3371a3a 100644
--- a/docs/dyn/adsense_v1_3.customchannels.adunits.html
+++ b/docs/dyn/adsense_v1_3.customchannels.adunits.html
@@ -132,7 +132,7 @@ <h3>Method Details</h3>
           "size": "A String", # Size of this ad unit.
         },
         "customStyle": { # Custom style information specific to this ad unit.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_3.savedadstyles.html b/docs/dyn/adsense_v1_3.savedadstyles.html
index 4a663e18775..064f2fb431d 100644
--- a/docs/dyn/adsense_v1_3.savedadstyles.html
+++ b/docs/dyn/adsense_v1_3.savedadstyles.html
@@ -97,7 +97,7 @@ <h3>Method Details</h3>
     {
     "kind": "adsense#savedAdStyle", # Kind of resource this is, in this case adsense#savedAdStyle.
     "adStyle": { # The AdStyle itself.
-      "corners": "A String", # The style of the corners in the ad.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -133,7 +133,7 @@ <h3>Method Details</h3>
       {
         "kind": "adsense#savedAdStyle", # Kind of resource this is, in this case adsense#savedAdStyle.
         "adStyle": { # The AdStyle itself.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_4.accounts.adunits.html b/docs/dyn/adsense_v1_4.accounts.adunits.html
index b720c12376f..8ed6b573f46 100644
--- a/docs/dyn/adsense_v1_4.accounts.adunits.html
+++ b/docs/dyn/adsense_v1_4.accounts.adunits.html
@@ -138,7 +138,7 @@ <h3>Method Details</h3>
       "size": "A String", # Size of this ad unit.
     },
     "customStyle": { # Custom style information specific to this ad unit.
-      "corners": "A String", # The style of the corners in the ad.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -224,7 +224,7 @@ <h3>Method Details</h3>
           "size": "A String", # Size of this ad unit.
         },
         "customStyle": { # Custom style information specific to this ad unit.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_4.accounts.customchannels.adunits.html b/docs/dyn/adsense_v1_4.accounts.customchannels.adunits.html
index e982c350953..ae414ce842b 100644
--- a/docs/dyn/adsense_v1_4.accounts.customchannels.adunits.html
+++ b/docs/dyn/adsense_v1_4.accounts.customchannels.adunits.html
@@ -133,7 +133,7 @@ <h3>Method Details</h3>
           "size": "A String", # Size of this ad unit.
         },
         "customStyle": { # Custom style information specific to this ad unit.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_4.accounts.savedadstyles.html b/docs/dyn/adsense_v1_4.accounts.savedadstyles.html
index 5c7e7fb7287..dfdb717cb22 100644
--- a/docs/dyn/adsense_v1_4.accounts.savedadstyles.html
+++ b/docs/dyn/adsense_v1_4.accounts.savedadstyles.html
@@ -98,7 +98,7 @@ <h3>Method Details</h3>
     {
     "kind": "adsense#savedAdStyle", # Kind of resource this is, in this case adsense#savedAdStyle.
     "adStyle": { # The AdStyle itself.
-      "corners": "A String", # The style of the corners in the ad.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -135,7 +135,7 @@ <h3>Method Details</h3>
       {
         "kind": "adsense#savedAdStyle", # Kind of resource this is, in this case adsense#savedAdStyle.
         "adStyle": { # The AdStyle itself.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_4.adunits.html b/docs/dyn/adsense_v1_4.adunits.html
index 8f92a18331f..1e85befc333 100644
--- a/docs/dyn/adsense_v1_4.adunits.html
+++ b/docs/dyn/adsense_v1_4.adunits.html
@@ -137,7 +137,7 @@ <h3>Method Details</h3>
       "size": "A String", # Size of this ad unit.
     },
     "customStyle": { # Custom style information specific to this ad unit.
-      "corners": "A String", # The style of the corners in the ad.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -221,7 +221,7 @@ <h3>Method Details</h3>
           "size": "A String", # Size of this ad unit.
         },
         "customStyle": { # Custom style information specific to this ad unit.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_4.customchannels.adunits.html b/docs/dyn/adsense_v1_4.customchannels.adunits.html
index 8ad228fd04d..19d3d7daa81 100644
--- a/docs/dyn/adsense_v1_4.customchannels.adunits.html
+++ b/docs/dyn/adsense_v1_4.customchannels.adunits.html
@@ -132,7 +132,7 @@ <h3>Method Details</h3>
           "size": "A String", # Size of this ad unit.
         },
         "customStyle": { # Custom style information specific to this ad unit.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsense_v1_4.savedadstyles.html b/docs/dyn/adsense_v1_4.savedadstyles.html
index ccc5ff69451..194d7fedc2c 100644
--- a/docs/dyn/adsense_v1_4.savedadstyles.html
+++ b/docs/dyn/adsense_v1_4.savedadstyles.html
@@ -97,7 +97,7 @@ <h3>Method Details</h3>
     {
     "kind": "adsense#savedAdStyle", # Kind of resource this is, in this case adsense#savedAdStyle.
     "adStyle": { # The AdStyle itself.
-      "corners": "A String", # The style of the corners in the ad.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -133,7 +133,7 @@ <h3>Method Details</h3>
       {
         "kind": "adsense#savedAdStyle", # Kind of resource this is, in this case adsense#savedAdStyle.
         "adStyle": { # The AdStyle itself.
-          "corners": "A String", # The style of the corners in the ad.
+          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
           "colors": { # The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
             "url": "A String", # The color of the ad url.
             "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/adsensehost_v4_1.accounts.adunits.html b/docs/dyn/adsensehost_v4_1.accounts.adunits.html
index a7b0a7e0b29..bbabaf0ea5e 100644
--- a/docs/dyn/adsensehost_v4_1.accounts.adunits.html
+++ b/docs/dyn/adsensehost_v4_1.accounts.adunits.html
@@ -138,7 +138,7 @@ <h3>Method Details</h3>
         "size": "A String", # Size of this ad unit.
       },
       "customStyle": { # Custom style information specific to this ad unit.
-        "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+        "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
         "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
           "url": "A String", # The color of the ad url.
           "text": "A String", # The color of the ad text.
@@ -194,7 +194,7 @@ <h3>Method Details</h3>
         "size": "A String", # Size of this ad unit.
       },
       "customStyle": { # Custom style information specific to this ad unit.
-        "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+        "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
         "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
           "url": "A String", # The color of the ad url.
           "text": "A String", # The color of the ad text.
@@ -267,7 +267,7 @@ <h3>Method Details</h3>
       "size": "A String", # Size of this ad unit.
     },
     "customStyle": { # Custom style information specific to this ad unit.
-      "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -314,7 +314,7 @@ <h3>Method Details</h3>
         "size": "A String", # Size of this ad unit.
       },
       "customStyle": { # Custom style information specific to this ad unit.
-        "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+        "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
         "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
           "url": "A String", # The color of the ad url.
           "text": "A String", # The color of the ad text.
@@ -375,7 +375,7 @@ <h3>Method Details</h3>
             "size": "A String", # Size of this ad unit.
           },
           "customStyle": { # Custom style information specific to this ad unit.
-            "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+            "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
             "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
               "url": "A String", # The color of the ad url.
               "text": "A String", # The color of the ad text.
@@ -448,7 +448,7 @@ <h3>Method Details</h3>
       "size": "A String", # Size of this ad unit.
     },
     "customStyle": { # Custom style information specific to this ad unit.
-      "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -495,7 +495,7 @@ <h3>Method Details</h3>
         "size": "A String", # Size of this ad unit.
       },
       "customStyle": { # Custom style information specific to this ad unit.
-        "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+        "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
         "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
           "url": "A String", # The color of the ad url.
           "text": "A String", # The color of the ad text.
@@ -549,7 +549,7 @@ <h3>Method Details</h3>
       "size": "A String", # Size of this ad unit.
     },
     "customStyle": { # Custom style information specific to this ad unit.
-      "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
       "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
         "url": "A String", # The color of the ad url.
         "text": "A String", # The color of the ad text.
@@ -596,7 +596,7 @@ <h3>Method Details</h3>
         "size": "A String", # Size of this ad unit.
       },
       "customStyle": { # Custom style information specific to this ad unit.
-        "corners": "A String", # The style of the corners in the ad. Possible values are SQUARE, SLIGHTLY_ROUNDED and VERY_ROUNDED.
+        "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
         "colors": { # The colors included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash.
           "url": "A String", # The color of the ad url.
           "text": "A String", # The color of the ad text.
diff --git a/docs/dyn/analytics_v3.management.uploads.html b/docs/dyn/analytics_v3.management.uploads.html
index 1b63eccb22f..79d1c8f6138 100644
--- a/docs/dyn/analytics_v3.management.uploads.html
+++ b/docs/dyn/analytics_v3.management.uploads.html
@@ -84,7 +84,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list(accountId, webPropertyId, customDataSourceId, max_results=None, start_index=None)</a></code></p>
 <p class="firstline">List uploads to which the user has access.</p>
 <p class="toc_element">
-  <code><a href="#uploadData">uploadData(accountId, webPropertyId, customDataSourceId, media_body=None)</a></code></p>
+  <code><a href="#uploadData">uploadData(accountId, webPropertyId, customDataSourceId, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Upload data for a custom data source.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -169,7 +169,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="uploadData">uploadData(accountId, webPropertyId, customDataSourceId, media_body=None)</code>
+    <code class="details" id="uploadData">uploadData(accountId, webPropertyId, customDataSourceId, media_body=None, media_mime_type=None)</code>
   <pre>Upload data for a custom data source.
 
 Args:
@@ -177,6 +177,7 @@ <h3>Method Details</h3>
   webPropertyId: string, Web property UA-string associated with the upload. (required)
   customDataSourceId: string, Custom data source Id to which the data being uploaded belongs. (required)
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/analyticsreporting_v4.reports.html b/docs/dyn/analyticsreporting_v4.reports.html
index f4316beca02..69f3515e3c6 100644
--- a/docs/dyn/analyticsreporting_v4.reports.html
+++ b/docs/dyn/analyticsreporting_v4.reports.html
@@ -823,6 +823,8 @@ <h3>Method Details</h3>
             },
           ],
           "rowCount": 42, # Total number of matching rows for this query.
+          "dataLastRefreshed": "A String", # 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.
           "samplesReadCounts": [ # If the results are
               # [sampled](https://support.google.com/analytics/answer/2637192),
               # this returns the total number of samples read, one entry per date range.
diff --git a/docs/dyn/androidenterprise_v1.enterprises.html b/docs/dyn/androidenterprise_v1.enterprises.html
index 53b5c611537..a31348c42c7 100644
--- a/docs/dyn/androidenterprise_v1.enterprises.html
+++ b/docs/dyn/androidenterprise_v1.enterprises.html
@@ -118,7 +118,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Set the account that will be used to authenticate to the API as the enterprise.</p>
 <p class="toc_element">
   <code><a href="#setStoreLayout">setStoreLayout(enterpriseId, body)</a></code></p>
-<p class="firstline">Sets the store layout for the enterprise.</p>
+<p class="firstline">Sets the store layout for the enterprise. By default, storeLayoutType is set to "basic" and the basic store layout is enabled. The basic layout only contains apps approved by the administrator, and that have been added to the available product set for a user (using the  setAvailableProductSet call). Apps on the page are sorted in order of their product ID value. If you create a custom store layout (by setting storeLayoutType = "custom"), the basic store layout is disabled.</p>
 <p class="toc_element">
   <code><a href="#unenroll">unenroll(enterpriseId)</a></code></p>
 <p class="firstline">Unenrolls an enterprise from the calling EMM.</p>
@@ -170,7 +170,7 @@ <h3>Method Details</h3>
 { # Specification for a token used to generate iframes. The token specifies what data the admin is allowed to modify and the URI the iframe is allowed to communiate with.
     "kind": "androidenterprise#administratorWebTokenSpec", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#administratorWebTokenSpec".
     "parent": "A String", # The URI of the parent frame hosting the iframe. To prevent XSS, the iframe may not be hosted at other URIs. This URI must be https.
-    "permission": [ # The list of permissions the admin is granted within the iframe. The admin will only be allowed to view an iframe if they have all of the permissions associated with it.
+    "permission": [ # The list of permissions the admin is granted within the iframe. The admin will only be allowed to view an iframe if they have all of the permissions associated with it. The only valid value is "approveApps" that will allow the admin to access the iframe in "approve" mode.
       "A String",
     ],
   }
@@ -303,10 +303,11 @@ <h3>Method Details</h3>
     "kind": "androidenterprise#serviceAccount", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#serviceAccount".
     "name": "A String", # The account name of the service account, in the form of an email address. Assigned by the server.
     "key": { # Credentials that can be used to authenticate as a service account. # Credentials that can be used to authenticate as this ServiceAccount.
-      "type": "A String", # The file format of the generated key data.
+      "publicData": "A String", # Public key data for the credentials file. This is an X.509 cert. If you are using the googleCredentials key type, this is identical to the cert that can be retrieved by using the X.509 cert url inside of the credentials file.
       "kind": "androidenterprise#serviceAccountKey", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#serviceAccountKey".
       "data": "A String", # The body of the private key credentials file, in string format. This is only populated when the ServiceAccountKey is created, and is not stored by Google.
       "id": "A String", # An opaque, unique identifier for this ServiceAccountKey. Assigned by the server.
+      "type": "A String", # The file format of the generated key data.
     },
   }</pre>
 </div>
@@ -328,7 +329,7 @@ <h3>Method Details</h3>
         #
         # If there exists at least one page, this field must be set to the ID of a valid page.
     "kind": "androidenterprise#storeLayout", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#storeLayout".
-    "storeLayoutType": "A String", # Sets a store layout type. If set to "custom", "homepageId" must be specified. If set to "basic", the layout will consist of all approved apps accessible by the user, split in pages of 100 each; in this case, "homepageId" must not be specified. The "basic" setting takes precedence over any existing collections setup for this enterprise (if any). Should the enterprise use collectionViewers for controlling access rights, these will still be respected.
+    "storeLayoutType": "A String", # The store layout type. By default, this value is set to "basic". If set to "custom", "homepageId" must be specified. If set to "basic", the layout will consist of all approved apps accessible by the user, split in pages of 100 each; in this case, "homepageId" must not be specified. The "basic" setting takes precedence over any existing collections setup for this enterprise (if any). Should the enterprise use collectionViewers for controlling access rights, these will still be respected.
   }</pre>
 </div>
 
@@ -508,7 +509,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="setStoreLayout">setStoreLayout(enterpriseId, body)</code>
-  <pre>Sets the store layout for the enterprise.
+  <pre>Sets the store layout for the enterprise. By default, storeLayoutType is set to "basic" and the basic store layout is enabled. The basic layout only contains apps approved by the administrator, and that have been added to the available product set for a user (using the  setAvailableProductSet call). Apps on the page are sorted in order of their product ID value. If you create a custom store layout (by setting storeLayoutType = "custom"), the basic store layout is disabled.
 
 Args:
   enterpriseId: string, The ID of the enterprise. (required)
@@ -522,7 +523,7 @@ <h3>Method Details</h3>
       # 
       # If there exists at least one page, this field must be set to the ID of a valid page.
   "kind": "androidenterprise#storeLayout", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#storeLayout".
-  "storeLayoutType": "A String", # Sets a store layout type. If set to "custom", "homepageId" must be specified. If set to "basic", the layout will consist of all approved apps accessible by the user, split in pages of 100 each; in this case, "homepageId" must not be specified. The "basic" setting takes precedence over any existing collections setup for this enterprise (if any). Should the enterprise use collectionViewers for controlling access rights, these will still be respected.
+  "storeLayoutType": "A String", # The store layout type. By default, this value is set to "basic". If set to "custom", "homepageId" must be specified. If set to "basic", the layout will consist of all approved apps accessible by the user, split in pages of 100 each; in this case, "homepageId" must not be specified. The "basic" setting takes precedence over any existing collections setup for this enterprise (if any). Should the enterprise use collectionViewers for controlling access rights, these will still be respected.
 }
 
 
@@ -536,7 +537,7 @@ <h3>Method Details</h3>
         #
         # If there exists at least one page, this field must be set to the ID of a valid page.
     "kind": "androidenterprise#storeLayout", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#storeLayout".
-    "storeLayoutType": "A String", # Sets a store layout type. If set to "custom", "homepageId" must be specified. If set to "basic", the layout will consist of all approved apps accessible by the user, split in pages of 100 each; in this case, "homepageId" must not be specified. The "basic" setting takes precedence over any existing collections setup for this enterprise (if any). Should the enterprise use collectionViewers for controlling access rights, these will still be respected.
+    "storeLayoutType": "A String", # The store layout type. By default, this value is set to "basic". If set to "custom", "homepageId" must be specified. If set to "basic", the layout will consist of all approved apps accessible by the user, split in pages of 100 each; in this case, "homepageId" must not be specified. The "basic" setting takes precedence over any existing collections setup for this enterprise (if any). Should the enterprise use collectionViewers for controlling access rights, these will still be respected.
   }</pre>
 </div>
 
diff --git a/docs/dyn/androidenterprise_v1.serviceaccountkeys.html b/docs/dyn/androidenterprise_v1.serviceaccountkeys.html
index 438225f963b..d1292cfff80 100644
--- a/docs/dyn/androidenterprise_v1.serviceaccountkeys.html
+++ b/docs/dyn/androidenterprise_v1.serviceaccountkeys.html
@@ -106,10 +106,11 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Credentials that can be used to authenticate as a service account.
-  "type": "A String", # The file format of the generated key data.
+  "publicData": "A String", # Public key data for the credentials file. This is an X.509 cert. If you are using the googleCredentials key type, this is identical to the cert that can be retrieved by using the X.509 cert url inside of the credentials file.
   "kind": "androidenterprise#serviceAccountKey", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#serviceAccountKey".
   "data": "A String", # The body of the private key credentials file, in string format. This is only populated when the ServiceAccountKey is created, and is not stored by Google.
   "id": "A String", # An opaque, unique identifier for this ServiceAccountKey. Assigned by the server.
+  "type": "A String", # The file format of the generated key data.
 }
 
 
@@ -117,10 +118,11 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # Credentials that can be used to authenticate as a service account.
-    "type": "A String", # The file format of the generated key data.
+    "publicData": "A String", # Public key data for the credentials file. This is an X.509 cert. If you are using the googleCredentials key type, this is identical to the cert that can be retrieved by using the X.509 cert url inside of the credentials file.
     "kind": "androidenterprise#serviceAccountKey", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#serviceAccountKey".
     "data": "A String", # The body of the private key credentials file, in string format. This is only populated when the ServiceAccountKey is created, and is not stored by Google.
     "id": "A String", # An opaque, unique identifier for this ServiceAccountKey. Assigned by the server.
+    "type": "A String", # The file format of the generated key data.
   }</pre>
 </div>
 
@@ -137,10 +139,11 @@ <h3>Method Details</h3>
     {
     "serviceAccountKey": [ # The service account credentials.
       { # Credentials that can be used to authenticate as a service account.
-        "type": "A String", # The file format of the generated key data.
+        "publicData": "A String", # Public key data for the credentials file. This is an X.509 cert. If you are using the googleCredentials key type, this is identical to the cert that can be retrieved by using the X.509 cert url inside of the credentials file.
         "kind": "androidenterprise#serviceAccountKey", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#serviceAccountKey".
         "data": "A String", # The body of the private key credentials file, in string format. This is only populated when the ServiceAccountKey is created, and is not stored by Google.
         "id": "A String", # An opaque, unique identifier for this ServiceAccountKey. Assigned by the server.
+        "type": "A String", # The file format of the generated key data.
       },
     ],
   }</pre>
diff --git a/docs/dyn/androidenterprise_v1.users.html b/docs/dyn/androidenterprise_v1.users.html
index 0ea296f6c8b..9349c3aeb38 100644
--- a/docs/dyn/androidenterprise_v1.users.html
+++ b/docs/dyn/androidenterprise_v1.users.html
@@ -194,7 +194,7 @@ <h3>Method Details</h3>
 
     { # A set of products.
       "kind": "androidenterprise#productSet", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#productSet".
-      "productSetBehavior": "A String", # 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.
+      "productSetBehavior": "A String", # 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.
       "productId": [ # The list of product IDs making up the set of products.
         "A String",
       ],
@@ -334,7 +334,7 @@ <h3>Method Details</h3>
 
 { # A set of products.
     "kind": "androidenterprise#productSet", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#productSet".
-    "productSetBehavior": "A String", # 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.
+    "productSetBehavior": "A String", # 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.
     "productId": [ # The list of product IDs making up the set of products.
       "A String",
     ],
@@ -346,7 +346,7 @@ <h3>Method Details</h3>
 
     { # A set of products.
       "kind": "androidenterprise#productSet", # Identifies what kind of resource this is. Value: the fixed string "androidenterprise#productSet".
-      "productSetBehavior": "A String", # 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.
+      "productSetBehavior": "A String", # 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.
       "productId": [ # The list of product IDs making up the set of products.
         "A String",
       ],
diff --git a/docs/dyn/androidpublisher_v2.edits.apks.html b/docs/dyn/androidpublisher_v2.edits.apks.html
index 636762a993b..2fd99f0514c 100644
--- a/docs/dyn/androidpublisher_v2.edits.apks.html
+++ b/docs/dyn/androidpublisher_v2.edits.apks.html
@@ -81,7 +81,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list(packageName, editId)</a></code></p>
 <p class="firstline">A description of how to use this function</p>
 <p class="toc_element">
-  <code><a href="#upload">upload(packageName, editId, media_body=None)</a></code></p>
+  <code><a href="#upload">upload(packageName, editId, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">A description of how to use this function</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -186,13 +186,14 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="upload">upload(packageName, editId, media_body=None)</code>
+    <code class="details" id="upload">upload(packageName, editId, media_body=None, media_mime_type=None)</code>
   <pre>A description of how to use this function
 
 Args:
   packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required)
   editId: string, Unique identifier for this edit. (required)
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/androidpublisher_v2.edits.deobfuscationfiles.html b/docs/dyn/androidpublisher_v2.edits.deobfuscationfiles.html
index 14e2f105f8b..27b38ae1f21 100644
--- a/docs/dyn/androidpublisher_v2.edits.deobfuscationfiles.html
+++ b/docs/dyn/androidpublisher_v2.edits.deobfuscationfiles.html
@@ -75,11 +75,11 @@
 <h1><a href="androidpublisher_v2.html">Google Play Developer API</a> . <a href="androidpublisher_v2.edits.html">edits</a> . <a href="androidpublisher_v2.edits.deobfuscationfiles.html">deobfuscationfiles</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#upload">upload(packageName, editId, apkVersionCode, deobfuscationFileType, media_body=None)</a></code></p>
+  <code><a href="#upload">upload(packageName, editId, apkVersionCode, deobfuscationFileType, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Uploads the deobfuscation file of the specified APK. If a deobfuscation file already exists, it will be replaced.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="upload">upload(packageName, editId, apkVersionCode, deobfuscationFileType, media_body=None)</code>
+    <code class="details" id="upload">upload(packageName, editId, apkVersionCode, deobfuscationFileType, media_body=None, media_mime_type=None)</code>
   <pre>Uploads the deobfuscation file of the specified APK. If a deobfuscation file already exists, it will be replaced.
 
 Args:
@@ -90,6 +90,7 @@ <h3>Method Details</h3>
     Allowed values
       proguard - 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/androidpublisher_v2.edits.expansionfiles.html b/docs/dyn/androidpublisher_v2.edits.expansionfiles.html
index 117b9dfbb5f..05358d00512 100644
--- a/docs/dyn/androidpublisher_v2.edits.expansionfiles.html
+++ b/docs/dyn/androidpublisher_v2.edits.expansionfiles.html
@@ -84,7 +84,7 @@ <h2>Instance Methods</h2>
   <code><a href="#update">update(packageName, editId, apkVersionCode, expansionFileType, body)</a></code></p>
 <p class="firstline">Updates the APK's Expansion File configuration to reference another APK's Expansion Files. To add a new Expansion File use the Upload method.</p>
 <p class="toc_element">
-  <code><a href="#upload">upload(packageName, editId, apkVersionCode, expansionFileType, media_body=None)</a></code></p>
+  <code><a href="#upload">upload(packageName, editId, apkVersionCode, expansionFileType, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Uploads and attaches a new Expansion File to the APK specified.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -170,7 +170,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="upload">upload(packageName, editId, apkVersionCode, expansionFileType, media_body=None)</code>
+    <code class="details" id="upload">upload(packageName, editId, apkVersionCode, expansionFileType, media_body=None, media_mime_type=None)</code>
   <pre>Uploads and attaches a new Expansion File to the APK specified.
 
 Args:
@@ -182,6 +182,7 @@ <h3>Method Details</h3>
       main - 
       patch - 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/androidpublisher_v2.edits.images.html b/docs/dyn/androidpublisher_v2.edits.images.html
index 5d4a27f7460..c4e25572a4d 100644
--- a/docs/dyn/androidpublisher_v2.edits.images.html
+++ b/docs/dyn/androidpublisher_v2.edits.images.html
@@ -84,7 +84,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list(packageName, editId, language, imageType)</a></code></p>
 <p class="firstline">Lists all images for the specified language and image type.</p>
 <p class="toc_element">
-  <code><a href="#upload">upload(packageName, editId, language, imageType, media_body=None)</a></code></p>
+  <code><a href="#upload">upload(packageName, editId, language, imageType, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Uploads a new image and adds it to the list of images for the specified language and image type.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -179,7 +179,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="upload">upload(packageName, editId, language, imageType, media_body=None)</code>
+    <code class="details" id="upload">upload(packageName, editId, language, imageType, media_body=None, media_mime_type=None)</code>
   <pre>Uploads a new image and adds it to the list of images for the specified language and image type.
 
 Args:
@@ -198,6 +198,7 @@ <h3>Method Details</h3>
       tvScreenshots - 
       wearScreenshots - 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/androidpublisher_v2.purchases.html b/docs/dyn/androidpublisher_v2.purchases.html
index 9acea14872b..4865e46542c 100644
--- a/docs/dyn/androidpublisher_v2.purchases.html
+++ b/docs/dyn/androidpublisher_v2.purchases.html
@@ -84,4 +84,9 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the subscriptions Resource.</p>
 
+<p class="toc_element">
+  <code><a href="androidpublisher_v2.purchases.voidedpurchases.html">voidedpurchases()</a></code>
+</p>
+<p class="firstline">Returns the voidedpurchases Resource.</p>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/androidpublisher_v2.purchases.voidedpurchases.html b/docs/dyn/androidpublisher_v2.purchases.voidedpurchases.html
new file mode 100644
index 00000000000..f24b2524bac
--- /dev/null
+++ b/docs/dyn/androidpublisher_v2.purchases.voidedpurchases.html
@@ -0,0 +1,117 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="androidpublisher_v2.html">Google Play Developer API</a> . <a href="androidpublisher_v2.purchases.html">purchases</a> . <a href="androidpublisher_v2.purchases.voidedpurchases.html">voidedpurchases</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#list">list(packageName, startTime=None, token=None, maxResults=None, startIndex=None, endTime=None)</a></code></p>
+<p class="firstline">Lists the purchases that were cancelled, refunded or charged-back.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="list">list(packageName, startTime=None, token=None, maxResults=None, startIndex=None, endTime=None)</code>
+  <pre>Lists the purchases that were cancelled, refunded or charged-back.
+
+Args:
+  packageName: string, The package name of the application for which voided purchases need to be returned (for example, 'com.some.thing'). (required)
+  startTime: string, The start time of list window, in milliseconds since the epoch (Jan 1, 1970). If not specified, default to current time - 30 days, which is also the earlies accepted start time. This parameter will be ignored if pagination token is set.
+  token: string, A parameter
+  maxResults: integer, A parameter
+  startIndex: integer, A parameter
+  endTime: string, The end time of list window, in milliseconds since the epoch (Jan 1, 1970). If not specified, default to current time, which is also the latest accepted end time. This parameter will be ignored if pagination token is set.
+
+Returns:
+  An object of the form:
+
+    {
+    "voidedPurchases": [
+      { # A VoidedPurchase resource indicates the purchase was either cancelled/refunded/charged-back.
+        "kind": "androidpublisher#voidedPurchase", # This kind represents a voided purchase object in the androidpublisher service.
+        "voidedTimeMillis": "A String", # The time when the purchase was cancelled/refunded/chargeback, in milliseconds since the epoch (Jan 1, 1970).
+        "purchaseToken": "A String", # The token that was generated when a purchase was made and uniquely identifies a purchase.
+        "purchaseTimeMillis": "A String", # The time the purchase was made, in milliseconds since the epoch (Jan 1, 1970).
+      },
+    ],
+    "tokenPagination": {
+      "nextPageToken": "A String",
+      "previousPageToken": "A String",
+    },
+    "pageInfo": {
+      "totalResults": 42,
+      "startIndex": 42,
+      "resultPerPage": 42,
+    },
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/androidpublisher_v2.reviews.html b/docs/dyn/androidpublisher_v2.reviews.html
index 0e8d71b2af4..4b64122e8a1 100644
--- a/docs/dyn/androidpublisher_v2.reviews.html
+++ b/docs/dyn/androidpublisher_v2.reviews.html
@@ -75,22 +75,23 @@
 <h1><a href="androidpublisher_v2.html">Google Play Developer API</a> . <a href="androidpublisher_v2.reviews.html">reviews</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#get">get(packageName, reviewId)</a></code></p>
+  <code><a href="#get">get(packageName, reviewId, translationLanguage=None)</a></code></p>
 <p class="firstline">Returns a single review.</p>
 <p class="toc_element">
-  <code><a href="#list">list(packageName, token=None, maxResults=None, startIndex=None)</a></code></p>
+  <code><a href="#list">list(packageName, translationLanguage=None, token=None, maxResults=None, startIndex=None)</a></code></p>
 <p class="firstline">Returns a list of reviews.</p>
 <p class="toc_element">
   <code><a href="#reply">reply(packageName, reviewId, body)</a></code></p>
 <p class="firstline">Reply to a single review, or update an existing reply.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="get">get(packageName, reviewId)</code>
+    <code class="details" id="get">get(packageName, reviewId, translationLanguage=None)</code>
   <pre>Returns a single review.
 
 Args:
   packageName: string, Unique identifier for the Android app for which we want reviews; for example, "com.spiffygame". (required)
   reviewId: string, A parameter (required)
+  translationLanguage: string, A parameter
 
 Returns:
   An object of the form:
@@ -109,16 +110,32 @@ <h3>Method Details</h3>
         },
         "userComment": { # A comment from a user.
           "appVersionCode": 42, # Integer version code of the app as installed at the time the review was written. May be absent.
+          "originalText": "A String", # Untranslated text of the review, in the case where the review has been translated. If the review has not been translated this is left blank.
           "reviewerLanguage": "A String", # Language code for the reviewer. This is taken from the device settings so is not guaranteed to match the language the review is written in. May be absent.
           "lastModified": { # The last time at which this comment was updated.
             "nanos": 42,
             "seconds": "A String",
           },
+          "thumbsUpCount": 42, # Number of users who have given this review a thumbs up
           "starRating": 42, # The star rating associated with the review, from 1 to 5.
           "text": "A String", # The content of the comment, i.e. review body. In some cases users have been able to write a review with separate title and body; in those cases the title and body are concatenated and separated by a tab character.
           "device": "A String", # Codename for the reviewer's device, e.g. klte, flounder. May be absent.
           "androidOsVersion": 42, # Integer Android SDK version of the user's device at the time the review was written, e.g. 23 is Marshmallow. May be absent.
+          "deviceMetadata": { # Some information about the characteristics of the user's device
+            "screenDensityDpi": 42, # Screen density in DPI
+            "screenHeightPx": 42, # Screen height in pixels
+            "cpuModel": "A String", # Device CPU model e.g. "MSM8974"
+            "productName": "A String", # Device model name (e.g. Droid)
+            "nativePlatform": "A String", # Comma separated list of native platforms (e.g. "arm", "arm7")
+            "deviceClass": "A String", # Device class (e.g. tablet)
+            "cpuMake": "A String", # Device CPU make e.g. "Qualcomm"
+            "ramMb": 42, # Device RAM in Megabytes e.g. "2048"
+            "screenWidthPx": 42, # Screen width in pixels
+            "glEsVersion": 42, # OpenGL version
+            "manufacturer": "A String", # Device manufacturer (e.g. Motorola)
+          },
           "appVersionName": "A String", # String version name of the app as installed at the time the review was written. May be absent.
+          "thumbsDownCount": 42, # Number of users who have given this review a thumbs down
         },
       },
     ],
@@ -126,11 +143,12 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(packageName, token=None, maxResults=None, startIndex=None)</code>
+    <code class="details" id="list">list(packageName, translationLanguage=None, token=None, maxResults=None, startIndex=None)</code>
   <pre>Returns a list of reviews.
 
 Args:
   packageName: string, Unique identifier for the Android app for which we want reviews; for example, "com.spiffygame". (required)
+  translationLanguage: string, A parameter
   token: string, A parameter
   maxResults: integer, A parameter
   startIndex: integer, A parameter
@@ -154,16 +172,32 @@ <h3>Method Details</h3>
             },
             "userComment": { # A comment from a user.
               "appVersionCode": 42, # Integer version code of the app as installed at the time the review was written. May be absent.
+              "originalText": "A String", # Untranslated text of the review, in the case where the review has been translated. If the review has not been translated this is left blank.
               "reviewerLanguage": "A String", # Language code for the reviewer. This is taken from the device settings so is not guaranteed to match the language the review is written in. May be absent.
               "lastModified": { # The last time at which this comment was updated.
                 "nanos": 42,
                 "seconds": "A String",
               },
+              "thumbsUpCount": 42, # Number of users who have given this review a thumbs up
               "starRating": 42, # The star rating associated with the review, from 1 to 5.
               "text": "A String", # The content of the comment, i.e. review body. In some cases users have been able to write a review with separate title and body; in those cases the title and body are concatenated and separated by a tab character.
               "device": "A String", # Codename for the reviewer's device, e.g. klte, flounder. May be absent.
               "androidOsVersion": 42, # Integer Android SDK version of the user's device at the time the review was written, e.g. 23 is Marshmallow. May be absent.
+              "deviceMetadata": { # Some information about the characteristics of the user's device
+                "screenDensityDpi": 42, # Screen density in DPI
+                "screenHeightPx": 42, # Screen height in pixels
+                "cpuModel": "A String", # Device CPU model e.g. "MSM8974"
+                "productName": "A String", # Device model name (e.g. Droid)
+                "nativePlatform": "A String", # Comma separated list of native platforms (e.g. "arm", "arm7")
+                "deviceClass": "A String", # Device class (e.g. tablet)
+                "cpuMake": "A String", # Device CPU make e.g. "Qualcomm"
+                "ramMb": 42, # Device RAM in Megabytes e.g. "2048"
+                "screenWidthPx": 42, # Screen width in pixels
+                "glEsVersion": 42, # OpenGL version
+                "manufacturer": "A String", # Device manufacturer (e.g. Motorola)
+              },
               "appVersionName": "A String", # String version name of the app as installed at the time the review was written. May be absent.
+              "thumbsDownCount": 42, # Number of users who have given this review a thumbs down
             },
           },
         ],
diff --git a/docs/dyn/appengine_v1.apps.html b/docs/dyn/appengine_v1.apps.html
index 91638370d4a..54b57365d78 100644
--- a/docs/dyn/appengine_v1.apps.html
+++ b/docs/dyn/appengine_v1.apps.html
@@ -89,71 +89,126 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the services Resource.</p>
 
+<p class="toc_element">
+  <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the Google Cloud Resource Manager create project topic (https://cloud.google.com/resource-manager/docs/creating-project).</p>
 <p class="toc_element">
   <code><a href="#get">get(appsId, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets information about an application.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(appsId, body, updateMask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates application parameters.</p>
+<p class="firstline">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)</p>
 <p class="toc_element">
   <code><a href="#repair">repair(appsId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">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*".</p>
+<p class="firstline">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.</p>
 <h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="create">create(body, x__xgafv=None)</code>
+  <pre>Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the Google Cloud Resource Manager create project topic (https://cloud.google.com/resource-manager/docs/creating-project).
+
+Args:
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # An Application resource contains the top-level configuration of an App Engine application.
+    "defaultHostname": "A String", # Hostname used to reach this application, as resolved by App Engine.@OutputOnly
+    "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+    "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+    "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content.@OutputOnly
+    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent.@OutputOnly
+      { # Rules to match an HTTP request and dispatch that request to a service.
+        "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+        "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+        "service": "A String", # Resource ID of a service in this application that should serve the matched request. The service must already exist. Example: default.
+      },
+    ],
+    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+    "locationId": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
+  }
+
+  x__xgafv: string, V1 error format.
+
+Returns:
+  An object of the form:
+
+    { # This resource represents a long-running operation that is the result of a network API call.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
+    },
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
+      "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+      "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+      "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
+        {
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
+        },
+      ],
+    },
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
+    "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
+    },
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="get">get(appsId, x__xgafv=None)</code>
   <pre>Gets information about an application.
 
 Args:
-  appsId: string, Part of `name`. Name of the Application resource to get. Example: `apps/myapp`. (required)
+  appsId: string, Part of `name`. Name of the Application resource to get. Example: apps/myapp. (required)
   x__xgafv: string, V1 error format.
 
 Returns:
   An object of the form:
 
     { # An Application resource contains the top-level configuration of an App Engine application.
-      "defaultHostname": "A String", # Hostname used to reach this application, as resolved by App Engine. @OutputOnly
-      "name": "A String", # Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly
-      "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly
-      "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content. @OutputOnly
-      "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent. @OutputOnly
+      "defaultHostname": "A String", # Hostname used to reach this application, as resolved by App Engine.@OutputOnly
+      "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+      "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+      "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content.@OutputOnly
+      "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent.@OutputOnly
         { # Rules to match an HTTP request and dispatch that request to a service.
-          "path": "A String", # Pathname within the host. Must start with a "`/`". A single "`*`" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
-          "domain": "A String", # Domain name to match against. The wildcard "`*`" is supported if specified before a period: "`*.`". Defaults to matching all domains: "`*`".
-          "service": "A String", # Resource ID of a service in this application that should serve the matched request. The service must already exist. Example: `default`.
+          "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+          "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+          "service": "A String", # Resource ID of a service in this application that should serve the matched request. The service must already exist. Example: default.
         },
       ],
-      "defaultCookieExpiration": "A String", # Cookie expiration policy for this application. @OutputOnly
-      "locationId": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US
-      "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.
-      "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.
+      "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+      "locationId": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+      "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+      "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="patch">patch(appsId, body, updateMask=None, x__xgafv=None)</code>
-  <pre>Updates application parameters.
+  <pre>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)
 
 Args:
-  appsId: string, Part of `name`. Name of the application to update. Example: `apps/myapp`. (required)
+  appsId: string, Part of `name`. Name of the Application resource to update. Example: apps/myapp. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # An Application resource contains the top-level configuration of an App Engine application.
-    "defaultHostname": "A String", # Hostname used to reach this application, as resolved by App Engine. @OutputOnly
-    "name": "A String", # Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly
-    "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly
-    "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content. @OutputOnly
-    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent. @OutputOnly
+    "defaultHostname": "A String", # Hostname used to reach this application, as resolved by App Engine.@OutputOnly
+    "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+    "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+    "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content.@OutputOnly
+    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent.@OutputOnly
       { # Rules to match an HTTP request and dispatch that request to a service.
-        "path": "A String", # Pathname within the host. Must start with a "`/`". A single "`*`" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
-        "domain": "A String", # Domain name to match against. The wildcard "`*`" is supported if specified before a period: "`*.`". Defaults to matching all domains: "`*`".
-        "service": "A String", # Resource ID of a service in this application that should serve the matched request. The service must already exist. Example: `default`.
+        "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+        "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+        "service": "A String", # Resource ID of a service in this application that should serve the matched request. The service must already exist. Example: default.
       },
     ],
-    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application. @OutputOnly
-    "locationId": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US
-    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.
-    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.
+    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+    "locationId": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   }
 
   updateMask: string, Standard field mask for the set of fields to be updated.
@@ -163,10 +218,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -175,8 +230,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -185,10 +240,10 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="repair">repair(appsId, body, x__xgafv=None)</code>
-  <pre>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*".
+  <pre>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.
 
 Args:
-  appsId: string, Part of `name`. Name of the application to repair. Example: `apps/myapp` (required)
+  appsId: string, Part of `name`. Name of the application to repair. Example: apps/myapp (required)
   body: object, The request body. (required)
     The object takes the form of:
 
@@ -201,10 +256,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -213,8 +268,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1.apps.locations.html b/docs/dyn/appengine_v1.apps.locations.html
index 50a71c6ee9f..41892918338 100644
--- a/docs/dyn/appengine_v1.apps.locations.html
+++ b/docs/dyn/appengine_v1.apps.locations.html
@@ -100,8 +100,8 @@ <h3>Method Details</h3>
     "labels": { # Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"}
       "a_key": "A String",
     },
-    "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
-    "name": "A String", # Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"`
+    "locationId": "A String", # The canonical id for this location. For example: "us-east1".
+    "name": "A String", # Resource name for the location, which may vary between implementations. For example: "projects/example-project/locations/us-east1"
     "metadata": { # Service-specific metadata. For example the available capacity at the given location.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -129,8 +129,8 @@ <h3>Method Details</h3>
         "labels": { # Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"}
           "a_key": "A String",
         },
-        "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
-        "name": "A String", # Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"`
+        "locationId": "A String", # The canonical id for this location. For example: "us-east1".
+        "name": "A String", # Resource name for the location, which may vary between implementations. For example: "projects/example-project/locations/us-east1"
         "metadata": { # Service-specific metadata. For example the available capacity at the given location.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
diff --git a/docs/dyn/appengine_v1.apps.operations.html b/docs/dyn/appengine_v1.apps.operations.html
index ef14ed9aa84..0e5e39c36f1 100644
--- a/docs/dyn/appengine_v1.apps.operations.html
+++ b/docs/dyn/appengine_v1.apps.operations.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.</p>
 <p class="toc_element">
   <code><a href="#list">list(appsId, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.</p>
+<p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding below allows API services to override the binding to use different resource name schemes, such as users/*/operations.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -97,10 +97,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -109,8 +109,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -119,7 +119,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(appsId, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.
+  <pre>Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding below allows API services to override the binding to use different resource name schemes, such as users/*/operations.
 
 Args:
   appsId: string, Part of `name`. The name of the operation collection. (required)
@@ -134,10 +134,10 @@ <h3>Method Details</h3>
     { # The response message for Operations.ListOperations.
     "operations": [ # A list of operations that matches the specified filter in the request.
       { # This resource represents a long-running operation that is the result of a network API call.
-        "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+        "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+        "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
           "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
           "code": 42, # The status code, which should be an enum value of google.rpc.Code.
           "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -146,8 +146,8 @@ <h3>Method Details</h3>
             },
           ],
         },
-        "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-        "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+        "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+        "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
         "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
diff --git a/docs/dyn/appengine_v1.apps.services.html b/docs/dyn/appengine_v1.apps.services.html
index cbc826b6d88..ca148e8e8b9 100644
--- a/docs/dyn/appengine_v1.apps.services.html
+++ b/docs/dyn/appengine_v1.apps.services.html
@@ -100,7 +100,7 @@ <h3>Method Details</h3>
   <pre>Deletes the specified service and all enclosed versions.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
 
@@ -108,10 +108,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -120,8 +120,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -133,7 +133,7 @@ <h3>Method Details</h3>
   <pre>Gets the current configuration of the specified service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
 
@@ -147,8 +147,8 @@ <h3>Method Details</h3>
           "a_key": 3.14,
         },
       },
-      "name": "A String", # Full path to the Service resource in the API. Example: `apps/myapp/services/default`. @OutputOnly
-      "id": "A String", # Relative name of the service within the application. Example: `default`. @OutputOnly
+      "name": "A String", # Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly
+      "id": "A String", # Relative name of the service within the application. Example: default.@OutputOnly
     }</pre>
 </div>
 
@@ -157,7 +157,7 @@ <h3>Method Details</h3>
   <pre>Lists all the services in the application.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: `apps/myapp`. (required)
+  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
@@ -165,7 +165,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Response message for `Services.ListServices`.
+    { # Response message for Services.ListServices.
     "services": [ # The services belonging to the requested application.
       { # A Service resource is a logical component of an application that can share state and communicate in a secure fashion with other services. For example, an application that handles customer requests might include separate services to handle tasks such as backend data analysis or API requests from mobile devices. Each service has a collection of versions that define a specific set of code used to implement the functionality of that service.
           "split": { # Traffic routing configuration for versions within a single service. Traffic splits define how traffic directed to the service is assigned to versions. # Mapping that defines fractional HTTP traffic diversion to different versions within the service.
@@ -174,8 +174,8 @@ <h3>Method Details</h3>
               "a_key": 3.14,
             },
           },
-          "name": "A String", # Full path to the Service resource in the API. Example: `apps/myapp/services/default`. @OutputOnly
-          "id": "A String", # Relative name of the service within the application. Example: `default`. @OutputOnly
+          "name": "A String", # Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly
+          "id": "A String", # Relative name of the service within the application. Example: default.@OutputOnly
         },
     ],
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
@@ -201,7 +201,7 @@ <h3>Method Details</h3>
   <pre>Updates the configuration of the specified service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
@@ -213,11 +213,11 @@ <h3>Method Details</h3>
         "a_key": 3.14,
       },
     },
-    "name": "A String", # Full path to the Service resource in the API. Example: `apps/myapp/services/default`. @OutputOnly
-    "id": "A String", # Relative name of the service within the application. Example: `default`. @OutputOnly
+    "name": "A String", # Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly
+    "id": "A String", # Relative name of the service within the application. Example: default.@OutputOnly
   }
 
-  migrateTraffic: boolean, Set to `true` to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both [warmup requests](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#inboundservicetype) and [automatic scaling](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling). You must specify the [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby) field in the Service resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see [Migrating and Splitting Traffic](https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).
+  migrateTraffic: boolean, Set to true to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both warmup requests (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby) field in the Service resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see Migrating and Splitting Traffic (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).
   updateMask: string, Standard field mask for the set of fields to be updated.
   x__xgafv: string, V1 error format.
 
@@ -225,10 +225,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -237,8 +237,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1.apps.services.versions.html b/docs/dyn/appengine_v1.apps.services.versions.html
index 00db1c35d83..8d15d33edf2 100644
--- a/docs/dyn/appengine_v1.apps.services.versions.html
+++ b/docs/dyn/appengine_v1.apps.services.versions.html
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Deletes an existing Version resource.</p>
 <p class="toc_element">
   <code><a href="#get">get(appsId, servicesId, versionsId, x__xgafv=None, view=None)</a></code></p>
-<p class="firstline">Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.</p>
+<p class="firstline">Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.</p>
 <p class="toc_element">
   <code><a href="#list">list(appsId, servicesId, pageSize=None, x__xgafv=None, pageToken=None, view=None)</a></code></p>
 <p class="firstline">Lists the versions of a service.</p>
@@ -96,19 +96,23 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(appsId, servicesId, versionsId, body, updateMask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.</p>
+<p class="firstline">Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(appsId, servicesId, body, x__xgafv=None)</code>
   <pre>Deploys code and resource files to a new version.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent resource to create this version under. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `parent`. Name of the parent resource to create this version under. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # A Version resource is a specific set of source code and configuration files that are deployed into a service.
+    "endpointsApiService": { # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy.The fields here refer to the name and configuration id of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview). # Cloud Endpoints configuration.If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
+      "configId": "A String", # Endpoints service configuration id as specified by the Service Management API. For example "2016-09-19r1"
+      "name": "A String", # Endpoints service name which is the name of the "service" resource in the Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+    },
     "basicScaling": { # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity. # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
       "idleTimeout": "A String", # Duration of time after the last request that an instance must wait before the instance is shut down.
       "maxInstances": 42, # Maximum number of instances to create for this version.
@@ -117,24 +121,24 @@ <h3>Method Details</h3>
       "a_key": "A String",
     },
     "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
       { # Custom static error page to be served when an error occurs.
         "errorCode": "A String", # Error condition this handler applies to.
-        "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+        "mimeType": "A String", # MIME type of file. Defaults to text/html.
         "staticFile": "A String", # Static file content to be served for this error.
       },
     ],
-    "id": "A String", # Relative name of the version within the service. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-    "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+    "id": "A String", # Relative name of the version within the service. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+    "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
       "url": "A String", # URL to serve the endpoint at.
       "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-      "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+      "login": "A String", # Level of login required to access this resource. Defaults to optional.
       "script": "A String", # Path to the script from the application root directory.
     },
     "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
       "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
       "checkInterval": "A String", # Interval between health checks.
       "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -143,16 +147,16 @@ <h3>Method Details</h3>
       "timeout": "A String", # Time before the health check is considered failed.
       "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
     },
-    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-    "versionUrl": "A String", # Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com" @OutputOnly
-    "libraries": [ # Configuration for third-party Python runtime libraries that are required by the application. Only returned in `GET` requests if `view=FULL` is set.
+    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+    "versionUrl": "A String", # Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com"@OutputOnly
+    "libraries": [ # Configuration for third-party Python runtime libraries that are required by the application.Only returned in GET requests if view=FULL is set.
       { # Third-party Python runtime library that is required by the application.
         "version": "A String", # Version of the library to select, or "latest".
         "name": "A String", # Name of the library. Example: "django".
       },
     ],
-    "env": "A String", # App Engine execution environment for this version. Defaults to `standard`.
-    "diskUsageBytes": "A String", # Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk. @OutputOnly
+    "env": "A String", # App Engine execution environment for this version.Defaults to standard.
+    "diskUsageBytes": "A String", # Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk.@OutputOnly
     "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
       "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
       "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -174,35 +178,42 @@ <h3>Method Details</h3>
         "targetConcurrentRequests": 42, # Target number of concurrent requests.
         "targetRequestCountPerSecond": 42, # Target requests per second.
       },
-      "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+      "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
       "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
       "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
       "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
         "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
         "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
       },
     },
-    "envVariables": { # Environment variables available to the application. Only returned in `GET` requests if `view=FULL` is set.
+    "envVariables": { # Environment variables available to the application.Only returned in GET requests if view=FULL is set.
       "a_key": "A String",
     },
     "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+      "volumes": [ # User specified volumes.
+        { # Volumes mounted within the app container. Only applicable for VM runtimes.
+          "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+          "name": "A String", # Unique name for the volume.
+          "sizeGb": 3.14, # Volume size in gigabytes.
+        },
+      ],
       "diskGb": 3.14, # Disk size (GB) needed.
       "cpu": 3.14, # Number of CPU cores needed.
       "memoryGb": 3.14, # Memory (GB) needed.
     },
     "manualScaling": { # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-      "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+      "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
     },
     "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
       "A String",
     ],
-    "createdBy": "A String", # Email address of the user who created this version. @OutputOnly
-    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+    "createdBy": "A String", # Email address of the user who created this version.@OutputOnly
+    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
       "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
         "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-          "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+          "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
           "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
         },
       },
@@ -211,29 +222,30 @@ <h3>Method Details</h3>
       },
       "zip": { # The zip file information for a zip deployment. # The zip file for this deployment, if this is a zip deployment.
         "filesCount": 42, # An estimate of the number of files in a zip for a zip deployment. If set, must be greater than or equal to the actual number of files. Used for optimizing performance; if not provided, deployment may be slow.
-        "sourceUrl": "A String", # URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+        "sourceUrl": "A String", # URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
       },
     },
-    "createTime": "A String", # Time that this version was created. @OutputOnly
+    "createTime": "A String", # Time that this version was created.@OutputOnly
     "network": { # Extra network settings. Only applicable for VM runtimes. # Extra network settings. Only applicable for VM runtimes.
       "instanceTag": "A String", # Tag to apply to the VM instance during creation.
       "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
         "A String",
       ],
-      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
+      "subnetworkName": "A String", # Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app.
     },
-    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-    "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly
-    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+    "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
+    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
       { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
         "urlRegex": "A String", # URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
         "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
           "scriptPath": "A String", # Path to the script from the application root directory.
         },
         "staticFiles": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static file handlers describe which files in the application directory are static files, and which URLs serve them. # Returns the contents of a file, such as an image, as the response.
-          "mimeType": "A String", # MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are derived from each file's filename extension.
+          "mimeType": "A String", # MIME type used to serve all files served by this handler.Defaults to file-specific MIME types, which are derived from each file's filename extension.
           "applicationReadable": True or False, # Whether files should also be uploaded as code data. By default, files declared in static file handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas.
           "expiration": "A String", # Time a static file served by this handler should be cached by web proxies and browsers.
           "requireMatchingFile": True or False, # Whether this handler should match the request if the file referenced by the handler does not exist.
@@ -247,11 +259,11 @@ <h3>Method Details</h3>
           "scriptPath": "A String", # Path to the script from the application root directory.
         },
         "login": "A String", # Level of login required to access this resource.
-        "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+        "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
       },
     ],
-    "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-    "runtime": "A String", # Desired runtime. Example: `python27`.
+    "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+    "runtime": "A String", # Desired runtime. Example: python27.
   }
 
   x__xgafv: string, V1 error format.
@@ -260,10 +272,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -272,8 +284,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -285,7 +297,7 @@ <h3>Method Details</h3>
   <pre>Deletes an existing Version resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
@@ -294,10 +306,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -306,8 +318,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -316,19 +328,23 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(appsId, servicesId, versionsId, x__xgafv=None, view=None)</code>
-  <pre>Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.
+  <pre>Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
-  view: string, Controls the set of fields returned in the `Get` response.
+  view: string, Controls the set of fields returned in the Get response.
 
 Returns:
   An object of the form:
 
     { # A Version resource is a specific set of source code and configuration files that are deployed into a service.
+      "endpointsApiService": { # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy.The fields here refer to the name and configuration id of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview). # Cloud Endpoints configuration.If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
+        "configId": "A String", # Endpoints service configuration id as specified by the Service Management API. For example "2016-09-19r1"
+        "name": "A String", # Endpoints service name which is the name of the "service" resource in the Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+      },
       "basicScaling": { # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity. # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
         "idleTimeout": "A String", # Duration of time after the last request that an instance must wait before the instance is shut down.
         "maxInstances": 42, # Maximum number of instances to create for this version.
@@ -337,24 +353,24 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
       "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-      "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-      "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+      "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+      "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
         { # Custom static error page to be served when an error occurs.
           "errorCode": "A String", # Error condition this handler applies to.
-          "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+          "mimeType": "A String", # MIME type of file. Defaults to text/html.
           "staticFile": "A String", # Static file content to be served for this error.
         },
       ],
-      "id": "A String", # Relative name of the version within the service. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-      "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+      "id": "A String", # Relative name of the version within the service. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+      "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
         "url": "A String", # URL to serve the endpoint at.
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-        "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+        "login": "A String", # Level of login required to access this resource. Defaults to optional.
         "script": "A String", # Path to the script from the application root directory.
       },
       "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-      "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+      "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
         "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
         "checkInterval": "A String", # Interval between health checks.
         "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -363,16 +379,16 @@ <h3>Method Details</h3>
         "timeout": "A String", # Time before the health check is considered failed.
         "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
       },
-      "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-      "versionUrl": "A String", # Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com" @OutputOnly
-      "libraries": [ # Configuration for third-party Python runtime libraries that are required by the application. Only returned in `GET` requests if `view=FULL` is set.
+      "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+      "versionUrl": "A String", # Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com"@OutputOnly
+      "libraries": [ # Configuration for third-party Python runtime libraries that are required by the application.Only returned in GET requests if view=FULL is set.
         { # Third-party Python runtime library that is required by the application.
           "version": "A String", # Version of the library to select, or "latest".
           "name": "A String", # Name of the library. Example: "django".
         },
       ],
-      "env": "A String", # App Engine execution environment for this version. Defaults to `standard`.
-      "diskUsageBytes": "A String", # Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk. @OutputOnly
+      "env": "A String", # App Engine execution environment for this version.Defaults to standard.
+      "diskUsageBytes": "A String", # Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk.@OutputOnly
       "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
         "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
         "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -394,35 +410,42 @@ <h3>Method Details</h3>
           "targetConcurrentRequests": 42, # Target number of concurrent requests.
           "targetRequestCountPerSecond": 42, # Target requests per second.
         },
-        "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+        "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
         "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-        "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+        "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
         "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
         "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
           "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
           "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
         },
       },
-      "envVariables": { # Environment variables available to the application. Only returned in `GET` requests if `view=FULL` is set.
+      "envVariables": { # Environment variables available to the application.Only returned in GET requests if view=FULL is set.
         "a_key": "A String",
       },
       "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+        "volumes": [ # User specified volumes.
+          { # Volumes mounted within the app container. Only applicable for VM runtimes.
+            "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+            "name": "A String", # Unique name for the volume.
+            "sizeGb": 3.14, # Volume size in gigabytes.
+          },
+        ],
         "diskGb": 3.14, # Disk size (GB) needed.
         "cpu": 3.14, # Number of CPU cores needed.
         "memoryGb": 3.14, # Memory (GB) needed.
       },
       "manualScaling": { # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-        "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+        "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
       },
       "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
         "A String",
       ],
-      "createdBy": "A String", # Email address of the user who created this version. @OutputOnly
-      "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+      "createdBy": "A String", # Email address of the user who created this version.@OutputOnly
+      "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
         "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
           "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-            "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-            "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+            "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+            "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
             "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
           },
         },
@@ -431,29 +454,30 @@ <h3>Method Details</h3>
         },
         "zip": { # The zip file information for a zip deployment. # The zip file for this deployment, if this is a zip deployment.
           "filesCount": 42, # An estimate of the number of files in a zip for a zip deployment. If set, must be greater than or equal to the actual number of files. Used for optimizing performance; if not provided, deployment may be slow.
-          "sourceUrl": "A String", # URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+          "sourceUrl": "A String", # URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
         },
       },
-      "createTime": "A String", # Time that this version was created. @OutputOnly
+      "createTime": "A String", # Time that this version was created.@OutputOnly
       "network": { # Extra network settings. Only applicable for VM runtimes. # Extra network settings. Only applicable for VM runtimes.
         "instanceTag": "A String", # Tag to apply to the VM instance during creation.
         "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
           "A String",
         ],
-        "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+        "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
+        "subnetworkName": "A String", # Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app.
       },
-      "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-      "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly
-      "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+      "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+      "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
+      "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
         { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
           "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-          "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+          "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
           "urlRegex": "A String", # URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
           "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
             "scriptPath": "A String", # Path to the script from the application root directory.
           },
           "staticFiles": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static file handlers describe which files in the application directory are static files, and which URLs serve them. # Returns the contents of a file, such as an image, as the response.
-            "mimeType": "A String", # MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are derived from each file's filename extension.
+            "mimeType": "A String", # MIME type used to serve all files served by this handler.Defaults to file-specific MIME types, which are derived from each file's filename extension.
             "applicationReadable": True or False, # Whether files should also be uploaded as code data. By default, files declared in static file handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas.
             "expiration": "A String", # Time a static file served by this handler should be cached by web proxies and browsers.
             "requireMatchingFile": True or False, # Whether this handler should match the request if the file referenced by the handler does not exist.
@@ -467,11 +491,11 @@ <h3>Method Details</h3>
             "scriptPath": "A String", # Path to the script from the application root directory.
           },
           "login": "A String", # Level of login required to access this resource.
-          "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+          "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
         },
       ],
-      "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-      "runtime": "A String", # Desired runtime. Example: `python27`.
+      "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+      "runtime": "A String", # Desired runtime. Example: python27.
     }</pre>
 </div>
 
@@ -480,20 +504,24 @@ <h3>Method Details</h3>
   <pre>Lists the versions of a service.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Service resource. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `parent`. Name of the parent Service resource. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
   x__xgafv: string, V1 error format.
   pageToken: string, Continuation token for fetching the next page of results.
-  view: string, Controls the set of fields returned in the `List` response.
+  view: string, Controls the set of fields returned in the List response.
 
 Returns:
   An object of the form:
 
-    { # Response message for `Versions.ListVersions`.
+    { # Response message for Versions.ListVersions.
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
     "versions": [ # The versions belonging to the requested service.
       { # A Version resource is a specific set of source code and configuration files that are deployed into a service.
+          "endpointsApiService": { # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy.The fields here refer to the name and configuration id of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview). # Cloud Endpoints configuration.If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
+            "configId": "A String", # Endpoints service configuration id as specified by the Service Management API. For example "2016-09-19r1"
+            "name": "A String", # Endpoints service name which is the name of the "service" resource in the Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+          },
           "basicScaling": { # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity. # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
             "idleTimeout": "A String", # Duration of time after the last request that an instance must wait before the instance is shut down.
             "maxInstances": 42, # Maximum number of instances to create for this version.
@@ -502,24 +530,24 @@ <h3>Method Details</h3>
             "a_key": "A String",
           },
           "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-          "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-          "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+          "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+          "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
             { # Custom static error page to be served when an error occurs.
               "errorCode": "A String", # Error condition this handler applies to.
-              "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+              "mimeType": "A String", # MIME type of file. Defaults to text/html.
               "staticFile": "A String", # Static file content to be served for this error.
             },
           ],
-          "id": "A String", # Relative name of the version within the service. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-          "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+          "id": "A String", # Relative name of the version within the service. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+          "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
             "url": "A String", # URL to serve the endpoint at.
             "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-            "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-            "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+            "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+            "login": "A String", # Level of login required to access this resource. Defaults to optional.
             "script": "A String", # Path to the script from the application root directory.
           },
           "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-          "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+          "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
             "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
             "checkInterval": "A String", # Interval between health checks.
             "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -528,16 +556,16 @@ <h3>Method Details</h3>
             "timeout": "A String", # Time before the health check is considered failed.
             "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
           },
-          "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-          "versionUrl": "A String", # Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com" @OutputOnly
-          "libraries": [ # Configuration for third-party Python runtime libraries that are required by the application. Only returned in `GET` requests if `view=FULL` is set.
+          "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+          "versionUrl": "A String", # Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com"@OutputOnly
+          "libraries": [ # Configuration for third-party Python runtime libraries that are required by the application.Only returned in GET requests if view=FULL is set.
             { # Third-party Python runtime library that is required by the application.
               "version": "A String", # Version of the library to select, or "latest".
               "name": "A String", # Name of the library. Example: "django".
             },
           ],
-          "env": "A String", # App Engine execution environment for this version. Defaults to `standard`.
-          "diskUsageBytes": "A String", # Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk. @OutputOnly
+          "env": "A String", # App Engine execution environment for this version.Defaults to standard.
+          "diskUsageBytes": "A String", # Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk.@OutputOnly
           "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
             "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
             "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -559,35 +587,42 @@ <h3>Method Details</h3>
               "targetConcurrentRequests": 42, # Target number of concurrent requests.
               "targetRequestCountPerSecond": 42, # Target requests per second.
             },
-            "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+            "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
             "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-            "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+            "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
             "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
             "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
               "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
               "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
             },
           },
-          "envVariables": { # Environment variables available to the application. Only returned in `GET` requests if `view=FULL` is set.
+          "envVariables": { # Environment variables available to the application.Only returned in GET requests if view=FULL is set.
             "a_key": "A String",
           },
           "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+            "volumes": [ # User specified volumes.
+              { # Volumes mounted within the app container. Only applicable for VM runtimes.
+                "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+                "name": "A String", # Unique name for the volume.
+                "sizeGb": 3.14, # Volume size in gigabytes.
+              },
+            ],
             "diskGb": 3.14, # Disk size (GB) needed.
             "cpu": 3.14, # Number of CPU cores needed.
             "memoryGb": 3.14, # Memory (GB) needed.
           },
           "manualScaling": { # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-            "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+            "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
           },
           "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
             "A String",
           ],
-          "createdBy": "A String", # Email address of the user who created this version. @OutputOnly
-          "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+          "createdBy": "A String", # Email address of the user who created this version.@OutputOnly
+          "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
             "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
               "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-                "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-                "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+                "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+                "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
                 "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
               },
             },
@@ -596,29 +631,30 @@ <h3>Method Details</h3>
             },
             "zip": { # The zip file information for a zip deployment. # The zip file for this deployment, if this is a zip deployment.
               "filesCount": 42, # An estimate of the number of files in a zip for a zip deployment. If set, must be greater than or equal to the actual number of files. Used for optimizing performance; if not provided, deployment may be slow.
-              "sourceUrl": "A String", # URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+              "sourceUrl": "A String", # URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
             },
           },
-          "createTime": "A String", # Time that this version was created. @OutputOnly
+          "createTime": "A String", # Time that this version was created.@OutputOnly
           "network": { # Extra network settings. Only applicable for VM runtimes. # Extra network settings. Only applicable for VM runtimes.
             "instanceTag": "A String", # Tag to apply to the VM instance during creation.
             "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
               "A String",
             ],
-            "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+            "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
+            "subnetworkName": "A String", # Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app.
           },
-          "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-          "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly
-          "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+          "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+          "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
+          "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
             { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
               "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-              "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+              "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
               "urlRegex": "A String", # URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
               "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
                 "scriptPath": "A String", # Path to the script from the application root directory.
               },
               "staticFiles": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static file handlers describe which files in the application directory are static files, and which URLs serve them. # Returns the contents of a file, such as an image, as the response.
-                "mimeType": "A String", # MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are derived from each file's filename extension.
+                "mimeType": "A String", # MIME type used to serve all files served by this handler.Defaults to file-specific MIME types, which are derived from each file's filename extension.
                 "applicationReadable": True or False, # Whether files should also be uploaded as code data. By default, files declared in static file handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas.
                 "expiration": "A String", # Time a static file served by this handler should be cached by web proxies and browsers.
                 "requireMatchingFile": True or False, # Whether this handler should match the request if the file referenced by the handler does not exist.
@@ -632,11 +668,11 @@ <h3>Method Details</h3>
                 "scriptPath": "A String", # Path to the script from the application root directory.
               },
               "login": "A String", # Level of login required to access this resource.
-              "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+              "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
             },
           ],
-          "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-          "runtime": "A String", # Desired runtime. Example: `python27`.
+          "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+          "runtime": "A String", # Desired runtime. Example: python27.
         },
     ],
   }</pre>
@@ -658,16 +694,20 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="patch">patch(appsId, servicesId, versionsId, body, updateMask=None, x__xgafv=None)</code>
-  <pre>Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.
+  <pre>Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: `apps/myapp/services/default/versions/1`. (required)
+  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # A Version resource is a specific set of source code and configuration files that are deployed into a service.
+    "endpointsApiService": { # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy.The fields here refer to the name and configuration id of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview). # Cloud Endpoints configuration.If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
+      "configId": "A String", # Endpoints service configuration id as specified by the Service Management API. For example "2016-09-19r1"
+      "name": "A String", # Endpoints service name which is the name of the "service" resource in the Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+    },
     "basicScaling": { # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity. # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
       "idleTimeout": "A String", # Duration of time after the last request that an instance must wait before the instance is shut down.
       "maxInstances": 42, # Maximum number of instances to create for this version.
@@ -676,24 +716,24 @@ <h3>Method Details</h3>
       "a_key": "A String",
     },
     "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
       { # Custom static error page to be served when an error occurs.
         "errorCode": "A String", # Error condition this handler applies to.
-        "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+        "mimeType": "A String", # MIME type of file. Defaults to text/html.
         "staticFile": "A String", # Static file content to be served for this error.
       },
     ],
-    "id": "A String", # Relative name of the version within the service. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-    "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+    "id": "A String", # Relative name of the version within the service. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+    "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
       "url": "A String", # URL to serve the endpoint at.
       "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-      "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+      "login": "A String", # Level of login required to access this resource. Defaults to optional.
       "script": "A String", # Path to the script from the application root directory.
     },
     "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
       "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
       "checkInterval": "A String", # Interval between health checks.
       "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -702,16 +742,16 @@ <h3>Method Details</h3>
       "timeout": "A String", # Time before the health check is considered failed.
       "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
     },
-    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-    "versionUrl": "A String", # Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com" @OutputOnly
-    "libraries": [ # Configuration for third-party Python runtime libraries that are required by the application. Only returned in `GET` requests if `view=FULL` is set.
+    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+    "versionUrl": "A String", # Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com"@OutputOnly
+    "libraries": [ # Configuration for third-party Python runtime libraries that are required by the application.Only returned in GET requests if view=FULL is set.
       { # Third-party Python runtime library that is required by the application.
         "version": "A String", # Version of the library to select, or "latest".
         "name": "A String", # Name of the library. Example: "django".
       },
     ],
-    "env": "A String", # App Engine execution environment for this version. Defaults to `standard`.
-    "diskUsageBytes": "A String", # Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk. @OutputOnly
+    "env": "A String", # App Engine execution environment for this version.Defaults to standard.
+    "diskUsageBytes": "A String", # Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk.@OutputOnly
     "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
       "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
       "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -733,35 +773,42 @@ <h3>Method Details</h3>
         "targetConcurrentRequests": 42, # Target number of concurrent requests.
         "targetRequestCountPerSecond": 42, # Target requests per second.
       },
-      "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+      "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
       "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
       "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
       "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
         "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
         "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
       },
     },
-    "envVariables": { # Environment variables available to the application. Only returned in `GET` requests if `view=FULL` is set.
+    "envVariables": { # Environment variables available to the application.Only returned in GET requests if view=FULL is set.
       "a_key": "A String",
     },
     "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+      "volumes": [ # User specified volumes.
+        { # Volumes mounted within the app container. Only applicable for VM runtimes.
+          "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+          "name": "A String", # Unique name for the volume.
+          "sizeGb": 3.14, # Volume size in gigabytes.
+        },
+      ],
       "diskGb": 3.14, # Disk size (GB) needed.
       "cpu": 3.14, # Number of CPU cores needed.
       "memoryGb": 3.14, # Memory (GB) needed.
     },
     "manualScaling": { # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-      "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+      "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
     },
     "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
       "A String",
     ],
-    "createdBy": "A String", # Email address of the user who created this version. @OutputOnly
-    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+    "createdBy": "A String", # Email address of the user who created this version.@OutputOnly
+    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
       "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
         "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-          "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+          "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
           "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
         },
       },
@@ -770,29 +817,30 @@ <h3>Method Details</h3>
       },
       "zip": { # The zip file information for a zip deployment. # The zip file for this deployment, if this is a zip deployment.
         "filesCount": 42, # An estimate of the number of files in a zip for a zip deployment. If set, must be greater than or equal to the actual number of files. Used for optimizing performance; if not provided, deployment may be slow.
-        "sourceUrl": "A String", # URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+        "sourceUrl": "A String", # URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
       },
     },
-    "createTime": "A String", # Time that this version was created. @OutputOnly
+    "createTime": "A String", # Time that this version was created.@OutputOnly
     "network": { # Extra network settings. Only applicable for VM runtimes. # Extra network settings. Only applicable for VM runtimes.
       "instanceTag": "A String", # Tag to apply to the VM instance during creation.
       "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
         "A String",
       ],
-      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
+      "subnetworkName": "A String", # Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app.
     },
-    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-    "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly
-    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+    "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
+    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
       { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
         "urlRegex": "A String", # URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
         "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
           "scriptPath": "A String", # Path to the script from the application root directory.
         },
         "staticFiles": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static file handlers describe which files in the application directory are static files, and which URLs serve them. # Returns the contents of a file, such as an image, as the response.
-          "mimeType": "A String", # MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are derived from each file's filename extension.
+          "mimeType": "A String", # MIME type used to serve all files served by this handler.Defaults to file-specific MIME types, which are derived from each file's filename extension.
           "applicationReadable": True or False, # Whether files should also be uploaded as code data. By default, files declared in static file handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas.
           "expiration": "A String", # Time a static file served by this handler should be cached by web proxies and browsers.
           "requireMatchingFile": True or False, # Whether this handler should match the request if the file referenced by the handler does not exist.
@@ -806,11 +854,11 @@ <h3>Method Details</h3>
           "scriptPath": "A String", # Path to the script from the application root directory.
         },
         "login": "A String", # Level of login required to access this resource.
-        "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+        "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
       },
     ],
-    "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-    "runtime": "A String", # Desired runtime. Example: `python27`.
+    "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+    "runtime": "A String", # Desired runtime. Example: python27.
   }
 
   updateMask: string, Standard field mask for the set of fields to be updated.
@@ -820,10 +868,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -832,8 +880,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1.apps.services.versions.instances.html b/docs/dyn/appengine_v1.apps.services.versions.instances.html
index 8a33df9c730..10345fa9449 100644
--- a/docs/dyn/appengine_v1.apps.services.versions.instances.html
+++ b/docs/dyn/appengine_v1.apps.services.versions.instances.html
@@ -76,7 +76,7 @@ <h1><a href="appengine_v1.html">Google App Engine Admin API</a> . <a href="appen
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#debug">debug(appsId, servicesId, versionsId, instancesId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started. Only applicable for instances in App Engine flexible environment.</p>
+<p class="firstline">Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(appsId, servicesId, versionsId, instancesId, x__xgafv=None)</a></code></p>
 <p class="firstline">Stops a running instance.</p>
@@ -92,17 +92,18 @@ <h2>Instance Methods</h2>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="debug">debug(appsId, servicesId, versionsId, instancesId, body, x__xgafv=None)</code>
-  <pre>Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started. Only applicable for instances in App Engine flexible environment.
+  <pre>Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Request message for `Instances.DebugInstance`.
+{ # Request message for Instances.DebugInstance.
+    "sshKey": "A String", # Public SSH key to add to the instance. Examples: [USERNAME]:ssh-rsa [KEY_VALUE] [USERNAME] [USERNAME]:ssh-rsa [KEY_VALUE] google-ssh {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}For more information, see Adding and Removing SSH Keys (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys).
   }
 
   x__xgafv: string, V1 error format.
@@ -111,10 +112,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -123,8 +124,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -136,7 +137,7 @@ <h3>Method Details</h3>
   <pre>Stops a running instance.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -146,10 +147,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -158,8 +159,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -171,7 +172,7 @@ <h3>Method Details</h3>
   <pre>Gets instance information.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -181,21 +182,22 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Instance resource is the computing unit that App Engine uses to automatically scale an application.
-    "errors": 42, # Number of errors since this instance was started. @OutputOnly
-    "name": "A String", # Full path to the Instance resource in the API. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. @OutputOnly
-    "appEngineRelease": "A String", # App Engine release this instance is running on. @OutputOnly
-    "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "memoryUsage": "A String", # Total memory in use (bytes). @OutputOnly
-    "id": "A String", # Relative name of the instance within the version. Example: `instance-1`. @OutputOnly
-    "averageLatency": 42, # Average latency (ms) over the last minute. @OutputOnly
-    "vmDebugEnabled": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "startTime": "A String", # Time that this instance was started. @OutputOnly
-    "qps": 3.14, # Average queries per second (QPS) over the last minute. @OutputOnly
-    "requests": 42, # Number of requests since this instance was started. @OutputOnly
-    "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "availability": "A String", # Availability of the instance. @OutputOnly
-    "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
+    "errors": 42, # Number of errors since this instance was started.@OutputOnly
+    "name": "A String", # Full path to the Instance resource in the API. Example: apps/myapp/services/default/versions/v1/instances/instance-1.@OutputOnly
+    "appEngineRelease": "A String", # App Engine release this instance is running on.@OutputOnly
+    "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "memoryUsage": "A String", # Total memory in use (bytes).@OutputOnly
+    "id": "A String", # Relative name of the instance within the version. Example: instance-1.@OutputOnly
+    "averageLatency": 42, # Average latency (ms) over the last minute.@OutputOnly
+    "vmDebugEnabled": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "startTime": "A String", # Time that this instance was started.@OutputOnly
+    "vmIp": "A String", # The IP address of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "qps": 3.14, # Average queries per second (QPS) over the last minute.@OutputOnly
+    "requests": 42, # Number of requests since this instance was started.@OutputOnly
+    "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "availability": "A String", # Availability of the instance.@OutputOnly
+    "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
   }</pre>
 </div>
 
@@ -204,7 +206,7 @@ <h3>Method Details</h3>
   <pre>Lists the instances of a version.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Version resource. Example: `apps/myapp/services/default/versions/v1`. (required)
+  appsId: string, Part of `parent`. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   versionsId: string, Part of `parent`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
@@ -214,25 +216,26 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Response message for `Instances.ListInstances`.
+    { # Response message for Instances.ListInstances.
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
     "instances": [ # The instances belonging to the requested version.
       { # An Instance resource is the computing unit that App Engine uses to automatically scale an application.
-        "errors": 42, # Number of errors since this instance was started. @OutputOnly
-        "name": "A String", # Full path to the Instance resource in the API. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. @OutputOnly
-        "appEngineRelease": "A String", # App Engine release this instance is running on. @OutputOnly
-        "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "memoryUsage": "A String", # Total memory in use (bytes). @OutputOnly
-        "id": "A String", # Relative name of the instance within the version. Example: `instance-1`. @OutputOnly
-        "averageLatency": 42, # Average latency (ms) over the last minute. @OutputOnly
-        "vmDebugEnabled": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "startTime": "A String", # Time that this instance was started. @OutputOnly
-        "qps": 3.14, # Average queries per second (QPS) over the last minute. @OutputOnly
-        "requests": 42, # Number of requests since this instance was started. @OutputOnly
-        "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "availability": "A String", # Availability of the instance. @OutputOnly
-        "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
+        "errors": 42, # Number of errors since this instance was started.@OutputOnly
+        "name": "A String", # Full path to the Instance resource in the API. Example: apps/myapp/services/default/versions/v1/instances/instance-1.@OutputOnly
+        "appEngineRelease": "A String", # App Engine release this instance is running on.@OutputOnly
+        "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "memoryUsage": "A String", # Total memory in use (bytes).@OutputOnly
+        "id": "A String", # Relative name of the instance within the version. Example: instance-1.@OutputOnly
+        "averageLatency": 42, # Average latency (ms) over the last minute.@OutputOnly
+        "vmDebugEnabled": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "startTime": "A String", # Time that this instance was started.@OutputOnly
+        "vmIp": "A String", # The IP address of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "qps": 3.14, # Average queries per second (QPS) over the last minute.@OutputOnly
+        "requests": 42, # Number of requests since this instance was started.@OutputOnly
+        "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "availability": "A String", # Availability of the instance.@OutputOnly
+        "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
       },
     ],
   }</pre>
diff --git a/docs/dyn/appengine_v1.html b/docs/dyn/appengine_v1.html
index 14a727122c3..effe6f76734 100644
--- a/docs/dyn/appengine_v1.html
+++ b/docs/dyn/appengine_v1.html
@@ -79,11 +79,6 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the apps Resource.</p>
 
-<p class="toc_element">
-  <code><a href="appengine_v1.experimental.html">experimental()</a></code>
-</p>
-<p class="firstline">Returns the experimental Resource.</p>
-
 <p class="toc_element">
   <code><a href="#new_batch_http_request">new_batch_http_request()</a></code></p>
 <p class="firstline">Create a BatchHttpRequest object based on the discovery document.</p>
diff --git a/docs/dyn/appengine_v1beta4.apps.html b/docs/dyn/appengine_v1beta4.apps.html
index b92a0971f78..8e89eb43f1c 100644
--- a/docs/dyn/appengine_v1beta4.apps.html
+++ b/docs/dyn/appengine_v1beta4.apps.html
@@ -91,38 +91,38 @@ <h2>Instance Methods</h2>
 
 <p class="toc_element">
   <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the [Google Cloud Resource Manager create project topic](https://cloud.google.com/resource-manager/docs/creating-project).</p>
+<p class="firstline">Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the Google Cloud Resource Manager create project topic (https://cloud.google.com/resource-manager/docs/creating-project).</p>
 <p class="toc_element">
   <code><a href="#get">get(appsId, x__xgafv=None, ensureResourcesExist=None)</a></code></p>
 <p class="firstline">Gets information about an application.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(appsId, body, mask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates application parameters.</p>
+<p class="firstline">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)</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(body, x__xgafv=None)</code>
-  <pre>Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the [Google Cloud Resource Manager create project topic](https://cloud.google.com/resource-manager/docs/creating-project).
+  <pre>Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the Google Cloud Resource Manager create project topic (https://cloud.google.com/resource-manager/docs/creating-project).
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # An Application resource contains the top-level configuration of an App Engine application.
-    "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine. @OutputOnly
-    "name": "A String", # Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly
-    "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly
-    "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content. @OutputOnly
-    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a module or version. Rules are order-dependent. @OutputOnly
+    "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine.@OutputOnly
+    "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+    "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+    "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content.@OutputOnly
+    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a module or version. Rules are order-dependent.@OutputOnly
       { # Rules to match an HTTP request and dispatch that request to a module.
-        "path": "A String", # Pathname within the host. Must start with a "`/`". A single "`*`" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
-        "domain": "A String", # Domain name to match against. The wildcard "`*`" is supported if specified before a period: "`*.`". Defaults to matching all domains: "`*`".
-        "module": "A String", # Resource ID of a module in this application that should serve the matched request. The module must already exist. Example: `default`.
+        "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+        "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+        "module": "A String", # Resource ID of a module in this application that should serve the matched request. The module must already exist. Example: default.
       },
     ],
-    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application. @OutputOnly
-    "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US
-    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.
-    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.
+    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+    "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   }
 
   x__xgafv: string, V1 error format.
@@ -131,10 +131,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -143,8 +143,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -156,57 +156,57 @@ <h3>Method Details</h3>
   <pre>Gets information about an application.
 
 Args:
-  appsId: string, Part of `name`. Name of the application to get. Example: `apps/myapp`. (required)
+  appsId: string, Part of `name`. Name of the application to get. Example: apps/myapp. (required)
   x__xgafv: string, V1 error format.
-  ensureResourcesExist: boolean, Certain resources associated with an application are created on-demand. Controls whether these resources should be created when performing the `GET` operation. If specified and any resources could not be created, the request will fail with an error code. Additionally, this parameter can cause the request to take longer to complete.
+  ensureResourcesExist: boolean, Certain resources associated with an application are created on-demand. Controls whether these resources should be created when performing the GET operation. If specified and any resources could not be created, the request will fail with an error code. Additionally, this parameter can cause the request to take longer to complete.
 
 Returns:
   An object of the form:
 
     { # An Application resource contains the top-level configuration of an App Engine application.
-      "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine. @OutputOnly
-      "name": "A String", # Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly
-      "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly
-      "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content. @OutputOnly
-      "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a module or version. Rules are order-dependent. @OutputOnly
+      "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine.@OutputOnly
+      "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+      "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+      "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content.@OutputOnly
+      "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a module or version. Rules are order-dependent.@OutputOnly
         { # Rules to match an HTTP request and dispatch that request to a module.
-          "path": "A String", # Pathname within the host. Must start with a "`/`". A single "`*`" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
-          "domain": "A String", # Domain name to match against. The wildcard "`*`" is supported if specified before a period: "`*.`". Defaults to matching all domains: "`*`".
-          "module": "A String", # Resource ID of a module in this application that should serve the matched request. The module must already exist. Example: `default`.
+          "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+          "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+          "module": "A String", # Resource ID of a module in this application that should serve the matched request. The module must already exist. Example: default.
         },
       ],
-      "defaultCookieExpiration": "A String", # Cookie expiration policy for this application. @OutputOnly
-      "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US
-      "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.
-      "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.
+      "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+      "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+      "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+      "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="patch">patch(appsId, body, mask=None, x__xgafv=None)</code>
-  <pre>Updates application parameters.
+  <pre>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)
 
 Args:
-  appsId: string, Part of `name`. Name of the application to update. For example: "apps/myapp". (required)
+  appsId: string, Part of `name`. Name of the Application resource to update. Example: apps/myapp. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # An Application resource contains the top-level configuration of an App Engine application.
-    "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine. @OutputOnly
-    "name": "A String", # Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly
-    "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly
-    "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content. @OutputOnly
-    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a module or version. Rules are order-dependent. @OutputOnly
+    "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine.@OutputOnly
+    "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+    "codeBucket": "A String", # Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+    "defaultBucket": "A String", # Google Cloud Storage bucket that can be used by this application to store content.@OutputOnly
+    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a module or version. Rules are order-dependent.@OutputOnly
       { # Rules to match an HTTP request and dispatch that request to a module.
-        "path": "A String", # Pathname within the host. Must start with a "`/`". A single "`*`" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
-        "domain": "A String", # Domain name to match against. The wildcard "`*`" is supported if specified before a period: "`*.`". Defaults to matching all domains: "`*`".
-        "module": "A String", # Resource ID of a module in this application that should serve the matched request. The module must already exist. Example: `default`.
+        "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+        "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+        "module": "A String", # Resource ID of a module in this application that should serve the matched request. The module must already exist. Example: default.
       },
     ],
-    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application. @OutputOnly
-    "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US
-    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.
-    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.
+    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+    "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   }
 
   mask: string, Standard field mask for the set of fields to be updated.
@@ -216,10 +216,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -228,8 +228,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1beta4.apps.locations.html b/docs/dyn/appengine_v1beta4.apps.locations.html
index b2df972d8c9..313ecca9e93 100644
--- a/docs/dyn/appengine_v1beta4.apps.locations.html
+++ b/docs/dyn/appengine_v1beta4.apps.locations.html
@@ -100,8 +100,8 @@ <h3>Method Details</h3>
     "labels": { # Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"}
       "a_key": "A String",
     },
-    "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
-    "name": "A String", # Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"`
+    "locationId": "A String", # The canonical id for this location. For example: "us-east1".
+    "name": "A String", # Resource name for the location, which may vary between implementations. For example: "projects/example-project/locations/us-east1"
     "metadata": { # Service-specific metadata. For example the available capacity at the given location.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -129,8 +129,8 @@ <h3>Method Details</h3>
         "labels": { # Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"}
           "a_key": "A String",
         },
-        "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
-        "name": "A String", # Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"`
+        "locationId": "A String", # The canonical id for this location. For example: "us-east1".
+        "name": "A String", # Resource name for the location, which may vary between implementations. For example: "projects/example-project/locations/us-east1"
         "metadata": { # Service-specific metadata. For example the available capacity at the given location.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
diff --git a/docs/dyn/appengine_v1beta4.apps.modules.html b/docs/dyn/appengine_v1beta4.apps.modules.html
index 70dbc030377..27462af248e 100644
--- a/docs/dyn/appengine_v1beta4.apps.modules.html
+++ b/docs/dyn/appengine_v1beta4.apps.modules.html
@@ -100,7 +100,7 @@ <h3>Method Details</h3>
   <pre>Deletes the specified module and all enclosed versions.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
 
@@ -108,10 +108,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -120,8 +120,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -133,7 +133,7 @@ <h3>Method Details</h3>
   <pre>Gets the current configuration of the specified module.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
 
@@ -147,8 +147,8 @@ <h3>Method Details</h3>
           "a_key": 3.14,
         },
       },
-      "name": "A String", # Full path to the Module resource in the API. Example: `apps/myapp/modules/default`. @OutputOnly
-      "id": "A String", # Relative name of the module within the application. Example: `default`. @OutputOnly
+      "name": "A String", # Full path to the Module resource in the API. Example: apps/myapp/modules/default.@OutputOnly
+      "id": "A String", # Relative name of the module within the application. Example: default.@OutputOnly
     }</pre>
 </div>
 
@@ -157,7 +157,7 @@ <h3>Method Details</h3>
   <pre>Lists all the modules in the application.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
@@ -165,7 +165,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Response message for `Modules.ListModules`.
+    { # Response message for Modules.ListModules.
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
     "modules": [ # The modules belonging to the requested application.
       { # A Module resource is a logical component of an application that can share state and communicate in a secure fashion with other modules. For example, an application that handles customer requests might include separate modules to handle tasks such as backend data analysis or API requests from mobile devices. Each module has a collection of versions that define a specific set of code used to implement the functionality of that module.
@@ -175,8 +175,8 @@ <h3>Method Details</h3>
               "a_key": 3.14,
             },
           },
-          "name": "A String", # Full path to the Module resource in the API. Example: `apps/myapp/modules/default`. @OutputOnly
-          "id": "A String", # Relative name of the module within the application. Example: `default`. @OutputOnly
+          "name": "A String", # Full path to the Module resource in the API. Example: apps/myapp/modules/default.@OutputOnly
+          "id": "A String", # Relative name of the module within the application. Example: default.@OutputOnly
         },
     ],
   }</pre>
@@ -201,7 +201,7 @@ <h3>Method Details</h3>
   <pre>Updates the configuration of the specified module.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: `apps/myapp/modules/default`. (required)
+  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/modules/default. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
@@ -213,11 +213,11 @@ <h3>Method Details</h3>
         "a_key": 3.14,
       },
     },
-    "name": "A String", # Full path to the Module resource in the API. Example: `apps/myapp/modules/default`. @OutputOnly
-    "id": "A String", # Relative name of the module within the application. Example: `default`. @OutputOnly
+    "name": "A String", # Full path to the Module resource in the API. Example: apps/myapp/modules/default.@OutputOnly
+    "id": "A String", # Relative name of the module within the application. Example: default.@OutputOnly
   }
 
-  migrateTraffic: boolean, Set to `true` to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both [warmup requests](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#inboundservicetype) and [automatic scaling](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#automaticscaling). You must specify the [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules#shardby) field in the Module resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see [Migrating and Splitting Traffic](https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).
+  migrateTraffic: boolean, Set to true to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both warmup requests (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules#shardby) field in the Module resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see Migrating and Splitting Traffic (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).
   mask: string, Standard field mask for the set of fields to be updated.
   x__xgafv: string, V1 error format.
 
@@ -225,10 +225,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -237,8 +237,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1beta4.apps.modules.versions.html b/docs/dyn/appengine_v1beta4.apps.modules.versions.html
index 223561dfa95..96752288acb 100644
--- a/docs/dyn/appengine_v1beta4.apps.modules.versions.html
+++ b/docs/dyn/appengine_v1beta4.apps.modules.versions.html
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Deletes an existing version.</p>
 <p class="toc_element">
   <code><a href="#get">get(appsId, modulesId, versionsId, x__xgafv=None, view=None)</a></code></p>
-<p class="firstline">Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.</p>
+<p class="firstline">Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.</p>
 <p class="toc_element">
   <code><a href="#list">list(appsId, modulesId, pageSize=None, pageToken=None, x__xgafv=None, view=None)</a></code></p>
 <p class="firstline">Lists the versions of a module.</p>
@@ -96,14 +96,14 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(appsId, modulesId, versionsId, body, mask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.</p>
+<p class="firstline">Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(appsId, modulesId, body, x__xgafv=None)</code>
   <pre>Deploys code and resource files to a new version.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: `apps/myapp/modules/default`. (required)
+  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/modules/default. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
@@ -117,24 +117,24 @@ <h3>Method Details</h3>
       "a_key": "A String",
     },
     "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
       { # Custom static error page to be served when an error occurs.
         "errorCode": "A String", # Error condition this handler applies to.
-        "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+        "mimeType": "A String", # MIME type of file. Defaults to text/html.
         "staticFile": "A String", # Static file content to be served for this error.
       },
     ],
-    "id": "A String", # Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-    "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+    "id": "A String", # Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+    "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
       "url": "A String", # URL to serve the endpoint at.
       "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-      "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+      "login": "A String", # Level of login required to access this resource. Defaults to optional.
       "script": "A String", # Path to the script from the application root directory.
     },
     "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
       "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
       "checkInterval": "A String", # Interval between health checks.
       "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -143,15 +143,15 @@ <h3>Method Details</h3>
       "timeout": "A String", # Time before the health check is considered failed.
       "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
     },
-    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-    "libraries": [ # Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.
+    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+    "libraries": [ # Configuration for third-party Python runtime libraries required by the application.Only returned in GET requests if view=FULL is set.
       { # Third-party Python runtime library that is required by the application.
         "version": "A String", # Version of the library to select, or "latest".
         "name": "A String", # Name of the library. Example: "django".
       },
     ],
-    "deployer": "A String", # Email address of the user who created this version. @OutputOnly
-    "env": "A String", # App Engine execution environment to use for this version. Defaults to `1`.
+    "deployer": "A String", # Email address of the user who created this version.@OutputOnly
+    "env": "A String", # App Engine execution environment to use for this version.Defaults to 1.
     "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
       "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
       "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -173,34 +173,41 @@ <h3>Method Details</h3>
         "targetConcurrentRequests": 42, # Target number of concurrent requests.
         "targetRequestCountPerSec": 42, # Target requests per second.
       },
-      "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+      "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
       "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
       "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
       "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
         "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
         "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
       },
     },
-    "envVariables": { # Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.
+    "envVariables": { # Environment variables made available to the application.Only returned in GET requests if view=FULL is set.
       "a_key": "A String",
     },
     "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+      "volumes": [ # User specified volumes.
+        { # Volumes mounted within the app container. Only applicable for VM runtimes.
+          "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+          "name": "A String", # Unique name for the volume.
+          "sizeGb": 3.14, # Volume size in gigabytes.
+        },
+      ],
       "diskGb": 3.14, # Disk size (GB) needed.
       "cpu": 3.14, # Number of CPU cores needed.
       "memoryGb": 3.14, # Memory (GB) needed.
     },
     "manualScaling": { # A module with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A module with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-      "instances": 42, # Number of instances to assign to the module at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+      "instances": 42, # Number of instances to assign to the module at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
     },
     "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
       "A String",
     ],
-    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
       "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
         "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-          "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+          "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
           "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
         },
       },
@@ -219,24 +226,24 @@ <h3>Method Details</h3>
       "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
         "A String",
       ],
-      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
     },
-    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-    "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/modules/default/versions/v1`. @OutputOnly
-    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+    "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/modules/default/versions/v1.@OutputOnly
+    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
       { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
-        "staticDirectory": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static directory handlers make it easy to serve the entire contents of a directory as static files. # Serves the entire contents of a directory as static files. This attribute is deprecated. You can mimic the behavior of static directories using static files.
+        "staticDirectory": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static directory handlers make it easy to serve the entire contents of a directory as static files. # Serves the entire contents of a directory as static files.This attribute is deprecated. You can mimic the behavior of static directories using static files.
           "mimeType": "A String", # MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are direved from each file's filename extension.
           "httpHeaders": { # HTTP headers to use for all responses from these URLs.
             "a_key": "A String",
           },
           "expiration": "A String", # Time a static file served by this handler should be cached.
-          "directory": "A String", # Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to `static_dir` to form the full path to the requested file.
+          "directory": "A String", # Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to static_dir to form the full path to the requested file.
           "requireMatchingFile": True or False, # Whether this handler should match the request if the file referenced by the handler does not exist.
           "applicationReadable": True or False, # Whether files should also be uploaded as code data. By default, files declared in static directory handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas.
         },
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
         "urlRegex": "A String", # A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
         "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
           "scriptPath": "A String", # Path to the script from the application root directory.
@@ -256,12 +263,12 @@ <h3>Method Details</h3>
           "scriptPath": "A String", # Path to the script from the application root directory.
         },
         "login": "A String", # Level of login required to access this resource.
-        "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+        "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
       },
     ],
-    "creationTime": "A String", # Time that this version was created. @OutputOnly
-    "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-    "runtime": "A String", # Desired runtime. Example: `python27`.
+    "creationTime": "A String", # Time that this version was created.@OutputOnly
+    "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+    "runtime": "A String", # Desired runtime. Example: python27.
   }
 
   x__xgafv: string, V1 error format.
@@ -270,10 +277,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -282,8 +289,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -295,7 +302,7 @@ <h3>Method Details</h3>
   <pre>Deletes an existing version.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default/versions/v1. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
@@ -304,10 +311,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -316,8 +323,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -326,14 +333,14 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(appsId, modulesId, versionsId, x__xgafv=None, view=None)</code>
-  <pre>Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.
+  <pre>Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default/versions/v1. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
-  view: string, Controls the set of fields returned in the `Get` response.
+  view: string, Controls the set of fields returned in the Get response.
 
 Returns:
   An object of the form:
@@ -347,24 +354,24 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
       "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-      "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-      "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+      "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+      "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
         { # Custom static error page to be served when an error occurs.
           "errorCode": "A String", # Error condition this handler applies to.
-          "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+          "mimeType": "A String", # MIME type of file. Defaults to text/html.
           "staticFile": "A String", # Static file content to be served for this error.
         },
       ],
-      "id": "A String", # Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-      "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+      "id": "A String", # Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+      "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
         "url": "A String", # URL to serve the endpoint at.
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-        "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+        "login": "A String", # Level of login required to access this resource. Defaults to optional.
         "script": "A String", # Path to the script from the application root directory.
       },
       "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-      "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+      "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
         "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
         "checkInterval": "A String", # Interval between health checks.
         "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -373,15 +380,15 @@ <h3>Method Details</h3>
         "timeout": "A String", # Time before the health check is considered failed.
         "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
       },
-      "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-      "libraries": [ # Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.
+      "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+      "libraries": [ # Configuration for third-party Python runtime libraries required by the application.Only returned in GET requests if view=FULL is set.
         { # Third-party Python runtime library that is required by the application.
           "version": "A String", # Version of the library to select, or "latest".
           "name": "A String", # Name of the library. Example: "django".
         },
       ],
-      "deployer": "A String", # Email address of the user who created this version. @OutputOnly
-      "env": "A String", # App Engine execution environment to use for this version. Defaults to `1`.
+      "deployer": "A String", # Email address of the user who created this version.@OutputOnly
+      "env": "A String", # App Engine execution environment to use for this version.Defaults to 1.
       "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
         "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
         "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -403,34 +410,41 @@ <h3>Method Details</h3>
           "targetConcurrentRequests": 42, # Target number of concurrent requests.
           "targetRequestCountPerSec": 42, # Target requests per second.
         },
-        "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+        "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
         "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-        "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+        "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
         "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
         "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
           "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
           "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
         },
       },
-      "envVariables": { # Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.
+      "envVariables": { # Environment variables made available to the application.Only returned in GET requests if view=FULL is set.
         "a_key": "A String",
       },
       "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+        "volumes": [ # User specified volumes.
+          { # Volumes mounted within the app container. Only applicable for VM runtimes.
+            "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+            "name": "A String", # Unique name for the volume.
+            "sizeGb": 3.14, # Volume size in gigabytes.
+          },
+        ],
         "diskGb": 3.14, # Disk size (GB) needed.
         "cpu": 3.14, # Number of CPU cores needed.
         "memoryGb": 3.14, # Memory (GB) needed.
       },
       "manualScaling": { # A module with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A module with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-        "instances": 42, # Number of instances to assign to the module at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+        "instances": 42, # Number of instances to assign to the module at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
       },
       "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
         "A String",
       ],
-      "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+      "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
         "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
           "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-            "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-            "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+            "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+            "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
             "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
           },
         },
@@ -449,24 +463,24 @@ <h3>Method Details</h3>
         "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
           "A String",
         ],
-        "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+        "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
       },
-      "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-      "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/modules/default/versions/v1`. @OutputOnly
-      "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+      "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+      "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/modules/default/versions/v1.@OutputOnly
+      "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
         { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
-          "staticDirectory": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static directory handlers make it easy to serve the entire contents of a directory as static files. # Serves the entire contents of a directory as static files. This attribute is deprecated. You can mimic the behavior of static directories using static files.
+          "staticDirectory": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static directory handlers make it easy to serve the entire contents of a directory as static files. # Serves the entire contents of a directory as static files.This attribute is deprecated. You can mimic the behavior of static directories using static files.
             "mimeType": "A String", # MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are direved from each file's filename extension.
             "httpHeaders": { # HTTP headers to use for all responses from these URLs.
               "a_key": "A String",
             },
             "expiration": "A String", # Time a static file served by this handler should be cached.
-            "directory": "A String", # Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to `static_dir` to form the full path to the requested file.
+            "directory": "A String", # Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to static_dir to form the full path to the requested file.
             "requireMatchingFile": True or False, # Whether this handler should match the request if the file referenced by the handler does not exist.
             "applicationReadable": True or False, # Whether files should also be uploaded as code data. By default, files declared in static directory handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas.
           },
           "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-          "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+          "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
           "urlRegex": "A String", # A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
           "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
             "scriptPath": "A String", # Path to the script from the application root directory.
@@ -486,12 +500,12 @@ <h3>Method Details</h3>
             "scriptPath": "A String", # Path to the script from the application root directory.
           },
           "login": "A String", # Level of login required to access this resource.
-          "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+          "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
         },
       ],
-      "creationTime": "A String", # Time that this version was created. @OutputOnly
-      "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-      "runtime": "A String", # Desired runtime. Example: `python27`.
+      "creationTime": "A String", # Time that this version was created.@OutputOnly
+      "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+      "runtime": "A String", # Desired runtime. Example: python27.
     }</pre>
 </div>
 
@@ -500,17 +514,17 @@ <h3>Method Details</h3>
   <pre>Lists the versions of a module.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
-  view: string, Controls the set of fields returned in the `List` response.
+  view: string, Controls the set of fields returned in the List response.
 
 Returns:
   An object of the form:
 
-    { # Response message for `Versions.ListVersions`.
+    { # Response message for Versions.ListVersions.
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
     "versions": [ # The versions belonging to the requested module.
       { # A Version resource is a specific set of source code and configuration files that are deployed into a module.
@@ -522,24 +536,24 @@ <h3>Method Details</h3>
             "a_key": "A String",
           },
           "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-          "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-          "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+          "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+          "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
             { # Custom static error page to be served when an error occurs.
               "errorCode": "A String", # Error condition this handler applies to.
-              "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+              "mimeType": "A String", # MIME type of file. Defaults to text/html.
               "staticFile": "A String", # Static file content to be served for this error.
             },
           ],
-          "id": "A String", # Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-          "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+          "id": "A String", # Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+          "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
             "url": "A String", # URL to serve the endpoint at.
             "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-            "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-            "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+            "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+            "login": "A String", # Level of login required to access this resource. Defaults to optional.
             "script": "A String", # Path to the script from the application root directory.
           },
           "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-          "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+          "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
             "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
             "checkInterval": "A String", # Interval between health checks.
             "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -548,15 +562,15 @@ <h3>Method Details</h3>
             "timeout": "A String", # Time before the health check is considered failed.
             "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
           },
-          "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-          "libraries": [ # Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.
+          "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+          "libraries": [ # Configuration for third-party Python runtime libraries required by the application.Only returned in GET requests if view=FULL is set.
             { # Third-party Python runtime library that is required by the application.
               "version": "A String", # Version of the library to select, or "latest".
               "name": "A String", # Name of the library. Example: "django".
             },
           ],
-          "deployer": "A String", # Email address of the user who created this version. @OutputOnly
-          "env": "A String", # App Engine execution environment to use for this version. Defaults to `1`.
+          "deployer": "A String", # Email address of the user who created this version.@OutputOnly
+          "env": "A String", # App Engine execution environment to use for this version.Defaults to 1.
           "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
             "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
             "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -578,34 +592,41 @@ <h3>Method Details</h3>
               "targetConcurrentRequests": 42, # Target number of concurrent requests.
               "targetRequestCountPerSec": 42, # Target requests per second.
             },
-            "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+            "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
             "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-            "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+            "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
             "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
             "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
               "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
               "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
             },
           },
-          "envVariables": { # Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.
+          "envVariables": { # Environment variables made available to the application.Only returned in GET requests if view=FULL is set.
             "a_key": "A String",
           },
           "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+            "volumes": [ # User specified volumes.
+              { # Volumes mounted within the app container. Only applicable for VM runtimes.
+                "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+                "name": "A String", # Unique name for the volume.
+                "sizeGb": 3.14, # Volume size in gigabytes.
+              },
+            ],
             "diskGb": 3.14, # Disk size (GB) needed.
             "cpu": 3.14, # Number of CPU cores needed.
             "memoryGb": 3.14, # Memory (GB) needed.
           },
           "manualScaling": { # A module with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A module with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-            "instances": 42, # Number of instances to assign to the module at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+            "instances": 42, # Number of instances to assign to the module at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
           },
           "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
             "A String",
           ],
-          "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+          "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
             "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
               "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-                "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-                "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+                "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+                "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
                 "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
               },
             },
@@ -624,24 +645,24 @@ <h3>Method Details</h3>
             "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
               "A String",
             ],
-            "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+            "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
           },
-          "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-          "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/modules/default/versions/v1`. @OutputOnly
-          "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+          "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+          "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/modules/default/versions/v1.@OutputOnly
+          "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
             { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
-              "staticDirectory": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static directory handlers make it easy to serve the entire contents of a directory as static files. # Serves the entire contents of a directory as static files. This attribute is deprecated. You can mimic the behavior of static directories using static files.
+              "staticDirectory": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static directory handlers make it easy to serve the entire contents of a directory as static files. # Serves the entire contents of a directory as static files.This attribute is deprecated. You can mimic the behavior of static directories using static files.
                 "mimeType": "A String", # MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are direved from each file's filename extension.
                 "httpHeaders": { # HTTP headers to use for all responses from these URLs.
                   "a_key": "A String",
                 },
                 "expiration": "A String", # Time a static file served by this handler should be cached.
-                "directory": "A String", # Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to `static_dir` to form the full path to the requested file.
+                "directory": "A String", # Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to static_dir to form the full path to the requested file.
                 "requireMatchingFile": True or False, # Whether this handler should match the request if the file referenced by the handler does not exist.
                 "applicationReadable": True or False, # Whether files should also be uploaded as code data. By default, files declared in static directory handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas.
               },
               "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-              "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+              "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
               "urlRegex": "A String", # A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
               "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
                 "scriptPath": "A String", # Path to the script from the application root directory.
@@ -661,12 +682,12 @@ <h3>Method Details</h3>
                 "scriptPath": "A String", # Path to the script from the application root directory.
               },
               "login": "A String", # Level of login required to access this resource.
-              "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+              "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
             },
           ],
-          "creationTime": "A String", # Time that this version was created. @OutputOnly
-          "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-          "runtime": "A String", # Desired runtime. Example: `python27`.
+          "creationTime": "A String", # Time that this version was created.@OutputOnly
+          "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+          "runtime": "A String", # Desired runtime. Example: python27.
         },
     ],
   }</pre>
@@ -688,10 +709,10 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="patch">patch(appsId, modulesId, versionsId, body, mask=None, x__xgafv=None)</code>
-  <pre>Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.
+  <pre>Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: `apps/myapp/modules/default/versions/1`. (required)
+  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/modules/default/versions/1. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
@@ -706,24 +727,24 @@ <h3>Method Details</h3>
       "a_key": "A String",
     },
     "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
       { # Custom static error page to be served when an error occurs.
         "errorCode": "A String", # Error condition this handler applies to.
-        "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+        "mimeType": "A String", # MIME type of file. Defaults to text/html.
         "staticFile": "A String", # Static file content to be served for this error.
       },
     ],
-    "id": "A String", # Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-    "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+    "id": "A String", # Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+    "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
       "url": "A String", # URL to serve the endpoint at.
       "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-      "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+      "login": "A String", # Level of login required to access this resource. Defaults to optional.
       "script": "A String", # Path to the script from the application root directory.
     },
     "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
       "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
       "checkInterval": "A String", # Interval between health checks.
       "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -732,15 +753,15 @@ <h3>Method Details</h3>
       "timeout": "A String", # Time before the health check is considered failed.
       "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
     },
-    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-    "libraries": [ # Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.
+    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+    "libraries": [ # Configuration for third-party Python runtime libraries required by the application.Only returned in GET requests if view=FULL is set.
       { # Third-party Python runtime library that is required by the application.
         "version": "A String", # Version of the library to select, or "latest".
         "name": "A String", # Name of the library. Example: "django".
       },
     ],
-    "deployer": "A String", # Email address of the user who created this version. @OutputOnly
-    "env": "A String", # App Engine execution environment to use for this version. Defaults to `1`.
+    "deployer": "A String", # Email address of the user who created this version.@OutputOnly
+    "env": "A String", # App Engine execution environment to use for this version.Defaults to 1.
     "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
       "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
       "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -762,34 +783,41 @@ <h3>Method Details</h3>
         "targetConcurrentRequests": 42, # Target number of concurrent requests.
         "targetRequestCountPerSec": 42, # Target requests per second.
       },
-      "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+      "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
       "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
       "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
       "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
         "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
         "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
       },
     },
-    "envVariables": { # Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.
+    "envVariables": { # Environment variables made available to the application.Only returned in GET requests if view=FULL is set.
       "a_key": "A String",
     },
     "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+      "volumes": [ # User specified volumes.
+        { # Volumes mounted within the app container. Only applicable for VM runtimes.
+          "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+          "name": "A String", # Unique name for the volume.
+          "sizeGb": 3.14, # Volume size in gigabytes.
+        },
+      ],
       "diskGb": 3.14, # Disk size (GB) needed.
       "cpu": 3.14, # Number of CPU cores needed.
       "memoryGb": 3.14, # Memory (GB) needed.
     },
     "manualScaling": { # A module with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A module with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-      "instances": 42, # Number of instances to assign to the module at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+      "instances": 42, # Number of instances to assign to the module at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
     },
     "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
       "A String",
     ],
-    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
       "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
         "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-          "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+          "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
           "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
         },
       },
@@ -808,24 +836,24 @@ <h3>Method Details</h3>
       "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
         "A String",
       ],
-      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
     },
-    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-    "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/modules/default/versions/v1`. @OutputOnly
-    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+    "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/modules/default/versions/v1.@OutputOnly
+    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
       { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
-        "staticDirectory": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static directory handlers make it easy to serve the entire contents of a directory as static files. # Serves the entire contents of a directory as static files. This attribute is deprecated. You can mimic the behavior of static directories using static files.
+        "staticDirectory": { # Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static directory handlers make it easy to serve the entire contents of a directory as static files. # Serves the entire contents of a directory as static files.This attribute is deprecated. You can mimic the behavior of static directories using static files.
           "mimeType": "A String", # MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are direved from each file's filename extension.
           "httpHeaders": { # HTTP headers to use for all responses from these URLs.
             "a_key": "A String",
           },
           "expiration": "A String", # Time a static file served by this handler should be cached.
-          "directory": "A String", # Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to `static_dir` to form the full path to the requested file.
+          "directory": "A String", # Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to static_dir to form the full path to the requested file.
           "requireMatchingFile": True or False, # Whether this handler should match the request if the file referenced by the handler does not exist.
           "applicationReadable": True or False, # Whether files should also be uploaded as code data. By default, files declared in static directory handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas.
         },
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
         "urlRegex": "A String", # A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
         "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
           "scriptPath": "A String", # Path to the script from the application root directory.
@@ -845,12 +873,12 @@ <h3>Method Details</h3>
           "scriptPath": "A String", # Path to the script from the application root directory.
         },
         "login": "A String", # Level of login required to access this resource.
-        "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+        "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
       },
     ],
-    "creationTime": "A String", # Time that this version was created. @OutputOnly
-    "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-    "runtime": "A String", # Desired runtime. Example: `python27`.
+    "creationTime": "A String", # Time that this version was created.@OutputOnly
+    "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+    "runtime": "A String", # Desired runtime. Example: python27.
   }
 
   mask: string, Standard field mask for the set of fields to be updated.
@@ -860,10 +888,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -872,8 +900,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1beta4.apps.modules.versions.instances.html b/docs/dyn/appengine_v1beta4.apps.modules.versions.instances.html
index a21db3f09f9..43ad34a539f 100644
--- a/docs/dyn/appengine_v1beta4.apps.modules.versions.instances.html
+++ b/docs/dyn/appengine_v1beta4.apps.modules.versions.instances.html
@@ -76,7 +76,7 @@ <h1><a href="appengine_v1beta4.html">Google App Engine Admin API</a> . <a href="
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#debug">debug(appsId, modulesId, versionsId, instancesId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started. Only applicable for instances in App Engine flexible environment.</p>
+<p class="firstline">Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(appsId, modulesId, versionsId, instancesId, x__xgafv=None)</a></code></p>
 <p class="firstline">Stops a running instance.</p>
@@ -92,17 +92,18 @@ <h2>Instance Methods</h2>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="debug">debug(appsId, modulesId, versionsId, instancesId, body, x__xgafv=None)</code>
-  <pre>Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started. Only applicable for instances in App Engine flexible environment.
+  <pre>Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default/versions/v1/instances/instance-1. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Request message for `Instances.DebugInstance`.
+{ # Request message for Instances.DebugInstance.
+    "sshKey": "A String", # Public SSH key to add to the instance. Examples: [USERNAME]:ssh-rsa [KEY_VALUE] [USERNAME] [USERNAME]:ssh-rsa [KEY_VALUE] google-ssh {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}For more information, see Adding and Removing SSH Keys (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys).
   }
 
   x__xgafv: string, V1 error format.
@@ -111,10 +112,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -123,8 +124,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -136,7 +137,7 @@ <h3>Method Details</h3>
   <pre>Stops a running instance.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default/versions/v1/instances/instance-1. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -146,10 +147,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -158,8 +159,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -171,7 +172,7 @@ <h3>Method Details</h3>
   <pre>Gets instance information.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default/versions/v1/instances/instance-1. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -181,21 +182,22 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Instance resource is the computing unit that App Engine uses to automatically scale an application.
-    "errors": 42, # Number of errors since this instance was started. @OutputOnly
-    "name": "A String", # Full path to the Instance resource in the API. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`. @OutputOnly
-    "startTimestamp": "A String", # Time that this instance was started. @OutputOnly
-    "appEngineRelease": "A String", # App Engine release this instance is running on. @OutputOnly
-    "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "memoryUsage": "A String", # Total memory in use (bytes). @OutputOnly
-    "id": "A String", # Relative name of the instance within the version. Example: `instance-1`. @OutputOnly
-    "vmUnlocked": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "averageLatency": 42, # Average latency (ms) over the last minute. @OutputOnly
-    "qps": 3.14, # Average queries per second (QPS) over the last minute. @OutputOnly
-    "requests": 42, # Number of requests since this instance was started. @OutputOnly
-    "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "availability": "A String", # Availability of the instance. @OutputOnly
-    "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
+    "errors": 42, # Number of errors since this instance was started.@OutputOnly
+    "name": "A String", # Full path to the Instance resource in the API. Example: apps/myapp/modules/default/versions/v1/instances/instance-1.@OutputOnly
+    "startTimestamp": "A String", # Time that this instance was started.@OutputOnly
+    "appEngineRelease": "A String", # App Engine release this instance is running on.@OutputOnly
+    "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "memoryUsage": "A String", # Total memory in use (bytes).@OutputOnly
+    "id": "A String", # Relative name of the instance within the version. Example: instance-1.@OutputOnly
+    "vmUnlocked": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "averageLatency": 42, # Average latency (ms) over the last minute.@OutputOnly
+    "vmIp": "A String", # The IP address of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "qps": 3.14, # Average queries per second (QPS) over the last minute.@OutputOnly
+    "requests": 42, # Number of requests since this instance was started.@OutputOnly
+    "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "availability": "A String", # Availability of the instance.@OutputOnly
+    "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
   }</pre>
 </div>
 
@@ -204,7 +206,7 @@ <h3>Method Details</h3>
   <pre>Lists the instances of a version.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default/versions/v1. (required)
   modulesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
@@ -214,25 +216,26 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Response message for `Instances.ListInstances`.
+    { # Response message for Instances.ListInstances.
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
     "instances": [ # The instances belonging to the requested version.
       { # An Instance resource is the computing unit that App Engine uses to automatically scale an application.
-        "errors": 42, # Number of errors since this instance was started. @OutputOnly
-        "name": "A String", # Full path to the Instance resource in the API. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`. @OutputOnly
-        "startTimestamp": "A String", # Time that this instance was started. @OutputOnly
-        "appEngineRelease": "A String", # App Engine release this instance is running on. @OutputOnly
-        "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "memoryUsage": "A String", # Total memory in use (bytes). @OutputOnly
-        "id": "A String", # Relative name of the instance within the version. Example: `instance-1`. @OutputOnly
-        "vmUnlocked": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "averageLatency": 42, # Average latency (ms) over the last minute. @OutputOnly
-        "qps": 3.14, # Average queries per second (QPS) over the last minute. @OutputOnly
-        "requests": 42, # Number of requests since this instance was started. @OutputOnly
-        "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "availability": "A String", # Availability of the instance. @OutputOnly
-        "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
+        "errors": 42, # Number of errors since this instance was started.@OutputOnly
+        "name": "A String", # Full path to the Instance resource in the API. Example: apps/myapp/modules/default/versions/v1/instances/instance-1.@OutputOnly
+        "startTimestamp": "A String", # Time that this instance was started.@OutputOnly
+        "appEngineRelease": "A String", # App Engine release this instance is running on.@OutputOnly
+        "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "memoryUsage": "A String", # Total memory in use (bytes).@OutputOnly
+        "id": "A String", # Relative name of the instance within the version. Example: instance-1.@OutputOnly
+        "vmUnlocked": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "averageLatency": 42, # Average latency (ms) over the last minute.@OutputOnly
+        "vmIp": "A String", # The IP address of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "qps": 3.14, # Average queries per second (QPS) over the last minute.@OutputOnly
+        "requests": 42, # Number of requests since this instance was started.@OutputOnly
+        "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "availability": "A String", # Availability of the instance.@OutputOnly
+        "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
       },
     ],
   }</pre>
diff --git a/docs/dyn/appengine_v1beta4.apps.operations.html b/docs/dyn/appengine_v1beta4.apps.operations.html
index a4e0bb5d553..72ba0641381 100644
--- a/docs/dyn/appengine_v1beta4.apps.operations.html
+++ b/docs/dyn/appengine_v1beta4.apps.operations.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.</p>
 <p class="toc_element">
   <code><a href="#list">list(appsId, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.</p>
+<p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding below allows API services to override the binding to use different resource name schemes, such as users/*/operations.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -97,10 +97,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -109,8 +109,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -119,7 +119,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(appsId, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.
+  <pre>Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding below allows API services to override the binding to use different resource name schemes, such as users/*/operations.
 
 Args:
   appsId: string, Part of `name`. The name of the operation collection. (required)
@@ -134,10 +134,10 @@ <h3>Method Details</h3>
     { # The response message for Operations.ListOperations.
     "operations": [ # A list of operations that matches the specified filter in the request.
       { # This resource represents a long-running operation that is the result of a network API call.
-        "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+        "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+        "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
           "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
           "code": 42, # The status code, which should be an enum value of google.rpc.Code.
           "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -146,8 +146,8 @@ <h3>Method Details</h3>
             },
           ],
         },
-        "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-        "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+        "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+        "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
         "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
diff --git a/docs/dyn/appengine_v1beta5.apps.html b/docs/dyn/appengine_v1beta5.apps.html
index 7b012ff63d3..85ea070f40c 100644
--- a/docs/dyn/appengine_v1beta5.apps.html
+++ b/docs/dyn/appengine_v1beta5.apps.html
@@ -91,38 +91,38 @@ <h2>Instance Methods</h2>
 
 <p class="toc_element">
   <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the [Google Cloud Resource Manager create project topic](https://cloud.google.com/resource-manager/docs/creating-project).</p>
+<p class="firstline">Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the Google Cloud Resource Manager create project topic (https://cloud.google.com/resource-manager/docs/creating-project).</p>
 <p class="toc_element">
   <code><a href="#get">get(appsId, x__xgafv=None, ensureResourcesExist=None)</a></code></p>
 <p class="firstline">Gets information about an application.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(appsId, body, mask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates application parameters.</p>
+<p class="firstline">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)</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(body, x__xgafv=None)</code>
-  <pre>Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the [Google Cloud Resource Manager create project topic](https://cloud.google.com/resource-manager/docs/creating-project).
+  <pre>Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the Google Cloud Resource Manager create project topic (https://cloud.google.com/resource-manager/docs/creating-project).
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # An Application resource contains the top-level configuration of an App Engine application.
-    "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine. @OutputOnly
-    "name": "A String", # Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly
-    "codeBucket": "A String", # A Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly
-    "defaultBucket": "A String", # A Google Cloud Storage bucket that can be used by the application to store content. @OutputOnly
-    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent. @OutputOnly
+    "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine.@OutputOnly
+    "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+    "codeBucket": "A String", # A Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+    "defaultBucket": "A String", # A Google Cloud Storage bucket that can be used by the application to store content.@OutputOnly
+    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent.@OutputOnly
       { # Rules to match an HTTP request and dispatch that request to a service.
-        "path": "A String", # Pathname within the host. Must start with a "`/`". A single "`*`" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
-        "domain": "A String", # Domain name to match against. The wildcard "`*`" is supported if specified before a period: "`*.`". Defaults to matching all domains: "`*`".
-        "service": "A String", # Resource id of a service in this application that should serve the matched request. The service must already exist. Example: `default`.
+        "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+        "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+        "service": "A String", # Resource id of a service in this application that should serve the matched request. The service must already exist. Example: default.
       },
     ],
-    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application. @OutputOnly
-    "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US
-    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.
-    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.
+    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+    "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   }
 
   x__xgafv: string, V1 error format.
@@ -131,10 +131,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -143,8 +143,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -156,57 +156,57 @@ <h3>Method Details</h3>
   <pre>Gets information about an application.
 
 Args:
-  appsId: string, Part of `name`. Name of the application to get. Example: `apps/myapp`. (required)
+  appsId: string, Part of `name`. Name of the application to get. Example: apps/myapp. (required)
   x__xgafv: string, V1 error format.
-  ensureResourcesExist: boolean, Certain resources associated with an application are created on-demand. Controls whether these resources should be created when performing the `GET` operation. If specified and any resources could not be created, the request will fail with an error code. Additionally, this parameter can cause the request to take longer to complete. Note: This parameter will be deprecated in a future version of the API.
+  ensureResourcesExist: boolean, Certain resources associated with an application are created on-demand. Controls whether these resources should be created when performing the GET operation. If specified and any resources could not be created, the request will fail with an error code. Additionally, this parameter can cause the request to take longer to complete. Note: This parameter will be deprecated in a future version of the API.
 
 Returns:
   An object of the form:
 
     { # An Application resource contains the top-level configuration of an App Engine application.
-      "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine. @OutputOnly
-      "name": "A String", # Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly
-      "codeBucket": "A String", # A Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly
-      "defaultBucket": "A String", # A Google Cloud Storage bucket that can be used by the application to store content. @OutputOnly
-      "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent. @OutputOnly
+      "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine.@OutputOnly
+      "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+      "codeBucket": "A String", # A Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+      "defaultBucket": "A String", # A Google Cloud Storage bucket that can be used by the application to store content.@OutputOnly
+      "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent.@OutputOnly
         { # Rules to match an HTTP request and dispatch that request to a service.
-          "path": "A String", # Pathname within the host. Must start with a "`/`". A single "`*`" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
-          "domain": "A String", # Domain name to match against. The wildcard "`*`" is supported if specified before a period: "`*.`". Defaults to matching all domains: "`*`".
-          "service": "A String", # Resource id of a service in this application that should serve the matched request. The service must already exist. Example: `default`.
+          "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+          "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+          "service": "A String", # Resource id of a service in this application that should serve the matched request. The service must already exist. Example: default.
         },
       ],
-      "defaultCookieExpiration": "A String", # Cookie expiration policy for this application. @OutputOnly
-      "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US
-      "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.
-      "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.
+      "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+      "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+      "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+      "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="patch">patch(appsId, body, mask=None, x__xgafv=None)</code>
-  <pre>Updates application parameters.
+  <pre>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)
 
 Args:
-  appsId: string, Part of `name`. Name of the application to update. Example: `apps/myapp`. (required)
+  appsId: string, Part of `name`. Name of the Application resource to update. Example: apps/myapp. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # An Application resource contains the top-level configuration of an App Engine application.
-    "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine. @OutputOnly
-    "name": "A String", # Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly
-    "codeBucket": "A String", # A Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly
-    "defaultBucket": "A String", # A Google Cloud Storage bucket that can be used by the application to store content. @OutputOnly
-    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent. @OutputOnly
+    "defaultHostname": "A String", # Hostname used to reach the application, as resolved by App Engine.@OutputOnly
+    "name": "A String", # Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+    "codeBucket": "A String", # A Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly
+    "defaultBucket": "A String", # A Google Cloud Storage bucket that can be used by the application to store content.@OutputOnly
+    "dispatchRules": [ # HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent.@OutputOnly
       { # Rules to match an HTTP request and dispatch that request to a service.
-        "path": "A String", # Pathname within the host. Must start with a "`/`". A single "`*`" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
-        "domain": "A String", # Domain name to match against. The wildcard "`*`" is supported if specified before a period: "`*.`". Defaults to matching all domains: "`*`".
-        "service": "A String", # Resource id of a service in this application that should serve the matched request. The service must already exist. Example: `default`.
+        "path": "A String", # Pathname within the host. Must start with a "/". A single "*" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.
+        "domain": "A String", # Domain name to match against. The wildcard "*" is supported if specified before a period: "*.".Defaults to matching all domains: "*".
+        "service": "A String", # Resource id of a service in this application that should serve the matched request. The service must already exist. Example: default.
       },
     ],
-    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application. @OutputOnly
-    "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US
-    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.
-    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.
+    "defaultCookieExpiration": "A String", # Cookie expiration policy for this application.
+    "location": "A String", # Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US
+    "authDomain": "A String", # Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.
+    "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   }
 
   mask: string, Standard field mask for the set of fields to be updated.
@@ -216,10 +216,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -228,8 +228,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1beta5.apps.locations.html b/docs/dyn/appengine_v1beta5.apps.locations.html
index 9f5bc478a89..8692253b8ba 100644
--- a/docs/dyn/appengine_v1beta5.apps.locations.html
+++ b/docs/dyn/appengine_v1beta5.apps.locations.html
@@ -100,8 +100,8 @@ <h3>Method Details</h3>
     "labels": { # Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"}
       "a_key": "A String",
     },
-    "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
-    "name": "A String", # Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"`
+    "locationId": "A String", # The canonical id for this location. For example: "us-east1".
+    "name": "A String", # Resource name for the location, which may vary between implementations. For example: "projects/example-project/locations/us-east1"
     "metadata": { # Service-specific metadata. For example the available capacity at the given location.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -129,8 +129,8 @@ <h3>Method Details</h3>
         "labels": { # Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"}
           "a_key": "A String",
         },
-        "locationId": "A String", # The canonical id for this location. For example: `"us-east1"`.
-        "name": "A String", # Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"`
+        "locationId": "A String", # The canonical id for this location. For example: "us-east1".
+        "name": "A String", # Resource name for the location, which may vary between implementations. For example: "projects/example-project/locations/us-east1"
         "metadata": { # Service-specific metadata. For example the available capacity at the given location.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
diff --git a/docs/dyn/appengine_v1beta5.apps.operations.html b/docs/dyn/appengine_v1beta5.apps.operations.html
index c16565fe3f5..7b8249c206b 100644
--- a/docs/dyn/appengine_v1beta5.apps.operations.html
+++ b/docs/dyn/appengine_v1beta5.apps.operations.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.</p>
 <p class="toc_element">
   <code><a href="#list">list(appsId, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.</p>
+<p class="firstline">Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding below allows API services to override the binding to use different resource name schemes, such as users/*/operations.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -97,10 +97,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -109,8 +109,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -119,7 +119,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(appsId, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.
+  <pre>Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding below allows API services to override the binding to use different resource name schemes, such as users/*/operations.
 
 Args:
   appsId: string, Part of `name`. The name of the operation collection. (required)
@@ -134,10 +134,10 @@ <h3>Method Details</h3>
     { # The response message for Operations.ListOperations.
     "operations": [ # A list of operations that matches the specified filter in the request.
       { # This resource represents a long-running operation that is the result of a network API call.
-        "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+        "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+        "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
           "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
           "code": 42, # The status code, which should be an enum value of google.rpc.Code.
           "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -146,8 +146,8 @@ <h3>Method Details</h3>
             },
           ],
         },
-        "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-        "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+        "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+        "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
         "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
diff --git a/docs/dyn/appengine_v1beta5.apps.services.html b/docs/dyn/appengine_v1beta5.apps.services.html
index bfc93e09e4e..1f5111a52ec 100644
--- a/docs/dyn/appengine_v1beta5.apps.services.html
+++ b/docs/dyn/appengine_v1beta5.apps.services.html
@@ -100,7 +100,7 @@ <h3>Method Details</h3>
   <pre>Deletes the specified service and all enclosed versions.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
 
@@ -108,10 +108,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -120,8 +120,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -133,7 +133,7 @@ <h3>Method Details</h3>
   <pre>Gets the current configuration of the specified service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
 
@@ -147,8 +147,8 @@ <h3>Method Details</h3>
           "a_key": 3.14,
         },
       },
-      "name": "A String", # Full path to the Service resource in the API. Example: `apps/myapp/services/default`. @OutputOnly
-      "id": "A String", # Relative name of the service within the application. Example: `default`. @OutputOnly
+      "name": "A String", # Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly
+      "id": "A String", # Relative name of the service within the application. Example: default.@OutputOnly
     }</pre>
 </div>
 
@@ -157,7 +157,7 @@ <h3>Method Details</h3>
   <pre>Lists all the services in the application.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
@@ -165,7 +165,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Response message for `Services.ListServices`.
+    { # Response message for Services.ListServices.
     "services": [ # The services belonging to the requested application.
       { # A Service resource is a logical component of an application that can share state and communicate in a secure fashion with other services. For example, an application that handles customer requests might include separate services to handle other tasks such as API requests from mobile devices or backend data analysis. Each service has a collection of versions that define a specific set of code used to implement the functionality of that service.
           "split": { # Traffic routing configuration for versions within a single service. Traffic splits define how traffic directed to the service is assigned to versions. # Mapping that defines fractional HTTP traffic diversion to different versions within the service.
@@ -174,8 +174,8 @@ <h3>Method Details</h3>
               "a_key": 3.14,
             },
           },
-          "name": "A String", # Full path to the Service resource in the API. Example: `apps/myapp/services/default`. @OutputOnly
-          "id": "A String", # Relative name of the service within the application. Example: `default`. @OutputOnly
+          "name": "A String", # Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly
+          "id": "A String", # Relative name of the service within the application. Example: default.@OutputOnly
         },
     ],
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
@@ -201,7 +201,7 @@ <h3>Method Details</h3>
   <pre>Updates the configuration of the specified service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
@@ -213,11 +213,11 @@ <h3>Method Details</h3>
         "a_key": 3.14,
       },
     },
-    "name": "A String", # Full path to the Service resource in the API. Example: `apps/myapp/services/default`. @OutputOnly
-    "id": "A String", # Relative name of the service within the application. Example: `default`. @OutputOnly
+    "name": "A String", # Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly
+    "id": "A String", # Relative name of the service within the application. Example: default.@OutputOnly
   }
 
-  migrateTraffic: boolean, Set to `true` to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both [warmup requests](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#inboundservicetype) and [automatic scaling](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#automaticscaling). You must specify the [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services#shardby) field in the Service resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see [Migrating and Splitting Traffic](https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).
+  migrateTraffic: boolean, Set to true to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both warmup requests (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services#shardby) field in the Service resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see Migrating and Splitting Traffic (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).
   mask: string, Standard field mask for the set of fields to be updated.
   x__xgafv: string, V1 error format.
 
@@ -225,10 +225,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -237,8 +237,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1beta5.apps.services.versions.html b/docs/dyn/appengine_v1beta5.apps.services.versions.html
index 043b3ebe98d..8a3c947c4aa 100644
--- a/docs/dyn/appengine_v1beta5.apps.services.versions.html
+++ b/docs/dyn/appengine_v1beta5.apps.services.versions.html
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Deletes an existing version.</p>
 <p class="toc_element">
   <code><a href="#get">get(appsId, servicesId, versionsId, x__xgafv=None, view=None)</a></code></p>
-<p class="firstline">Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.</p>
+<p class="firstline">Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.</p>
 <p class="toc_element">
   <code><a href="#list">list(appsId, servicesId, pageSize=None, x__xgafv=None, pageToken=None, view=None)</a></code></p>
 <p class="firstline">Lists the versions of a service.</p>
@@ -96,7 +96,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(appsId, servicesId, versionsId, body, mask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.</p>
+<p class="firstline">Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(appsId, servicesId, body, x__xgafv=None)</code>
@@ -109,6 +109,10 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # A Version resource is a specific set of source code and configuration files that are deployed into a service.
+    "endpointsApiService": { # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy.The fields here refer to the name and configuration id of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview). # Cloud Endpoints configuration.If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
+      "configId": "A String", # Endpoints service configuration id as specified by the Service Management API. For example "2016-09-19r1"
+      "name": "A String", # Endpoints service name which is the name of the "service" resource in the Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+    },
     "basicScaling": { # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity. # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
       "idleTimeout": "A String", # Duration of time after the last request that an instance must wait before the instance is shut down.
       "maxInstances": 42, # Maximum number of instances to create for this version.
@@ -117,24 +121,24 @@ <h3>Method Details</h3>
       "a_key": "A String",
     },
     "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
       { # Custom static error page to be served when an error occurs.
         "errorCode": "A String", # Error condition this handler applies to.
-        "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+        "mimeType": "A String", # MIME type of file. Defaults to text/html.
         "staticFile": "A String", # Static file content to be served for this error.
       },
     ],
-    "id": "A String", # Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-    "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+    "id": "A String", # Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+    "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
       "url": "A String", # URL to serve the endpoint at.
       "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-      "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+      "login": "A String", # Level of login required to access this resource. Defaults to optional.
       "script": "A String", # Path to the script from the application root directory.
     },
     "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
       "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
       "checkInterval": "A String", # Interval between health checks.
       "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -143,16 +147,16 @@ <h3>Method Details</h3>
       "timeout": "A String", # Time before the health check is considered failed.
       "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
     },
-    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-    "libraries": [ # Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.
+    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+    "libraries": [ # Configuration for third-party Python runtime libraries required by the application.Only returned in GET requests if view=FULL is set.
       { # Third-party Python runtime library that is required by the application.
         "version": "A String", # Version of the library to select, or "latest".
         "name": "A String", # Name of the library. Example: "django".
       },
     ],
-    "deployer": "A String", # Email address of the user who created this version. @OutputOnly
-    "env": "A String", # App Engine execution environment to use for this version. Defaults to `1`.
-    "diskUsageBytes": "A String", # Total size of version files hosted on App Engine disk in bytes. @OutputOnly
+    "deployer": "A String", # Email address of the user who created this version.@OutputOnly
+    "env": "A String", # App Engine execution environment to use for this version.Defaults to 1.
+    "diskUsageBytes": "A String", # Total size of version files hosted on App Engine disk in bytes.@OutputOnly
     "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
       "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
       "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -174,34 +178,41 @@ <h3>Method Details</h3>
         "targetConcurrentRequests": 42, # Target number of concurrent requests.
         "targetRequestCountPerSec": 42, # Target requests per second.
       },
-      "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+      "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
       "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
       "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
       "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
         "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
         "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
       },
     },
-    "envVariables": { # Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.
+    "envVariables": { # Environment variables made available to the application.Only returned in GET requests if view=FULL is set.
       "a_key": "A String",
     },
     "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+      "volumes": [ # Volumes mounted within the app container.
+        { # Volumes mounted within the app container. Only applicable for VM runtimes.
+          "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+          "name": "A String", # Unique name for the volume.
+          "sizeGb": 3.14, # Volume size in gigabytes.
+        },
+      ],
       "diskGb": 3.14, # Disk size (GB) needed.
       "cpu": 3.14, # Number of CPU cores needed.
       "memoryGb": 3.14, # Memory (GB) needed.
     },
     "manualScaling": { # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-      "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+      "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
     },
     "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
       "A String",
     ],
-    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
       "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
         "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-          "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+          "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
           "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
         },
       },
@@ -220,14 +231,15 @@ <h3>Method Details</h3>
       "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
         "A String",
       ],
-      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
+      "subnetworkName": "A String", # Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app.
     },
-    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-    "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly
-    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+    "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
+    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
       { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
         "urlRegex": "A String", # A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
         "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
           "scriptPath": "A String", # Path to the script from the application root directory.
@@ -247,12 +259,12 @@ <h3>Method Details</h3>
           "scriptPath": "A String", # Path to the script from the application root directory.
         },
         "login": "A String", # Level of login required to access this resource.
-        "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+        "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
       },
     ],
-    "creationTime": "A String", # Time that this version was created. @OutputOnly
-    "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-    "runtime": "A String", # Desired runtime. Example: `python27`.
+    "creationTime": "A String", # Time that this version was created.@OutputOnly
+    "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+    "runtime": "A String", # Desired runtime. Example: python27.
   }
 
   x__xgafv: string, V1 error format.
@@ -261,10 +273,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -273,8 +285,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -286,7 +298,7 @@ <h3>Method Details</h3>
   <pre>Deletes an existing version.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
@@ -295,10 +307,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -307,8 +319,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -317,19 +329,23 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(appsId, servicesId, versionsId, x__xgafv=None, view=None)</code>
-  <pre>Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.
+  <pre>Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
-  view: string, Controls the set of fields returned in the `Get` response.
+  view: string, Controls the set of fields returned in the Get response.
 
 Returns:
   An object of the form:
 
     { # A Version resource is a specific set of source code and configuration files that are deployed into a service.
+      "endpointsApiService": { # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy.The fields here refer to the name and configuration id of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview). # Cloud Endpoints configuration.If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
+        "configId": "A String", # Endpoints service configuration id as specified by the Service Management API. For example "2016-09-19r1"
+        "name": "A String", # Endpoints service name which is the name of the "service" resource in the Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+      },
       "basicScaling": { # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity. # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
         "idleTimeout": "A String", # Duration of time after the last request that an instance must wait before the instance is shut down.
         "maxInstances": 42, # Maximum number of instances to create for this version.
@@ -338,24 +354,24 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
       "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-      "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-      "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+      "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+      "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
         { # Custom static error page to be served when an error occurs.
           "errorCode": "A String", # Error condition this handler applies to.
-          "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+          "mimeType": "A String", # MIME type of file. Defaults to text/html.
           "staticFile": "A String", # Static file content to be served for this error.
         },
       ],
-      "id": "A String", # Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-      "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+      "id": "A String", # Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+      "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
         "url": "A String", # URL to serve the endpoint at.
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-        "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+        "login": "A String", # Level of login required to access this resource. Defaults to optional.
         "script": "A String", # Path to the script from the application root directory.
       },
       "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-      "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+      "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
         "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
         "checkInterval": "A String", # Interval between health checks.
         "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -364,16 +380,16 @@ <h3>Method Details</h3>
         "timeout": "A String", # Time before the health check is considered failed.
         "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
       },
-      "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-      "libraries": [ # Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.
+      "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+      "libraries": [ # Configuration for third-party Python runtime libraries required by the application.Only returned in GET requests if view=FULL is set.
         { # Third-party Python runtime library that is required by the application.
           "version": "A String", # Version of the library to select, or "latest".
           "name": "A String", # Name of the library. Example: "django".
         },
       ],
-      "deployer": "A String", # Email address of the user who created this version. @OutputOnly
-      "env": "A String", # App Engine execution environment to use for this version. Defaults to `1`.
-      "diskUsageBytes": "A String", # Total size of version files hosted on App Engine disk in bytes. @OutputOnly
+      "deployer": "A String", # Email address of the user who created this version.@OutputOnly
+      "env": "A String", # App Engine execution environment to use for this version.Defaults to 1.
+      "diskUsageBytes": "A String", # Total size of version files hosted on App Engine disk in bytes.@OutputOnly
       "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
         "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
         "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -395,34 +411,41 @@ <h3>Method Details</h3>
           "targetConcurrentRequests": 42, # Target number of concurrent requests.
           "targetRequestCountPerSec": 42, # Target requests per second.
         },
-        "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+        "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
         "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-        "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+        "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
         "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
         "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
           "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
           "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
         },
       },
-      "envVariables": { # Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.
+      "envVariables": { # Environment variables made available to the application.Only returned in GET requests if view=FULL is set.
         "a_key": "A String",
       },
       "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+        "volumes": [ # Volumes mounted within the app container.
+          { # Volumes mounted within the app container. Only applicable for VM runtimes.
+            "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+            "name": "A String", # Unique name for the volume.
+            "sizeGb": 3.14, # Volume size in gigabytes.
+          },
+        ],
         "diskGb": 3.14, # Disk size (GB) needed.
         "cpu": 3.14, # Number of CPU cores needed.
         "memoryGb": 3.14, # Memory (GB) needed.
       },
       "manualScaling": { # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-        "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+        "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
       },
       "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
         "A String",
       ],
-      "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+      "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
         "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
           "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-            "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-            "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+            "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+            "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
             "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
           },
         },
@@ -441,14 +464,15 @@ <h3>Method Details</h3>
         "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
           "A String",
         ],
-        "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+        "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
+        "subnetworkName": "A String", # Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app.
       },
-      "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-      "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly
-      "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+      "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+      "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
+      "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
         { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
           "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-          "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+          "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
           "urlRegex": "A String", # A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
           "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
             "scriptPath": "A String", # Path to the script from the application root directory.
@@ -468,12 +492,12 @@ <h3>Method Details</h3>
             "scriptPath": "A String", # Path to the script from the application root directory.
           },
           "login": "A String", # Level of login required to access this resource.
-          "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+          "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
         },
       ],
-      "creationTime": "A String", # Time that this version was created. @OutputOnly
-      "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-      "runtime": "A String", # Desired runtime. Example: `python27`.
+      "creationTime": "A String", # Time that this version was created.@OutputOnly
+      "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+      "runtime": "A String", # Desired runtime. Example: python27.
     }</pre>
 </div>
 
@@ -482,20 +506,24 @@ <h3>Method Details</h3>
   <pre>Lists the versions of a service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
   x__xgafv: string, V1 error format.
   pageToken: string, Continuation token for fetching the next page of results.
-  view: string, Controls the set of fields returned in the `List` response.
+  view: string, Controls the set of fields returned in the List response.
 
 Returns:
   An object of the form:
 
-    { # Response message for `Versions.ListVersions`.
+    { # Response message for Versions.ListVersions.
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
     "versions": [ # The versions belonging to the requested service.
       { # A Version resource is a specific set of source code and configuration files that are deployed into a service.
+          "endpointsApiService": { # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy.The fields here refer to the name and configuration id of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview). # Cloud Endpoints configuration.If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
+            "configId": "A String", # Endpoints service configuration id as specified by the Service Management API. For example "2016-09-19r1"
+            "name": "A String", # Endpoints service name which is the name of the "service" resource in the Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+          },
           "basicScaling": { # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity. # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
             "idleTimeout": "A String", # Duration of time after the last request that an instance must wait before the instance is shut down.
             "maxInstances": 42, # Maximum number of instances to create for this version.
@@ -504,24 +532,24 @@ <h3>Method Details</h3>
             "a_key": "A String",
           },
           "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-          "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-          "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+          "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+          "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
             { # Custom static error page to be served when an error occurs.
               "errorCode": "A String", # Error condition this handler applies to.
-              "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+              "mimeType": "A String", # MIME type of file. Defaults to text/html.
               "staticFile": "A String", # Static file content to be served for this error.
             },
           ],
-          "id": "A String", # Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-          "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+          "id": "A String", # Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+          "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
             "url": "A String", # URL to serve the endpoint at.
             "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-            "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-            "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+            "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+            "login": "A String", # Level of login required to access this resource. Defaults to optional.
             "script": "A String", # Path to the script from the application root directory.
           },
           "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-          "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+          "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
             "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
             "checkInterval": "A String", # Interval between health checks.
             "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -530,16 +558,16 @@ <h3>Method Details</h3>
             "timeout": "A String", # Time before the health check is considered failed.
             "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
           },
-          "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-          "libraries": [ # Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.
+          "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+          "libraries": [ # Configuration for third-party Python runtime libraries required by the application.Only returned in GET requests if view=FULL is set.
             { # Third-party Python runtime library that is required by the application.
               "version": "A String", # Version of the library to select, or "latest".
               "name": "A String", # Name of the library. Example: "django".
             },
           ],
-          "deployer": "A String", # Email address of the user who created this version. @OutputOnly
-          "env": "A String", # App Engine execution environment to use for this version. Defaults to `1`.
-          "diskUsageBytes": "A String", # Total size of version files hosted on App Engine disk in bytes. @OutputOnly
+          "deployer": "A String", # Email address of the user who created this version.@OutputOnly
+          "env": "A String", # App Engine execution environment to use for this version.Defaults to 1.
+          "diskUsageBytes": "A String", # Total size of version files hosted on App Engine disk in bytes.@OutputOnly
           "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
             "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
             "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -561,34 +589,41 @@ <h3>Method Details</h3>
               "targetConcurrentRequests": 42, # Target number of concurrent requests.
               "targetRequestCountPerSec": 42, # Target requests per second.
             },
-            "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+            "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
             "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-            "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+            "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
             "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
             "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
               "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
               "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
             },
           },
-          "envVariables": { # Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.
+          "envVariables": { # Environment variables made available to the application.Only returned in GET requests if view=FULL is set.
             "a_key": "A String",
           },
           "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+            "volumes": [ # Volumes mounted within the app container.
+              { # Volumes mounted within the app container. Only applicable for VM runtimes.
+                "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+                "name": "A String", # Unique name for the volume.
+                "sizeGb": 3.14, # Volume size in gigabytes.
+              },
+            ],
             "diskGb": 3.14, # Disk size (GB) needed.
             "cpu": 3.14, # Number of CPU cores needed.
             "memoryGb": 3.14, # Memory (GB) needed.
           },
           "manualScaling": { # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-            "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+            "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
           },
           "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
             "A String",
           ],
-          "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+          "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
             "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
               "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-                "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-                "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+                "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+                "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
                 "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
               },
             },
@@ -607,14 +642,15 @@ <h3>Method Details</h3>
             "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
               "A String",
             ],
-            "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+            "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
+            "subnetworkName": "A String", # Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app.
           },
-          "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-          "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly
-          "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+          "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+          "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
+          "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
             { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
               "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-              "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+              "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
               "urlRegex": "A String", # A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
               "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
                 "scriptPath": "A String", # Path to the script from the application root directory.
@@ -634,12 +670,12 @@ <h3>Method Details</h3>
                 "scriptPath": "A String", # Path to the script from the application root directory.
               },
               "login": "A String", # Level of login required to access this resource.
-              "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+              "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
             },
           ],
-          "creationTime": "A String", # Time that this version was created. @OutputOnly
-          "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-          "runtime": "A String", # Desired runtime. Example: `python27`.
+          "creationTime": "A String", # Time that this version was created.@OutputOnly
+          "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+          "runtime": "A String", # Desired runtime. Example: python27.
         },
     ],
   }</pre>
@@ -661,16 +697,20 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="patch">patch(appsId, servicesId, versionsId, body, mask=None, x__xgafv=None)</code>
-  <pre>Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.
+  <pre>Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: `apps/myapp/services/default/versions/1`. (required)
+  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # A Version resource is a specific set of source code and configuration files that are deployed into a service.
+    "endpointsApiService": { # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy.The fields here refer to the name and configuration id of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview). # Cloud Endpoints configuration.If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
+      "configId": "A String", # Endpoints service configuration id as specified by the Service Management API. For example "2016-09-19r1"
+      "name": "A String", # Endpoints service name which is the name of the "service" resource in the Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+    },
     "basicScaling": { # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity. # A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
       "idleTimeout": "A String", # Duration of time after the last request that an instance must wait before the instance is shut down.
       "maxInstances": 42, # Maximum number of instances to create for this version.
@@ -679,24 +719,24 @@ <h3>Method Details</h3>
       "a_key": "A String",
     },
     "vm": True or False, # Whether to deploy this version in a container on a virtual machine.
-    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for AutomaticScaling and `B1` for ManualScaling or BasicScaling.
-    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.
+    "instanceClass": "A String", # Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
+    "errorHandlers": [ # Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
       { # Custom static error page to be served when an error occurs.
         "errorCode": "A String", # Error condition this handler applies to.
-        "mimeType": "A String", # MIME type of file. Defaults to `text/html`.
+        "mimeType": "A String", # MIME type of file. Defaults to text/html.
         "staticFile": "A String", # Static file content to be served for this error.
       },
     ],
-    "id": "A String", # Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
-    "apiConfig": { # [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set.
+    "id": "A String", # Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
+    "apiConfig": { # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers. # Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set.
       "url": "A String", # URL to serve the endpoint at.
       "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
-      "login": "A String", # Level of login required to access this resource. Defaults to `optional`.
+      "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
+      "login": "A String", # Level of login required to access this resource. Defaults to optional.
       "script": "A String", # Path to the script from the application root directory.
     },
     "threadsafe": True or False, # Whether multiple requests can be dispatched to this version at once.
-    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set.
+    "healthCheck": { # Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment. # Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set.
       "restartThreshold": 42, # Number of consecutive failed health checks required before an instance is restarted.
       "checkInterval": "A String", # Interval between health checks.
       "unhealthyThreshold": 42, # Number of consecutive failed health checks required before removing traffic.
@@ -705,16 +745,16 @@ <h3>Method Details</h3>
       "timeout": "A String", # Time before the health check is considered failed.
       "disableHealthCheck": True or False, # Whether to explicitly disable health checks for this instance.
     },
-    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is set.
-    "libraries": [ # Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.
+    "defaultExpiration": "A String", # Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
+    "libraries": [ # Configuration for third-party Python runtime libraries required by the application.Only returned in GET requests if view=FULL is set.
       { # Third-party Python runtime library that is required by the application.
         "version": "A String", # Version of the library to select, or "latest".
         "name": "A String", # Name of the library. Example: "django".
       },
     ],
-    "deployer": "A String", # Email address of the user who created this version. @OutputOnly
-    "env": "A String", # App Engine execution environment to use for this version. Defaults to `1`.
-    "diskUsageBytes": "A String", # Total size of version files hosted on App Engine disk in bytes. @OutputOnly
+    "deployer": "A String", # Email address of the user who created this version.@OutputOnly
+    "env": "A String", # App Engine execution environment to use for this version.Defaults to 1.
+    "diskUsageBytes": "A String", # Total size of version files hosted on App Engine disk in bytes.@OutputOnly
     "automaticScaling": { # Automatic scaling is based on request rate, response latencies, and other application metrics. # Automatic scaling is based on request rate, response latencies, and other application metrics.
       "minPendingLatency": "A String", # Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.
       "networkUtilization": { # Target scaling by network usage. Only applicable for VM runtimes. # Target scaling by network usage.
@@ -736,34 +776,41 @@ <h3>Method Details</h3>
         "targetConcurrentRequests": 42, # Target number of concurrent requests.
         "targetRequestCountPerSec": 42, # Target requests per second.
       },
-      "coolDownPeriod": "A String", # Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
+      "coolDownPeriod": "A String", # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes.
       "maxTotalInstances": 42, # Maximum number of instances that should be started to handle requests.
-      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.
+      "maxConcurrentRequests": 42, # Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value.
       "minTotalInstances": 42, # Minimum number of instances that should be maintained for this version.
       "cpuUtilization": { # Target scaling by CPU usage. # Target scaling by CPU usage.
         "targetUtilization": 3.14, # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
         "aggregationWindowLength": "A String", # Period of time over which CPU utilization is calculated.
       },
     },
-    "envVariables": { # Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.
+    "envVariables": { # Environment variables made available to the application.Only returned in GET requests if view=FULL is set.
       "a_key": "A String",
     },
     "resources": { # Machine resources for a version. # Machine resources for this version. Only applicable for VM runtimes.
+      "volumes": [ # Volumes mounted within the app container.
+        { # Volumes mounted within the app container. Only applicable for VM runtimes.
+          "volumeType": "A String", # Underlying volume type, e.g. 'tmpfs'.
+          "name": "A String", # Unique name for the volume.
+          "sizeGb": 3.14, # Volume size in gigabytes.
+        },
+      ],
       "diskGb": 3.14, # Disk size (GB) needed.
       "cpu": 3.14, # Number of CPU cores needed.
       "memoryGb": 3.14, # Memory (GB) needed.
     },
     "manualScaling": { # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. # A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
-      "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.
+      "instances": 42, # Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function.
     },
     "inboundServices": [ # Before an application can receive email or XMPP messages, the application must be configured to enable the service.
       "A String",
     ],
-    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set.
+    "deployment": { # Code and application artifacts used to deploy a version to App Engine. # Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set.
       "files": { # Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.
         "a_key": { # Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.
-          "mimeType": "A String", # The MIME type of the file. Defaults to the value from Google Cloud Storage.
-          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+          "mimeType": "A String", # The MIME type of the file.Defaults to the value from Google Cloud Storage.
+          "sourceUrl": "A String", # URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
           "sha1Sum": "A String", # The SHA1 hash of the file, in hex.
         },
       },
@@ -782,14 +829,15 @@ <h3>Method Details</h3>
       "forwardedPorts": [ # List of ports, or port pairs, to forward from the virtual machine to the application container.
         "A String",
       ],
-      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`.
+      "name": "A String", # Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default.
+      "subnetworkName": "A String", # Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app.
     },
-    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes. Only returned in `GET` requests if `view=FULL` is set.
-    "name": "A String", # Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly
-    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set.
+    "nobuildFilesRegex": "A String", # Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
+    "name": "A String", # Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
+    "handlers": [ # An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.Only returned in GET requests if view=FULL is set.
       { # URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.
         "securityLevel": "A String", # Security (HTTPS) enforcement for this URL.
-        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to `redirect`.
+        "authFailAction": "A String", # Action to take when users access resources that require authentication. Defaults to redirect.
         "urlRegex": "A String", # A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path.
         "script": { # Executes a script to handle the request that matches the URL pattern. # Executes a script to handle the request that matches this URL pattern.
           "scriptPath": "A String", # Path to the script from the application root directory.
@@ -809,12 +857,12 @@ <h3>Method Details</h3>
           "scriptPath": "A String", # Path to the script from the application root directory.
         },
         "login": "A String", # Level of login required to access this resource.
-        "redirectHttpResponseCode": "A String", # `30x` code to use when performing redirects for the `secure` field. Defaults to `302`.
+        "redirectHttpResponseCode": "A String", # 30x code to use when performing redirects for the secure field. Defaults to 302.
       },
     ],
-    "creationTime": "A String", # Time that this version was created. @OutputOnly
-    "servingStatus": "A String", # Current serving status of this version. Only the versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
-    "runtime": "A String", # Desired runtime. Example: `python27`.
+    "creationTime": "A String", # Time that this version was created.@OutputOnly
+    "servingStatus": "A String", # Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
+    "runtime": "A String", # Desired runtime. Example: python27.
   }
 
   mask: string, Standard field mask for the set of fields to be updated.
@@ -824,10 +872,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -836,8 +884,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
diff --git a/docs/dyn/appengine_v1beta5.apps.services.versions.instances.html b/docs/dyn/appengine_v1beta5.apps.services.versions.instances.html
index bbf7545e250..0e2a897de8c 100644
--- a/docs/dyn/appengine_v1beta5.apps.services.versions.instances.html
+++ b/docs/dyn/appengine_v1beta5.apps.services.versions.instances.html
@@ -76,7 +76,7 @@ <h1><a href="appengine_v1beta5.html">Google App Engine Admin API</a> . <a href="
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#debug">debug(appsId, servicesId, versionsId, instancesId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started. Only applicable for instances in App Engine flexible environment.</p>
+<p class="firstline">Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(appsId, servicesId, versionsId, instancesId, x__xgafv=None)</a></code></p>
 <p class="firstline">Stops a running instance.</p>
@@ -92,17 +92,18 @@ <h2>Instance Methods</h2>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="debug">debug(appsId, servicesId, versionsId, instancesId, body, x__xgafv=None)</code>
-  <pre>Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started. Only applicable for instances in App Engine flexible environment.
+  <pre>Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Request message for `Instances.DebugInstance`.
+{ # Request message for Instances.DebugInstance.
+    "sshKey": "A String", # Public SSH key to add to the instance. Examples: [USERNAME]:ssh-rsa [KEY_VALUE] [USERNAME] [USERNAME]:ssh-rsa [KEY_VALUE] google-ssh {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}For more information, see Adding and Removing SSH Keys (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys).
   }
 
   x__xgafv: string, V1 error format.
@@ -111,10 +112,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -123,8 +124,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -146,10 +147,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be: Simple to use and understand for most users Flexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc which can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include: Partial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors. Workflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting purpose. Batch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response. Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message. Logging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
@@ -158,8 +159,8 @@ <h3>Method Details</h3>
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
+    "done": True or False, # If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
@@ -171,7 +172,7 @@ <h3>Method Details</h3>
   <pre>Gets instance information.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -181,21 +182,22 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Instance resource is the computing unit that App Engine uses to automatically scale an application.
-    "errors": 42, # Number of errors since this instance was started. @OutputOnly
-    "name": "A String", # Full path to the Instance resource in the API. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. @OutputOnly
-    "startTimestamp": "A String", # Time that this instance was started. @OutputOnly
-    "appEngineRelease": "A String", # App Engine release this instance is running on. @OutputOnly
-    "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "memoryUsage": "A String", # Total memory in use (bytes). @OutputOnly
-    "id": "A String", # Relative name of the instance within the version. Example: `instance-1`. @OutputOnly
-    "vmUnlocked": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "averageLatency": 42, # Average latency (ms) over the last minute. @OutputOnly
-    "qps": 3.14, # Average queries per second (QPS) over the last minute. @OutputOnly
-    "requests": 42, # Number of requests since this instance was started. @OutputOnly
-    "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "availability": "A String", # Availability of the instance. @OutputOnly
-    "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly
-    "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
+    "errors": 42, # Number of errors since this instance was started.@OutputOnly
+    "name": "A String", # Full path to the Instance resource in the API. Example: apps/myapp/services/default/versions/v1/instances/instance-1.@OutputOnly
+    "startTimestamp": "A String", # Time that this instance was started.@OutputOnly
+    "appEngineRelease": "A String", # App Engine release this instance is running on.@OutputOnly
+    "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "memoryUsage": "A String", # Total memory in use (bytes).@OutputOnly
+    "id": "A String", # Relative name of the instance within the version. Example: instance-1.@OutputOnly
+    "vmUnlocked": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "averageLatency": 42, # Average latency (ms) over the last minute.@OutputOnly
+    "vmIp": "A String", # The IP address of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "qps": 3.14, # Average queries per second (QPS) over the last minute.@OutputOnly
+    "requests": 42, # Number of requests since this instance was started.@OutputOnly
+    "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "availability": "A String", # Availability of the instance.@OutputOnly
+    "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment.@OutputOnly
+    "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
   }</pre>
 </div>
 
@@ -204,7 +206,7 @@ <h3>Method Details</h3>
   <pre>Lists the instances of a version.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`. (required)
+  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
@@ -214,25 +216,26 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Response message for `Instances.ListInstances`.
+    { # Response message for Instances.ListInstances.
     "nextPageToken": "A String", # Continuation token for fetching the next page of results.
     "instances": [ # The instances belonging to the requested version.
       { # An Instance resource is the computing unit that App Engine uses to automatically scale an application.
-        "errors": 42, # Number of errors since this instance was started. @OutputOnly
-        "name": "A String", # Full path to the Instance resource in the API. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. @OutputOnly
-        "startTimestamp": "A String", # Time that this instance was started. @OutputOnly
-        "appEngineRelease": "A String", # App Engine release this instance is running on. @OutputOnly
-        "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "memoryUsage": "A String", # Total memory in use (bytes). @OutputOnly
-        "id": "A String", # Relative name of the instance within the version. Example: `instance-1`. @OutputOnly
-        "vmUnlocked": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "averageLatency": 42, # Average latency (ms) over the last minute. @OutputOnly
-        "qps": 3.14, # Average queries per second (QPS) over the last minute. @OutputOnly
-        "requests": 42, # Number of requests since this instance was started. @OutputOnly
-        "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "availability": "A String", # Availability of the instance. @OutputOnly
-        "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly
-        "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly
+        "errors": 42, # Number of errors since this instance was started.@OutputOnly
+        "name": "A String", # Full path to the Instance resource in the API. Example: apps/myapp/services/default/versions/v1/instances/instance-1.@OutputOnly
+        "startTimestamp": "A String", # Time that this instance was started.@OutputOnly
+        "appEngineRelease": "A String", # App Engine release this instance is running on.@OutputOnly
+        "vmId": "A String", # Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "memoryUsage": "A String", # Total memory in use (bytes).@OutputOnly
+        "id": "A String", # Relative name of the instance within the version. Example: instance-1.@OutputOnly
+        "vmUnlocked": True or False, # Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "averageLatency": 42, # Average latency (ms) over the last minute.@OutputOnly
+        "vmIp": "A String", # The IP address of this instance. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "qps": 3.14, # Average queries per second (QPS) over the last minute.@OutputOnly
+        "requests": 42, # Number of requests since this instance was started.@OutputOnly
+        "vmName": "A String", # Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "availability": "A String", # Availability of the instance.@OutputOnly
+        "vmZoneName": "A String", # Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment.@OutputOnly
+        "vmStatus": "A String", # Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.@OutputOnly
       },
     ],
   }</pre>
diff --git a/docs/dyn/appsactivity_v1.activities.html b/docs/dyn/appsactivity_v1.activities.html
index 4fceeae14c5..3595478ff85 100644
--- a/docs/dyn/appsactivity_v1.activities.html
+++ b/docs/dyn/appsactivity_v1.activities.html
@@ -147,8 +147,9 @@ <h3>Method Details</h3>
                       "url": "A String", # The URL of the photo.
                     },
                     "permissionId": "A String", # The permission ID associated with this user. Equivalent to the Drive API's permission ID for this user, returned as part of the Drive Permissions resource.
-                    "name": "A String", # The displayable name of the user.
+                    "isMe": True or False, # Whether the user is the authenticated user.
                     "isDeleted": True or False, # A boolean which indicates whether the specified User was deleted. If true, name, photo and permission_id will be omitted.
+                    "name": "A String", # The displayable name of the user.
                   },
                   "type": "A String", # Indicates how widely permissions are granted.
                 },
@@ -164,8 +165,9 @@ <h3>Method Details</h3>
                       "url": "A String", # The URL of the photo.
                     },
                     "permissionId": "A String", # The permission ID associated with this user. Equivalent to the Drive API's permission ID for this user, returned as part of the Drive Permissions resource.
-                    "name": "A String", # The displayable name of the user.
+                    "isMe": True or False, # Whether the user is the authenticated user.
                     "isDeleted": True or False, # A boolean which indicates whether the specified User was deleted. If true, name, photo and permission_id will be omitted.
+                    "name": "A String", # The displayable name of the user.
                   },
                   "type": "A String", # Indicates how widely permissions are granted.
                 },
@@ -177,8 +179,9 @@ <h3>Method Details</h3>
               "url": "A String", # The URL of the photo.
             },
             "permissionId": "A String", # The permission ID associated with this user. Equivalent to the Drive API's permission ID for this user, returned as part of the Drive Permissions resource.
-            "name": "A String", # The displayable name of the user.
+            "isMe": True or False, # Whether the user is the authenticated user.
             "isDeleted": True or False, # A boolean which indicates whether the specified User was deleted. If true, name, photo and permission_id will be omitted.
+            "name": "A String", # The displayable name of the user.
           },
           "eventTimeMillis": "A String", # The time at which the event occurred formatted as Unix time in milliseconds.
           "primaryEventType": "A String", # The main type of event that occurred.
@@ -227,8 +230,9 @@ <h3>Method Details</h3>
                         "url": "A String", # The URL of the photo.
                       },
                       "permissionId": "A String", # The permission ID associated with this user. Equivalent to the Drive API's permission ID for this user, returned as part of the Drive Permissions resource.
-                      "name": "A String", # The displayable name of the user.
+                      "isMe": True or False, # Whether the user is the authenticated user.
                       "isDeleted": True or False, # A boolean which indicates whether the specified User was deleted. If true, name, photo and permission_id will be omitted.
+                      "name": "A String", # The displayable name of the user.
                     },
                     "type": "A String", # Indicates how widely permissions are granted.
                   },
@@ -244,8 +248,9 @@ <h3>Method Details</h3>
                         "url": "A String", # The URL of the photo.
                       },
                       "permissionId": "A String", # The permission ID associated with this user. Equivalent to the Drive API's permission ID for this user, returned as part of the Drive Permissions resource.
-                      "name": "A String", # The displayable name of the user.
+                      "isMe": True or False, # Whether the user is the authenticated user.
                       "isDeleted": True or False, # A boolean which indicates whether the specified User was deleted. If true, name, photo and permission_id will be omitted.
+                      "name": "A String", # The displayable name of the user.
                     },
                     "type": "A String", # Indicates how widely permissions are granted.
                   },
@@ -257,8 +262,9 @@ <h3>Method Details</h3>
                 "url": "A String", # The URL of the photo.
               },
               "permissionId": "A String", # The permission ID associated with this user. Equivalent to the Drive API's permission ID for this user, returned as part of the Drive Permissions resource.
-              "name": "A String", # The displayable name of the user.
+              "isMe": True or False, # Whether the user is the authenticated user.
               "isDeleted": True or False, # A boolean which indicates whether the specified User was deleted. If true, name, photo and permission_id will be omitted.
+              "name": "A String", # The displayable name of the user.
             },
             "eventTimeMillis": "A String", # The time at which the event occurred formatted as Unix time in milliseconds.
             "primaryEventType": "A String", # The main type of event that occurred.
diff --git a/docs/dyn/bigquery_v2.jobs.html b/docs/dyn/bigquery_v2.jobs.html
index 647b13c48a9..c2666aa6e57 100644
--- a/docs/dyn/bigquery_v2.jobs.html
+++ b/docs/dyn/bigquery_v2.jobs.html
@@ -84,7 +84,7 @@ <h2>Instance Methods</h2>
   <code><a href="#getQueryResults">getQueryResults(projectId, jobId, timeoutMs=None, pageToken=None, maxResults=None, startIndex=None)</a></code></p>
 <p class="firstline">Retrieves the results of a query job.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(projectId, body=None, media_body=None)</a></code></p>
+  <code><a href="#insert">insert(projectId, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Starts a new asynchronous job. Requires the Can View project role.</p>
 <p class="toc_element">
   <code><a href="#list">list(projectId, projection=None, stateFilter=None, pageToken=None, allUsers=None, maxResults=None)</a></code></p>
@@ -162,6 +162,7 @@ <h3>Method Details</h3>
                 "name": "A String", # Human-readable name for stage.
               },
             ],
+            "statementType": "A String", # [Output-only, Experimental] The type of query statement, if valid.
             "totalBytesBilled": "A String", # [Output-only] Total bytes billed for the job.
             "totalBytesProcessed": "A String", # [Output-only] Total bytes processed for the job.
             "cacheHit": True or False, # [Output-only] Whether the query result was fetched from the query cache.
@@ -205,7 +206,7 @@ <h3>Method Details</h3>
                   "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                     # Object with schema name: TableFieldSchema
                   ],
-                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                   "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                   "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                   "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -228,10 +229,13 @@ <h3>Method Details</h3>
         "user_email": "A String", # [Output-only] Email address of the user who ran the job.
         "configuration": { # [Required] Describes the job configuration.
           "load": { # [Pick one] Configures a load job.
-            "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
+            "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
+              "A String",
+            ],
             "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
             "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. The separator can be any ISO-8859-1 single-byte character. To use a character in the range 128-255, you must encode the character as UTF8. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
             "autodetect": True or False, # [Experimental] Indicates if we should automatically infer the options and schema for CSV and JSON sources.
+            "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
             "destinationTable": { # [Required] The destination table to load the data into.
               "projectId": "A String", # [Required] The ID of the project containing this table.
               "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -239,9 +243,7 @@ <h3>Method Details</h3>
             },
             "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_APPEND. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.
             "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid.
-            "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
-              "A String",
-            ],
+            "nullMarker": "A String", # [Optional] This string will be interpreted as a null value when it appears in a CSV file. The default value is the empty string. Please refer to the documentation for further information.
             "allowJaggedRows": True or False, # [Optional] Accept rows that are missing trailing optional columns. The missing values are treated as nulls. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. Only applicable to CSV, ignored for other formats.
             "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
             "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. Each URI can contain one '*' wildcard character and it must come after the 'bucket' name.
@@ -262,7 +264,7 @@ <h3>Method Details</h3>
                   "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                     # Object with schema name: TableFieldSchema
                   ],
-                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                   "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                   "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                   "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -282,7 +284,7 @@ <h3>Method Details</h3>
               "projectId": "A String", # [Optional] The ID of the project containing this dataset.
               "datasetId": "A String", # [Required] A unique ID for this dataset, without the project name. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
             },
-            "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
+            "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
             "destinationTable": { # [Optional] Describes the table where the query results should be stored. If not present, a new table will be created to store the results.
               "projectId": "A String", # [Required] The ID of the project containing this table.
               "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -378,7 +380,7 @@ <h3>Method Details</h3>
                       "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                         # Object with schema name: TableFieldSchema
                       ],
-                      "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                      "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                       "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                       "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                       "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -498,6 +500,7 @@ <h3>Method Details</h3>
               "name": "A String", # Human-readable name for stage.
             },
           ],
+          "statementType": "A String", # [Output-only, Experimental] The type of query statement, if valid.
           "totalBytesBilled": "A String", # [Output-only] Total bytes billed for the job.
           "totalBytesProcessed": "A String", # [Output-only] Total bytes processed for the job.
           "cacheHit": True or False, # [Output-only] Whether the query result was fetched from the query cache.
@@ -541,7 +544,7 @@ <h3>Method Details</h3>
                 "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                   # Object with schema name: TableFieldSchema
                 ],
-                "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                 "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                 "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                 "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -564,10 +567,13 @@ <h3>Method Details</h3>
       "user_email": "A String", # [Output-only] Email address of the user who ran the job.
       "configuration": { # [Required] Describes the job configuration.
         "load": { # [Pick one] Configures a load job.
-          "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
+          "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
+            "A String",
+          ],
           "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
           "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. The separator can be any ISO-8859-1 single-byte character. To use a character in the range 128-255, you must encode the character as UTF8. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
           "autodetect": True or False, # [Experimental] Indicates if we should automatically infer the options and schema for CSV and JSON sources.
+          "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
           "destinationTable": { # [Required] The destination table to load the data into.
             "projectId": "A String", # [Required] The ID of the project containing this table.
             "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -575,9 +581,7 @@ <h3>Method Details</h3>
           },
           "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_APPEND. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.
           "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid.
-          "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
-            "A String",
-          ],
+          "nullMarker": "A String", # [Optional] This string will be interpreted as a null value when it appears in a CSV file. The default value is the empty string. Please refer to the documentation for further information.
           "allowJaggedRows": True or False, # [Optional] Accept rows that are missing trailing optional columns. The missing values are treated as nulls. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. Only applicable to CSV, ignored for other formats.
           "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
           "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. Each URI can contain one '*' wildcard character and it must come after the 'bucket' name.
@@ -598,7 +602,7 @@ <h3>Method Details</h3>
                 "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                   # Object with schema name: TableFieldSchema
                 ],
-                "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                 "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                 "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                 "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -618,7 +622,7 @@ <h3>Method Details</h3>
             "projectId": "A String", # [Optional] The ID of the project containing this dataset.
             "datasetId": "A String", # [Required] A unique ID for this dataset, without the project name. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
           },
-          "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
+          "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
           "destinationTable": { # [Optional] Describes the table where the query results should be stored. If not present, a new table will be created to store the results.
             "projectId": "A String", # [Required] The ID of the project containing this table.
             "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -714,7 +718,7 @@ <h3>Method Details</h3>
                     "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                       # Object with schema name: TableFieldSchema
                     ],
-                    "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                    "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                     "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                     "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                     "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -818,7 +822,7 @@ <h3>Method Details</h3>
           "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
             # Object with schema name: TableFieldSchema
           ],
-          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
           "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
           "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
           "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -829,7 +833,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(projectId, body=None, media_body=None)</code>
+    <code class="details" id="insert">insert(projectId, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Starts a new asynchronous job. Requires the Can View project role.
 
 Args:
@@ -891,6 +895,7 @@ <h3>Method Details</h3>
             "name": "A String", # Human-readable name for stage.
           },
         ],
+        "statementType": "A String", # [Output-only, Experimental] The type of query statement, if valid.
         "totalBytesBilled": "A String", # [Output-only] Total bytes billed for the job.
         "totalBytesProcessed": "A String", # [Output-only] Total bytes processed for the job.
         "cacheHit": True or False, # [Output-only] Whether the query result was fetched from the query cache.
@@ -934,7 +939,7 @@ <h3>Method Details</h3>
               "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                 # Object with schema name: TableFieldSchema
               ],
-              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
               "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
               "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
               "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -957,10 +962,13 @@ <h3>Method Details</h3>
     "user_email": "A String", # [Output-only] Email address of the user who ran the job.
     "configuration": { # [Required] Describes the job configuration.
       "load": { # [Pick one] Configures a load job.
-        "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
+        "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
+          "A String",
+        ],
         "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
         "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. The separator can be any ISO-8859-1 single-byte character. To use a character in the range 128-255, you must encode the character as UTF8. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
         "autodetect": True or False, # [Experimental] Indicates if we should automatically infer the options and schema for CSV and JSON sources.
+        "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
         "destinationTable": { # [Required] The destination table to load the data into.
           "projectId": "A String", # [Required] The ID of the project containing this table.
           "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -968,9 +976,7 @@ <h3>Method Details</h3>
         },
         "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_APPEND. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.
         "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid.
-        "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
-          "A String",
-        ],
+        "nullMarker": "A String", # [Optional] This string will be interpreted as a null value when it appears in a CSV file. The default value is the empty string. Please refer to the documentation for further information.
         "allowJaggedRows": True or False, # [Optional] Accept rows that are missing trailing optional columns. The missing values are treated as nulls. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. Only applicable to CSV, ignored for other formats.
         "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
         "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. Each URI can contain one '*' wildcard character and it must come after the 'bucket' name.
@@ -991,7 +997,7 @@ <h3>Method Details</h3>
               "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                 # Object with schema name: TableFieldSchema
               ],
-              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
               "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
               "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
               "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -1011,7 +1017,7 @@ <h3>Method Details</h3>
           "projectId": "A String", # [Optional] The ID of the project containing this dataset.
           "datasetId": "A String", # [Required] A unique ID for this dataset, without the project name. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
         },
-        "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
+        "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
         "destinationTable": { # [Optional] Describes the table where the query results should be stored. If not present, a new table will be created to store the results.
           "projectId": "A String", # [Required] The ID of the project containing this table.
           "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -1107,7 +1113,7 @@ <h3>Method Details</h3>
                   "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                     # Object with schema name: TableFieldSchema
                   ],
-                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                   "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                   "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                   "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -1160,6 +1166,7 @@ <h3>Method Details</h3>
   }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
@@ -1218,6 +1225,7 @@ <h3>Method Details</h3>
               "name": "A String", # Human-readable name for stage.
             },
           ],
+          "statementType": "A String", # [Output-only, Experimental] The type of query statement, if valid.
           "totalBytesBilled": "A String", # [Output-only] Total bytes billed for the job.
           "totalBytesProcessed": "A String", # [Output-only] Total bytes processed for the job.
           "cacheHit": True or False, # [Output-only] Whether the query result was fetched from the query cache.
@@ -1261,7 +1269,7 @@ <h3>Method Details</h3>
                 "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                   # Object with schema name: TableFieldSchema
                 ],
-                "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                 "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                 "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                 "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -1284,10 +1292,13 @@ <h3>Method Details</h3>
       "user_email": "A String", # [Output-only] Email address of the user who ran the job.
       "configuration": { # [Required] Describes the job configuration.
         "load": { # [Pick one] Configures a load job.
-          "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
+          "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
+            "A String",
+          ],
           "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
           "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. The separator can be any ISO-8859-1 single-byte character. To use a character in the range 128-255, you must encode the character as UTF8. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
           "autodetect": True or False, # [Experimental] Indicates if we should automatically infer the options and schema for CSV and JSON sources.
+          "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
           "destinationTable": { # [Required] The destination table to load the data into.
             "projectId": "A String", # [Required] The ID of the project containing this table.
             "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -1295,9 +1306,7 @@ <h3>Method Details</h3>
           },
           "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_APPEND. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.
           "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid.
-          "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
-            "A String",
-          ],
+          "nullMarker": "A String", # [Optional] This string will be interpreted as a null value when it appears in a CSV file. The default value is the empty string. Please refer to the documentation for further information.
           "allowJaggedRows": True or False, # [Optional] Accept rows that are missing trailing optional columns. The missing values are treated as nulls. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. Only applicable to CSV, ignored for other formats.
           "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
           "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. Each URI can contain one '*' wildcard character and it must come after the 'bucket' name.
@@ -1318,7 +1327,7 @@ <h3>Method Details</h3>
                 "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                   # Object with schema name: TableFieldSchema
                 ],
-                "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                 "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                 "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                 "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -1338,7 +1347,7 @@ <h3>Method Details</h3>
             "projectId": "A String", # [Optional] The ID of the project containing this dataset.
             "datasetId": "A String", # [Required] A unique ID for this dataset, without the project name. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
           },
-          "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
+          "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
           "destinationTable": { # [Optional] Describes the table where the query results should be stored. If not present, a new table will be created to store the results.
             "projectId": "A String", # [Required] The ID of the project containing this table.
             "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -1434,7 +1443,7 @@ <h3>Method Details</h3>
                     "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                       # Object with schema name: TableFieldSchema
                     ],
-                    "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                    "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                     "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                     "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                     "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -1568,6 +1577,7 @@ <h3>Method Details</h3>
                 "name": "A String", # Human-readable name for stage.
               },
             ],
+            "statementType": "A String", # [Output-only, Experimental] The type of query statement, if valid.
             "totalBytesBilled": "A String", # [Output-only] Total bytes billed for the job.
             "totalBytesProcessed": "A String", # [Output-only] Total bytes processed for the job.
             "cacheHit": True or False, # [Output-only] Whether the query result was fetched from the query cache.
@@ -1611,7 +1621,7 @@ <h3>Method Details</h3>
                   "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                     # Object with schema name: TableFieldSchema
                   ],
-                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                   "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                   "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                   "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -1634,10 +1644,13 @@ <h3>Method Details</h3>
         "user_email": "A String", # [Full-projection-only] Email address of the user who ran the job.
         "configuration": { # [Full-projection-only] Specifies the job configuration.
           "load": { # [Pick one] Configures a load job.
-            "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
+            "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
+              "A String",
+            ],
             "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
             "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. The separator can be any ISO-8859-1 single-byte character. To use a character in the range 128-255, you must encode the character as UTF8. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
             "autodetect": True or False, # [Experimental] Indicates if we should automatically infer the options and schema for CSV and JSON sources.
+            "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify "AVRO". The default value is CSV.
             "destinationTable": { # [Required] The destination table to load the data into.
               "projectId": "A String", # [Required] The ID of the project containing this table.
               "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -1645,9 +1658,7 @@ <h3>Method Details</h3>
             },
             "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_APPEND. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.
             "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid.
-            "schemaUpdateOptions": [ # [Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.
-              "A String",
-            ],
+            "nullMarker": "A String", # [Optional] This string will be interpreted as a null value when it appears in a CSV file. The default value is the empty string. Please refer to the documentation for further information.
             "allowJaggedRows": True or False, # [Optional] Accept rows that are missing trailing optional columns. The missing values are treated as nulls. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. Only applicable to CSV, ignored for other formats.
             "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
             "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. Each URI can contain one '*' wildcard character and it must come after the 'bucket' name.
@@ -1668,7 +1679,7 @@ <h3>Method Details</h3>
                   "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                     # Object with schema name: TableFieldSchema
                   ],
-                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                  "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                   "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                   "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                   "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -1688,7 +1699,7 @@ <h3>Method Details</h3>
               "projectId": "A String", # [Optional] The ID of the project containing this dataset.
               "datasetId": "A String", # [Required] A unique ID for this dataset, without the project name. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
             },
-            "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
+            "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
             "destinationTable": { # [Optional] Describes the table where the query results should be stored. If not present, a new table will be created to store the results.
               "projectId": "A String", # [Required] The ID of the project containing this table.
               "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
@@ -1784,7 +1795,7 @@ <h3>Method Details</h3>
                       "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                         # Object with schema name: TableFieldSchema
                       ],
-                      "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+                      "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
                       "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
                       "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
                       "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -1877,7 +1888,7 @@ <h3>Method Details</h3>
       "projectId": "A String", # [Optional] The ID of the project containing this dataset.
       "datasetId": "A String", # [Required] A unique ID for this dataset, without the project name. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
     },
-    "useLegacySql": true, # [Experimental] Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
+    "useLegacySql": true, # Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the values of allowLargeResults and flattenResults are ignored; query will be run as if allowLargeResults is true and flattenResults is false.
     "maxResults": 42, # [Optional] The maximum number of rows of data to return per page of results. Setting this flag to a small value such as 1000 and then paging through results might improve reliability when the query result set is large. In addition to this limit, responses are also limited to 10 MB. By default, there is no maximum row count, and only the byte limit applies.
     "queryParameters": [ # [Experimental] Query parameters for Standard SQL queries.
       {
@@ -1947,7 +1958,7 @@ <h3>Method Details</h3>
           "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
             # Object with schema name: TableFieldSchema
           ],
-          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
           "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
           "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
           "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
diff --git a/docs/dyn/bigquery_v2.tables.html b/docs/dyn/bigquery_v2.tables.html
index d0906dca1fb..091ae9a872b 100644
--- a/docs/dyn/bigquery_v2.tables.html
+++ b/docs/dyn/bigquery_v2.tables.html
@@ -124,15 +124,8 @@ <h3>Method Details</h3>
       "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch.
       "description": "A String", # [Optional] A user-friendly description of this table.
       "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch.
-      "view": { # [Optional] The view definition.
-        "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
-        "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
-        "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
-          {
-            "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
-            "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
-          },
-        ],
+      "labels": { # [Experimental] The labels associated with this table. You can use these to organize and group your tables. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.
+        "a_key": "A String",
       },
       "externalDataConfiguration": { # [Optional] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.
         "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.
@@ -182,7 +175,7 @@ <h3>Method Details</h3>
               "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                 # Object with schema name: TableFieldSchema
               ],
-              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
               "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
               "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
               "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -198,6 +191,16 @@ <h3>Method Details</h3>
       "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer.
       "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer.
       "etag": "A String", # [Output-only] A hash of this resource.
+      "view": { # [Optional] The view definition.
+        "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
+        "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
+        "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
+          {
+            "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
+            "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
+          },
+        ],
+      },
       "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset.
       "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer.
         "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer.
@@ -216,7 +219,7 @@ <h3>Method Details</h3>
             "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
               # Object with schema name: TableFieldSchema
             ],
-            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
             "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
             "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
             "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -245,15 +248,8 @@ <h3>Method Details</h3>
     "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch.
     "description": "A String", # [Optional] A user-friendly description of this table.
     "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch.
-    "view": { # [Optional] The view definition.
-      "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
-      "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
-      "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
-        {
-          "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
-          "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
-        },
-      ],
+    "labels": { # [Experimental] The labels associated with this table. You can use these to organize and group your tables. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.
+      "a_key": "A String",
     },
     "externalDataConfiguration": { # [Optional] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.
       "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.
@@ -303,7 +299,7 @@ <h3>Method Details</h3>
             "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
               # Object with schema name: TableFieldSchema
             ],
-            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
             "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
             "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
             "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -319,6 +315,16 @@ <h3>Method Details</h3>
     "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer.
     "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer.
     "etag": "A String", # [Output-only] A hash of this resource.
+    "view": { # [Optional] The view definition.
+      "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
+      "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
+      "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
+        {
+          "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
+          "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
+        },
+      ],
+    },
     "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset.
     "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer.
       "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer.
@@ -337,7 +343,7 @@ <h3>Method Details</h3>
           "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
             # Object with schema name: TableFieldSchema
           ],
-          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
           "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
           "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
           "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -359,15 +365,8 @@ <h3>Method Details</h3>
       "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch.
       "description": "A String", # [Optional] A user-friendly description of this table.
       "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch.
-      "view": { # [Optional] The view definition.
-        "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
-        "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
-        "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
-          {
-            "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
-            "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
-          },
-        ],
+      "labels": { # [Experimental] The labels associated with this table. You can use these to organize and group your tables. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.
+        "a_key": "A String",
       },
       "externalDataConfiguration": { # [Optional] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.
         "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.
@@ -417,7 +416,7 @@ <h3>Method Details</h3>
               "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                 # Object with schema name: TableFieldSchema
               ],
-              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
               "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
               "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
               "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -433,6 +432,16 @@ <h3>Method Details</h3>
       "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer.
       "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer.
       "etag": "A String", # [Output-only] A hash of this resource.
+      "view": { # [Optional] The view definition.
+        "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
+        "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
+        "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
+          {
+            "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
+            "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
+          },
+        ],
+      },
       "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset.
       "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer.
         "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer.
@@ -451,7 +460,7 @@ <h3>Method Details</h3>
             "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
               # Object with schema name: TableFieldSchema
             ],
-            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
             "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
             "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
             "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -482,15 +491,18 @@ <h3>Method Details</h3>
     "nextPageToken": "A String", # A token to request the next page of results.
     "tables": [ # Tables in the requested dataset.
       {
-        "friendlyName": "A String", # The user-friendly name for this table.
         "kind": "bigquery#table", # The resource type.
-        "type": "A String", # The type of table. Possible values are: TABLE, VIEW.
-        "id": "A String", # An opaque ID of the table
+        "labels": { # [Experimental] The labels associated with this table. You can use these to organize and group your tables.
+          "a_key": "A String",
+        },
         "tableReference": { # A reference uniquely identifying the table.
           "projectId": "A String", # [Required] The ID of the project containing this table.
           "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
           "datasetId": "A String", # [Required] The ID of the dataset containing this table.
         },
+        "friendlyName": "A String", # The user-friendly name for this table.
+        "type": "A String", # The type of table. Possible values are: TABLE, VIEW.
+        "id": "A String", # An opaque ID of the table
       },
     ],
     "kind": "bigquery#tableList", # The type of list.
@@ -529,15 +541,8 @@ <h3>Method Details</h3>
     "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch.
     "description": "A String", # [Optional] A user-friendly description of this table.
     "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch.
-    "view": { # [Optional] The view definition.
-      "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
-      "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
-      "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
-        {
-          "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
-          "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
-        },
-      ],
+    "labels": { # [Experimental] The labels associated with this table. You can use these to organize and group your tables. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.
+      "a_key": "A String",
     },
     "externalDataConfiguration": { # [Optional] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.
       "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.
@@ -587,7 +592,7 @@ <h3>Method Details</h3>
             "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
               # Object with schema name: TableFieldSchema
             ],
-            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
             "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
             "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
             "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -603,6 +608,16 @@ <h3>Method Details</h3>
     "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer.
     "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer.
     "etag": "A String", # [Output-only] A hash of this resource.
+    "view": { # [Optional] The view definition.
+      "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
+      "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
+      "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
+        {
+          "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
+          "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
+        },
+      ],
+    },
     "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset.
     "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer.
       "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer.
@@ -621,7 +636,7 @@ <h3>Method Details</h3>
           "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
             # Object with schema name: TableFieldSchema
           ],
-          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
           "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
           "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
           "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -643,15 +658,8 @@ <h3>Method Details</h3>
       "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch.
       "description": "A String", # [Optional] A user-friendly description of this table.
       "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch.
-      "view": { # [Optional] The view definition.
-        "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
-        "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
-        "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
-          {
-            "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
-            "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
-          },
-        ],
+      "labels": { # [Experimental] The labels associated with this table. You can use these to organize and group your tables. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.
+        "a_key": "A String",
       },
       "externalDataConfiguration": { # [Optional] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.
         "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.
@@ -701,7 +709,7 @@ <h3>Method Details</h3>
               "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                 # Object with schema name: TableFieldSchema
               ],
-              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
               "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
               "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
               "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -717,6 +725,16 @@ <h3>Method Details</h3>
       "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer.
       "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer.
       "etag": "A String", # [Output-only] A hash of this resource.
+      "view": { # [Optional] The view definition.
+        "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
+        "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
+        "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
+          {
+            "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
+            "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
+          },
+        ],
+      },
       "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset.
       "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer.
         "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer.
@@ -735,7 +753,7 @@ <h3>Method Details</h3>
             "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
               # Object with schema name: TableFieldSchema
             ],
-            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
             "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
             "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
             "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -765,15 +783,8 @@ <h3>Method Details</h3>
     "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch.
     "description": "A String", # [Optional] A user-friendly description of this table.
     "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch.
-    "view": { # [Optional] The view definition.
-      "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
-      "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
-      "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
-        {
-          "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
-          "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
-        },
-      ],
+    "labels": { # [Experimental] The labels associated with this table. You can use these to organize and group your tables. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.
+      "a_key": "A String",
     },
     "externalDataConfiguration": { # [Optional] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.
       "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.
@@ -823,7 +834,7 @@ <h3>Method Details</h3>
             "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
               # Object with schema name: TableFieldSchema
             ],
-            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
             "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
             "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
             "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -839,6 +850,16 @@ <h3>Method Details</h3>
     "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer.
     "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer.
     "etag": "A String", # [Output-only] A hash of this resource.
+    "view": { # [Optional] The view definition.
+      "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
+      "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
+      "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
+        {
+          "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
+          "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
+        },
+      ],
+    },
     "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset.
     "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer.
       "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer.
@@ -857,7 +878,7 @@ <h3>Method Details</h3>
           "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
             # Object with schema name: TableFieldSchema
           ],
-          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+          "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
           "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
           "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
           "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -879,15 +900,8 @@ <h3>Method Details</h3>
       "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch.
       "description": "A String", # [Optional] A user-friendly description of this table.
       "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch.
-      "view": { # [Optional] The view definition.
-        "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
-        "useLegacySql": True or False, # [Experimental] Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
-        "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
-          {
-            "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
-            "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
-          },
-        ],
+      "labels": { # [Experimental] The labels associated with this table. You can use these to organize and group your tables. Label keys and values can be no longer than 63 characters, can only contain letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and must be unique within a dataset. Both keys and values are additionally constrained to be <= 128 bytes in size.
+        "a_key": "A String",
       },
       "externalDataConfiguration": { # [Optional] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.
         "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. This setting is ignored for Google Cloud Bigtable, Google Cloud Datastore backups and Avro formats.
@@ -937,7 +951,7 @@ <h3>Method Details</h3>
               "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
                 # Object with schema name: TableFieldSchema
               ],
-              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+              "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
               "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
               "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
               "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
@@ -953,6 +967,16 @@ <h3>Method Details</h3>
       "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer.
       "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer.
       "etag": "A String", # [Output-only] A hash of this resource.
+      "view": { # [Optional] The view definition.
+        "query": "A String", # [Required] A query that BigQuery executes when the view is referenced.
+        "useLegacySql": True or False, # Specifies whether to use BigQuery's legacy SQL for this view. The default value is true. If set to false, the view will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ Queries and views that reference this view must use the same flag value.
+        "userDefinedFunctionResources": [ # [Experimental] Describes user-defined function resources used in the query.
+          {
+            "resourceUri": "A String", # [Pick one] A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
+            "inlineCode": "A String", # [Pick one] An inline resource that contains code for a user-defined function (UDF). Providing a inline code resource is equivalent to providing a URI for a file containing the same code.
+          },
+        ],
+      },
       "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset.
       "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer.
         "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer.
@@ -971,7 +995,7 @@ <h3>Method Details</h3>
             "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
               # Object with schema name: TableFieldSchema
             ],
-            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, DATE, TIME, DATETIME, or RECORD (where RECORD indicates that the field contains a nested schema).
+            "type": "A String", # [Required] The field data type. Possible values include STRING, BYTES, INTEGER, INT64 (same as INTEGER), FLOAT, FLOAT64 (same as FLOAT), BOOLEAN, BOOL (same as BOOLEAN), TIMESTAMP, DATE, TIME, DATETIME, RECORD (where RECORD indicates that the field contains a nested schema) or STRUCT (same as RECORD).
             "description": "A String", # [Optional] The field description. The maximum length is 16K characters.
             "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters.
             "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
diff --git a/docs/dyn/books_v1.notification.html b/docs/dyn/books_v1.notification.html
index 250a7765ce2..31252a0be9b 100644
--- a/docs/dyn/books_v1.notification.html
+++ b/docs/dyn/books_v1.notification.html
@@ -102,6 +102,7 @@ <h3>Method Details</h3>
       "A String",
     ],
     "reason": "A String",
+    "notificationGroup": "A String",
     "targetUrl": "A String",
     "notification_type": "A String",
     "pcampaign_id": "A String",
diff --git a/docs/dyn/books_v1.series.html b/docs/dyn/books_v1.series.html
index 52426c3342b..011b1541679 100644
--- a/docs/dyn/books_v1.series.html
+++ b/docs/dyn/books_v1.series.html
@@ -94,7 +94,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     {
-    "series": [ # Series info list. The client always expects this element in the JSON output, hence declared here as OutputAlways.
+    "series": [
       {
         "seriesId": "A String",
         "bannerImageUrl": "A String",
diff --git a/docs/dyn/cloudbuild_v1.operations.html b/docs/dyn/cloudbuild_v1.operations.html
index 493f9a603aa..88d02631fc5 100644
--- a/docs/dyn/cloudbuild_v1.operations.html
+++ b/docs/dyn/cloudbuild_v1.operations.html
@@ -74,6 +74,9 @@
 
 <h1><a href="cloudbuild_v1.html">Google Cloud Container Builder API</a> . <a href="cloudbuild_v1.operations.html">operations</a></h1>
 <h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#cancel">cancel(name, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Starts asynchronous cancellation on a long-running operation.  The server</p>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the latest state of a long-running operation.  Clients can use this</p>
@@ -84,6 +87,47 @@ <h2>Instance Methods</h2>
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="cancel">cancel(name, body, x__xgafv=None)</code>
+  <pre>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`.
+
+Args:
+  name: string, The name of the operation resource to be cancelled. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # The request message for Operations.CancelOperation.
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="get">get(name, x__xgafv=None)</code>
   <pre>Gets the latest state of a long-running operation.  Clients can use this
diff --git a/docs/dyn/cloudbuild_v1.projects.builds.html b/docs/dyn/cloudbuild_v1.projects.builds.html
index 1ab68eb3bf9..8ae8b6ef60f 100644
--- a/docs/dyn/cloudbuild_v1.projects.builds.html
+++ b/docs/dyn/cloudbuild_v1.projects.builds.html
@@ -130,6 +130,9 @@ <h3>Method Details</h3>
     "status": "A String", # Status of the build.
         # @OutputOnly
     "finishTime": "A String", # 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
     "timeout": "A String", # 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
@@ -157,7 +160,7 @@ <h3>Method Details</h3>
         "A String",
       ],
     },
-    "createTime": "A String", # Time at which the build was created.
+    "createTime": "A String", # Time at which the request to create the build was received.
         # @OutputOnly
     "id": "A String", # Unique identifier of the build.
         # @OutputOnly
@@ -186,6 +189,9 @@ <h3>Method Details</h3>
         "commitSha": "A String", # Explicit commit SHA to build.
       },
     },
+    "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+        # triggered automatically.
+        # @OutputOnly
     "steps": [ # Describes the operations to be performed on the workspace.
       { # BuildStep describes a step to perform in the build pipeline.
         "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -197,10 +203,9 @@ <h3>Method Details</h3>
         ],
         "name": "A String", # The name of the container image that will run this particular build step.
             #
-            # If the image is already available in the host's
-            # Docker daemon's cache, it will be run directly. If not, the host will
-            # attempt to pull the image first, using the builder service account's
-            # credentials if necessary.
+            # If the image is already available in the host's Docker daemon's cache, it
+            # will be run directly. If not, the host will attempt to pull the image
+            # first, using the builder service account's credentials if necessary.
             #
             # The Docker daemon's cache will already have the latest versions of all of
             # the officially supported build steps
@@ -284,8 +289,7 @@ <h3>Method Details</h3>
     "images": [ # A list of images to be pushed upon the successful completion of all build
         # steps.
         #
-        # The images will be pushed using the builder
-        # service account's credentials.
+        # The images will be pushed using the builder service account's credentials.
         #
         # The digests of the pushed images will be stored in the Build resource's
         # results field.
@@ -336,6 +340,9 @@ <h3>Method Details</h3>
   "status": "A String", # Status of the build.
       # @OutputOnly
   "finishTime": "A String", # 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
   "timeout": "A String", # 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
@@ -363,7 +370,7 @@ <h3>Method Details</h3>
       "A String",
     ],
   },
-  "createTime": "A String", # Time at which the build was created.
+  "createTime": "A String", # Time at which the request to create the build was received.
       # @OutputOnly
   "id": "A String", # Unique identifier of the build.
       # @OutputOnly
@@ -392,6 +399,9 @@ <h3>Method Details</h3>
       "commitSha": "A String", # Explicit commit SHA to build.
     },
   },
+  "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+      # triggered automatically.
+      # @OutputOnly
   "steps": [ # Describes the operations to be performed on the workspace.
     { # BuildStep describes a step to perform in the build pipeline.
       "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -403,10 +413,9 @@ <h3>Method Details</h3>
       ],
       "name": "A String", # The name of the container image that will run this particular build step.
           #
-          # If the image is already available in the host's
-          # Docker daemon's cache, it will be run directly. If not, the host will
-          # attempt to pull the image first, using the builder service account's
-          # credentials if necessary.
+          # If the image is already available in the host's Docker daemon's cache, it
+          # will be run directly. If not, the host will attempt to pull the image
+          # first, using the builder service account's credentials if necessary.
           #
           # The Docker daemon's cache will already have the latest versions of all of
           # the officially supported build steps
@@ -490,8 +499,7 @@ <h3>Method Details</h3>
   "images": [ # A list of images to be pushed upon the successful completion of all build
       # steps.
       # 
-      # The images will be pushed using the builder
-      # service account's credentials.
+      # The images will be pushed using the builder service account's credentials.
       # 
       # The digests of the pushed images will be stored in the Build resource's
       # results field.
@@ -644,6 +652,9 @@ <h3>Method Details</h3>
     "status": "A String", # Status of the build.
         # @OutputOnly
     "finishTime": "A String", # 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
     "timeout": "A String", # 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
@@ -671,7 +682,7 @@ <h3>Method Details</h3>
         "A String",
       ],
     },
-    "createTime": "A String", # Time at which the build was created.
+    "createTime": "A String", # Time at which the request to create the build was received.
         # @OutputOnly
     "id": "A String", # Unique identifier of the build.
         # @OutputOnly
@@ -700,6 +711,9 @@ <h3>Method Details</h3>
         "commitSha": "A String", # Explicit commit SHA to build.
       },
     },
+    "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+        # triggered automatically.
+        # @OutputOnly
     "steps": [ # Describes the operations to be performed on the workspace.
       { # BuildStep describes a step to perform in the build pipeline.
         "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -711,10 +725,9 @@ <h3>Method Details</h3>
         ],
         "name": "A String", # The name of the container image that will run this particular build step.
             #
-            # If the image is already available in the host's
-            # Docker daemon's cache, it will be run directly. If not, the host will
-            # attempt to pull the image first, using the builder service account's
-            # credentials if necessary.
+            # If the image is already available in the host's Docker daemon's cache, it
+            # will be run directly. If not, the host will attempt to pull the image
+            # first, using the builder service account's credentials if necessary.
             #
             # The Docker daemon's cache will already have the latest versions of all of
             # the officially supported build steps
@@ -798,8 +811,7 @@ <h3>Method Details</h3>
     "images": [ # A list of images to be pushed upon the successful completion of all build
         # steps.
         #
-        # The images will be pushed using the builder
-        # service account's credentials.
+        # The images will be pushed using the builder service account's credentials.
         #
         # The digests of the pushed images will be stored in the Build resource's
         # results field.
@@ -860,6 +872,9 @@ <h3>Method Details</h3>
         "status": "A String", # Status of the build.
             # @OutputOnly
         "finishTime": "A String", # 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
         "timeout": "A String", # 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
@@ -887,7 +902,7 @@ <h3>Method Details</h3>
             "A String",
           ],
         },
-        "createTime": "A String", # Time at which the build was created.
+        "createTime": "A String", # Time at which the request to create the build was received.
             # @OutputOnly
         "id": "A String", # Unique identifier of the build.
             # @OutputOnly
@@ -916,6 +931,9 @@ <h3>Method Details</h3>
             "commitSha": "A String", # Explicit commit SHA to build.
           },
         },
+        "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+            # triggered automatically.
+            # @OutputOnly
         "steps": [ # Describes the operations to be performed on the workspace.
           { # BuildStep describes a step to perform in the build pipeline.
             "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -927,10 +945,9 @@ <h3>Method Details</h3>
             ],
             "name": "A String", # The name of the container image that will run this particular build step.
                 #
-                # If the image is already available in the host's
-                # Docker daemon's cache, it will be run directly. If not, the host will
-                # attempt to pull the image first, using the builder service account's
-                # credentials if necessary.
+                # If the image is already available in the host's Docker daemon's cache, it
+                # will be run directly. If not, the host will attempt to pull the image
+                # first, using the builder service account's credentials if necessary.
                 #
                 # The Docker daemon's cache will already have the latest versions of all of
                 # the officially supported build steps
@@ -1014,8 +1031,7 @@ <h3>Method Details</h3>
         "images": [ # A list of images to be pushed upon the successful completion of all build
             # steps.
             #
-            # The images will be pushed using the builder
-            # service account's credentials.
+            # The images will be pushed using the builder service account's credentials.
             #
             # The digests of the pushed images will be stored in the Build resource's
             # results field.
diff --git a/docs/dyn/cloudbuild_v1.projects.triggers.html b/docs/dyn/cloudbuild_v1.projects.triggers.html
index 95aecd562e5..bf987496cec 100644
--- a/docs/dyn/cloudbuild_v1.projects.triggers.html
+++ b/docs/dyn/cloudbuild_v1.projects.triggers.html
@@ -129,6 +129,9 @@ <h3>Method Details</h3>
       "status": "A String", # Status of the build.
           # @OutputOnly
       "finishTime": "A String", # 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
       "timeout": "A String", # 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
@@ -156,7 +159,7 @@ <h3>Method Details</h3>
           "A String",
         ],
       },
-      "createTime": "A String", # Time at which the build was created.
+      "createTime": "A String", # Time at which the request to create the build was received.
           # @OutputOnly
       "id": "A String", # Unique identifier of the build.
           # @OutputOnly
@@ -185,6 +188,9 @@ <h3>Method Details</h3>
           "commitSha": "A String", # Explicit commit SHA to build.
         },
       },
+      "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+          # triggered automatically.
+          # @OutputOnly
       "steps": [ # Describes the operations to be performed on the workspace.
         { # BuildStep describes a step to perform in the build pipeline.
           "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -196,10 +202,9 @@ <h3>Method Details</h3>
           ],
           "name": "A String", # The name of the container image that will run this particular build step.
               #
-              # If the image is already available in the host's
-              # Docker daemon's cache, it will be run directly. If not, the host will
-              # attempt to pull the image first, using the builder service account's
-              # credentials if necessary.
+              # If the image is already available in the host's Docker daemon's cache, it
+              # will be run directly. If not, the host will attempt to pull the image
+              # first, using the builder service account's credentials if necessary.
               #
               # The Docker daemon's cache will already have the latest versions of all of
               # the officially supported build steps
@@ -283,8 +288,7 @@ <h3>Method Details</h3>
       "images": [ # A list of images to be pushed upon the successful completion of all build
           # steps.
           #
-          # The images will be pushed using the builder
-          # service account's credentials.
+          # The images will be pushed using the builder service account's credentials.
           #
           # The digests of the pushed images will be stored in the Build resource's
           # results field.
@@ -355,6 +359,9 @@ <h3>Method Details</h3>
         "status": "A String", # Status of the build.
             # @OutputOnly
         "finishTime": "A String", # 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
         "timeout": "A String", # 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
@@ -382,7 +389,7 @@ <h3>Method Details</h3>
             "A String",
           ],
         },
-        "createTime": "A String", # Time at which the build was created.
+        "createTime": "A String", # Time at which the request to create the build was received.
             # @OutputOnly
         "id": "A String", # Unique identifier of the build.
             # @OutputOnly
@@ -411,6 +418,9 @@ <h3>Method Details</h3>
             "commitSha": "A String", # Explicit commit SHA to build.
           },
         },
+        "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+            # triggered automatically.
+            # @OutputOnly
         "steps": [ # Describes the operations to be performed on the workspace.
           { # BuildStep describes a step to perform in the build pipeline.
             "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -422,10 +432,9 @@ <h3>Method Details</h3>
             ],
             "name": "A String", # The name of the container image that will run this particular build step.
                 #
-                # If the image is already available in the host's
-                # Docker daemon's cache, it will be run directly. If not, the host will
-                # attempt to pull the image first, using the builder service account's
-                # credentials if necessary.
+                # If the image is already available in the host's Docker daemon's cache, it
+                # will be run directly. If not, the host will attempt to pull the image
+                # first, using the builder service account's credentials if necessary.
                 #
                 # The Docker daemon's cache will already have the latest versions of all of
                 # the officially supported build steps
@@ -509,8 +518,7 @@ <h3>Method Details</h3>
         "images": [ # A list of images to be pushed upon the successful completion of all build
             # steps.
             #
-            # The images will be pushed using the builder
-            # service account's credentials.
+            # The images will be pushed using the builder service account's credentials.
             #
             # The digests of the pushed images will be stored in the Build resource's
             # results field.
@@ -620,6 +628,9 @@ <h3>Method Details</h3>
         "status": "A String", # Status of the build.
             # @OutputOnly
         "finishTime": "A String", # 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
         "timeout": "A String", # 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
@@ -647,7 +658,7 @@ <h3>Method Details</h3>
             "A String",
           ],
         },
-        "createTime": "A String", # Time at which the build was created.
+        "createTime": "A String", # Time at which the request to create the build was received.
             # @OutputOnly
         "id": "A String", # Unique identifier of the build.
             # @OutputOnly
@@ -676,6 +687,9 @@ <h3>Method Details</h3>
             "commitSha": "A String", # Explicit commit SHA to build.
           },
         },
+        "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+            # triggered automatically.
+            # @OutputOnly
         "steps": [ # Describes the operations to be performed on the workspace.
           { # BuildStep describes a step to perform in the build pipeline.
             "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -687,10 +701,9 @@ <h3>Method Details</h3>
             ],
             "name": "A String", # The name of the container image that will run this particular build step.
                 #
-                # If the image is already available in the host's
-                # Docker daemon's cache, it will be run directly. If not, the host will
-                # attempt to pull the image first, using the builder service account's
-                # credentials if necessary.
+                # If the image is already available in the host's Docker daemon's cache, it
+                # will be run directly. If not, the host will attempt to pull the image
+                # first, using the builder service account's credentials if necessary.
                 #
                 # The Docker daemon's cache will already have the latest versions of all of
                 # the officially supported build steps
@@ -774,8 +787,7 @@ <h3>Method Details</h3>
         "images": [ # A list of images to be pushed upon the successful completion of all build
             # steps.
             #
-            # The images will be pushed using the builder
-            # service account's credentials.
+            # The images will be pushed using the builder service account's credentials.
             #
             # The digests of the pushed images will be stored in the Build resource's
             # results field.
@@ -857,6 +869,9 @@ <h3>Method Details</h3>
             "status": "A String", # Status of the build.
                 # @OutputOnly
             "finishTime": "A String", # 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
             "timeout": "A String", # 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
@@ -884,7 +899,7 @@ <h3>Method Details</h3>
                 "A String",
               ],
             },
-            "createTime": "A String", # Time at which the build was created.
+            "createTime": "A String", # Time at which the request to create the build was received.
                 # @OutputOnly
             "id": "A String", # Unique identifier of the build.
                 # @OutputOnly
@@ -913,6 +928,9 @@ <h3>Method Details</h3>
                 "commitSha": "A String", # Explicit commit SHA to build.
               },
             },
+            "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+                # triggered automatically.
+                # @OutputOnly
             "steps": [ # Describes the operations to be performed on the workspace.
               { # BuildStep describes a step to perform in the build pipeline.
                 "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -924,10 +942,9 @@ <h3>Method Details</h3>
                 ],
                 "name": "A String", # The name of the container image that will run this particular build step.
                     #
-                    # If the image is already available in the host's
-                    # Docker daemon's cache, it will be run directly. If not, the host will
-                    # attempt to pull the image first, using the builder service account's
-                    # credentials if necessary.
+                    # If the image is already available in the host's Docker daemon's cache, it
+                    # will be run directly. If not, the host will attempt to pull the image
+                    # first, using the builder service account's credentials if necessary.
                     #
                     # The Docker daemon's cache will already have the latest versions of all of
                     # the officially supported build steps
@@ -1011,8 +1028,7 @@ <h3>Method Details</h3>
             "images": [ # A list of images to be pushed upon the successful completion of all build
                 # steps.
                 #
-                # The images will be pushed using the builder
-                # service account's credentials.
+                # The images will be pushed using the builder service account's credentials.
                 #
                 # The digests of the pushed images will be stored in the Build resource's
                 # results field.
@@ -1090,6 +1106,9 @@ <h3>Method Details</h3>
       "status": "A String", # Status of the build.
           # @OutputOnly
       "finishTime": "A String", # 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
       "timeout": "A String", # 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
@@ -1117,7 +1136,7 @@ <h3>Method Details</h3>
           "A String",
         ],
       },
-      "createTime": "A String", # Time at which the build was created.
+      "createTime": "A String", # Time at which the request to create the build was received.
           # @OutputOnly
       "id": "A String", # Unique identifier of the build.
           # @OutputOnly
@@ -1146,6 +1165,9 @@ <h3>Method Details</h3>
           "commitSha": "A String", # Explicit commit SHA to build.
         },
       },
+      "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+          # triggered automatically.
+          # @OutputOnly
       "steps": [ # Describes the operations to be performed on the workspace.
         { # BuildStep describes a step to perform in the build pipeline.
           "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -1157,10 +1179,9 @@ <h3>Method Details</h3>
           ],
           "name": "A String", # The name of the container image that will run this particular build step.
               #
-              # If the image is already available in the host's
-              # Docker daemon's cache, it will be run directly. If not, the host will
-              # attempt to pull the image first, using the builder service account's
-              # credentials if necessary.
+              # If the image is already available in the host's Docker daemon's cache, it
+              # will be run directly. If not, the host will attempt to pull the image
+              # first, using the builder service account's credentials if necessary.
               #
               # The Docker daemon's cache will already have the latest versions of all of
               # the officially supported build steps
@@ -1244,8 +1265,7 @@ <h3>Method Details</h3>
       "images": [ # A list of images to be pushed upon the successful completion of all build
           # steps.
           #
-          # The images will be pushed using the builder
-          # service account's credentials.
+          # The images will be pushed using the builder service account's credentials.
           #
           # The digests of the pushed images will be stored in the Build resource's
           # results field.
@@ -1316,6 +1336,9 @@ <h3>Method Details</h3>
         "status": "A String", # Status of the build.
             # @OutputOnly
         "finishTime": "A String", # 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
         "timeout": "A String", # 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
@@ -1343,7 +1366,7 @@ <h3>Method Details</h3>
             "A String",
           ],
         },
-        "createTime": "A String", # Time at which the build was created.
+        "createTime": "A String", # Time at which the request to create the build was received.
             # @OutputOnly
         "id": "A String", # Unique identifier of the build.
             # @OutputOnly
@@ -1372,6 +1395,9 @@ <h3>Method Details</h3>
             "commitSha": "A String", # Explicit commit SHA to build.
           },
         },
+        "buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
+            # triggered automatically.
+            # @OutputOnly
         "steps": [ # Describes the operations to be performed on the workspace.
           { # BuildStep describes a step to perform in the build pipeline.
             "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
@@ -1383,10 +1409,9 @@ <h3>Method Details</h3>
             ],
             "name": "A String", # The name of the container image that will run this particular build step.
                 #
-                # If the image is already available in the host's
-                # Docker daemon's cache, it will be run directly. If not, the host will
-                # attempt to pull the image first, using the builder service account's
-                # credentials if necessary.
+                # If the image is already available in the host's Docker daemon's cache, it
+                # will be run directly. If not, the host will attempt to pull the image
+                # first, using the builder service account's credentials if necessary.
                 #
                 # The Docker daemon's cache will already have the latest versions of all of
                 # the officially supported build steps
@@ -1470,8 +1495,7 @@ <h3>Method Details</h3>
         "images": [ # A list of images to be pushed upon the successful completion of all build
             # steps.
             #
-            # The images will be pushed using the builder
-            # service account's credentials.
+            # The images will be pushed using the builder service account's credentials.
             #
             # The digests of the pushed images will be stored in the Build resource's
             # results field.
diff --git a/docs/dyn/clouderrorreporting_v1beta1.projects.events.html b/docs/dyn/clouderrorreporting_v1beta1.projects.events.html
index 8867a95afc1..36e1f8536e4 100644
--- a/docs/dyn/clouderrorreporting_v1beta1.projects.events.html
+++ b/docs/dyn/clouderrorreporting_v1beta1.projects.events.html
@@ -75,7 +75,7 @@
 <h1><a href="clouderrorreporting_v1beta1.html">Stackdriver Error Reporting API</a> . <a href="clouderrorreporting_v1beta1.projects.html">projects</a> . <a href="clouderrorreporting_v1beta1.projects.events.html">events</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#list">list(projectName=None, pageSize=None, x__xgafv=None, timeRange_period=None, pageToken=None, serviceFilter_version=None, serviceFilter_service=None, groupId=None)</a></code></p>
+  <code><a href="#list">list(projectName=None, pageSize=None, x__xgafv=None, serviceFilter_resourceType=None, timeRange_period=None, serviceFilter_version=None, pageToken=None, serviceFilter_service=None, groupId=None)</a></code></p>
 <p class="firstline">Lists the specified events.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -85,23 +85,26 @@ <h2>Instance Methods</h2>
 <p class="firstline">Report an individual error event.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="list">list(projectName=None, pageSize=None, x__xgafv=None, timeRange_period=None, pageToken=None, serviceFilter_version=None, serviceFilter_service=None, groupId=None)</code>
+    <code class="details" id="list">list(projectName=None, pageSize=None, x__xgafv=None, serviceFilter_resourceType=None, timeRange_period=None, serviceFilter_version=None, pageToken=None, serviceFilter_service=None, groupId=None)</code>
   <pre>Lists the specified events.
 
 Args:
   projectName: string, [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).
+[Google Cloud Platform project
+ID](https://support.google.com/cloud/answer/6158840).
 Example: `projects/my-project-123`. (required)
   pageSize: integer, [Optional] The maximum number of results to return per response.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
+  serviceFilter_resourceType: string, [Optional] The exact value to match against
+[`ServiceContext.resource_type`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type).
   timeRange_period: string, Restricts the query to the specified time range.
-  pageToken: string, [Optional] A `next_page_token` provided by a previous response.
   serviceFilter_version: string, [Optional] The exact value to match against
 [`ServiceContext.version`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version).
+  pageToken: string, [Optional] A `next_page_token` provided by a previous response.
   serviceFilter_service: string, [Optional] The exact value to match against
 [`ServiceContext.service`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service).
   groupId: string, [Required] The group for which events shall be returned.
@@ -117,6 +120,11 @@ <h3>Method Details</h3>
       { # An error event which is returned by the Error Reporting system.
         "serviceContext": { # Describes a running service that sends errors. # The `ServiceContext` for which this error was reported.
             # Its version changes over time and multiple versions can run in parallel.
+          "resourceType": "A String", # 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.
           "version": "A String", # Represents the source code version that the developer provided,
               # which could represent a version label or a Git SHA-1 hash, for example.
           "service": "A String", # An identifier of the service, such as the name of the
@@ -178,6 +186,7 @@ <h3>Method Details</h3>
         },
       },
     ],
+    "timeRangeBegin": "A String", # The timestamp specifies the start time to which the request was restricted.
   }</pre>
 </div>
 
@@ -217,6 +226,11 @@ <h3>Method Details</h3>
 { # An error event which is reported to the Error Reporting system.
     "serviceContext": { # Describes a running service that sends errors. # [Required] The service context in which this error has occurred.
         # Its version changes over time and multiple versions can run in parallel.
+      "resourceType": "A String", # 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.
       "version": "A String", # Represents the source code version that the developer provided,
           # which could represent a version label or a Git SHA-1 hash, for example.
       "service": "A String", # An identifier of the service, such as the name of the
diff --git a/docs/dyn/clouderrorreporting_v1beta1.projects.groupStats.html b/docs/dyn/clouderrorreporting_v1beta1.projects.groupStats.html
index 53bd6b39caa..65cc885ea6c 100644
--- a/docs/dyn/clouderrorreporting_v1beta1.projects.groupStats.html
+++ b/docs/dyn/clouderrorreporting_v1beta1.projects.groupStats.html
@@ -75,14 +75,14 @@
 <h1><a href="clouderrorreporting_v1beta1.html">Stackdriver Error Reporting API</a> . <a href="clouderrorreporting_v1beta1.projects.html">projects</a> . <a href="clouderrorreporting_v1beta1.projects.groupStats.html">groupStats</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#list">list(projectName=None, alignmentTime=None, pageSize=None, x__xgafv=None, alignment=None, timedCountDuration=None, timeRange_period=None, pageToken=None, serviceFilter_version=None, serviceFilter_service=None, groupId=None, order=None)</a></code></p>
+  <code><a href="#list">list(projectName=None, alignmentTime=None, pageSize=None, x__xgafv=None, alignment=None, serviceFilter_resourceType=None, timedCountDuration=None, timeRange_period=None, pageToken=None, serviceFilter_version=None, serviceFilter_service=None, groupId=None, order=None)</a></code></p>
 <p class="firstline">Lists the specified groups.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="list">list(projectName=None, alignmentTime=None, pageSize=None, x__xgafv=None, alignment=None, timedCountDuration=None, timeRange_period=None, pageToken=None, serviceFilter_version=None, serviceFilter_service=None, groupId=None, order=None)</code>
+    <code class="details" id="list">list(projectName=None, alignmentTime=None, pageSize=None, x__xgafv=None, alignment=None, serviceFilter_resourceType=None, timedCountDuration=None, timeRange_period=None, pageToken=None, serviceFilter_version=None, serviceFilter_service=None, groupId=None, order=None)</code>
   <pre>Lists the specified groups.
 
 Args:
@@ -102,6 +102,8 @@ <h3>Method Details</h3>
       2 - v2 error format
   alignment: string, [Optional] The alignment of the timed counts to be returned.
 Default is `ALIGNMENT_EQUAL_AT_END`.
+  serviceFilter_resourceType: string, [Optional] The exact value to match against
+[`ServiceContext.resource_type`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type).
   timedCountDuration: string, [Optional] The preferred duration for a single returned `TimedCount`.
 If not set, no timed counts are returned.
   timeRange_period: string, Restricts the query to the specified time range.
@@ -179,6 +181,11 @@ <h3>Method Details</h3>
             # insight into the characteristics of the group as a whole.
           "serviceContext": { # Describes a running service that sends errors. # The `ServiceContext` for which this error was reported.
               # Its version changes over time and multiple versions can run in parallel.
+            "resourceType": "A String", # 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.
             "version": "A String", # Represents the source code version that the developer provided,
                 # which could represent a version label or a Git SHA-1 hash, for example.
             "service": "A String", # An identifier of the service, such as the name of the
@@ -246,6 +253,11 @@ <h3>Method Details</h3>
             # Refer to `num_affected_services` for the total count.
           { # Describes a running service that sends errors.
               # Its version changes over time and multiple versions can run in parallel.
+            "resourceType": "A String", # 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.
             "version": "A String", # Represents the source code version that the developer provided,
                 # which could represent a version label or a Git SHA-1 hash, for example.
             "service": "A String", # An identifier of the service, such as the name of the
@@ -259,6 +271,10 @@ <h3>Method Details</h3>
         ],
       },
     ],
+    "timeRangeBegin": "A String", # The timestamp specifies the start time to which the request was restricted.
+        # The start time is set based on the requested time range. It may be adjusted
+        # to a later time if a project has exceeded the storage quota and older data
+        # has been deleted.
   }</pre>
 </div>
 
diff --git a/docs/dyn/clouderrorreporting_v1beta1.projects.html b/docs/dyn/clouderrorreporting_v1beta1.projects.html
index ff6465f8491..7929c1fa79c 100644
--- a/docs/dyn/clouderrorreporting_v1beta1.projects.html
+++ b/docs/dyn/clouderrorreporting_v1beta1.projects.html
@@ -100,7 +100,8 @@ <h3>Method Details</h3>
 Args:
   projectName: string, [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).
+[Google Cloud Platform project
+ID](https://support.google.com/cloud/answer/6158840).
 Example: `projects/my-project-123`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
diff --git a/docs/dyn/cloudresourcemanager_v1.operations.html b/docs/dyn/cloudresourcemanager_v1.operations.html
index 996cd920f05..c936baa4a82 100644
--- a/docs/dyn/cloudresourcemanager_v1.operations.html
+++ b/docs/dyn/cloudresourcemanager_v1.operations.html
@@ -76,37 +76,111 @@ <h1><a href="cloudresourcemanager_v1.html">Google Cloud Resource Manager API</a>
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.</p>
+<p class="firstline">Gets the latest state of a long-running operation.  Clients can use this</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="get">get(name, x__xgafv=None)</code>
-  <pre>Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
+  <pre>Gets the latest state of a long-running operation.  Clients can use this
+method to poll the operation result at intervals as recommended by the API
+service.
 
 Args:
   name: string, The name of the operation resource. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    { # This resource represents a long-running operation that is the result of a
+      # network API call.
+    "metadata": { # Service-specific metadata associated with the operation.  It typically
+        # contains progress information and common metadata such as create time.
+        # Some services might not provide such metadata.  Any method that returns a
+        # long-running operation should document the metadata type, if any.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
-      "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+    "done": True or False, # If the value is `false`, it means the operation is still in progress.
+        # If true, the operation is completed, and either `error` or `response` is
+        # available.
+    "response": { # The normal response of the operation in case of success.  If the original
+        # method returns no data on success, such as `Delete`, the response is
+        # `google.protobuf.Empty`.  If the original method is standard
+        # `Get`/`Create`/`Update`, the response should be the resource.  For other
+        # methods, the response should have the type `XxxResponse`, where `Xxx`
+        # is the original method name.  For example, if the original method name
+        # is `TakeSnapshot()`, the inferred response type is
+        # `TakeSnapshotResponse`.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
+    },
+    "name": "A String", # The server-assigned name, which is only unique within the same service that
+        # originally returns it. If you use the default HTTP mapping, the
+        # `name` should have the format of `operations/some/unique/name`.
+    "error": { # The `Status` type defines a logical error model that is suitable for different # The error result of the operation in case of failure or cancellation.
+        # programming environments, including REST APIs and RPC APIs. It is used by
+        # [gRPC](https://github.com/grpc). The error model is designed to be:
+        #
+        # - Simple to use and understand for most users
+        # - Flexible enough to meet unexpected needs
+        #
+        # # Overview
+        #
+        # The `Status` message contains three pieces of data: error code, error message,
+        # and error details. The error code should be an enum value of
+        # google.rpc.Code, but it may accept additional error codes if needed.  The
+        # error message should be a developer-facing English message that helps
+        # developers *understand* and *resolve* the error. If a localized user-facing
+        # error message is needed, put the localized message in the error details or
+        # localize it in the client. The optional error details may contain arbitrary
+        # information about the error. There is a predefined set of error detail types
+        # in the package `google.rpc` which can be used for common error conditions.
+        #
+        # # Language mapping
+        #
+        # The `Status` message is the logical representation of the error model, but it
+        # is not necessarily the actual wire format. When the `Status` message is
+        # exposed in different client libraries and different wire protocols, it can be
+        # mapped differently. For example, it will likely be mapped to some exceptions
+        # in Java, but more likely mapped to some error codes in C.
+        #
+        # # Other uses
+        #
+        # The error model and the `Status` message can be used in a variety of
+        # environments, either with or without APIs, to provide a
+        # consistent developer experience across different environments.
+        #
+        # Example uses of this error model include:
+        #
+        # - Partial errors. If a service needs to return partial errors to the client,
+        #     it may embed the `Status` in the normal response to indicate the partial
+        #     errors.
+        #
+        # - Workflow errors. A typical workflow has multiple steps. Each step may
+        #     have a `Status` message for error reporting purpose.
+        #
+        # - Batch operations. If a client uses batch request and batch response, the
+        #     `Status` message should be used directly inside batch response, one for
+        #     each error sub-response.
+        #
+        # - Asynchronous operations. If an API call embeds asynchronous operation
+        #     results in its response, the status of those operations should be
+        #     represented directly using the `Status` message.
+        #
+        # - Logging. If some API errors are stored in logs, the message `Status` could
+        #     be used directly after any stripping needed for security/privacy reasons.
+      "message": "A String", # A developer-facing error message, which should be in English. Any
+          # user-facing error message should be localized and sent in the
+          # google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
-      "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
+      "details": [ # A list of messages that carry the error details.  There will be a
+          # common set of message types for APIs to use.
         {
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
-    "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @type with type URL.
-    },
   }</pre>
 </div>
 
diff --git a/docs/dyn/cloudresourcemanager_v1.organizations.html b/docs/dyn/cloudresourcemanager_v1.organizations.html
index 933fc5b9770..4cbe33aa7a2 100644
--- a/docs/dyn/cloudresourcemanager_v1.organizations.html
+++ b/docs/dyn/cloudresourcemanager_v1.organizations.html
@@ -78,17 +78,17 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Fetches an Organization resource identified by the specified resource name.</p>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the access control policy for an Organization resource. May be empty if no such policy or resource exists. The `resource` field should be the organization's resource name, e.g. "organizations/123".</p>
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the access control policy for an Organization resource. May be empty</p>
 <p class="toc_element">
   <code><a href="#search">search(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Searches Organization resources that are visible to the user and satisfy the specified filter. This method returns Organizations in an unspecified order. New Organizations do not necessarily appear at the end of the results.</p>
+<p class="firstline">Searches Organization resources that are visible to the user and satisfy</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the access control policy on an Organization resource. Replaces any existing policy. The `resource` field should be the organization's resource name, e.g. "organizations/123".</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the access control policy on an Organization resource. Replaces any</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Returns permissions that a caller has on the specified Organization. The `resource` field should be the organization's resource name, e.g. "organizations/123".</p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Returns permissions that a caller has on the specified Organization.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="get">get(name, x__xgafv=None)</code>
@@ -97,27 +97,47 @@ <h3>Method Details</h3>
 Args:
   name: string, The resource name of the Organization to fetch, e.g. "organizations/1234". (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # The root node in the resource hierarchy to which a particular entity's (e.g., company) resources belong.
-    "owner": { # The entity that owns an Organization. The lifetime of the Organization and all of its descendants are bound to the `OrganizationOwner`. If the `OrganizationOwner` is deleted, the Organization and all its descendants will be deleted. # The owner of this Organization. The owner should be specified on creation. Once set, it cannot be changed. This field is required.
+    { # The root node in the resource hierarchy to which a particular entity's
+      # (e.g., company) resources belong.
+    "owner": { # The entity that owns an Organization. The lifetime of the Organization and # The owner of this Organization. The owner should be specified on
+        # creation. Once set, it cannot be changed.
+        # This field is required.
+        # all of its descendants are bound to the `OrganizationOwner`. If the
+        # `OrganizationOwner` is deleted, the Organization and all its descendants will
+        # be deleted.
       "directoryCustomerId": "A String", # The Google for Work customer id used in the Directory API.
     },
-    "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server. @OutputOnly
-    "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI. Assigned by the server, set to the firm name of the Google For Work customer that owns this organization. @OutputOnly
-    "name": "A String", # Output Only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organization_id]". For example, "organizations/1234".
-    "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server. @OutputOnly
+    "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server.
+        # @OutputOnly
+    "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI.
+        # Assigned by the server, set to the firm name of the Google For Work
+        # customer that owns this organization.
+        # @OutputOnly
+    "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server.
+        # @OutputOnly
+    "name": "A String", # Output Only. The resource name of the organization. This is the
+        # organization's relative path in the API. Its format is
+        # "organizations/[organization_id]". For example, "organizations/1234".
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Gets the access control policy for an Organization resource. May be empty if no such policy or resource exists. The `resource` field should be the organization's resource name, e.g. "organizations/123".
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Gets the access control policy for an Organization resource. May be empty
+if no such policy or resource exists. The `resource` field should be the
+organization's resource name, e.g. "organizations/123".
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
@@ -125,124 +145,380 @@ <h3>Method Details</h3>
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="search">search(body, x__xgafv=None)</code>
-  <pre>Searches Organization resources that are visible to the user and satisfy the specified filter. This method returns Organizations in an unspecified order. New Organizations do not necessarily appear at the end of the results.
+  <pre>Searches Organization resources that are visible to the user and satisfy
+the specified filter. This method returns Organizations in an unspecified
+order. New Organizations do not necessarily appear at the end of the
+results.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # The request sent to the `SearchOrganizations` method.
-    "filter": "A String", # An optional query string used to filter the Organizations to return in the response. Filter rules are case-insensitive. Organizations may be filtered by `owner.directoryCustomerId` or by `domain`, where the domain is a Google for Work domain, for example: |Filter|Description| |------|-----------| |owner.directorycustomerid:123456789|Organizations with `owner.directory_customer_id` equal to `123456789`.| |domain:google.com|Organizations corresponding to the domain `google.com`.| This field is optional.
-    "pageToken": "A String", # A pagination token returned from a previous call to `SearchOrganizations` that indicates from where listing should continue. This field is optional.
-    "pageSize": 42, # The maximum number of Organizations to return in the response. This field is optional.
+    "filter": "A String", # An optional query string used to filter the Organizations to return in
+        # the response. Filter rules are case-insensitive.
+        # 
+        # 
+        # Organizations may be filtered by `owner.directoryCustomerId` or by
+        # `domain`, where the domain is a Google for Work domain, for example:
+        # 
+        # |Filter|Description|
+        # |------|-----------|
+        # |owner.directorycustomerid:123456789|Organizations with
+        # `owner.directory_customer_id` equal to `123456789`.|
+        # |domain:google.com|Organizations corresponding to the domain `google.com`.|
+        # 
+        # This field is optional.
+    "pageToken": "A String", # A pagination token returned from a previous call to `SearchOrganizations`
+        # that indicates from where listing should continue.
+        # This field is optional.
+    "pageSize": 42, # The maximum number of Organizations to return in the response.
+        # This field is optional.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # The response returned from the `SearchOrganizations` method.
-    "nextPageToken": "A String", # A pagination token to be used to retrieve the next page of results. If the result is too large to fit within the page size specified in the request, this field will be set with a token that can be used to fetch the next page of results. If this field is empty, it indicates that this response contains the last page of results.
-    "organizations": [ # The list of Organizations that matched the search query, possibly paginated.
-      { # The root node in the resource hierarchy to which a particular entity's (e.g., company) resources belong.
-        "owner": { # The entity that owns an Organization. The lifetime of the Organization and all of its descendants are bound to the `OrganizationOwner`. If the `OrganizationOwner` is deleted, the Organization and all its descendants will be deleted. # The owner of this Organization. The owner should be specified on creation. Once set, it cannot be changed. This field is required.
+    "nextPageToken": "A String", # A pagination token to be used to retrieve the next page of results. If the
+        # result is too large to fit within the page size specified in the request,
+        # this field will be set with a token that can be used to fetch the next page
+        # of results. If this field is empty, it indicates that this response
+        # contains the last page of results.
+    "organizations": [ # The list of Organizations that matched the search query, possibly
+        # paginated.
+      { # The root node in the resource hierarchy to which a particular entity's
+          # (e.g., company) resources belong.
+        "owner": { # The entity that owns an Organization. The lifetime of the Organization and # The owner of this Organization. The owner should be specified on
+            # creation. Once set, it cannot be changed.
+            # This field is required.
+            # all of its descendants are bound to the `OrganizationOwner`. If the
+            # `OrganizationOwner` is deleted, the Organization and all its descendants will
+            # be deleted.
           "directoryCustomerId": "A String", # The Google for Work customer id used in the Directory API.
         },
-        "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server. @OutputOnly
-        "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI. Assigned by the server, set to the firm name of the Google For Work customer that owns this organization. @OutputOnly
-        "name": "A String", # Output Only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organization_id]". For example, "organizations/1234".
-        "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server. @OutputOnly
+        "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server.
+            # @OutputOnly
+        "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI.
+            # Assigned by the server, set to the firm name of the Google For Work
+            # customer that owns this organization.
+            # @OutputOnly
+        "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server.
+            # @OutputOnly
+        "name": "A String", # Output Only. The resource name of the organization. This is the
+            # organization's relative path in the API. Its format is
+            # "organizations/[organization_id]". For example, "organizations/1234".
       },
     ],
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the access control policy on an Organization resource. Replaces any existing policy. The `resource` field should be the organization's resource name, e.g. "organizations/123".
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the access control policy on an Organization resource. Replaces any
+existing policy. The `resource` field should be the organization's resource
+name, e.g. "organizations/123".
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
-  <pre>Returns permissions that a caller has on the specified Organization. The `resource` field should be the organization's resource name, e.g. "organizations/123".
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
+  <pre>Returns permissions that a caller has on the specified Organization.
+The `resource` field should be the organization's resource name,
+e.g. "organizations/123".
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
diff --git a/docs/dyn/cloudresourcemanager_v1.projects.html b/docs/dyn/cloudresourcemanager_v1.projects.html
index faa247aa604..be4714c4099 100644
--- a/docs/dyn/cloudresourcemanager_v1.projects.html
+++ b/docs/dyn/cloudresourcemanager_v1.projects.html
@@ -76,132 +76,409 @@ <h1><a href="cloudresourcemanager_v1.html">Google Cloud Resource Manager API</a>
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Request that a new Project be created. The result is an Operation which can be used to track the creation process. It is automatically deleted after a few hours, so there is no need to call DeleteOperation. Our SLO permits Project creation to take up to 30 seconds at the 90th percentile. As of 2016-08-29, we are observing 6 seconds 50th percentile latency. 95th percentile latency is around 11 seconds. We recommend polling at the 5th second with an exponential backoff.</p>
+<p class="firstline">Request that a new Project be created. The result is an Operation which</p>
 <p class="toc_element">
-  <code><a href="#delete">delete(projectId, x__xgafv=None)</a></code></p>
-<p class="firstline">Marks the Project identified by the specified `project_id` (for example, `my-project-123`) for deletion. This method will only affect the Project if the following criteria are met: + The Project does not have a billing account associated with it. + The Project has a lifecycle state of ACTIVE. This method changes the Project's lifecycle state from ACTIVE to DELETE_REQUESTED. The deletion starts at an unspecified time, at which point the Project is no longer accessible. Until the deletion completes, you can check the lifecycle state checked by retrieving the Project with GetProject, and the Project remains visible to ListProjects. However, you cannot update the project. After the deletion completes, the Project is not retrievable by the GetProject and ListProjects methods. The caller must have modify permissions for this Project.</p>
+  <code><a href="#delete">delete(projectId=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Marks the Project identified by the specified</p>
 <p class="toc_element">
-  <code><a href="#get">get(projectId, x__xgafv=None)</a></code></p>
-<p class="firstline">Retrieves the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have read permissions for this Project.</p>
+  <code><a href="#get">get(projectId=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Retrieves the Project identified by the specified</p>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Returns the IAM access control policy for the specified Project. Permission is denied if the policy or the resource does not exist.</p>
+  <code><a href="#getAncestry">getAncestry(projectId=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets a list of ancestors in the resource hierarchy for the Project</p>
+<p class="toc_element">
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Returns the IAM access control policy for the specified Project.</p>
 <p class="toc_element">
   <code><a href="#list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists Projects that are visible to the user and satisfy the specified filter. This method returns Projects in an unspecified order. New Projects do not necessarily appear at the end of the list.</p>
+<p class="firstline">Lists Projects that are visible to the user and satisfy the</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the IAM access control policy for the specified Project. Replaces any existing policy. The following constraints apply when using `setIamPolicy()`: + Project does not support `allUsers` and `allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The owner role can be granted only to `user` and `serviceAccount`. + Service accounts can be made owners of a project directly without any restrictions. However, to be added as an owner, a user must be invited via Cloud Platform console and must accept the invitation. + A user cannot be granted the owner role using `setIamPolicy()`. The user must be granted the owner role using the Cloud Platform Console and must explicitly accept the invitation. + Invitations to grant the owner role cannot be sent using `setIamPolicy()`; they must be sent only using the Cloud Platform Console. + Membership changes that leave the project without any owners that have accepted the Terms of Service (ToS) will be rejected. + There must be at least one owner who has accepted the Terms of Service (ToS) agreement in the policy. Calling `setIamPolicy()` to to remove the last ToS-accepted owner from the policy will fail. This restriction also applies to legacy projects that no longer have owners who have accepted the ToS. Edits to IAM policies will be rejected until the lack of a ToS-accepting owner is rectified. + Calling this method requires enabling the App Engine Admin API. Note: Removing service accounts from policies or changing their roles can render services completely inoperable. It is important to understand how the service account is being used before removing or updating its roles.</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the IAM access control policy for the specified Project. Replaces</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified Project.</p>
 <p class="toc_element">
-  <code><a href="#undelete">undelete(projectId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Restores the Project identified by the specified `project_id` (for example, `my-project-123`). You can only use this method for a Project that has a lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot be restored. The caller must have modify permissions for this Project.</p>
+  <code><a href="#undelete">undelete(projectId=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Restores the Project identified by the specified</p>
 <p class="toc_element">
-  <code><a href="#update">update(projectId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the attributes of the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have modify permissions for this Project.</p>
+  <code><a href="#update">update(projectId=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates the attributes of the Project identified by the specified</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(body, x__xgafv=None)</code>
-  <pre>Request that a new Project be created. The result is an Operation which can be used to track the creation process. It is automatically deleted after a few hours, so there is no need to call DeleteOperation. Our SLO permits Project creation to take up to 30 seconds at the 90th percentile. As of 2016-08-29, we are observing 6 seconds 50th percentile latency. 95th percentile latency is around 11 seconds. We recommend polling at the 5th second with an exponential backoff.
+  <pre>Request that a new Project be created. The result is an Operation which
+can be used to track the creation process. It is automatically deleted
+after a few hours, so there is no need to call DeleteOperation.
+
+Our SLO permits Project creation to take up to 30 seconds at the 90th
+percentile. As of 2016-08-29, we are observing 6 seconds 50th percentile
+latency. 95th percentile latency is around 11 seconds. We recommend
+polling at the 5th second with an exponential backoff.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-  "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-  "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-    "type": "A String", # Required field representing the resource type this id is for. At present, the only valid type is "organization".
-    "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+{ # A Project is a high-level Google Cloud Platform entity.  It is a
+    # container for ACLs, APIs, AppEngine Apps, VMs, and other
+    # Google Cloud Platform resources.
+  "name": "A String", # The user-assigned display name of the Project.
+      # It must be 4 to 30 characters.
+      # Allowed characters are: lowercase and uppercase letters, numbers,
+      # hyphen, single-quote, double-quote, space, and exclamation point.
+      # 
+      # Example: <code>My Project</code>
+      # 
+      # Read-write.
+  "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+      # 
+      # The only supported parent type is "organization". Once set, the parent
+      # cannot be modified. The `parent` can be set on creation or using the
+      # `UpdateProject` method; the end user must have the
+      # `resourcemanager.projects.create` permission on the parent.
+      # 
+      # Read-write.
+      # Cloud Platform is a generic term for something you (a developer) may want to
+      # interact with through one of our API's. Some examples are an AppEngine app,
+      # a Compute Engine instance, a Cloud SQL database, and so on.
+    "type": "A String", # Required field representing the resource type this id is for.
+        # At present, the only valid type is "organization".
+    "id": "A String", # Required field for the type-specific id. This should correspond to the id
+        # used in the type-specific API's.
   },
-  "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-  "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+  "projectId": "A String", # The unique, user-assigned ID of the Project.
+      # It must be 6 to 30 lowercase letters, digits, or hyphens.
+      # It must start with a letter.
+      # Trailing hyphens are prohibited.
+      # 
+      # Example: <code>tokyo-rain-123</code>
+      # 
+      # Read-only after creation.
+  "labels": { # The labels associated with this Project.
+      # 
+      # Label keys must be between 1 and 63 characters long and must conform
+      # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+      # 
+      # Label values must be between 0 and 63 characters long and must conform
+      # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+      # 
+      # No more than 256 labels can be associated with a given resource.
+      # 
+      # Clients should store labels in a representation such as JSON that does not
+      # depend on specific characters being disallowed.
+      # 
+      # Example: <code>"environment" : "dev"</code>
+      # 
+      # Read-write.
     "a_key": "A String",
   },
-  "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-  "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-  "createTime": "A String", # Creation time. Read-only.
+  "createTime": "A String", # Creation time.
+      # 
+      # Read-only.
+  "lifecycleState": "A String", # The Project lifecycle state.
+      # 
+      # Read-only.
+  "projectNumber": "A String", # The number uniquely identifying the project.
+      # 
+      # Example: <code>415104041262</code>
+      # 
+      # Read-only.
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # This resource represents a long-running operation that is the result of a network API call.
-    "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    { # This resource represents a long-running operation that is the result of a
+      # network API call.
+    "metadata": { # Service-specific metadata associated with the operation.  It typically
+        # contains progress information and common metadata such as create time.
+        # Some services might not provide such metadata.  Any method that returns a
+        # long-running operation should document the metadata type, if any.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
+    },
+    "done": True or False, # If the value is `false`, it means the operation is still in progress.
+        # If true, the operation is completed, and either `error` or `response` is
+        # available.
+    "response": { # The normal response of the operation in case of success.  If the original
+        # method returns no data on success, such as `Delete`, the response is
+        # `google.protobuf.Empty`.  If the original method is standard
+        # `Get`/`Create`/`Update`, the response should be the resource.  For other
+        # methods, the response should have the type `XxxResponse`, where `Xxx`
+        # is the original method name.  For example, if the original method name
+        # is `TakeSnapshot()`, the inferred response type is
+        # `TakeSnapshotResponse`.
       "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
-      "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+    "name": "A String", # The server-assigned name, which is only unique within the same service that
+        # originally returns it. If you use the default HTTP mapping, the
+        # `name` should have the format of `operations/some/unique/name`.
+    "error": { # The `Status` type defines a logical error model that is suitable for different # The error result of the operation in case of failure or cancellation.
+        # programming environments, including REST APIs and RPC APIs. It is used by
+        # [gRPC](https://github.com/grpc). The error model is designed to be:
+        #
+        # - Simple to use and understand for most users
+        # - Flexible enough to meet unexpected needs
+        #
+        # # Overview
+        #
+        # The `Status` message contains three pieces of data: error code, error message,
+        # and error details. The error code should be an enum value of
+        # google.rpc.Code, but it may accept additional error codes if needed.  The
+        # error message should be a developer-facing English message that helps
+        # developers *understand* and *resolve* the error. If a localized user-facing
+        # error message is needed, put the localized message in the error details or
+        # localize it in the client. The optional error details may contain arbitrary
+        # information about the error. There is a predefined set of error detail types
+        # in the package `google.rpc` which can be used for common error conditions.
+        #
+        # # Language mapping
+        #
+        # The `Status` message is the logical representation of the error model, but it
+        # is not necessarily the actual wire format. When the `Status` message is
+        # exposed in different client libraries and different wire protocols, it can be
+        # mapped differently. For example, it will likely be mapped to some exceptions
+        # in Java, but more likely mapped to some error codes in C.
+        #
+        # # Other uses
+        #
+        # The error model and the `Status` message can be used in a variety of
+        # environments, either with or without APIs, to provide a
+        # consistent developer experience across different environments.
+        #
+        # Example uses of this error model include:
+        #
+        # - Partial errors. If a service needs to return partial errors to the client,
+        #     it may embed the `Status` in the normal response to indicate the partial
+        #     errors.
+        #
+        # - Workflow errors. A typical workflow has multiple steps. Each step may
+        #     have a `Status` message for error reporting purpose.
+        #
+        # - Batch operations. If a client uses batch request and batch response, the
+        #     `Status` message should be used directly inside batch response, one for
+        #     each error sub-response.
+        #
+        # - Asynchronous operations. If an API call embeds asynchronous operation
+        #     results in its response, the status of those operations should be
+        #     represented directly using the `Status` message.
+        #
+        # - Logging. If some API errors are stored in logs, the message `Status` could
+        #     be used directly after any stripping needed for security/privacy reasons.
+      "message": "A String", # A developer-facing error message, which should be in English. Any
+          # user-facing error message should be localized and sent in the
+          # google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
-      "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
+      "details": [ # A list of messages that carry the error details.  There will be a
+          # common set of message types for APIs to use.
         {
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
-    "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
-    "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @type with type URL.
-    },
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="delete">delete(projectId, x__xgafv=None)</code>
-  <pre>Marks the Project identified by the specified `project_id` (for example, `my-project-123`) for deletion. This method will only affect the Project if the following criteria are met: + The Project does not have a billing account associated with it. + The Project has a lifecycle state of ACTIVE. This method changes the Project's lifecycle state from ACTIVE to DELETE_REQUESTED. The deletion starts at an unspecified time, at which point the Project is no longer accessible. Until the deletion completes, you can check the lifecycle state checked by retrieving the Project with GetProject, and the Project remains visible to ListProjects. However, you cannot update the project. After the deletion completes, the Project is not retrievable by the GetProject and ListProjects methods. The caller must have modify permissions for this Project.
+    <code class="details" id="delete">delete(projectId=None, x__xgafv=None)</code>
+  <pre>Marks the Project identified by the specified
+`project_id` (for example, `my-project-123`) for deletion.
+This method will only affect the Project if the following criteria are met:
+
++ The Project does not have a billing account associated with it.
++ The Project has a lifecycle state of
+ACTIVE.
+
+This method changes the Project's lifecycle state from
+ACTIVE
+to DELETE_REQUESTED.
+The deletion starts at an unspecified time,
+at which point the Project is no longer accessible.
+
+Until the deletion completes, you can check the lifecycle state
+checked by retrieving the Project with GetProject,
+and the Project remains visible to ListProjects.
+However, you cannot update the project.
+
+After the deletion completes, the Project is not retrievable by
+the  GetProject and
+ListProjects methods.
+
+The caller must have modify permissions for this Project.
 
 Args:
-  projectId: string, The Project ID (for example, `foo-bar-123`). Required. (required)
+  projectId: string, The Project ID (for example, `foo-bar-123`).
+
+Required. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="get">get(projectId, x__xgafv=None)</code>
-  <pre>Retrieves the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have read permissions for this Project.
+    <code class="details" id="get">get(projectId=None, x__xgafv=None)</code>
+  <pre>Retrieves the Project identified by the specified
+`project_id` (for example, `my-project-123`).
+
+The caller must have read permissions for this Project.
 
 Args:
-  projectId: string, The Project ID (for example, `my-project-123`). Required. (required)
+  projectId: string, The Project ID (for example, `my-project-123`).
+
+Required. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-    "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-    "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-      "type": "A String", # Required field representing the resource type this id is for. At present, the only valid type is "organization".
-      "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+    { # A Project is a high-level Google Cloud Platform entity.  It is a
+      # container for ACLs, APIs, AppEngine Apps, VMs, and other
+      # Google Cloud Platform resources.
+    "name": "A String", # The user-assigned display name of the Project.
+        # It must be 4 to 30 characters.
+        # Allowed characters are: lowercase and uppercase letters, numbers,
+        # hyphen, single-quote, double-quote, space, and exclamation point.
+        #
+        # Example: <code>My Project</code>
+        #
+        # Read-write.
+    "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+        #
+        # The only supported parent type is "organization". Once set, the parent
+        # cannot be modified. The `parent` can be set on creation or using the
+        # `UpdateProject` method; the end user must have the
+        # `resourcemanager.projects.create` permission on the parent.
+        #
+        # Read-write.
+        # Cloud Platform is a generic term for something you (a developer) may want to
+        # interact with through one of our API's. Some examples are an AppEngine app,
+        # a Compute Engine instance, a Cloud SQL database, and so on.
+      "type": "A String", # Required field representing the resource type this id is for.
+          # At present, the only valid type is "organization".
+      "id": "A String", # Required field for the type-specific id. This should correspond to the id
+          # used in the type-specific API's.
     },
-    "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-    "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+    "projectId": "A String", # The unique, user-assigned ID of the Project.
+        # It must be 6 to 30 lowercase letters, digits, or hyphens.
+        # It must start with a letter.
+        # Trailing hyphens are prohibited.
+        #
+        # Example: <code>tokyo-rain-123</code>
+        #
+        # Read-only after creation.
+    "labels": { # The labels associated with this Project.
+        #
+        # Label keys must be between 1 and 63 characters long and must conform
+        # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+        #
+        # Label values must be between 0 and 63 characters long and must conform
+        # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+        #
+        # No more than 256 labels can be associated with a given resource.
+        #
+        # Clients should store labels in a representation such as JSON that does not
+        # depend on specific characters being disallowed.
+        #
+        # Example: <code>"environment" : "dev"</code>
+        #
+        # Read-write.
       "a_key": "A String",
     },
-    "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-    "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-    "createTime": "A String", # Creation time. Read-only.
+    "createTime": "A String", # Creation time.
+        #
+        # Read-only.
+    "lifecycleState": "A String", # The Project lifecycle state.
+        #
+        # Read-only.
+    "projectNumber": "A String", # The number uniquely identifying the project.
+        #
+        # Example: <code>415104041262</code>
+        #
+        # Read-only.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Returns the IAM access control policy for the specified Project. Permission is denied if the policy or the resource does not exist.
+    <code class="details" id="getAncestry">getAncestry(projectId=None, body, x__xgafv=None)</code>
+  <pre>Gets a list of ancestors in the resource hierarchy for the Project
+identified by the specified `project_id` (for example, `my-project-123`).
+
+The caller must have read permissions for this Project.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  projectId: string, The Project ID (for example, `my-project-123`).
+
+Required. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # The request sent to the
+      # GetAncestry
+      # method.
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response from the GetAncestry method.
+    "ancestor": [ # Ancestors are ordered from bottom to top of the resource hierarchy. The
+        # first ancestor is the project itself, followed by the project's parent,
+        # etc.
+      { # Identifying information for a single ancestor of a project.
+        "resourceId": { # A container to reference an id for any resource type. A `resource` in Google # Resource id of the ancestor.
+            # Cloud Platform is a generic term for something you (a developer) may want to
+            # interact with through one of our API's. Some examples are an AppEngine app,
+            # a Compute Engine instance, a Cloud SQL database, and so on.
+          "type": "A String", # Required field representing the resource type this id is for.
+              # At present, the only valid type is "organization".
+          "id": "A String", # Required field for the type-specific id. This should correspond to the id
+              # used in the type-specific API's.
+        },
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Returns the IAM access control policy for the specified Project.
+Permission is denied if the policy or the resource does not exist.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
@@ -209,53 +486,220 @@ <h3>Method Details</h3>
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists Projects that are visible to the user and satisfy the specified filter. This method returns Projects in an unspecified order. New Projects do not necessarily appear at the end of the list.
+  <pre>Lists Projects that are visible to the user and satisfy the
+specified filter. This method returns Projects in an unspecified order.
+New Projects do not necessarily appear at the end of the list.
 
 Args:
-  pageSize: integer, The maximum number of Projects to return in the response. The server can return fewer Projects than requested. If unspecified, server picks an appropriate default. Optional.
-  filter: string, An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: + `name` + `id` + labels.key where *key* is the name of a label Some examples of using labels as filters: |Filter|Description| |------|-----------| |name:*|The project has a name.| |name:Howl|The project's name is `Howl` or `howl`.| |name:HOWL|Equivalent to above.| |NAME:howl|Equivalent to above.| |labels.color:*|The project has the label `color`.| |labels.color:red|The project's label `color` has the value `red`.| |labels.color:red label.size:big|The project's label `color` has the value `red` and its label `size` has the value `big`. Optional.
-  pageToken: string, A pagination token returned from a previous call to ListProjects that indicates from where listing should continue. Optional.
+  pageSize: integer, The maximum number of Projects to return in the response.
+The server can return fewer Projects than requested.
+If unspecified, server picks an appropriate default.
+
+Optional.
+  filter: string, An expression for filtering the results of the request.  Filter rules are
+case insensitive. The fields eligible for filtering are:
+
++ `name`
++ `id`
++ <code>labels.<em>key</em></code> where *key* is the name of a label
+
+Some examples of using labels as filters:
+
+|Filter|Description|
+|------|-----------|
+|name:*|The project has a name.|
+|name:Howl|The project's name is `Howl` or `howl`.|
+|name:HOWL|Equivalent to above.|
+|NAME:howl|Equivalent to above.|
+|labels.color:*|The project has the label `color`.|
+|labels.color:red|The project's label `color` has the value `red`.|
+|labels.color:red&nbsp;label.size:big|The project's label `color` has the
+value `red` and its label `size` has the value `big`.
+
+Optional.
+  pageToken: string, A pagination token returned from a previous call to ListProjects
+that indicates from where listing should continue.
+
+Optional.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A page of the response received from the ListProjects method. A paginated response where more pages are available has `next_page_token` set. This token can be used in a subsequent request to retrieve the next request page.
-    "nextPageToken": "A String", # Pagination token. If the result set is too large to fit in a single response, this token is returned. It encodes the position of the current result cursor. Feeding this value into a new list request with the `page_token` parameter gives the next page of the results. When `next_page_token` is not filled in, there is no next page and the list returned is the last page in the result set. Pagination tokens have a limited lifetime.
-    "projects": [ # The list of Projects that matched the list filter. This list can be paginated.
-      { # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-        "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-        "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-          "type": "A String", # Required field representing the resource type this id is for. At present, the only valid type is "organization".
-          "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+    { # A page of the response received from the
+      # ListProjects
+      # method.
+      #
+      # A paginated response where more pages are available has
+      # `next_page_token` set. This token can be used in a subsequent request to
+      # retrieve the next request page.
+    "nextPageToken": "A String", # Pagination token.
+        #
+        # If the result set is too large to fit in a single response, this token
+        # is returned. It encodes the position of the current result cursor.
+        # Feeding this value into a new list request with the `page_token` parameter
+        # gives the next page of the results.
+        #
+        # When `next_page_token` is not filled in, there is no next page and
+        # the list returned is the last page in the result set.
+        #
+        # Pagination tokens have a limited lifetime.
+    "projects": [ # The list of Projects that matched the list filter. This list can
+        # be paginated.
+      { # A Project is a high-level Google Cloud Platform entity.  It is a
+          # container for ACLs, APIs, AppEngine Apps, VMs, and other
+          # Google Cloud Platform resources.
+        "name": "A String", # The user-assigned display name of the Project.
+            # It must be 4 to 30 characters.
+            # Allowed characters are: lowercase and uppercase letters, numbers,
+            # hyphen, single-quote, double-quote, space, and exclamation point.
+            #
+            # Example: <code>My Project</code>
+            #
+            # Read-write.
+        "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+            #
+            # The only supported parent type is "organization". Once set, the parent
+            # cannot be modified. The `parent` can be set on creation or using the
+            # `UpdateProject` method; the end user must have the
+            # `resourcemanager.projects.create` permission on the parent.
+            #
+            # Read-write.
+            # Cloud Platform is a generic term for something you (a developer) may want to
+            # interact with through one of our API's. Some examples are an AppEngine app,
+            # a Compute Engine instance, a Cloud SQL database, and so on.
+          "type": "A String", # Required field representing the resource type this id is for.
+              # At present, the only valid type is "organization".
+          "id": "A String", # Required field for the type-specific id. This should correspond to the id
+              # used in the type-specific API's.
         },
-        "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-        "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+        "projectId": "A String", # The unique, user-assigned ID of the Project.
+            # It must be 6 to 30 lowercase letters, digits, or hyphens.
+            # It must start with a letter.
+            # Trailing hyphens are prohibited.
+            #
+            # Example: <code>tokyo-rain-123</code>
+            #
+            # Read-only after creation.
+        "labels": { # The labels associated with this Project.
+            #
+            # Label keys must be between 1 and 63 characters long and must conform
+            # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+            #
+            # Label values must be between 0 and 63 characters long and must conform
+            # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+            #
+            # No more than 256 labels can be associated with a given resource.
+            #
+            # Clients should store labels in a representation such as JSON that does not
+            # depend on specific characters being disallowed.
+            #
+            # Example: <code>"environment" : "dev"</code>
+            #
+            # Read-write.
           "a_key": "A String",
         },
-        "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-        "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-        "createTime": "A String", # Creation time. Read-only.
+        "createTime": "A String", # Creation time.
+            #
+            # Read-only.
+        "lifecycleState": "A String", # The Project lifecycle state.
+            #
+            # Read-only.
+        "projectNumber": "A String", # The number uniquely identifying the project.
+            #
+            # Example: <code>415104041262</code>
+            #
+            # Read-only.
       },
     ],
   }</pre>
@@ -276,138 +720,450 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the IAM access control policy for the specified Project. Replaces any existing policy. The following constraints apply when using `setIamPolicy()`: + Project does not support `allUsers` and `allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The owner role can be granted only to `user` and `serviceAccount`. + Service accounts can be made owners of a project directly without any restrictions. However, to be added as an owner, a user must be invited via Cloud Platform console and must accept the invitation. + A user cannot be granted the owner role using `setIamPolicy()`. The user must be granted the owner role using the Cloud Platform Console and must explicitly accept the invitation. + Invitations to grant the owner role cannot be sent using `setIamPolicy()`; they must be sent only using the Cloud Platform Console. + Membership changes that leave the project without any owners that have accepted the Terms of Service (ToS) will be rejected. + There must be at least one owner who has accepted the Terms of Service (ToS) agreement in the policy. Calling `setIamPolicy()` to to remove the last ToS-accepted owner from the policy will fail. This restriction also applies to legacy projects that no longer have owners who have accepted the ToS. Edits to IAM policies will be rejected until the lack of a ToS-accepting owner is rectified. + Calling this method requires enabling the App Engine Admin API. Note: Removing service accounts from policies or changing their roles can render services completely inoperable. It is important to understand how the service account is being used before removing or updating its roles.
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the IAM access control policy for the specified Project. Replaces
+any existing policy.
+
+The following constraints apply when using `setIamPolicy()`:
+
++ Project does not support `allUsers` and `allAuthenticatedUsers` as
+`members` in a `Binding` of a `Policy`.
+
++ The owner role can be granted only to `user` and `serviceAccount`.
+
++ Service accounts can be made owners of a project directly
+without any restrictions. However, to be added as an owner, a user must be
+invited via Cloud Platform console and must accept the invitation.
+
++ A user cannot be granted the owner role using `setIamPolicy()`. The user
+must be granted the owner role using the Cloud Platform Console and must
+explicitly accept the invitation.
+
++ Invitations to grant the owner role cannot be sent using
+`setIamPolicy()`;
+they must be sent only using the Cloud Platform Console.
+
++ Membership changes that leave the project without any owners that have
+accepted the Terms of Service (ToS) will be rejected.
+
++ There must be at least one owner who has accepted the Terms of
+Service (ToS) agreement in the policy. Calling `setIamPolicy()` to
+to remove the last ToS-accepted owner from the policy will fail. This
+restriction also applies to legacy projects that no longer have owners
+who have accepted the ToS. Edits to IAM policies will be rejected until
+the lack of a ToS-accepting owner is rectified.
+
++ Calling this method requires enabling the App Engine Admin API.
+
+Note: Removing service accounts from policies or changing their roles
+can render services completely inoperable. It is important to understand
+how the service account is being used before removing or updating its
+roles.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
   <pre>Returns permissions that a caller has on the specified Project.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="undelete">undelete(projectId, body, x__xgafv=None)</code>
-  <pre>Restores the Project identified by the specified `project_id` (for example, `my-project-123`). You can only use this method for a Project that has a lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot be restored. The caller must have modify permissions for this Project.
+    <code class="details" id="undelete">undelete(projectId=None, body, x__xgafv=None)</code>
+  <pre>Restores the Project identified by the specified
+`project_id` (for example, `my-project-123`).
+You can only use this method for a Project that has a lifecycle state of
+DELETE_REQUESTED.
+After deletion starts, the Project cannot be restored.
+
+The caller must have modify permissions for this Project.
 
 Args:
-  projectId: string, The project ID (for example, `foo-bar-123`). Required. (required)
+  projectId: string, The project ID (for example, `foo-bar-123`).
+
+Required. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # The request sent to the UndeleteProject method.
+{ # The request sent to the UndeleteProject
+      # method.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(projectId, body, x__xgafv=None)</code>
-  <pre>Updates the attributes of the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have modify permissions for this Project.
+    <code class="details" id="update">update(projectId=None, body, x__xgafv=None)</code>
+  <pre>Updates the attributes of the Project identified by the specified
+`project_id` (for example, `my-project-123`).
+
+The caller must have modify permissions for this Project.
 
 Args:
-  projectId: string, The project ID (for example, `my-project-123`). Required. (required)
+  projectId: string, The project ID (for example, `my-project-123`).
+
+Required. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-  "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-  "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-    "type": "A String", # Required field representing the resource type this id is for. At present, the only valid type is "organization".
-    "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+{ # A Project is a high-level Google Cloud Platform entity.  It is a
+    # container for ACLs, APIs, AppEngine Apps, VMs, and other
+    # Google Cloud Platform resources.
+  "name": "A String", # The user-assigned display name of the Project.
+      # It must be 4 to 30 characters.
+      # Allowed characters are: lowercase and uppercase letters, numbers,
+      # hyphen, single-quote, double-quote, space, and exclamation point.
+      # 
+      # Example: <code>My Project</code>
+      # 
+      # Read-write.
+  "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+      # 
+      # The only supported parent type is "organization". Once set, the parent
+      # cannot be modified. The `parent` can be set on creation or using the
+      # `UpdateProject` method; the end user must have the
+      # `resourcemanager.projects.create` permission on the parent.
+      # 
+      # Read-write.
+      # Cloud Platform is a generic term for something you (a developer) may want to
+      # interact with through one of our API's. Some examples are an AppEngine app,
+      # a Compute Engine instance, a Cloud SQL database, and so on.
+    "type": "A String", # Required field representing the resource type this id is for.
+        # At present, the only valid type is "organization".
+    "id": "A String", # Required field for the type-specific id. This should correspond to the id
+        # used in the type-specific API's.
   },
-  "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-  "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+  "projectId": "A String", # The unique, user-assigned ID of the Project.
+      # It must be 6 to 30 lowercase letters, digits, or hyphens.
+      # It must start with a letter.
+      # Trailing hyphens are prohibited.
+      # 
+      # Example: <code>tokyo-rain-123</code>
+      # 
+      # Read-only after creation.
+  "labels": { # The labels associated with this Project.
+      # 
+      # Label keys must be between 1 and 63 characters long and must conform
+      # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+      # 
+      # Label values must be between 0 and 63 characters long and must conform
+      # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+      # 
+      # No more than 256 labels can be associated with a given resource.
+      # 
+      # Clients should store labels in a representation such as JSON that does not
+      # depend on specific characters being disallowed.
+      # 
+      # Example: <code>"environment" : "dev"</code>
+      # 
+      # Read-write.
     "a_key": "A String",
   },
-  "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-  "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-  "createTime": "A String", # Creation time. Read-only.
+  "createTime": "A String", # Creation time.
+      # 
+      # Read-only.
+  "lifecycleState": "A String", # The Project lifecycle state.
+      # 
+      # Read-only.
+  "projectNumber": "A String", # The number uniquely identifying the project.
+      # 
+      # Example: <code>415104041262</code>
+      # 
+      # Read-only.
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-    "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-    "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-      "type": "A String", # Required field representing the resource type this id is for. At present, the only valid type is "organization".
-      "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+    { # A Project is a high-level Google Cloud Platform entity.  It is a
+      # container for ACLs, APIs, AppEngine Apps, VMs, and other
+      # Google Cloud Platform resources.
+    "name": "A String", # The user-assigned display name of the Project.
+        # It must be 4 to 30 characters.
+        # Allowed characters are: lowercase and uppercase letters, numbers,
+        # hyphen, single-quote, double-quote, space, and exclamation point.
+        #
+        # Example: <code>My Project</code>
+        #
+        # Read-write.
+    "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+        #
+        # The only supported parent type is "organization". Once set, the parent
+        # cannot be modified. The `parent` can be set on creation or using the
+        # `UpdateProject` method; the end user must have the
+        # `resourcemanager.projects.create` permission on the parent.
+        #
+        # Read-write.
+        # Cloud Platform is a generic term for something you (a developer) may want to
+        # interact with through one of our API's. Some examples are an AppEngine app,
+        # a Compute Engine instance, a Cloud SQL database, and so on.
+      "type": "A String", # Required field representing the resource type this id is for.
+          # At present, the only valid type is "organization".
+      "id": "A String", # Required field for the type-specific id. This should correspond to the id
+          # used in the type-specific API's.
     },
-    "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-    "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+    "projectId": "A String", # The unique, user-assigned ID of the Project.
+        # It must be 6 to 30 lowercase letters, digits, or hyphens.
+        # It must start with a letter.
+        # Trailing hyphens are prohibited.
+        #
+        # Example: <code>tokyo-rain-123</code>
+        #
+        # Read-only after creation.
+    "labels": { # The labels associated with this Project.
+        #
+        # Label keys must be between 1 and 63 characters long and must conform
+        # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+        #
+        # Label values must be between 0 and 63 characters long and must conform
+        # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+        #
+        # No more than 256 labels can be associated with a given resource.
+        #
+        # Clients should store labels in a representation such as JSON that does not
+        # depend on specific characters being disallowed.
+        #
+        # Example: <code>"environment" : "dev"</code>
+        #
+        # Read-write.
       "a_key": "A String",
     },
-    "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-    "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-    "createTime": "A String", # Creation time. Read-only.
+    "createTime": "A String", # Creation time.
+        #
+        # Read-only.
+    "lifecycleState": "A String", # The Project lifecycle state.
+        #
+        # Read-only.
+    "projectNumber": "A String", # The number uniquely identifying the project.
+        #
+        # Example: <code>415104041262</code>
+        #
+        # Read-only.
   }</pre>
 </div>
 
diff --git a/docs/dyn/cloudresourcemanager_v1beta1.organizations.html b/docs/dyn/cloudresourcemanager_v1beta1.organizations.html
index 5ba6cdceada..ed08cef545b 100644
--- a/docs/dyn/cloudresourcemanager_v1beta1.organizations.html
+++ b/docs/dyn/cloudresourcemanager_v1beta1.organizations.html
@@ -78,22 +78,22 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(name, organizationId=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Fetches an Organization resource identified by the specified resource name.</p>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the access control policy for an Organization resource. May be empty if no such policy or resource exists. The `resource` field should be the organization's resource name, e.g. "organizations/123".</p>
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the access control policy for an Organization resource. May be empty</p>
 <p class="toc_element">
   <code><a href="#list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists Organization resources that are visible to the user and satisfy the specified filter. This method returns Organizations in an unspecified order. New Organizations do not necessarily appear at the end of the list.</p>
+<p class="firstline">Lists Organization resources that are visible to the user and satisfy</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the access control policy on an Organization resource. Replaces any existing policy. The `resource` field should be the organization's resource name, e.g. "organizations/123".</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the access control policy on an Organization resource. Replaces any</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Returns permissions that a caller has on the specified Organization. The `resource` field should be the organization's resource name, e.g. "organizations/123".</p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Returns permissions that a caller has on the specified Organization.</p>
 <p class="toc_element">
-  <code><a href="#update">update(name, body, x__xgafv=None)</a></code></p>
+  <code><a href="#update">update(name=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Updates an Organization resource identified by the specified resource name.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -102,30 +102,54 @@ <h3>Method Details</h3>
 
 Args:
   name: string, The resource name of the Organization to fetch, e.g. "organizations/1234". (required)
-  organizationId: string, The id of the Organization resource to fetch. This field is deprecated and will be removed in v1. Use name instead.
+  organizationId: string, The id of the Organization resource to fetch.
+This field is deprecated and will be removed in v1. Use name instead.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # The root node in the resource hierarchy to which a particular entity's (e.g., company) resources belong.
-    "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI. Assigned by the server, set to the firm name of the Google For Work customer that owns this organization. @OutputOnly
-    "name": "A String", # Output Only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organization_id]". For example, "organizations/1234".
-    "organizationId": "A String", # An immutable id for the Organization that is assigned on creation. This should be omitted when creating a new Organization. This field is read-only. This field is deprecated and will be removed in v1. Use name instead.
-    "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server. @OutputOnly
-    "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server. @OutputOnly
-    "owner": { # The entity that owns an Organization. The lifetime of the Organization and all of its descendants are bound to the `OrganizationOwner`. If the `OrganizationOwner` is deleted, the Organization and all its descendants will be deleted. # The owner of this Organization. The owner should be specified on creation. Once set, it cannot be changed. This field is required.
+    { # The root node in the resource hierarchy to which a particular entity's
+      # (e.g., company) resources belong.
+    "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI.
+        # Assigned by the server, set to the firm name of the Google For Work
+        # customer that owns this organization.
+        # @OutputOnly
+    "name": "A String", # Output Only. The resource name of the organization. This is the
+        # organization's relative path in the API. Its format is
+        # "organizations/[organization_id]". For example, "organizations/1234".
+    "organizationId": "A String", # An immutable id for the Organization that is assigned on creation. This
+        # should be omitted when creating a new Organization.
+        # This field is read-only.
+        # This field is deprecated and will be removed in v1. Use name instead.
+    "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server.
+        # @OutputOnly
+    "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server.
+        # @OutputOnly
+    "owner": { # The entity that owns an Organization. The lifetime of the Organization and # The owner of this Organization. The owner should be specified on
+        # creation. Once set, it cannot be changed.
+        # This field is required.
+        # all of its descendants are bound to the `OrganizationOwner`. If the
+        # `OrganizationOwner` is deleted, the Organization and all its descendants will
+        # be deleted.
       "directoryCustomerId": "A String", # The Google for Work customer id used in the Directory API.
     },
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Gets the access control policy for an Organization resource. May be empty if no such policy or resource exists. The `resource` field should be the organization's resource name, e.g. "organizations/123".
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Gets the access control policy for an Organization resource. May be empty
+if no such policy or resource exists. The `resource` field should be the
+organization's resource name, e.g. "organizations/123".
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
@@ -133,47 +157,154 @@ <h3>Method Details</h3>
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists Organization resources that are visible to the user and satisfy the specified filter. This method returns Organizations in an unspecified order. New Organizations do not necessarily appear at the end of the list.
+  <pre>Lists Organization resources that are visible to the user and satisfy
+the specified filter. This method returns Organizations in an unspecified
+order. New Organizations do not necessarily appear at the end of the list.
 
 Args:
-  pageSize: integer, The maximum number of Organizations to return in the response. This field is optional.
-  filter: string, An optional query string used to filter the Organizations to return in the response. Filter rules are case-insensitive. Organizations may be filtered by `owner.directoryCustomerId` or by `domain`, where the domain is a Google for Work domain, for example: |Filter|Description| |------|-----------| |owner.directorycustomerid:123456789|Organizations with `owner.directory_customer_id` equal to `123456789`.| |domain:google.com|Organizations corresponding to the domain `google.com`.| This field is optional.
-  pageToken: string, A pagination token returned from a previous call to `ListOrganizations` that indicates from where listing should continue. This field is optional.
+  pageSize: integer, The maximum number of Organizations to return in the response.
+This field is optional.
+  filter: string, An optional query string used to filter the Organizations to return in
+the response. Filter rules are case-insensitive.
+
+
+Organizations may be filtered by `owner.directoryCustomerId` or by
+`domain`, where the domain is a Google for Work domain, for example:
+
+|Filter|Description|
+|------|-----------|
+|owner.directorycustomerid:123456789|Organizations with `owner.directory_customer_id` equal to `123456789`.|
+|domain:google.com|Organizations corresponding to the domain `google.com`.|
+
+This field is optional.
+  pageToken: string, A pagination token returned from a previous call to `ListOrganizations`
+that indicates from where listing should continue.
+This field is optional.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # The response returned from the `ListOrganizations` method.
-    "nextPageToken": "A String", # A pagination token to be used to retrieve the next page of results. If the result is too large to fit within the page size specified in the request, this field will be set with a token that can be used to fetch the next page of results. If this field is empty, it indicates that this response contains the last page of results.
+    "nextPageToken": "A String", # A pagination token to be used to retrieve the next page of results. If the
+        # result is too large to fit within the page size specified in the request,
+        # this field will be set with a token that can be used to fetch the next page
+        # of results. If this field is empty, it indicates that this response
+        # contains the last page of results.
     "organizations": [ # The list of Organizations that matched the list query, possibly paginated.
-      { # The root node in the resource hierarchy to which a particular entity's (e.g., company) resources belong.
-        "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI. Assigned by the server, set to the firm name of the Google For Work customer that owns this organization. @OutputOnly
-        "name": "A String", # Output Only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organization_id]". For example, "organizations/1234".
-        "organizationId": "A String", # An immutable id for the Organization that is assigned on creation. This should be omitted when creating a new Organization. This field is read-only. This field is deprecated and will be removed in v1. Use name instead.
-        "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server. @OutputOnly
-        "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server. @OutputOnly
-        "owner": { # The entity that owns an Organization. The lifetime of the Organization and all of its descendants are bound to the `OrganizationOwner`. If the `OrganizationOwner` is deleted, the Organization and all its descendants will be deleted. # The owner of this Organization. The owner should be specified on creation. Once set, it cannot be changed. This field is required.
+      { # The root node in the resource hierarchy to which a particular entity's
+          # (e.g., company) resources belong.
+        "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI.
+            # Assigned by the server, set to the firm name of the Google For Work
+            # customer that owns this organization.
+            # @OutputOnly
+        "name": "A String", # Output Only. The resource name of the organization. This is the
+            # organization's relative path in the API. Its format is
+            # "organizations/[organization_id]". For example, "organizations/1234".
+        "organizationId": "A String", # An immutable id for the Organization that is assigned on creation. This
+            # should be omitted when creating a new Organization.
+            # This field is read-only.
+            # This field is deprecated and will be removed in v1. Use name instead.
+        "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server.
+            # @OutputOnly
+        "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server.
+            # @OutputOnly
+        "owner": { # The entity that owns an Organization. The lifetime of the Organization and # The owner of this Organization. The owner should be specified on
+            # creation. Once set, it cannot be changed.
+            # This field is required.
+            # all of its descendants are bound to the `OrganizationOwner`. If the
+            # `OrganizationOwner` is deleted, the Organization and all its descendants will
+            # be deleted.
           "directoryCustomerId": "A String", # The Google for Work customer id used in the Directory API.
         },
       },
@@ -196,107 +327,293 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the access control policy on an Organization resource. Replaces any existing policy. The `resource` field should be the organization's resource name, e.g. "organizations/123".
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the access control policy on an Organization resource. Replaces any
+existing policy. The `resource` field should be the organization's resource
+name, e.g. "organizations/123".
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
-  <pre>Returns permissions that a caller has on the specified Organization. The `resource` field should be the organization's resource name, e.g. "organizations/123".
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
+  <pre>Returns permissions that a caller has on the specified Organization.
+The `resource` field should be the organization's resource name,
+e.g. "organizations/123".
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(name, body, x__xgafv=None)</code>
+    <code class="details" id="update">update(name=None, body, x__xgafv=None)</code>
   <pre>Updates an Organization resource identified by the specified resource name.
 
 Args:
-  name: string, Output Only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organization_id]". For example, "organizations/1234". (required)
+  name: string, Output Only. The resource name of the organization. This is the
+organization's relative path in the API. Its format is
+"organizations/[organization_id]". For example, "organizations/1234". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # The root node in the resource hierarchy to which a particular entity's (e.g., company) resources belong.
-  "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI. Assigned by the server, set to the firm name of the Google For Work customer that owns this organization. @OutputOnly
-  "name": "A String", # Output Only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organization_id]". For example, "organizations/1234".
-  "organizationId": "A String", # An immutable id for the Organization that is assigned on creation. This should be omitted when creating a new Organization. This field is read-only. This field is deprecated and will be removed in v1. Use name instead.
-  "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server. @OutputOnly
-  "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server. @OutputOnly
-  "owner": { # The entity that owns an Organization. The lifetime of the Organization and all of its descendants are bound to the `OrganizationOwner`. If the `OrganizationOwner` is deleted, the Organization and all its descendants will be deleted. # The owner of this Organization. The owner should be specified on creation. Once set, it cannot be changed. This field is required.
+{ # The root node in the resource hierarchy to which a particular entity's
+    # (e.g., company) resources belong.
+  "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI.
+      # Assigned by the server, set to the firm name of the Google For Work
+      # customer that owns this organization.
+      # @OutputOnly
+  "name": "A String", # Output Only. The resource name of the organization. This is the
+      # organization's relative path in the API. Its format is
+      # "organizations/[organization_id]". For example, "organizations/1234".
+  "organizationId": "A String", # An immutable id for the Organization that is assigned on creation. This
+      # should be omitted when creating a new Organization.
+      # This field is read-only.
+      # This field is deprecated and will be removed in v1. Use name instead.
+  "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server.
+      # @OutputOnly
+  "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server.
+      # @OutputOnly
+  "owner": { # The entity that owns an Organization. The lifetime of the Organization and # The owner of this Organization. The owner should be specified on
+      # creation. Once set, it cannot be changed.
+      # This field is required.
+      # all of its descendants are bound to the `OrganizationOwner`. If the
+      # `OrganizationOwner` is deleted, the Organization and all its descendants will
+      # be deleted.
     "directoryCustomerId": "A String", # The Google for Work customer id used in the Directory API.
   },
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # The root node in the resource hierarchy to which a particular entity's (e.g., company) resources belong.
-    "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI. Assigned by the server, set to the firm name of the Google For Work customer that owns this organization. @OutputOnly
-    "name": "A String", # Output Only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organization_id]". For example, "organizations/1234".
-    "organizationId": "A String", # An immutable id for the Organization that is assigned on creation. This should be omitted when creating a new Organization. This field is read-only. This field is deprecated and will be removed in v1. Use name instead.
-    "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server. @OutputOnly
-    "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server. @OutputOnly
-    "owner": { # The entity that owns an Organization. The lifetime of the Organization and all of its descendants are bound to the `OrganizationOwner`. If the `OrganizationOwner` is deleted, the Organization and all its descendants will be deleted. # The owner of this Organization. The owner should be specified on creation. Once set, it cannot be changed. This field is required.
+    { # The root node in the resource hierarchy to which a particular entity's
+      # (e.g., company) resources belong.
+    "displayName": "A String", # A friendly string to be used to refer to the Organization in the UI.
+        # Assigned by the server, set to the firm name of the Google For Work
+        # customer that owns this organization.
+        # @OutputOnly
+    "name": "A String", # Output Only. The resource name of the organization. This is the
+        # organization's relative path in the API. Its format is
+        # "organizations/[organization_id]". For example, "organizations/1234".
+    "organizationId": "A String", # An immutable id for the Organization that is assigned on creation. This
+        # should be omitted when creating a new Organization.
+        # This field is read-only.
+        # This field is deprecated and will be removed in v1. Use name instead.
+    "creationTime": "A String", # Timestamp when the Organization was created. Assigned by the server.
+        # @OutputOnly
+    "lifecycleState": "A String", # The organization's current lifecycle state. Assigned by the server.
+        # @OutputOnly
+    "owner": { # The entity that owns an Organization. The lifetime of the Organization and # The owner of this Organization. The owner should be specified on
+        # creation. Once set, it cannot be changed.
+        # This field is required.
+        # all of its descendants are bound to the `OrganizationOwner`. If the
+        # `OrganizationOwner` is deleted, the Organization and all its descendants will
+        # be deleted.
       "directoryCustomerId": "A String", # The Google for Work customer id used in the Directory API.
     },
   }</pre>
diff --git a/docs/dyn/cloudresourcemanager_v1beta1.projects.html b/docs/dyn/cloudresourcemanager_v1beta1.projects.html
index 1c5be4862da..36afd11e810 100644
--- a/docs/dyn/cloudresourcemanager_v1beta1.projects.html
+++ b/docs/dyn/cloudresourcemanager_v1beta1.projects.html
@@ -76,148 +76,372 @@ <h1><a href="cloudresourcemanager_v1beta1.html">Google Cloud Resource Manager AP
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#create">create(body, useLegacyStack=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a Project resource. Initially, the Project resource is owned by its creator exclusively. The creator can later grant permission to others to read or update the Project. Several APIs are activated automatically for the Project, including Google Cloud Storage.</p>
+<p class="firstline">Creates a Project resource.</p>
 <p class="toc_element">
-  <code><a href="#delete">delete(projectId, x__xgafv=None)</a></code></p>
-<p class="firstline">Marks the Project identified by the specified `project_id` (for example, `my-project-123`) for deletion. This method will only affect the Project if the following criteria are met: + The Project does not have a billing account associated with it. + The Project has a lifecycle state of ACTIVE. This method changes the Project's lifecycle state from ACTIVE to DELETE_REQUESTED. The deletion starts at an unspecified time, at which point the project is no longer accessible. Until the deletion completes, you can check the lifecycle state checked by retrieving the Project with GetProject, and the Project remains visible to ListProjects. However, you cannot update the project. After the deletion completes, the Project is not retrievable by the GetProject and ListProjects methods. The caller must have modify permissions for this Project.</p>
+  <code><a href="#delete">delete(projectId=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Marks the Project identified by the specified</p>
 <p class="toc_element">
-  <code><a href="#get">get(projectId, x__xgafv=None)</a></code></p>
-<p class="firstline">Retrieves the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have read permissions for this Project.</p>
+  <code><a href="#get">get(projectId=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Retrieves the Project identified by the specified</p>
 <p class="toc_element">
-  <code><a href="#getAncestry">getAncestry(projectId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets a list of ancestors in the resource hierarchy for the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have read permissions for this Project.</p>
+  <code><a href="#getAncestry">getAncestry(projectId=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets a list of ancestors in the resource hierarchy for the Project</p>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Returns the IAM access control policy for the specified Project. Permission is denied if the policy or the resource does not exist.</p>
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Returns the IAM access control policy for the specified Project.</p>
 <p class="toc_element">
   <code><a href="#list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists Projects that are visible to the user and satisfy the specified filter. This method returns Projects in an unspecified order. New Projects do not necessarily appear at the end of the list.</p>
+<p class="firstline">Lists Projects that are visible to the user and satisfy the</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the IAM access control policy for the specified Project. Replaces any existing policy. The following constraints apply when using `setIamPolicy()`: + Project does not support `allUsers` and `allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The owner role can be granted only to `user` and `serviceAccount`. + Service accounts can be made owners of a project directly without any restrictions. However, to be added as an owner, a user must be invited via Cloud Platform console and must accept the invitation. + A user cannot be granted the owner role using `setIamPolicy()`. The user must be granted the owner role using the Cloud Platform Console and must explicitly accept the invitation. + Invitations to grant the owner role cannot be sent using `setIamPolicy()`; they must be sent only using the Cloud Platform Console. + Membership changes that leave the project without any owners that have accepted the Terms of Service (ToS) will be rejected. + There must be at least one owner who has accepted the Terms of Service (ToS) agreement in the policy. Calling `setIamPolicy()` to to remove the last ToS-accepted owner from the policy will fail. This restriction also applies to legacy projects that no longer have owners who have accepted the ToS. Edits to IAM policies will be rejected until the lack of a ToS-accepting owner is rectified. + Calling this method requires enabling the App Engine Admin API. Note: Removing service accounts from policies or changing their roles can render services completely inoperable. It is important to understand how the service account is being used before removing or updating its roles.</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the IAM access control policy for the specified Project. Replaces</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified Project.</p>
 <p class="toc_element">
-  <code><a href="#undelete">undelete(projectId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Restores the Project identified by the specified `project_id` (for example, `my-project-123`). You can only use this method for a Project that has a lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot be restored. The caller must have modify permissions for this Project.</p>
+  <code><a href="#undelete">undelete(projectId=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Restores the Project identified by the specified</p>
 <p class="toc_element">
-  <code><a href="#update">update(projectId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the attributes of the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have modify permissions for this Project.</p>
+  <code><a href="#update">update(projectId=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates the attributes of the Project identified by the specified</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(body, useLegacyStack=None, x__xgafv=None)</code>
-  <pre>Creates a Project resource. Initially, the Project resource is owned by its creator exclusively. The creator can later grant permission to others to read or update the Project. Several APIs are activated automatically for the Project, including Google Cloud Storage.
+  <pre>Creates a Project resource.
+
+Initially, the Project resource is owned by its creator exclusively.
+The creator can later grant permission to others to read or update the
+Project.
+
+Several APIs are activated automatically for the Project, including
+Google Cloud Storage.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-  "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-  "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-    "type": "A String", # Required field representing the resource type this id is for. At present, the valid types are "project" and "organization".
-    "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+{ # A Project is a high-level Google Cloud Platform entity.  It is a
+    # container for ACLs, APIs, AppEngine Apps, VMs, and other
+    # Google Cloud Platform resources.
+  "name": "A String", # The user-assigned display name of the Project.
+      # It must be 4 to 30 characters.
+      # Allowed characters are: lowercase and uppercase letters, numbers,
+      # hyphen, single-quote, double-quote, space, and exclamation point.
+      # 
+      # Example: <code>My Project</code>
+      # 
+      # Read-write.
+  "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+      # 
+      # The only supported parent type is "organization". Once set, the parent
+      # cannot be modified. The `parent` can be set on creation or using the
+      # `UpdateProject` method; the end user must have the
+      # `resourcemanager.projects.create` permission on the parent.
+      # 
+      # Read-write.
+      # Cloud Platform is a generic term for something you (a developer) may want to
+      # interact with through one of our API's. Some examples are an AppEngine app,
+      # a Compute Engine instance, a Cloud SQL database, and so on.
+    "type": "A String", # Required field representing the resource type this id is for.
+        # At present, the valid types are "project" and "organization".
+    "id": "A String", # Required field for the type-specific id. This should correspond to the id
+        # used in the type-specific API's.
   },
-  "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-  "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+  "projectId": "A String", # The unique, user-assigned ID of the Project.
+      # It must be 6 to 30 lowercase letters, digits, or hyphens.
+      # It must start with a letter.
+      # Trailing hyphens are prohibited.
+      # 
+      # Example: <code>tokyo-rain-123</code>
+      # 
+      # Read-only after creation.
+  "labels": { # The labels associated with this Project.
+      # 
+      # Label keys must be between 1 and 63 characters long and must conform
+      # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+      # 
+      # Label values must be between 0 and 63 characters long and must conform
+      # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+      # 
+      # No more than 256 labels can be associated with a given resource.
+      # 
+      # Clients should store labels in a representation such as JSON that does not
+      # depend on specific characters being disallowed.
+      # 
+      # Example: <code>"environment" : "dev"</code>
+      # 
+      # Read-write.
     "a_key": "A String",
   },
-  "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-  "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-  "createTime": "A String", # Creation time. Read-only.
+  "createTime": "A String", # Creation time.
+      # 
+      # Read-only.
+  "lifecycleState": "A String", # The Project lifecycle state.
+      # 
+      # Read-only.
+  "projectNumber": "A String", # The number uniquely identifying the project.
+      # 
+      # Example: <code>415104041262</code>
+      # 
+      # Read-only.
 }
 
   useLegacyStack: boolean, A safety hatch to opt out of the new reliable project creation process.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-    "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-    "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-      "type": "A String", # Required field representing the resource type this id is for. At present, the valid types are "project" and "organization".
-      "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+    { # A Project is a high-level Google Cloud Platform entity.  It is a
+      # container for ACLs, APIs, AppEngine Apps, VMs, and other
+      # Google Cloud Platform resources.
+    "name": "A String", # The user-assigned display name of the Project.
+        # It must be 4 to 30 characters.
+        # Allowed characters are: lowercase and uppercase letters, numbers,
+        # hyphen, single-quote, double-quote, space, and exclamation point.
+        #
+        # Example: <code>My Project</code>
+        #
+        # Read-write.
+    "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+        #
+        # The only supported parent type is "organization". Once set, the parent
+        # cannot be modified. The `parent` can be set on creation or using the
+        # `UpdateProject` method; the end user must have the
+        # `resourcemanager.projects.create` permission on the parent.
+        #
+        # Read-write.
+        # Cloud Platform is a generic term for something you (a developer) may want to
+        # interact with through one of our API's. Some examples are an AppEngine app,
+        # a Compute Engine instance, a Cloud SQL database, and so on.
+      "type": "A String", # Required field representing the resource type this id is for.
+          # At present, the valid types are "project" and "organization".
+      "id": "A String", # Required field for the type-specific id. This should correspond to the id
+          # used in the type-specific API's.
     },
-    "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-    "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+    "projectId": "A String", # The unique, user-assigned ID of the Project.
+        # It must be 6 to 30 lowercase letters, digits, or hyphens.
+        # It must start with a letter.
+        # Trailing hyphens are prohibited.
+        #
+        # Example: <code>tokyo-rain-123</code>
+        #
+        # Read-only after creation.
+    "labels": { # The labels associated with this Project.
+        #
+        # Label keys must be between 1 and 63 characters long and must conform
+        # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+        #
+        # Label values must be between 0 and 63 characters long and must conform
+        # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+        #
+        # No more than 256 labels can be associated with a given resource.
+        #
+        # Clients should store labels in a representation such as JSON that does not
+        # depend on specific characters being disallowed.
+        #
+        # Example: <code>"environment" : "dev"</code>
+        #
+        # Read-write.
       "a_key": "A String",
     },
-    "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-    "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-    "createTime": "A String", # Creation time. Read-only.
+    "createTime": "A String", # Creation time.
+        #
+        # Read-only.
+    "lifecycleState": "A String", # The Project lifecycle state.
+        #
+        # Read-only.
+    "projectNumber": "A String", # The number uniquely identifying the project.
+        #
+        # Example: <code>415104041262</code>
+        #
+        # Read-only.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="delete">delete(projectId, x__xgafv=None)</code>
-  <pre>Marks the Project identified by the specified `project_id` (for example, `my-project-123`) for deletion. This method will only affect the Project if the following criteria are met: + The Project does not have a billing account associated with it. + The Project has a lifecycle state of ACTIVE. This method changes the Project's lifecycle state from ACTIVE to DELETE_REQUESTED. The deletion starts at an unspecified time, at which point the project is no longer accessible. Until the deletion completes, you can check the lifecycle state checked by retrieving the Project with GetProject, and the Project remains visible to ListProjects. However, you cannot update the project. After the deletion completes, the Project is not retrievable by the GetProject and ListProjects methods. The caller must have modify permissions for this Project.
+    <code class="details" id="delete">delete(projectId=None, x__xgafv=None)</code>
+  <pre>Marks the Project identified by the specified
+`project_id` (for example, `my-project-123`) for deletion.
+This method will only affect the Project if the following criteria are met:
+
++ The Project does not have a billing account associated with it.
++ The Project has a lifecycle state of
+ACTIVE.
+
+This method changes the Project's lifecycle state from
+ACTIVE
+to DELETE_REQUESTED.
+The deletion starts at an unspecified time, at which point the project is
+no longer accessible.
+
+Until the deletion completes, you can check the lifecycle state
+checked by retrieving the Project with GetProject,
+and the Project remains visible to ListProjects.
+However, you cannot update the project.
+
+After the deletion completes, the Project is not retrievable by
+the  GetProject and
+ListProjects methods.
+
+The caller must have modify permissions for this Project.
 
 Args:
-  projectId: string, The Project ID (for example, `foo-bar-123`). Required. (required)
+  projectId: string, The Project ID (for example, `foo-bar-123`).
+
+Required. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="get">get(projectId, x__xgafv=None)</code>
-  <pre>Retrieves the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have read permissions for this Project.
+    <code class="details" id="get">get(projectId=None, x__xgafv=None)</code>
+  <pre>Retrieves the Project identified by the specified
+`project_id` (for example, `my-project-123`).
+
+The caller must have read permissions for this Project.
 
 Args:
-  projectId: string, The Project ID (for example, `my-project-123`). Required. (required)
+  projectId: string, The Project ID (for example, `my-project-123`).
+
+Required. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-    "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-    "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-      "type": "A String", # Required field representing the resource type this id is for. At present, the valid types are "project" and "organization".
-      "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+    { # A Project is a high-level Google Cloud Platform entity.  It is a
+      # container for ACLs, APIs, AppEngine Apps, VMs, and other
+      # Google Cloud Platform resources.
+    "name": "A String", # The user-assigned display name of the Project.
+        # It must be 4 to 30 characters.
+        # Allowed characters are: lowercase and uppercase letters, numbers,
+        # hyphen, single-quote, double-quote, space, and exclamation point.
+        #
+        # Example: <code>My Project</code>
+        #
+        # Read-write.
+    "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+        #
+        # The only supported parent type is "organization". Once set, the parent
+        # cannot be modified. The `parent` can be set on creation or using the
+        # `UpdateProject` method; the end user must have the
+        # `resourcemanager.projects.create` permission on the parent.
+        #
+        # Read-write.
+        # Cloud Platform is a generic term for something you (a developer) may want to
+        # interact with through one of our API's. Some examples are an AppEngine app,
+        # a Compute Engine instance, a Cloud SQL database, and so on.
+      "type": "A String", # Required field representing the resource type this id is for.
+          # At present, the valid types are "project" and "organization".
+      "id": "A String", # Required field for the type-specific id. This should correspond to the id
+          # used in the type-specific API's.
     },
-    "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-    "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+    "projectId": "A String", # The unique, user-assigned ID of the Project.
+        # It must be 6 to 30 lowercase letters, digits, or hyphens.
+        # It must start with a letter.
+        # Trailing hyphens are prohibited.
+        #
+        # Example: <code>tokyo-rain-123</code>
+        #
+        # Read-only after creation.
+    "labels": { # The labels associated with this Project.
+        #
+        # Label keys must be between 1 and 63 characters long and must conform
+        # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+        #
+        # Label values must be between 0 and 63 characters long and must conform
+        # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+        #
+        # No more than 256 labels can be associated with a given resource.
+        #
+        # Clients should store labels in a representation such as JSON that does not
+        # depend on specific characters being disallowed.
+        #
+        # Example: <code>"environment" : "dev"</code>
+        #
+        # Read-write.
       "a_key": "A String",
     },
-    "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-    "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-    "createTime": "A String", # Creation time. Read-only.
+    "createTime": "A String", # Creation time.
+        #
+        # Read-only.
+    "lifecycleState": "A String", # The Project lifecycle state.
+        #
+        # Read-only.
+    "projectNumber": "A String", # The number uniquely identifying the project.
+        #
+        # Example: <code>415104041262</code>
+        #
+        # Read-only.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="getAncestry">getAncestry(projectId, body, x__xgafv=None)</code>
-  <pre>Gets a list of ancestors in the resource hierarchy for the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have read permissions for this Project.
+    <code class="details" id="getAncestry">getAncestry(projectId=None, body, x__xgafv=None)</code>
+  <pre>Gets a list of ancestors in the resource hierarchy for the Project
+identified by the specified `project_id` (for example, `my-project-123`).
+
+The caller must have read permissions for this Project.
 
 Args:
-  projectId: string, The Project ID (for example, `my-project-123`). Required. (required)
+  projectId: string, The Project ID (for example, `my-project-123`).
+
+Required. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # The request sent to the GetAncestry method.
+{ # The request sent to the
+      # GetAncestry
+      # method.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response from the GetAncestry method.
-    "ancestor": [ # Ancestors are ordered from bottom to top of the resource hierarchy. The first ancestor is the project itself, followed by the project's parent, etc.
+    "ancestor": [ # Ancestors are ordered from bottom to top of the resource hierarchy. The
+        # first ancestor is the project itself, followed by the project's parent,
+        # etc.
       { # Identifying information for a single ancestor of a project.
-        "resourceId": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # Resource id of the ancestor.
-          "type": "A String", # Required field representing the resource type this id is for. At present, the valid types are "project" and "organization".
-          "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+        "resourceId": { # A container to reference an id for any resource type. A `resource` in Google # Resource id of the ancestor.
+            # Cloud Platform is a generic term for something you (a developer) may want to
+            # interact with through one of our API's. Some examples are an AppEngine app,
+            # a Compute Engine instance, a Cloud SQL database, and so on.
+          "type": "A String", # Required field representing the resource type this id is for.
+              # At present, the valid types are "project" and "organization".
+          "id": "A String", # Required field for the type-specific id. This should correspond to the id
+              # used in the type-specific API's.
         },
       },
     ],
@@ -225,11 +449,14 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Returns the IAM access control policy for the specified Project. Permission is denied if the policy or the resource does not exist.
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Returns the IAM access control policy for the specified Project.
+Permission is denied if the policy or the resource does not exist.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
@@ -237,53 +464,219 @@ <h3>Method Details</h3>
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists Projects that are visible to the user and satisfy the specified filter. This method returns Projects in an unspecified order. New Projects do not necessarily appear at the end of the list.
+  <pre>Lists Projects that are visible to the user and satisfy the
+specified filter. This method returns Projects in an unspecified order.
+New Projects do not necessarily appear at the end of the list.
 
 Args:
-  pageSize: integer, The maximum number of Projects to return in the response. The server can return fewer Projects than requested. If unspecified, server picks an appropriate default. Optional.
-  filter: string, An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: + `name` + `id` + labels.key where *key* is the name of a label Some examples of using labels as filters: |Filter|Description| |------|-----------| |name:*|The project has a name.| |name:Howl|The project's name is `Howl` or `howl`.| |name:HOWL|Equivalent to above.| |NAME:howl|Equivalent to above.| |labels.color:*|The project has the label `color`.| |labels.color:red|The project's label `color` has the value `red`.| |labels.color:red label.size:big|The project's label `color` has the value `red` and its label `size` has the value `big`. Optional.
-  pageToken: string, A pagination token returned from a previous call to ListProjects that indicates from where listing should continue. Optional.
+  pageSize: integer, The maximum number of Projects to return in the response.
+The server can return fewer Projects than requested.
+If unspecified, server picks an appropriate default.
+
+Optional.
+  filter: string, An expression for filtering the results of the request.  Filter rules are
+case insensitive. The fields eligible for filtering are:
+
++ `name`
++ `id`
++ <code>labels.<em>key</em></code> where *key* is the name of a label
+
+Some examples of using labels as filters:
+
+|Filter|Description|
+|------|-----------|
+|name:*|The project has a name.|
+|name:Howl|The project's name is `Howl` or `howl`.|
+|name:HOWL|Equivalent to above.|
+|NAME:howl|Equivalent to above.|
+|labels.color:*|The project has the label `color`.|
+|labels.color:red|The project's label `color` has the value `red`.|
+|labels.color:red&nbsp;label.size:big|The project's label `color` has the value `red` and its label `size` has the value `big`.
+
+Optional.
+  pageToken: string, A pagination token returned from a previous call to ListProjects
+that indicates from where listing should continue.
+
+Optional.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A page of the response received from the ListProjects method. A paginated response where more pages are available has `next_page_token` set. This token can be used in a subsequent request to retrieve the next request page.
-    "nextPageToken": "A String", # Pagination token. If the result set is too large to fit in a single response, this token is returned. It encodes the position of the current result cursor. Feeding this value into a new list request with the `page_token` parameter gives the next page of the results. When `next_page_token` is not filled in, there is no next page and the list returned is the last page in the result set. Pagination tokens have a limited lifetime.
-    "projects": [ # The list of Projects that matched the list filter. This list can be paginated.
-      { # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-        "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-        "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-          "type": "A String", # Required field representing the resource type this id is for. At present, the valid types are "project" and "organization".
-          "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+    { # A page of the response received from the
+      # ListProjects
+      # method.
+      #
+      # A paginated response where more pages are available has
+      # `next_page_token` set. This token can be used in a subsequent request to
+      # retrieve the next request page.
+    "nextPageToken": "A String", # Pagination token.
+        #
+        # If the result set is too large to fit in a single response, this token
+        # is returned. It encodes the position of the current result cursor.
+        # Feeding this value into a new list request with the `page_token` parameter
+        # gives the next page of the results.
+        #
+        # When `next_page_token` is not filled in, there is no next page and
+        # the list returned is the last page in the result set.
+        #
+        # Pagination tokens have a limited lifetime.
+    "projects": [ # The list of Projects that matched the list filter. This list can
+        # be paginated.
+      { # A Project is a high-level Google Cloud Platform entity.  It is a
+          # container for ACLs, APIs, AppEngine Apps, VMs, and other
+          # Google Cloud Platform resources.
+        "name": "A String", # The user-assigned display name of the Project.
+            # It must be 4 to 30 characters.
+            # Allowed characters are: lowercase and uppercase letters, numbers,
+            # hyphen, single-quote, double-quote, space, and exclamation point.
+            #
+            # Example: <code>My Project</code>
+            #
+            # Read-write.
+        "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+            #
+            # The only supported parent type is "organization". Once set, the parent
+            # cannot be modified. The `parent` can be set on creation or using the
+            # `UpdateProject` method; the end user must have the
+            # `resourcemanager.projects.create` permission on the parent.
+            #
+            # Read-write.
+            # Cloud Platform is a generic term for something you (a developer) may want to
+            # interact with through one of our API's. Some examples are an AppEngine app,
+            # a Compute Engine instance, a Cloud SQL database, and so on.
+          "type": "A String", # Required field representing the resource type this id is for.
+              # At present, the valid types are "project" and "organization".
+          "id": "A String", # Required field for the type-specific id. This should correspond to the id
+              # used in the type-specific API's.
         },
-        "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-        "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+        "projectId": "A String", # The unique, user-assigned ID of the Project.
+            # It must be 6 to 30 lowercase letters, digits, or hyphens.
+            # It must start with a letter.
+            # Trailing hyphens are prohibited.
+            #
+            # Example: <code>tokyo-rain-123</code>
+            #
+            # Read-only after creation.
+        "labels": { # The labels associated with this Project.
+            #
+            # Label keys must be between 1 and 63 characters long and must conform
+            # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+            #
+            # Label values must be between 0 and 63 characters long and must conform
+            # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+            #
+            # No more than 256 labels can be associated with a given resource.
+            #
+            # Clients should store labels in a representation such as JSON that does not
+            # depend on specific characters being disallowed.
+            #
+            # Example: <code>"environment" : "dev"</code>
+            #
+            # Read-write.
           "a_key": "A String",
         },
-        "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-        "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-        "createTime": "A String", # Creation time. Read-only.
+        "createTime": "A String", # Creation time.
+            #
+            # Read-only.
+        "lifecycleState": "A String", # The Project lifecycle state.
+            #
+            # Read-only.
+        "projectNumber": "A String", # The number uniquely identifying the project.
+            #
+            # Example: <code>415104041262</code>
+            #
+            # Read-only.
       },
     ],
   }</pre>
@@ -304,138 +697,448 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the IAM access control policy for the specified Project. Replaces any existing policy. The following constraints apply when using `setIamPolicy()`: + Project does not support `allUsers` and `allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The owner role can be granted only to `user` and `serviceAccount`. + Service accounts can be made owners of a project directly without any restrictions. However, to be added as an owner, a user must be invited via Cloud Platform console and must accept the invitation. + A user cannot be granted the owner role using `setIamPolicy()`. The user must be granted the owner role using the Cloud Platform Console and must explicitly accept the invitation. + Invitations to grant the owner role cannot be sent using `setIamPolicy()`; they must be sent only using the Cloud Platform Console. + Membership changes that leave the project without any owners that have accepted the Terms of Service (ToS) will be rejected. + There must be at least one owner who has accepted the Terms of Service (ToS) agreement in the policy. Calling `setIamPolicy()` to to remove the last ToS-accepted owner from the policy will fail. This restriction also applies to legacy projects that no longer have owners who have accepted the ToS. Edits to IAM policies will be rejected until the lack of a ToS-accepting owner is rectified. + Calling this method requires enabling the App Engine Admin API. Note: Removing service accounts from policies or changing their roles can render services completely inoperable. It is important to understand how the service account is being used before removing or updating its roles.
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the IAM access control policy for the specified Project. Replaces
+any existing policy.
+
+The following constraints apply when using `setIamPolicy()`:
+
++ Project does not support `allUsers` and `allAuthenticatedUsers` as
+`members` in a `Binding` of a `Policy`.
+
++ The owner role can be granted only to `user` and `serviceAccount`.
+
++ Service accounts can be made owners of a project directly
+without any restrictions. However, to be added as an owner, a user must be
+invited via Cloud Platform console and must accept the invitation.
+
++ A user cannot be granted the owner role using `setIamPolicy()`. The user
+must be granted the owner role using the Cloud Platform Console and must
+explicitly accept the invitation.
+
++ Invitations to grant the owner role cannot be sent using `setIamPolicy()`;
+they must be sent only using the Cloud Platform Console.
+
++ Membership changes that leave the project without any owners that have
+accepted the Terms of Service (ToS) will be rejected.
+
++ There must be at least one owner who has accepted the Terms of
+Service (ToS) agreement in the policy. Calling `setIamPolicy()` to
+to remove the last ToS-accepted owner from the policy will fail. This
+restriction also applies to legacy projects that no longer have owners
+who have accepted the ToS. Edits to IAM policies will be rejected until
+the lack of a ToS-accepting owner is rectified.
+
++ Calling this method requires enabling the App Engine Admin API.
+
+Note: Removing service accounts from policies or changing their roles
+can render services completely inoperable. It is important to understand
+how the service account is being used before removing or updating its roles.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
   <pre>Returns permissions that a caller has on the specified Project.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="undelete">undelete(projectId, body, x__xgafv=None)</code>
-  <pre>Restores the Project identified by the specified `project_id` (for example, `my-project-123`). You can only use this method for a Project that has a lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot be restored. The caller must have modify permissions for this Project.
+    <code class="details" id="undelete">undelete(projectId=None, body, x__xgafv=None)</code>
+  <pre>Restores the Project identified by the specified
+`project_id` (for example, `my-project-123`).
+You can only use this method for a Project that has a lifecycle state of
+DELETE_REQUESTED.
+After deletion starts, the Project cannot be restored.
+
+The caller must have modify permissions for this Project.
 
 Args:
-  projectId: string, The project ID (for example, `foo-bar-123`). Required. (required)
+  projectId: string, The project ID (for example, `foo-bar-123`).
+
+Required. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # The request sent to the UndeleteProject method.
+{ # The request sent to the UndeleteProject
+      # method.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(projectId, body, x__xgafv=None)</code>
-  <pre>Updates the attributes of the Project identified by the specified `project_id` (for example, `my-project-123`). The caller must have modify permissions for this Project.
+    <code class="details" id="update">update(projectId=None, body, x__xgafv=None)</code>
+  <pre>Updates the attributes of the Project identified by the specified
+`project_id` (for example, `my-project-123`).
+
+The caller must have modify permissions for this Project.
 
 Args:
-  projectId: string, The project ID (for example, `my-project-123`). Required. (required)
+  projectId: string, The project ID (for example, `my-project-123`).
+
+Required. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-  "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-  "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-    "type": "A String", # Required field representing the resource type this id is for. At present, the valid types are "project" and "organization".
-    "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+{ # A Project is a high-level Google Cloud Platform entity.  It is a
+    # container for ACLs, APIs, AppEngine Apps, VMs, and other
+    # Google Cloud Platform resources.
+  "name": "A String", # The user-assigned display name of the Project.
+      # It must be 4 to 30 characters.
+      # Allowed characters are: lowercase and uppercase letters, numbers,
+      # hyphen, single-quote, double-quote, space, and exclamation point.
+      # 
+      # Example: <code>My Project</code>
+      # 
+      # Read-write.
+  "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+      # 
+      # The only supported parent type is "organization". Once set, the parent
+      # cannot be modified. The `parent` can be set on creation or using the
+      # `UpdateProject` method; the end user must have the
+      # `resourcemanager.projects.create` permission on the parent.
+      # 
+      # Read-write.
+      # Cloud Platform is a generic term for something you (a developer) may want to
+      # interact with through one of our API's. Some examples are an AppEngine app,
+      # a Compute Engine instance, a Cloud SQL database, and so on.
+    "type": "A String", # Required field representing the resource type this id is for.
+        # At present, the valid types are "project" and "organization".
+    "id": "A String", # Required field for the type-specific id. This should correspond to the id
+        # used in the type-specific API's.
   },
-  "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-  "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+  "projectId": "A String", # The unique, user-assigned ID of the Project.
+      # It must be 6 to 30 lowercase letters, digits, or hyphens.
+      # It must start with a letter.
+      # Trailing hyphens are prohibited.
+      # 
+      # Example: <code>tokyo-rain-123</code>
+      # 
+      # Read-only after creation.
+  "labels": { # The labels associated with this Project.
+      # 
+      # Label keys must be between 1 and 63 characters long and must conform
+      # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+      # 
+      # Label values must be between 0 and 63 characters long and must conform
+      # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+      # 
+      # No more than 256 labels can be associated with a given resource.
+      # 
+      # Clients should store labels in a representation such as JSON that does not
+      # depend on specific characters being disallowed.
+      # 
+      # Example: <code>"environment" : "dev"</code>
+      # 
+      # Read-write.
     "a_key": "A String",
   },
-  "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-  "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-  "createTime": "A String", # Creation time. Read-only.
+  "createTime": "A String", # Creation time.
+      # 
+      # Read-only.
+  "lifecycleState": "A String", # The Project lifecycle state.
+      # 
+      # Read-only.
+  "projectNumber": "A String", # The number uniquely identifying the project.
+      # 
+      # Example: <code>415104041262</code>
+      # 
+      # Read-only.
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
-    "name": "A String", # The user-assigned display name of the Project. It must be 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: My Project Read-write.
-    "parent": { # A container to reference an id for any resource type. A `resource` in Google Cloud Platform is a generic term for something you (a developer) may want to interact with through one of our API's. Some examples are an AppEngine app, a Compute Engine instance, a Cloud SQL database, and so on. # An optional reference to a parent Resource. The only supported parent type is "organization". Once set, the parent cannot be modified. Read-write.
-      "type": "A String", # Required field representing the resource type this id is for. At present, the valid types are "project" and "organization".
-      "id": "A String", # Required field for the type-specific id. This should correspond to the id used in the type-specific API's.
+    { # A Project is a high-level Google Cloud Platform entity.  It is a
+      # container for ACLs, APIs, AppEngine Apps, VMs, and other
+      # Google Cloud Platform resources.
+    "name": "A String", # The user-assigned display name of the Project.
+        # It must be 4 to 30 characters.
+        # Allowed characters are: lowercase and uppercase letters, numbers,
+        # hyphen, single-quote, double-quote, space, and exclamation point.
+        #
+        # Example: <code>My Project</code>
+        #
+        # Read-write.
+    "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+        #
+        # The only supported parent type is "organization". Once set, the parent
+        # cannot be modified. The `parent` can be set on creation or using the
+        # `UpdateProject` method; the end user must have the
+        # `resourcemanager.projects.create` permission on the parent.
+        #
+        # Read-write.
+        # Cloud Platform is a generic term for something you (a developer) may want to
+        # interact with through one of our API's. Some examples are an AppEngine app,
+        # a Compute Engine instance, a Cloud SQL database, and so on.
+      "type": "A String", # Required field representing the resource type this id is for.
+          # At present, the valid types are "project" and "organization".
+      "id": "A String", # Required field for the type-specific id. This should correspond to the id
+          # used in the type-specific API's.
     },
-    "projectId": "A String", # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: tokyo-rain-123 Read-only after creation.
-    "labels": { # The labels associated with this Project. Label keys must be between 1 and 63 characters long and must conform to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63 characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be associated with a given resource. Clients should store labels in a representation such as JSON that does not depend on specific characters being disallowed. Example: "environment" : "dev" Read-write.
+    "projectId": "A String", # The unique, user-assigned ID of the Project.
+        # It must be 6 to 30 lowercase letters, digits, or hyphens.
+        # It must start with a letter.
+        # Trailing hyphens are prohibited.
+        #
+        # Example: <code>tokyo-rain-123</code>
+        #
+        # Read-only after creation.
+    "labels": { # The labels associated with this Project.
+        #
+        # Label keys must be between 1 and 63 characters long and must conform
+        # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+        #
+        # Label values must be between 0 and 63 characters long and must conform
+        # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+        #
+        # No more than 256 labels can be associated with a given resource.
+        #
+        # Clients should store labels in a representation such as JSON that does not
+        # depend on specific characters being disallowed.
+        #
+        # Example: <code>"environment" : "dev"</code>
+        #
+        # Read-write.
       "a_key": "A String",
     },
-    "projectNumber": "A String", # The number uniquely identifying the project. Example: 415104041262 Read-only.
-    "lifecycleState": "A String", # The Project lifecycle state. Read-only.
-    "createTime": "A String", # Creation time. Read-only.
+    "createTime": "A String", # Creation time.
+        #
+        # Read-only.
+    "lifecycleState": "A String", # The Project lifecycle state.
+        #
+        # Read-only.
+    "projectNumber": "A String", # The number uniquely identifying the project.
+        #
+        # Example: <code>415104041262</code>
+        #
+        # Read-only.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.addresses.html b/docs/dyn/compute_alpha.addresses.html
index 1387bf9586b..6910c09bbab 100644
--- a/docs/dyn/compute_alpha.addresses.html
+++ b/docs/dyn/compute_alpha.addresses.html
@@ -151,7 +151,7 @@ <h3>Method Details</h3>
               "labels": { # Labels to apply to this Address resource. These can be later modified by the setLabels method. Each label key/value must comply with RFC1035. Label values may be empty.
                 "a_key": "A String",
               },
-              "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+              "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
               "address": "A String", # The static external IP address represented by this resource.
               "region": "A String", # [Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.
               "users": [ # [Output Only] The URLs of the resources that are using this address.
@@ -240,7 +240,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -266,7 +266,7 @@ <h3>Method Details</h3>
       "labels": { # Labels to apply to this Address resource. These can be later modified by the setLabels method. Each label key/value must comply with RFC1035. Label values may be empty.
         "a_key": "A String",
       },
-      "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
       "address": "A String", # The static external IP address represented by this resource.
       "region": "A String", # [Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.
       "users": [ # [Output Only] The URLs of the resources that are using this address.
@@ -299,7 +299,7 @@ <h3>Method Details</h3>
     "labels": { # Labels to apply to this Address resource. These can be later modified by the setLabels method. Each label key/value must comply with RFC1035. Label values may be empty.
       "a_key": "A String",
     },
-    "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+    "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
     "address": "A String", # The static external IP address represented by this resource.
     "region": "A String", # [Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.
     "users": [ # [Output Only] The URLs of the resources that are using this address.
@@ -358,7 +358,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -402,7 +402,7 @@ <h3>Method Details</h3>
           "labels": { # Labels to apply to this Address resource. These can be later modified by the setLabels method. Each label key/value must comply with RFC1035. Label values may be empty.
             "a_key": "A String",
           },
-          "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
           "address": "A String", # The static external IP address represented by this resource.
           "region": "A String", # [Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.
           "users": [ # [Output Only] The URLs of the resources that are using this address.
diff --git a/docs/dyn/compute_alpha.autoscalers.html b/docs/dyn/compute_alpha.autoscalers.html
index 368a11e94c8..1217b564106 100644
--- a/docs/dyn/compute_alpha.autoscalers.html
+++ b/docs/dyn/compute_alpha.autoscalers.html
@@ -282,7 +282,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -472,7 +472,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -700,7 +700,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -848,7 +848,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.backendBuckets.html b/docs/dyn/compute_alpha.backendBuckets.html
index a0bba70e782..b807d61acbd 100644
--- a/docs/dyn/compute_alpha.backendBuckets.html
+++ b/docs/dyn/compute_alpha.backendBuckets.html
@@ -159,7 +159,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -211,11 +211,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -268,6 +276,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -348,7 +358,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -480,7 +490,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -508,11 +518,19 @@ <h3>Method Details</h3>
   "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
       # 
       # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-    { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+    { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
       "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
         "A String",
       ],
-      "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      "auditLogConfigs": [ # The configuration for each type of logging
+        { # Provides the configuration for a sub-type of logging.
+          "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
     },
   ],
   "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -565,6 +583,8 @@ <h3>Method Details</h3>
           #
           # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
           #
+          #
+          #
           # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
           #
           # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -595,11 +615,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -652,6 +680,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -760,7 +790,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.backendServices.html b/docs/dyn/compute_alpha.backendServices.html
index f2dbbc43d74..10df0d3a46a 100644
--- a/docs/dyn/compute_alpha.backendServices.html
+++ b/docs/dyn/compute_alpha.backendServices.html
@@ -179,7 +179,19 @@ <h3>Method Details</h3>
                   # When the protocol is UDP, this field is not used.
               "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
               "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-              "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+              "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+                "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+                  "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+                  "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+                  "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+                    "A String",
+                  ],
+                  "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+                    "A String",
+                  ],
+                  "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+                },
+              },
               "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
                   #
                   # When the load balancing scheme is INTERNAL, this field is not used.
@@ -200,6 +212,7 @@ <h3>Method Details</h3>
                   "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
                       #
                       # This cannot be used for internal load balancing.
+                  "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
                   "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
                       #
                       # This cannot be used for internal load balancing.
@@ -227,19 +240,9 @@ <h3>Method Details</h3>
                 "oauth2ClientSecretSha256": "A String",
               },
               "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-              "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-                "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-                  "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-                  "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-                  "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-                    "A String",
-                  ],
-                  "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-                    "A String",
-                  ],
-                  "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-                },
-              },
+              "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+                "A String",
+              ],
               "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
               "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
                   #
@@ -247,6 +250,7 @@ <h3>Method Details</h3>
               "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
               "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
               "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+              "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
               "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
             },
         ],
@@ -326,7 +330,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -370,7 +374,19 @@ <h3>Method Details</h3>
           # When the protocol is UDP, this field is not used.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-      "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+          "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+            "A String",
+          ],
+          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+        },
+      },
       "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
           #
           # When the load balancing scheme is INTERNAL, this field is not used.
@@ -391,6 +407,7 @@ <h3>Method Details</h3>
           "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
               #
               # This cannot be used for internal load balancing.
+          "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
           "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
               #
               # This cannot be used for internal load balancing.
@@ -418,19 +435,9 @@ <h3>Method Details</h3>
         "oauth2ClientSecretSha256": "A String",
       },
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-          "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-            "A String",
-          ],
-          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-            "A String",
-          ],
-          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-        },
-      },
+      "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+        "A String",
+      ],
       "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
       "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
           #
@@ -438,6 +445,7 @@ <h3>Method Details</h3>
       "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
       "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
       "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+      "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
     }</pre>
 </div>
@@ -511,7 +519,19 @@ <h3>Method Details</h3>
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      },
+    },
     "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -532,6 +552,7 @@ <h3>Method Details</h3>
         "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
             #
             # This cannot be used for internal load balancing.
+        "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
         "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
@@ -559,19 +580,9 @@ <h3>Method Details</h3>
       "oauth2ClientSecretSha256": "A String",
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-      },
-    },
+    "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+      "A String",
+    ],
     "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
     "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
         # 
@@ -579,6 +590,7 @@ <h3>Method Details</h3>
     "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
   }
 
@@ -629,7 +641,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -691,7 +703,19 @@ <h3>Method Details</h3>
               # When the protocol is UDP, this field is not used.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-          "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+          "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+            "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+              "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+              "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+              "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+                "A String",
+              ],
+              "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+                "A String",
+              ],
+              "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            },
+          },
           "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
               #
               # When the load balancing scheme is INTERNAL, this field is not used.
@@ -712,6 +736,7 @@ <h3>Method Details</h3>
               "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
                   #
                   # This cannot be used for internal load balancing.
+              "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
               "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
                   #
                   # This cannot be used for internal load balancing.
@@ -739,19 +764,9 @@ <h3>Method Details</h3>
             "oauth2ClientSecretSha256": "A String",
           },
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-          "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-            "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-              "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-              "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-              "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-                "A String",
-              ],
-              "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-                "A String",
-              ],
-              "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-            },
-          },
+          "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+            "A String",
+          ],
           "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
           "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
               #
@@ -759,6 +774,7 @@ <h3>Method Details</h3>
           "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
           "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
           "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+          "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
           "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
         },
     ],
@@ -821,7 +837,19 @@ <h3>Method Details</h3>
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      },
+    },
     "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -842,6 +870,7 @@ <h3>Method Details</h3>
         "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
             #
             # This cannot be used for internal load balancing.
+        "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
         "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
@@ -869,19 +898,9 @@ <h3>Method Details</h3>
       "oauth2ClientSecretSha256": "A String",
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-      },
-    },
+    "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+      "A String",
+    ],
     "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
     "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
         # 
@@ -889,6 +908,7 @@ <h3>Method Details</h3>
     "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
   }
 
@@ -939,7 +959,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1009,7 +1029,19 @@ <h3>Method Details</h3>
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      },
+    },
     "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -1030,6 +1062,7 @@ <h3>Method Details</h3>
         "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
             #
             # This cannot be used for internal load balancing.
+        "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
         "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
@@ -1057,19 +1090,9 @@ <h3>Method Details</h3>
       "oauth2ClientSecretSha256": "A String",
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-      },
-    },
+    "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+      "A String",
+    ],
     "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
     "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
         # 
@@ -1077,6 +1100,7 @@ <h3>Method Details</h3>
     "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
   }
 
@@ -1127,7 +1151,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.commitments.html b/docs/dyn/compute_alpha.commitments.html
new file mode 100644
index 00000000000..ed994d72a55
--- /dev/null
+++ b/docs/dyn/compute_alpha.commitments.html
@@ -0,0 +1,713 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="compute_alpha.html">Compute Engine API</a> . <a href="compute_alpha.commitments.html">commitments</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#aggregatedList">aggregatedList(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves an aggregated list of commitments.</p>
+<p class="toc_element">
+  <code><a href="#aggregatedList_next">aggregatedList_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#get">get(project, zone, commitment)</a></code></p>
+<p class="firstline">Returns the specified commitment resource. Get a list of available commitments by making a list() request.</p>
+<p class="toc_element">
+  <code><a href="#getIamPolicy">getIamPolicy(project, zone, resource)</a></code></p>
+<p class="firstline">Gets the access control policy for a resource. May be empty if no such policy or resource exists.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(project, zone, body)</a></code></p>
+<p class="firstline">Creates an commitment in the specified project using the data included in the request.</p>
+<p class="toc_element">
+  <code><a href="#list">list(project, zone, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves a list of commitments contained within the specified zone.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#setIamPolicy">setIamPolicy(project, zone, resource, body)</a></code></p>
+<p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy.</p>
+<p class="toc_element">
+  <code><a href="#testIamPermissions">testIamPermissions(project, zone, resource, body)</a></code></p>
+<p class="firstline">Returns permissions that a caller has on the specified resource.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="aggregatedList">aggregatedList(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves an aggregated list of commitments.
+
+Args:
+  project: string, Project ID for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    {
+    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+    "items": { # Commitments by scope.
+      "a_key": { # [Output Only] Name of the scope containing this set of commitments.
+        "warning": { # [Output Only] Informational warning which replaces the list of commitments when the list is empty.
+          "message": "A String", # [Output Only] A human-readable description of the warning code.
+          "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+          "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+              # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+            {
+              "value": "A String", # [Output Only] A warning data value corresponding to the key.
+              "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+            },
+          ],
+        },
+        "commitments": [ # [Output Only] List of commitments contained in this scope.
+          { # A usage-commitment with a start / end time. Users create commitments for particular resources (e.g. memory). Actual usage is first deducted from available commitments made prior, perhaps at a reduced price (as laid out in the commitment).
+              "status": "A String", # [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end-date defined). One of the following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED.
+              "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+              "kind": "compute#commitment", # [Output Only] Type of the resource. Always compute#commitment for commitments.
+              "statusMessage": "A String", # [Output Only] An optional, human-readable explanation of the status.
+              "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+              "zone": "A String", # [Output Only] URL of the zone where this commitment may be used.
+              "startTimestamp": "A String", # [Output Only] Commitment start time in RFC3339 text format.
+              "endTimestamp": "A String", # [Output Only] Commitment end time in RFC3339 text format.
+              "plan": "A String", # The plan for this commitment, which determines duration and discount rate. The currently supported plans are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years).
+              "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+              "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+              "resources": [ # List of commitment amounts for particular resources. Note that VCPU and MEMORY resource commitments must occur together.
+                { # Commitment for a particular resource (a Commitment is composed of one or more of these).
+                  "amount": "A String", # The amount of the resource purchased (in a type-dependent unit, such as bytes).
+                  "type": "A String", # Type of resource for which this commitment applies.
+                },
+              ],
+              "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+            },
+        ],
+      },
+    },
+    "kind": "compute#commitmentAggregatedList", # [Output Only] Type of resource. Always compute#commitmentAggregatedList for aggregated lists of commitments.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="aggregatedList_next">aggregatedList_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(project, zone, commitment)</code>
+  <pre>Returns the specified commitment resource. Get a list of available commitments by making a list() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  commitment: string, Name of the commitment to return. (required)
+
+Returns:
+  An object of the form:
+
+    { # A usage-commitment with a start / end time. Users create commitments for particular resources (e.g. memory). Actual usage is first deducted from available commitments made prior, perhaps at a reduced price (as laid out in the commitment).
+      "status": "A String", # [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end-date defined). One of the following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "kind": "compute#commitment", # [Output Only] Type of the resource. Always compute#commitment for commitments.
+      "statusMessage": "A String", # [Output Only] An optional, human-readable explanation of the status.
+      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "zone": "A String", # [Output Only] URL of the zone where this commitment may be used.
+      "startTimestamp": "A String", # [Output Only] Commitment start time in RFC3339 text format.
+      "endTimestamp": "A String", # [Output Only] Commitment end time in RFC3339 text format.
+      "plan": "A String", # The plan for this commitment, which determines duration and discount rate. The currently supported plans are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years).
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+      "resources": [ # List of commitment amounts for particular resources. Note that VCPU and MEMORY resource commitments must occur together.
+        { # Commitment for a particular resource (a Commitment is composed of one or more of these).
+          "amount": "A String", # The amount of the resource purchased (in a type-dependent unit, such as bytes).
+          "type": "A String", # Type of resource for which this commitment applies.
+        },
+      ],
+      "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="getIamPolicy">getIamPolicy(project, zone, resource)</code>
+  <pre>Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  resource: string, Name of the resource for this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.
+      #
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM.
+      #
+      # **Example**
+      #
+      # { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] }
+      #
+      # For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
+    "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
+        #
+        # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
+        "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
+          "A String",
+        ],
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
+      { # A rule to be applied in a Policy.
+        "logConfigs": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries that match the LOG action.
+          { # Specifies what kind of log the caller must write
+            "counter": { # Options for counters # Counter options.
+              "field": "A String", # The field value to attribute.
+              "metric": "A String", # The metric to update.
+            },
+          },
+        ],
+        "notIns": [ # If one or more 'not_in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
+          "A String",
+        ],
+        "ins": [ # If one or more 'in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
+          "A String",
+        ],
+        "action": "A String", # Required
+        "permissions": [ # A permission is a string of form '..' (e.g., 'storage.buckets.list'). A value of '*' matches all permissions, and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
+          "A String",
+        ],
+        "conditions": [ # Additional restrictions that must be met
+          { # A condition to be met.
+            "iam": "A String", # Trusted attributes supplied by the IAM system.
+            "svc": "A String", # Trusted attributes discharged by the service.
+            "value": "A String", # DEPRECATED. Use 'values' instead.
+            "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses the IAM system for access control.
+            "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
+              "A String",
+            ],
+            "op": "A String", # An operator to apply the subject with.
+          },
+        ],
+        "description": "A String", # Human-readable description of the rule.
+      },
+    ],
+    "version": 42, # Version of the `Policy`. The default version is 0.
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
+    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+      { # Associates `members` with a `role`.
+        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "A String",
+        ],
+      },
+    ],
+    "iamOwned": True or False,
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(project, zone, body)</code>
+  <pre>Creates an commitment in the specified project using the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # A usage-commitment with a start / end time. Users create commitments for particular resources (e.g. memory). Actual usage is first deducted from available commitments made prior, perhaps at a reduced price (as laid out in the commitment).
+    "status": "A String", # [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end-date defined). One of the following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "kind": "compute#commitment", # [Output Only] Type of the resource. Always compute#commitment for commitments.
+    "statusMessage": "A String", # [Output Only] An optional, human-readable explanation of the status.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "zone": "A String", # [Output Only] URL of the zone where this commitment may be used.
+    "startTimestamp": "A String", # [Output Only] Commitment start time in RFC3339 text format.
+    "endTimestamp": "A String", # [Output Only] Commitment end time in RFC3339 text format.
+    "plan": "A String", # The plan for this commitment, which determines duration and discount rate. The currently supported plans are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years).
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "resources": [ # List of commitment amounts for particular resources. Note that VCPU and MEMORY resource commitments must occur together.
+      { # Commitment for a particular resource (a Commitment is composed of one or more of these).
+        "amount": "A String", # The amount of the resource purchased (in a type-dependent unit, such as bytes).
+        "type": "A String", # Type of resource for which this commitment applies.
+      },
+    ],
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(project, zone, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves a list of commitments contained within the specified zone.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of Commitment resources.
+    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+    "items": [ # A list of Commitment resources.
+      { # A usage-commitment with a start / end time. Users create commitments for particular resources (e.g. memory). Actual usage is first deducted from available commitments made prior, perhaps at a reduced price (as laid out in the commitment).
+          "status": "A String", # [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end-date defined). One of the following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "kind": "compute#commitment", # [Output Only] Type of the resource. Always compute#commitment for commitments.
+          "statusMessage": "A String", # [Output Only] An optional, human-readable explanation of the status.
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "zone": "A String", # [Output Only] URL of the zone where this commitment may be used.
+          "startTimestamp": "A String", # [Output Only] Commitment start time in RFC3339 text format.
+          "endTimestamp": "A String", # [Output Only] Commitment end time in RFC3339 text format.
+          "plan": "A String", # The plan for this commitment, which determines duration and discount rate. The currently supported plans are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years).
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+          "resources": [ # List of commitment amounts for particular resources. Note that VCPU and MEMORY resource commitments must occur together.
+            { # Commitment for a particular resource (a Commitment is composed of one or more of these).
+              "amount": "A String", # The amount of the resource purchased (in a type-dependent unit, such as bytes).
+              "type": "A String", # Type of resource for which this commitment applies.
+            },
+          ],
+          "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+        },
+    ],
+    "kind": "compute#commitmentList", # [Output Only] Type of resource. Always compute#commitmentList for lists of commitments.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="setIamPolicy">setIamPolicy(project, zone, resource, body)</code>
+  <pre>Sets the access control policy on the specified resource. Replaces any existing policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  resource: string, Name of the resource for this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.
+    # 
+    # 
+    # 
+    # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM.
+    # 
+    # **Example**
+    # 
+    # { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] }
+    # 
+    # For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
+  "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
+      # 
+      # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
+    { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
+      "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
+        "A String",
+      ],
+      "auditLogConfigs": [ # The configuration for each type of logging
+        { # Provides the configuration for a sub-type of logging.
+          "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
+    { # A rule to be applied in a Policy.
+      "logConfigs": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries that match the LOG action.
+        { # Specifies what kind of log the caller must write
+          "counter": { # Options for counters # Counter options.
+            "field": "A String", # The field value to attribute.
+            "metric": "A String", # The metric to update.
+          },
+        },
+      ],
+      "notIns": [ # If one or more 'not_in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
+        "A String",
+      ],
+      "ins": [ # If one or more 'in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
+        "A String",
+      ],
+      "action": "A String", # Required
+      "permissions": [ # A permission is a string of form '..' (e.g., 'storage.buckets.list'). A value of '*' matches all permissions, and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
+        "A String",
+      ],
+      "conditions": [ # Additional restrictions that must be met
+        { # A condition to be met.
+          "iam": "A String", # Trusted attributes supplied by the IAM system.
+          "svc": "A String", # Trusted attributes discharged by the service.
+          "value": "A String", # DEPRECATED. Use 'values' instead.
+          "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses the IAM system for access control.
+          "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
+            "A String",
+          ],
+          "op": "A String", # An operator to apply the subject with.
+        },
+      ],
+      "description": "A String", # Human-readable description of the rule.
+    },
+  ],
+  "version": 42, # Version of the `Policy`. The default version is 0.
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy.
+      # 
+      # If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
+  "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Associates `members` with a `role`.
+      "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+      "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values:
+          #
+          # * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account.
+          #
+          # * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account.
+          #
+          # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
+          #
+          #
+          #
+          # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
+          #
+          # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
+          #
+          # * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "A String",
+      ],
+    },
+  ],
+  "iamOwned": True or False,
+}
+
+
+Returns:
+  An object of the form:
+
+    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.
+      #
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM.
+      #
+      # **Example**
+      #
+      # { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] }
+      #
+      # For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
+    "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
+        #
+        # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
+        "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
+          "A String",
+        ],
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
+      { # A rule to be applied in a Policy.
+        "logConfigs": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries that match the LOG action.
+          { # Specifies what kind of log the caller must write
+            "counter": { # Options for counters # Counter options.
+              "field": "A String", # The field value to attribute.
+              "metric": "A String", # The metric to update.
+            },
+          },
+        ],
+        "notIns": [ # If one or more 'not_in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
+          "A String",
+        ],
+        "ins": [ # If one or more 'in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
+          "A String",
+        ],
+        "action": "A String", # Required
+        "permissions": [ # A permission is a string of form '..' (e.g., 'storage.buckets.list'). A value of '*' matches all permissions, and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
+          "A String",
+        ],
+        "conditions": [ # Additional restrictions that must be met
+          { # A condition to be met.
+            "iam": "A String", # Trusted attributes supplied by the IAM system.
+            "svc": "A String", # Trusted attributes discharged by the service.
+            "value": "A String", # DEPRECATED. Use 'values' instead.
+            "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses the IAM system for access control.
+            "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
+              "A String",
+            ],
+            "op": "A String", # An operator to apply the subject with.
+          },
+        ],
+        "description": "A String", # Human-readable description of the rule.
+      },
+    ],
+    "version": 42, # Version of the `Policy`. The default version is 0.
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
+    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+      { # Associates `members` with a `role`.
+        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "A String",
+        ],
+      },
+    ],
+    "iamOwned": True or False,
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="testIamPermissions">testIamPermissions(project, zone, resource, body)</code>
+  <pre>Returns permissions that a caller has on the specified resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  resource: string, Name of the resource for this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "permissions": [ # The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed.
+      "A String",
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    {
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+      "A String",
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/compute_alpha.diskTypes.html b/docs/dyn/compute_alpha.diskTypes.html
index 4d1bd5a4d1b..72b81f134e7 100644
--- a/docs/dyn/compute_alpha.diskTypes.html
+++ b/docs/dyn/compute_alpha.diskTypes.html
@@ -138,10 +138,10 @@ <h3>Method Details</h3>
             "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
             "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
             "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-              "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+              "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
               "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
               "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
             },
             "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
@@ -191,10 +191,10 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
     "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
@@ -241,10 +241,10 @@ <h3>Method Details</h3>
         "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
         "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
diff --git a/docs/dyn/compute_alpha.disks.html b/docs/dyn/compute_alpha.disks.html
index f87e107017f..19c83183ba7 100644
--- a/docs/dyn/compute_alpha.disks.html
+++ b/docs/dyn/compute_alpha.disks.html
@@ -375,7 +375,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -434,7 +434,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -697,7 +697,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -907,7 +907,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -976,7 +976,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.firewalls.html b/docs/dyn/compute_alpha.firewalls.html
index 0e8d3043f4e..b6d73f5412d 100644
--- a/docs/dyn/compute_alpha.firewalls.html
+++ b/docs/dyn/compute_alpha.firewalls.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -169,14 +169,29 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # Represents a Firewall resource.
-      "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
+      "direction": "A String", # Direction of traffic to which this firewall applies; default is INGRESS. Note: For INGRESS traffic, it is NOT supported to specify destinationRanges; For EGRESS traffic, it is NOT supported to specify sourceRanges OR sourceTags.
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "destinationRanges": [ # If destination ranges are specified, the firewall will apply only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format.
+        "A String",
+      ],
       "sourceTags": [ # If source tags are specified, the firewall will apply only to traffic with source IP that belongs to a tag listed in source tags. Source tags cannot be used to control traffic to an instance's external IP address. Because tags are associated with an instance, not an IP address. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
         "A String",
       ],
+      "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+        {
+          "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
+          "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
+              #
+              # Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
+            "A String",
+          ],
+        },
+      ],
+      "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
       "sourceRanges": [ # If source ranges are specified, the firewall will apply only to traffic that has source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
         "A String",
       ],
+      "priority": 42, # Priority for this rule. This is an integer between 0 and 65535, both inclusive. When not specified, the value assumed is 1000. Relative priorities determine precedence of conflicting rules. Lower value of priority implies higher precedence (eg, a rule with priority 0 has higher precedence than a rule with priority 1). DENY rules take precedence over ALLOW rules having equal priority.
       "network": "A String", # URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used:
           # global/networks/default
           # If you choose to specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:
@@ -186,7 +201,7 @@ <h3>Method Details</h3>
       "targetTags": [ # A list of instance tags indicating sets of instances located in the network that may make network connections as specified in allowed[]. If no targetTags are specified, the firewall rule applies to all instances on the specified network.
         "A String",
       ],
-      "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+      "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
         {
           "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
           "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
@@ -213,14 +228,29 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Represents a Firewall resource.
-    "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
+    "direction": "A String", # Direction of traffic to which this firewall applies; default is INGRESS. Note: For INGRESS traffic, it is NOT supported to specify destinationRanges; For EGRESS traffic, it is NOT supported to specify sourceRanges OR sourceTags.
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "destinationRanges": [ # If destination ranges are specified, the firewall will apply only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format.
+      "A String",
+    ],
     "sourceTags": [ # If source tags are specified, the firewall will apply only to traffic with source IP that belongs to a tag listed in source tags. Source tags cannot be used to control traffic to an instance's external IP address. Because tags are associated with an instance, not an IP address. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
       "A String",
     ],
+    "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+      {
+        "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
+            # 
+            # Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
     "sourceRanges": [ # If source ranges are specified, the firewall will apply only to traffic that has source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
       "A String",
     ],
+    "priority": 42, # Priority for this rule. This is an integer between 0 and 65535, both inclusive. When not specified, the value assumed is 1000. Relative priorities determine precedence of conflicting rules. Lower value of priority implies higher precedence (eg, a rule with priority 0 has higher precedence than a rule with priority 1). DENY rules take precedence over ALLOW rules having equal priority.
     "network": "A String", # URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used:
         # global/networks/default
         # If you choose to specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:
@@ -230,7 +260,7 @@ <h3>Method Details</h3>
     "targetTags": [ # A list of instance tags indicating sets of instances located in the network that may make network connections as specified in allowed[]. If no targetTags are specified, the firewall rule applies to all instances on the specified network.
       "A String",
     ],
-    "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+    "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
       {
         "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
         "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
@@ -293,7 +323,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -327,14 +357,29 @@ <h3>Method Details</h3>
     "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
     "items": [ # [Output Only] A list of Firewall resources.
       { # Represents a Firewall resource.
-          "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
+          "direction": "A String", # Direction of traffic to which this firewall applies; default is INGRESS. Note: For INGRESS traffic, it is NOT supported to specify destinationRanges; For EGRESS traffic, it is NOT supported to specify sourceRanges OR sourceTags.
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "destinationRanges": [ # If destination ranges are specified, the firewall will apply only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format.
+            "A String",
+          ],
           "sourceTags": [ # If source tags are specified, the firewall will apply only to traffic with source IP that belongs to a tag listed in source tags. Source tags cannot be used to control traffic to an instance's external IP address. Because tags are associated with an instance, not an IP address. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
             "A String",
           ],
+          "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+            {
+              "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
+              "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
+                  #
+                  # Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
+                "A String",
+              ],
+            },
+          ],
+          "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
           "sourceRanges": [ # If source ranges are specified, the firewall will apply only to traffic that has source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
             "A String",
           ],
+          "priority": 42, # Priority for this rule. This is an integer between 0 and 65535, both inclusive. When not specified, the value assumed is 1000. Relative priorities determine precedence of conflicting rules. Lower value of priority implies higher precedence (eg, a rule with priority 0 has higher precedence than a rule with priority 1). DENY rules take precedence over ALLOW rules having equal priority.
           "network": "A String", # URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used:
               # global/networks/default
               # If you choose to specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:
@@ -344,7 +389,7 @@ <h3>Method Details</h3>
           "targetTags": [ # A list of instance tags indicating sets of instances located in the network that may make network connections as specified in allowed[]. If no targetTags are specified, the firewall rule applies to all instances on the specified network.
             "A String",
           ],
-          "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+          "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
             {
               "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
               "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
@@ -391,14 +436,29 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Represents a Firewall resource.
-    "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
+    "direction": "A String", # Direction of traffic to which this firewall applies; default is INGRESS. Note: For INGRESS traffic, it is NOT supported to specify destinationRanges; For EGRESS traffic, it is NOT supported to specify sourceRanges OR sourceTags.
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "destinationRanges": [ # If destination ranges are specified, the firewall will apply only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format.
+      "A String",
+    ],
     "sourceTags": [ # If source tags are specified, the firewall will apply only to traffic with source IP that belongs to a tag listed in source tags. Source tags cannot be used to control traffic to an instance's external IP address. Because tags are associated with an instance, not an IP address. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
       "A String",
     ],
+    "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+      {
+        "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
+            # 
+            # Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
     "sourceRanges": [ # If source ranges are specified, the firewall will apply only to traffic that has source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
       "A String",
     ],
+    "priority": 42, # Priority for this rule. This is an integer between 0 and 65535, both inclusive. When not specified, the value assumed is 1000. Relative priorities determine precedence of conflicting rules. Lower value of priority implies higher precedence (eg, a rule with priority 0 has higher precedence than a rule with priority 1). DENY rules take precedence over ALLOW rules having equal priority.
     "network": "A String", # URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used:
         # global/networks/default
         # If you choose to specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:
@@ -408,7 +468,7 @@ <h3>Method Details</h3>
     "targetTags": [ # A list of instance tags indicating sets of instances located in the network that may make network connections as specified in allowed[]. If no targetTags are specified, the firewall rule applies to all instances on the specified network.
       "A String",
     ],
-    "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+    "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
       {
         "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
         "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
@@ -471,7 +531,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -513,14 +573,29 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Represents a Firewall resource.
-    "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
+    "direction": "A String", # Direction of traffic to which this firewall applies; default is INGRESS. Note: For INGRESS traffic, it is NOT supported to specify destinationRanges; For EGRESS traffic, it is NOT supported to specify sourceRanges OR sourceTags.
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "destinationRanges": [ # If destination ranges are specified, the firewall will apply only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format.
+      "A String",
+    ],
     "sourceTags": [ # If source tags are specified, the firewall will apply only to traffic with source IP that belongs to a tag listed in source tags. Source tags cannot be used to control traffic to an instance's external IP address. Because tags are associated with an instance, not an IP address. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
       "A String",
     ],
+    "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+      {
+        "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
+        "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
+            # 
+            # Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
+          "A String",
+        ],
+      },
+    ],
+    "kind": "compute#firewall", # [Output Ony] Type of the resource. Always compute#firewall for firewall rules.
     "sourceRanges": [ # If source ranges are specified, the firewall will apply only to traffic that has source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both properties are set, the firewall will apply to traffic that has source IP address within sourceRanges OR the source IP that belongs to a tag listed in the sourceTags property. The connection does not need to match both properties for the firewall to apply.
       "A String",
     ],
+    "priority": 42, # Priority for this rule. This is an integer between 0 and 65535, both inclusive. When not specified, the value assumed is 1000. Relative priorities determine precedence of conflicting rules. Lower value of priority implies higher precedence (eg, a rule with priority 0 has higher precedence than a rule with priority 1). DENY rules take precedence over ALLOW rules having equal priority.
     "network": "A String", # URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used:
         # global/networks/default
         # If you choose to specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:
@@ -530,7 +605,7 @@ <h3>Method Details</h3>
     "targetTags": [ # A list of instance tags indicating sets of instances located in the network that may make network connections as specified in allowed[]. If no targetTags are specified, the firewall rule applies to all instances on the specified network.
       "A String",
     ],
-    "allowed": [ # The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
+    "denied": [ # The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.
       {
         "IPProtocol": "A String", # The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.
         "ports": [ # An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port.
@@ -593,7 +668,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.forwardingRules.html b/docs/dyn/compute_alpha.forwardingRules.html
index ef3d29f405c..9a1a574b89e 100644
--- a/docs/dyn/compute_alpha.forwardingRules.html
+++ b/docs/dyn/compute_alpha.forwardingRules.html
@@ -136,7 +136,10 @@ <h3>Method Details</h3>
           { # A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.
               "kind": "compute#forwardingRule", # [Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.
               "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-              "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+              "serviceName": "A String", # [Output Only] The internal fully qualified service name for this Forwarding Rule.
+                  #
+                  # This field is only used for internal load balancing.
+              "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
               "IPAddress": "A String", # The IP address that this forwarding rule is serving on behalf of.
                   #
                   # For global forwarding rules, the address must be a global IP; for regional forwarding rules, the address must live in the same region as the forwarding rule. By default, this field is empty and an ephemeral IP from the same scope (global or regional) will be assigned.
@@ -148,7 +151,6 @@ <h3>Method Details</h3>
               "labels": { # Labels to apply to this resource. These can be later modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.
                 "a_key": "A String",
               },
-              "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
               "ports": [ # This field is not used for external load balancing.
                   #
                   # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
@@ -162,17 +164,15 @@ <h3>Method Details</h3>
               "network": "A String", # This field is not used for external load balancing.
                   #
                   # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
-              "dnsName": "A String", # [Output Only] The internal fully qualified domain name for this Forwarding Rule.
+              "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
+              "serviceLabel": "A String", # An optional prefix to the service name for this Forwarding Rule. If specified, will be the first label of the fully qualified service name.
+                  #
+                  # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
                   #
                   # This field is only used for internal load balancing.
               "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
                   #
                   # This field is not used for internal load balancing.
-              "dnsLabel": "A String", # An optional prefix to the DNS name for this Forwarding Rule. If specified, will be the first label of the fully qualified domain name.
-                  #
-                  # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-                  #
-                  # This field is only used for internal load balancing.
               "backendService": "A String", # This field is not used for external load balancing.
                   #
                   # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
@@ -279,7 +279,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -298,7 +298,10 @@ <h3>Method Details</h3>
     { # A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.
       "kind": "compute#forwardingRule", # [Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-      "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+      "serviceName": "A String", # [Output Only] The internal fully qualified service name for this Forwarding Rule.
+          #
+          # This field is only used for internal load balancing.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
       "IPAddress": "A String", # The IP address that this forwarding rule is serving on behalf of.
           #
           # For global forwarding rules, the address must be a global IP; for regional forwarding rules, the address must live in the same region as the forwarding rule. By default, this field is empty and an ephemeral IP from the same scope (global or regional) will be assigned.
@@ -310,7 +313,6 @@ <h3>Method Details</h3>
       "labels": { # Labels to apply to this resource. These can be later modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.
         "a_key": "A String",
       },
-      "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
       "ports": [ # This field is not used for external load balancing.
           #
           # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
@@ -324,17 +326,15 @@ <h3>Method Details</h3>
       "network": "A String", # This field is not used for external load balancing.
           #
           # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
-      "dnsName": "A String", # [Output Only] The internal fully qualified domain name for this Forwarding Rule.
+      "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
+      "serviceLabel": "A String", # An optional prefix to the service name for this Forwarding Rule. If specified, will be the first label of the fully qualified service name.
+          #
+          # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
           #
           # This field is only used for internal load balancing.
       "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
           #
           # This field is not used for internal load balancing.
-      "dnsLabel": "A String", # An optional prefix to the DNS name for this Forwarding Rule. If specified, will be the first label of the fully qualified domain name.
-          #
-          # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-          #
-          # This field is only used for internal load balancing.
       "backendService": "A String", # This field is not used for external load balancing.
           #
           # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
@@ -367,7 +367,10 @@ <h3>Method Details</h3>
 { # A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.
     "kind": "compute#forwardingRule", # [Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+    "serviceName": "A String", # [Output Only] The internal fully qualified service name for this Forwarding Rule.
+        # 
+        # This field is only used for internal load balancing.
+    "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
     "IPAddress": "A String", # The IP address that this forwarding rule is serving on behalf of.
         # 
         # For global forwarding rules, the address must be a global IP; for regional forwarding rules, the address must live in the same region as the forwarding rule. By default, this field is empty and an ephemeral IP from the same scope (global or regional) will be assigned.
@@ -379,7 +382,6 @@ <h3>Method Details</h3>
     "labels": { # Labels to apply to this resource. These can be later modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.
       "a_key": "A String",
     },
-    "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
     "ports": [ # This field is not used for external load balancing.
         # 
         # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
@@ -393,17 +395,15 @@ <h3>Method Details</h3>
     "network": "A String", # This field is not used for external load balancing.
         # 
         # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
-    "dnsName": "A String", # [Output Only] The internal fully qualified domain name for this Forwarding Rule.
+    "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
+    "serviceLabel": "A String", # An optional prefix to the service name for this Forwarding Rule. If specified, will be the first label of the fully qualified service name.
+        # 
+        # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
         # 
         # This field is only used for internal load balancing.
     "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
         # 
         # This field is not used for internal load balancing.
-    "dnsLabel": "A String", # An optional prefix to the DNS name for this Forwarding Rule. If specified, will be the first label of the fully qualified domain name.
-        # 
-        # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-        # 
-        # This field is only used for internal load balancing.
     "backendService": "A String", # This field is not used for external load balancing.
         # 
         # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
@@ -469,7 +469,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -506,7 +506,10 @@ <h3>Method Details</h3>
       { # A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.
           "kind": "compute#forwardingRule", # [Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-          "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+          "serviceName": "A String", # [Output Only] The internal fully qualified service name for this Forwarding Rule.
+              #
+              # This field is only used for internal load balancing.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
           "IPAddress": "A String", # The IP address that this forwarding rule is serving on behalf of.
               #
               # For global forwarding rules, the address must be a global IP; for regional forwarding rules, the address must live in the same region as the forwarding rule. By default, this field is empty and an ephemeral IP from the same scope (global or regional) will be assigned.
@@ -518,7 +521,6 @@ <h3>Method Details</h3>
           "labels": { # Labels to apply to this resource. These can be later modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.
             "a_key": "A String",
           },
-          "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
           "ports": [ # This field is not used for external load balancing.
               #
               # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
@@ -532,17 +534,15 @@ <h3>Method Details</h3>
           "network": "A String", # This field is not used for external load balancing.
               #
               # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
-          "dnsName": "A String", # [Output Only] The internal fully qualified domain name for this Forwarding Rule.
+          "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
+          "serviceLabel": "A String", # An optional prefix to the service name for this Forwarding Rule. If specified, will be the first label of the fully qualified service name.
+              #
+              # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
               #
               # This field is only used for internal load balancing.
           "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
               #
               # This field is not used for internal load balancing.
-          "dnsLabel": "A String", # An optional prefix to the DNS name for this Forwarding Rule. If specified, will be the first label of the fully qualified domain name.
-              #
-              # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-              #
-              # This field is only used for internal load balancing.
           "backendService": "A String", # This field is not used for external load balancing.
               #
               # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
@@ -643,7 +643,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.globalAddresses.html b/docs/dyn/compute_alpha.globalAddresses.html
index aab6a3cd0d3..f0fb837f8ed 100644
--- a/docs/dyn/compute_alpha.globalAddresses.html
+++ b/docs/dyn/compute_alpha.globalAddresses.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -172,7 +172,7 @@ <h3>Method Details</h3>
       "labels": { # Labels to apply to this Address resource. These can be later modified by the setLabels method. Each label key/value must comply with RFC1035. Label values may be empty.
         "a_key": "A String",
       },
-      "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
       "address": "A String", # The static external IP address represented by this resource.
       "region": "A String", # [Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.
       "users": [ # [Output Only] The URLs of the resources that are using this address.
@@ -204,7 +204,7 @@ <h3>Method Details</h3>
     "labels": { # Labels to apply to this Address resource. These can be later modified by the setLabels method. Each label key/value must comply with RFC1035. Label values may be empty.
       "a_key": "A String",
     },
-    "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+    "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
     "address": "A String", # The static external IP address represented by this resource.
     "region": "A String", # [Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.
     "users": [ # [Output Only] The URLs of the resources that are using this address.
@@ -263,7 +263,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -306,7 +306,7 @@ <h3>Method Details</h3>
           "labels": { # Labels to apply to this Address resource. These can be later modified by the setLabels method. Each label key/value must comply with RFC1035. Label values may be empty.
             "a_key": "A String",
           },
-          "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this Address and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
           "address": "A String", # The static external IP address represented by this resource.
           "region": "A String", # [Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.
           "users": [ # [Output Only] The URLs of the resources that are using this address.
diff --git a/docs/dyn/compute_alpha.globalForwardingRules.html b/docs/dyn/compute_alpha.globalForwardingRules.html
index 60e49b48ca5..5d3254d0364 100644
--- a/docs/dyn/compute_alpha.globalForwardingRules.html
+++ b/docs/dyn/compute_alpha.globalForwardingRules.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -168,7 +168,10 @@ <h3>Method Details</h3>
     { # A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.
       "kind": "compute#forwardingRule", # [Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-      "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+      "serviceName": "A String", # [Output Only] The internal fully qualified service name for this Forwarding Rule.
+          #
+          # This field is only used for internal load balancing.
+      "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
       "IPAddress": "A String", # The IP address that this forwarding rule is serving on behalf of.
           #
           # For global forwarding rules, the address must be a global IP; for regional forwarding rules, the address must live in the same region as the forwarding rule. By default, this field is empty and an ephemeral IP from the same scope (global or regional) will be assigned.
@@ -180,7 +183,6 @@ <h3>Method Details</h3>
       "labels": { # Labels to apply to this resource. These can be later modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.
         "a_key": "A String",
       },
-      "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
       "ports": [ # This field is not used for external load balancing.
           #
           # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
@@ -194,17 +196,15 @@ <h3>Method Details</h3>
       "network": "A String", # This field is not used for external load balancing.
           #
           # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
-      "dnsName": "A String", # [Output Only] The internal fully qualified domain name for this Forwarding Rule.
+      "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
+      "serviceLabel": "A String", # An optional prefix to the service name for this Forwarding Rule. If specified, will be the first label of the fully qualified service name.
+          #
+          # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
           #
           # This field is only used for internal load balancing.
       "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
           #
           # This field is not used for internal load balancing.
-      "dnsLabel": "A String", # An optional prefix to the DNS name for this Forwarding Rule. If specified, will be the first label of the fully qualified domain name.
-          #
-          # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-          #
-          # This field is only used for internal load balancing.
       "backendService": "A String", # This field is not used for external load balancing.
           #
           # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
@@ -236,7 +236,10 @@ <h3>Method Details</h3>
 { # A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.
     "kind": "compute#forwardingRule", # [Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+    "serviceName": "A String", # [Output Only] The internal fully qualified service name for this Forwarding Rule.
+        # 
+        # This field is only used for internal load balancing.
+    "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
     "IPAddress": "A String", # The IP address that this forwarding rule is serving on behalf of.
         # 
         # For global forwarding rules, the address must be a global IP; for regional forwarding rules, the address must live in the same region as the forwarding rule. By default, this field is empty and an ephemeral IP from the same scope (global or regional) will be assigned.
@@ -248,7 +251,6 @@ <h3>Method Details</h3>
     "labels": { # Labels to apply to this resource. These can be later modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.
       "a_key": "A String",
     },
-    "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
     "ports": [ # This field is not used for external load balancing.
         # 
         # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
@@ -262,17 +264,15 @@ <h3>Method Details</h3>
     "network": "A String", # This field is not used for external load balancing.
         # 
         # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
-    "dnsName": "A String", # [Output Only] The internal fully qualified domain name for this Forwarding Rule.
+    "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
+    "serviceLabel": "A String", # An optional prefix to the service name for this Forwarding Rule. If specified, will be the first label of the fully qualified service name.
+        # 
+        # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
         # 
         # This field is only used for internal load balancing.
     "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
         # 
         # This field is not used for internal load balancing.
-    "dnsLabel": "A String", # An optional prefix to the DNS name for this Forwarding Rule. If specified, will be the first label of the fully qualified domain name.
-        # 
-        # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-        # 
-        # This field is only used for internal load balancing.
     "backendService": "A String", # This field is not used for external load balancing.
         # 
         # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
@@ -338,7 +338,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -374,7 +374,10 @@ <h3>Method Details</h3>
       { # A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.
           "kind": "compute#forwardingRule", # [Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-          "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+          "serviceName": "A String", # [Output Only] The internal fully qualified service name for this Forwarding Rule.
+              #
+              # This field is only used for internal load balancing.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this load balancer and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
           "IPAddress": "A String", # The IP address that this forwarding rule is serving on behalf of.
               #
               # For global forwarding rules, the address must be a global IP; for regional forwarding rules, the address must live in the same region as the forwarding rule. By default, this field is empty and an ephemeral IP from the same scope (global or regional) will be assigned.
@@ -386,7 +389,6 @@ <h3>Method Details</h3>
           "labels": { # Labels to apply to this resource. These can be later modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.
             "a_key": "A String",
           },
-          "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
           "ports": [ # This field is not used for external load balancing.
               #
               # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
@@ -400,17 +402,15 @@ <h3>Method Details</h3>
           "network": "A String", # This field is not used for external load balancing.
               #
               # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
-          "dnsName": "A String", # [Output Only] The internal fully qualified domain name for this Forwarding Rule.
+          "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
+          "serviceLabel": "A String", # An optional prefix to the service name for this Forwarding Rule. If specified, will be the first label of the fully qualified service name.
+              #
+              # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
               #
               # This field is only used for internal load balancing.
           "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
               #
               # This field is not used for internal load balancing.
-          "dnsLabel": "A String", # An optional prefix to the DNS name for this Forwarding Rule. If specified, will be the first label of the fully qualified domain name.
-              #
-              # The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-              #
-              # This field is only used for internal load balancing.
           "backendService": "A String", # This field is not used for external load balancing.
               #
               # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
@@ -510,7 +510,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.globalOperations.html b/docs/dyn/compute_alpha.globalOperations.html
index 534e1f6023b..093b01ef326 100644
--- a/docs/dyn/compute_alpha.globalOperations.html
+++ b/docs/dyn/compute_alpha.globalOperations.html
@@ -167,7 +167,7 @@ <h3>Method Details</h3>
             },
             "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
             "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-            "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+            "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
           },
         ],
         "warning": { # [Output Only] Informational warning which replaces the list of operations when the list is empty.
@@ -267,7 +267,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -343,7 +343,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_alpha.healthChecks.html b/docs/dyn/compute_alpha.healthChecks.html
index 221e16d3944..708bd9c734a 100644
--- a/docs/dyn/compute_alpha.healthChecks.html
+++ b/docs/dyn/compute_alpha.healthChecks.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -178,7 +178,7 @@ <h3>Method Details</h3>
       },
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-      "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+      "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
       "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
       "tcpHealthCheck": {
         "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -246,7 +246,7 @@ <h3>Method Details</h3>
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -341,7 +341,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -384,7 +384,7 @@ <h3>Method Details</h3>
           },
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
           "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-          "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+          "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
           "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
           "tcpHealthCheck": {
             "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -472,7 +472,7 @@ <h3>Method Details</h3>
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -567,7 +567,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -618,7 +618,7 @@ <h3>Method Details</h3>
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -713,7 +713,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.hosts.html b/docs/dyn/compute_alpha.hosts.html
index 0dfcd97944e..1b258d86a62 100644
--- a/docs/dyn/compute_alpha.hosts.html
+++ b/docs/dyn/compute_alpha.hosts.html
@@ -74,9 +74,30 @@
 
 <h1><a href="compute_alpha.html">Compute Engine API</a> . <a href="compute_alpha.hosts.html">hosts</a></h1>
 <h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#aggregatedList">aggregatedList(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves an aggregated list of hosts.</p>
+<p class="toc_element">
+  <code><a href="#aggregatedList_next">aggregatedList_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#delete">delete(project, zone, host)</a></code></p>
+<p class="firstline">Deletes the specified Host resource.</p>
+<p class="toc_element">
+  <code><a href="#get">get(project, zone, host)</a></code></p>
+<p class="firstline">Returns the specified host. Get a list of available hosts by making a list() request.</p>
 <p class="toc_element">
   <code><a href="#getIamPolicy">getIamPolicy(project, zone, resource)</a></code></p>
 <p class="firstline">Gets the access control policy for a resource. May be empty if no such policy or resource exists.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(project, zone, body)</a></code></p>
+<p class="firstline">Creates a host resource in the specified project using the data included in the request.</p>
+<p class="toc_element">
+  <code><a href="#list">list(project, zone, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves a list of hosts available to the specified project.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#setIamPolicy">setIamPolicy(project, zone, resource, body)</a></code></p>
 <p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy.</p>
@@ -84,6 +105,178 @@ <h2>Instance Methods</h2>
   <code><a href="#testIamPermissions">testIamPermissions(project, zone, resource, body)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="aggregatedList">aggregatedList(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves an aggregated list of hosts.
+
+Args:
+  project: string, Project ID for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    {
+    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+    "items": { # [Output Only] A map of scoped host lists.
+      "a_key": { # [Output Only] Name of the scope containing this set of hosts.
+        "warning": { # [Output Only] An informational warning that appears when the host list is empty.
+          "message": "A String", # [Output Only] A human-readable description of the warning code.
+          "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+          "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+              # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+            {
+              "value": "A String", # [Output Only] A warning data value corresponding to the key.
+              "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+            },
+          ],
+        },
+        "hosts": [ # [Output Only] List of hosts contained in this scope.
+          {
+              "status": "A String", # [Output Only] The status of the host. One of the following values: CREATING, READY, REPAIR, and DELETING.
+              "kind": "compute#host", # [Output Only] The type of the resource. Always compute#host for host.
+              "description": "A String", # [Output Only] An optional textual description of the resource.
+              "zone": "A String", # [Output Only] The name of the zone where the host resides, such as us-central1-a.
+              "hostType": "A String", # Full or partial URL of the host type resource to use for this host, in the format: zones/zone/hostTypes/host-type. This is provided by the client when the host is created. For example, the following is a valid partial url to a predefined host type:
+                  #
+                  # zones/us-central1-f/hostTypes/n1-host-64-416
+              "instances": [ # A list of resource URLs to the virtual machine instances in this host. They must live in zones contained in the same region as this host.
+                "A String",
+              ],
+              "statusMessage": "A String", # [Output Only] An optional, human-readable explanation of the status.
+              "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+              "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+              "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+              "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+            },
+        ],
+      },
+    },
+    "kind": "compute#hostAggregatedList", # [Output Only] Type of resource. Always compute#hostAggregatedList for aggregated lists of hosts.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="aggregatedList_next">aggregatedList_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="delete">delete(project, zone, host)</code>
+  <pre>Deletes the specified Host resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  host: string, Name of the Host resource to delete. (required)
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(project, zone, host)</code>
+  <pre>Returns the specified host. Get a list of available hosts by making a list() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  host: string, Name of the host to return. (required)
+
+Returns:
+  An object of the form:
+
+    {
+      "status": "A String", # [Output Only] The status of the host. One of the following values: CREATING, READY, REPAIR, and DELETING.
+      "kind": "compute#host", # [Output Only] The type of the resource. Always compute#host for host.
+      "description": "A String", # [Output Only] An optional textual description of the resource.
+      "zone": "A String", # [Output Only] The name of the zone where the host resides, such as us-central1-a.
+      "hostType": "A String", # Full or partial URL of the host type resource to use for this host, in the format: zones/zone/hostTypes/host-type. This is provided by the client when the host is created. For example, the following is a valid partial url to a predefined host type:
+          #
+          # zones/us-central1-f/hostTypes/n1-host-64-416
+      "instances": [ # A list of resource URLs to the virtual machine instances in this host. They must live in zones contained in the same region as this host.
+        "A String",
+      ],
+      "statusMessage": "A String", # [Output Only] An optional, human-readable explanation of the status.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+    }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="getIamPolicy">getIamPolicy(project, zone, resource)</code>
   <pre>Gets the access control policy for a resource. May be empty if no such policy or resource exists.
@@ -110,11 +303,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -167,6 +368,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -180,6 +383,153 @@ <h3>Method Details</h3>
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="insert">insert(project, zone, body)</code>
+  <pre>Creates a host resource in the specified project using the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "status": "A String", # [Output Only] The status of the host. One of the following values: CREATING, READY, REPAIR, and DELETING.
+    "kind": "compute#host", # [Output Only] The type of the resource. Always compute#host for host.
+    "description": "A String", # [Output Only] An optional textual description of the resource.
+    "zone": "A String", # [Output Only] The name of the zone where the host resides, such as us-central1-a.
+    "hostType": "A String", # Full or partial URL of the host type resource to use for this host, in the format: zones/zone/hostTypes/host-type. This is provided by the client when the host is created. For example, the following is a valid partial url to a predefined host type:
+        # 
+        # zones/us-central1-f/hostTypes/n1-host-64-416
+    "instances": [ # A list of resource URLs to the virtual machine instances in this host. They must live in zones contained in the same region as this host.
+      "A String",
+    ],
+    "statusMessage": "A String", # [Output Only] An optional, human-readable explanation of the status.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(project, zone, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves a list of hosts available to the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of hosts.
+    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+    "items": [ # [Output Only] A list of Host resources.
+      {
+          "status": "A String", # [Output Only] The status of the host. One of the following values: CREATING, READY, REPAIR, and DELETING.
+          "kind": "compute#host", # [Output Only] The type of the resource. Always compute#host for host.
+          "description": "A String", # [Output Only] An optional textual description of the resource.
+          "zone": "A String", # [Output Only] The name of the zone where the host resides, such as us-central1-a.
+          "hostType": "A String", # Full or partial URL of the host type resource to use for this host, in the format: zones/zone/hostTypes/host-type. This is provided by the client when the host is created. For example, the following is a valid partial url to a predefined host type:
+              #
+              # zones/us-central1-f/hostTypes/n1-host-64-416
+          "instances": [ # A list of resource URLs to the virtual machine instances in this host. They must live in zones contained in the same region as this host.
+            "A String",
+          ],
+          "statusMessage": "A String", # [Output Only] An optional, human-readable explanation of the status.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+        },
+    ],
+    "kind": "compute#hostList", # [Output Only] Type of resource. Always compute#hostList for lists of hosts.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
 <div class="method">
     <code class="details" id="setIamPolicy">setIamPolicy(project, zone, resource, body)</code>
   <pre>Sets the access control policy on the specified resource. Replaces any existing policy.
@@ -205,11 +555,19 @@ <h3>Method Details</h3>
   "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
       # 
       # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-    { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+    { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
       "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
         "A String",
       ],
-      "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      "auditLogConfigs": [ # The configuration for each type of logging
+        { # Provides the configuration for a sub-type of logging.
+          "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
     },
   ],
   "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -262,6 +620,8 @@ <h3>Method Details</h3>
           #
           # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
           #
+          #
+          #
           # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
           #
           # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -292,11 +652,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -349,6 +717,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
diff --git a/docs/dyn/compute_alpha.html b/docs/dyn/compute_alpha.html
index b5c668d3dbf..6b3f08d34aa 100644
--- a/docs/dyn/compute_alpha.html
+++ b/docs/dyn/compute_alpha.html
@@ -99,6 +99,11 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the clientSslPolicies Resource.</p>
 
+<p class="toc_element">
+  <code><a href="compute_alpha.commitments.html">commitments()</a></code>
+</p>
+<p class="firstline">Returns the commitments Resource.</p>
+
 <p class="toc_element">
   <code><a href="compute_alpha.diskTypes.html">diskTypes()</a></code>
 </p>
diff --git a/docs/dyn/compute_alpha.httpHealthChecks.html b/docs/dyn/compute_alpha.httpHealthChecks.html
index f780cf003d6..5b4fe357437 100644
--- a/docs/dyn/compute_alpha.httpHealthChecks.html
+++ b/docs/dyn/compute_alpha.httpHealthChecks.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -257,7 +257,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -399,7 +399,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -503,7 +503,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.httpsHealthChecks.html b/docs/dyn/compute_alpha.httpsHealthChecks.html
index c08250a26a7..6bc3d7b44c9 100644
--- a/docs/dyn/compute_alpha.httpsHealthChecks.html
+++ b/docs/dyn/compute_alpha.httpsHealthChecks.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -257,7 +257,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -399,7 +399,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -503,7 +503,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.images.html b/docs/dyn/compute_alpha.images.html
index c5684282844..6898bf49c44 100644
--- a/docs/dyn/compute_alpha.images.html
+++ b/docs/dyn/compute_alpha.images.html
@@ -156,7 +156,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -173,10 +173,10 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Deprecation status for a public resource.
-  "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-  "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+  "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+  "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
   "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-  "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+  "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
   "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
 }
 
@@ -227,7 +227,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -243,7 +243,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Image resource.
-      "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+      "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
           # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
           # - projects/project/zones/zone/disks/disk
           # - zones/zone/disks/disk
@@ -262,10 +262,10 @@ <h3>Method Details</h3>
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
       "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-        "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
         "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
         "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
       },
       "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.
@@ -276,9 +276,11 @@ <h3>Method Details</h3>
       },
       "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
       "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
-      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature is supported, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+          #
+          # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
         { # Guest OS features.
-          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported.
+          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
         },
       ],
       "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
@@ -326,7 +328,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Image resource.
-      "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+      "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
           # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
           # - projects/project/zones/zone/disks/disk
           # - zones/zone/disks/disk
@@ -345,10 +347,10 @@ <h3>Method Details</h3>
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
       "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-        "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
         "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
         "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
       },
       "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.
@@ -359,9 +361,11 @@ <h3>Method Details</h3>
       },
       "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
       "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
-      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature is supported, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+          #
+          # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
         { # Guest OS features.
-          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported.
+          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
         },
       ],
       "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
@@ -407,7 +411,7 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Image resource.
-    "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+    "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
         # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
         # - projects/project/zones/zone/disks/disk
         # - zones/zone/disks/disk
@@ -426,10 +430,10 @@ <h3>Method Details</h3>
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
     "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.
@@ -440,9 +444,11 @@ <h3>Method Details</h3>
     },
     "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
     "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
-    "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature is supported, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+    "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+        # 
+        # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
       { # Guest OS features.
-        "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported.
+        "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
       },
     ],
     "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
@@ -524,7 +530,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -558,7 +564,7 @@ <h3>Method Details</h3>
     "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
     "items": [ # [Output Only] A list of Image resources.
       { # An Image resource.
-          "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+          "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
               # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
               # - projects/project/zones/zone/disks/disk
               # - zones/zone/disks/disk
@@ -577,10 +583,10 @@ <h3>Method Details</h3>
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
           "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
           "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-            "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+            "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
             "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
             "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
           },
           "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.
@@ -591,9 +597,11 @@ <h3>Method Details</h3>
           },
           "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
           "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
-          "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature is supported, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+          "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+              #
+              # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
             { # Guest OS features.
-              "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported.
+              "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
             },
           ],
           "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
@@ -712,7 +720,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.instanceGroupManagers.html b/docs/dyn/compute_alpha.instanceGroupManagers.html
index 21847ffaa15..5980cf7704c 100644
--- a/docs/dyn/compute_alpha.instanceGroupManagers.html
+++ b/docs/dyn/compute_alpha.instanceGroupManagers.html
@@ -99,7 +99,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list(project, zone, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Retrieves a list of managed instance groups that are contained within the specified project and zone.</p>
 <p class="toc_element">
-  <code><a href="#listManagedInstances">listManagedInstances(project, zone, instanceGroupManager)</a></code></p>
+  <code><a href="#listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -196,7 +196,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -243,56 +243,19 @@ <h3>Method Details</h3>
         },
         "instanceGroupManagers": [ # [Output Only] The list of managed instance groups that are contained in the specified project and zone.
           { # An Instance Group Manager resource.
-              "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-                "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-                "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-                "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-                    #
-                    # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-                "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-                "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-                "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-                "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-                "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-              },
-              "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-              "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-              "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-                {
-                  "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-                    "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-                    "fixed": 42, # fixed must be non-negative.
-                    "percent": 42, # percent must belong to [0, 100].
-                  },
-                  "instanceTemplate": "A String",
-                  "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-                },
-              ],
-              "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-                {
-                  "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-                  "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-                  "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-                    "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-                    "fixed": 42, # fixed must be non-negative.
-                    "percent": 42, # percent must belong to [0, 100].
-                  },
-                },
-              ],
-              "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
               "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-              "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-              "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-              "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-                "A String",
-              ],
-              "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
               "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
                 "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
                 "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
                 "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
                 "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
               },
+              "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+              "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+              "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+              "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+              "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+              "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
               "updatePolicy": { # The update policy for this managed instance group.
                 "type": "A String",
                 "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -308,19 +271,58 @@ <h3>Method Details</h3>
                 },
                 "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
               },
-              "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-              "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-              "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+              "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+                "A String",
+              ],
               "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
                 { # The named port. For example: .
                   "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
                   "port": 42, # The port number, which can be a value between 1 and 65535.
                 },
               ],
-              "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-              "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-              "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+              "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+              "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+                {
+                  "healthCheck": "A String", # The URL for the health check that signals autohealing.
+                  "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+                  "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+                    "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+                    "fixed": 42, # fixed must be non-negative.
+                    "percent": 42, # percent must belong to [0, 100].
+                  },
+                },
+              ],
+              "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+              "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+              "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+              "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+              "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+                "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+                "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+                "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+                    #
+                    # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+                "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+                "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+                "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+                "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+                "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+                "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+              },
               "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+              "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+                {
+                  "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+                    "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+                    "fixed": 42, # fixed must be non-negative.
+                    "percent": 42, # percent must belong to [0, 100].
+                  },
+                  "instanceTemplate": "A String",
+                  "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+                },
+              ],
+              "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+              "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
             },
         ],
       },
@@ -400,7 +402,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -468,7 +470,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -485,56 +487,19 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Instance Group Manager resource.
-      "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-        "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-        "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-        "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-            #
-            # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-        "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-        "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-        "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-        "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-        "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-      },
-      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-      "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-      "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-        {
-          "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-            "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-            "fixed": 42, # fixed must be non-negative.
-            "percent": 42, # percent must belong to [0, 100].
-          },
-          "instanceTemplate": "A String",
-          "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-        },
-      ],
-      "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-        {
-          "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-          "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-          "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-            "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-            "fixed": 42, # fixed must be non-negative.
-            "percent": 42, # percent must belong to [0, 100].
-          },
-        },
-      ],
-      "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
       "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-      "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-      "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-      "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-        "A String",
-      ],
-      "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
       "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
         "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
         "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
         "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
         "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
       },
+      "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+      "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+      "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+      "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+      "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+      "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
       "updatePolicy": { # The update policy for this managed instance group.
         "type": "A String",
         "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -550,19 +515,58 @@ <h3>Method Details</h3>
         },
         "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
       },
-      "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-      "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+      "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+        "A String",
+      ],
       "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
         { # The named port. For example: .
           "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
           "port": 42, # The port number, which can be a value between 1 and 65535.
         },
       ],
-      "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-      "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-      "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+        {
+          "healthCheck": "A String", # The URL for the health check that signals autohealing.
+          "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+          "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+            "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+            "fixed": 42, # fixed must be non-negative.
+            "percent": 42, # percent must belong to [0, 100].
+          },
+        },
+      ],
+      "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+      "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+      "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+      "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+        "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+        "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+        "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+            #
+            # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+        "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+        "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+        "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+        "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+        "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+        "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+      },
       "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+      "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+        {
+          "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+            "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+            "fixed": 42, # fixed must be non-negative.
+            "percent": 42, # percent must belong to [0, 100].
+          },
+          "instanceTemplate": "A String",
+          "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+        },
+      ],
+      "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+      "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
     }</pre>
 </div>
 
@@ -577,56 +581,19 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Instance Group Manager resource.
-    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-          #
-          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-    },
-    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-      {
-        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-        "instanceTemplate": "A String",
-        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-      },
-    ],
-    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-      {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-      },
-    ],
-    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-      "A String",
-    ],
-    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
       "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
       "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
       "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
       "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
     },
+    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "updatePolicy": { # The update policy for this managed instance group.
       "type": "A String",
       "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -642,19 +609,58 @@ <h3>Method Details</h3>
       },
       "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
     },
-    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+      "A String",
+    ],
     "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
       { # The named port. For example: .
         "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
         "port": 42, # The port number, which can be a value between 1 and 65535.
       },
     ],
-    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+      {
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
+        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+      },
+    ],
+    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+          #
+          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+      "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+    },
     "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+      {
+        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+        "instanceTemplate": "A String",
+        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+      },
+    ],
+    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
   }
 
 
@@ -704,7 +710,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -735,60 +741,23 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # [Output Only] A list of managed instance groups.
-    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
-    "items": [ # [Output Only] A list of managed instance groups.
-      { # An Instance Group Manager resource.
-          "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-            "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-            "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-            "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-                #
-                # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-            "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-            "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-            "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-            "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-            "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-          },
-          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-          "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-          "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-            {
-              "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-                "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-                "fixed": 42, # fixed must be non-negative.
-                "percent": 42, # percent must belong to [0, 100].
-              },
-              "instanceTemplate": "A String",
-              "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-            },
-          ],
-          "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-            {
-              "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-              "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-              "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-                "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-                "fixed": 42, # fixed must be non-negative.
-                "percent": 42, # percent must belong to [0, 100].
-              },
-            },
-          ],
-          "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+    { # [Output Only] A list of managed instance groups.
+    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+    "items": [ # [Output Only] A list of managed instance groups.
+      { # An Instance Group Manager resource.
           "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-          "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-          "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-          "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-            "A String",
-          ],
-          "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
           "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
             "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
             "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
             "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
             "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
           },
+          "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+          "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+          "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+          "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+          "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+          "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
           "updatePolicy": { # The update policy for this managed instance group.
             "type": "A String",
             "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -804,19 +773,58 @@ <h3>Method Details</h3>
             },
             "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
           },
-          "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-          "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-          "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+          "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+            "A String",
+          ],
           "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
             { # The named port. For example: .
               "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
               "port": 42, # The port number, which can be a value between 1 and 65535.
             },
           ],
-          "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-          "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-          "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+            {
+              "healthCheck": "A String", # The URL for the health check that signals autohealing.
+              "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+              "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+                "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+                "fixed": 42, # fixed must be non-negative.
+                "percent": 42, # percent must belong to [0, 100].
+              },
+            },
+          ],
+          "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+          "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+          "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+          "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+          "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+            "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+            "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+            "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+                #
+                # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+            "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+            "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+            "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+            "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+            "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+            "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+          },
           "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+          "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+            {
+              "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+                "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+                "fixed": 42, # fixed must be non-negative.
+                "percent": 42, # percent must belong to [0, 100].
+              },
+              "instanceTemplate": "A String",
+              "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+            },
+          ],
+          "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+          "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
         },
     ],
     "kind": "compute#instanceGroupManagerList", # [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups.
@@ -826,13 +834,17 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="listManagedInstances">listManagedInstances(project, zone, instanceGroupManager)</code>
+    <code class="details" id="listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.
 
 Args:
   project: string, Project ID for this request. (required)
   zone: string, The name of the zone where the managed instance group is located. (required)
   instanceGroupManager: string, The name of the managed instance group. (required)
+  order_by: string, A parameter
+  maxResults: integer, A parameter
+  pageToken: string, A parameter
+  filter: string, A parameter
 
 Returns:
   An object of the form:
@@ -897,56 +909,19 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Instance Group Manager resource.
-    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-          #
-          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-    },
-    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-      {
-        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-        "instanceTemplate": "A String",
-        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-      },
-    ],
-    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-      {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-      },
-    ],
-    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-      "A String",
-    ],
-    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
       "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
       "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
       "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
       "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
     },
+    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "updatePolicy": { # The update policy for this managed instance group.
       "type": "A String",
       "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -962,19 +937,58 @@ <h3>Method Details</h3>
       },
       "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
     },
-    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+      "A String",
+    ],
     "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
       { # The named port. For example: .
         "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
         "port": 42, # The port number, which can be a value between 1 and 65535.
       },
     ],
-    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+      {
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
+        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+      },
+    ],
+    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+          #
+          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+      "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+    },
     "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+      {
+        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+        "instanceTemplate": "A String",
+        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+      },
+    ],
+    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
   }
 
 
@@ -1024,7 +1038,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1092,7 +1106,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1152,7 +1166,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1227,7 +1241,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1245,7 +1259,7 @@ <h3>Method Details</h3>
 {
     "autoHealingPolicies": [
       {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
         "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
         "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
           "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
@@ -1303,7 +1317,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1369,7 +1383,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1438,7 +1452,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1482,56 +1496,19 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Instance Group Manager resource.
-    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-          #
-          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-    },
-    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-      {
-        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-        "instanceTemplate": "A String",
-        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-      },
-    ],
-    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-      {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-      },
-    ],
-    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-      "A String",
-    ],
-    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
       "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
       "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
       "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
       "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
     },
+    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "updatePolicy": { # The update policy for this managed instance group.
       "type": "A String",
       "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -1547,19 +1524,58 @@ <h3>Method Details</h3>
       },
       "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
     },
-    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+      "A String",
+    ],
     "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
       { # The named port. For example: .
         "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
         "port": 42, # The port number, which can be a value between 1 and 65535.
       },
     ],
-    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+      {
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
+        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+      },
+    ],
+    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+          #
+          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+      "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+    },
     "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+      {
+        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+        "instanceTemplate": "A String",
+        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+      },
+    ],
+    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
   }
 
 
@@ -1609,7 +1625,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.instanceGroups.html b/docs/dyn/compute_alpha.instanceGroups.html
index 076c149b396..3eb135a1c9d 100644
--- a/docs/dyn/compute_alpha.instanceGroups.html
+++ b/docs/dyn/compute_alpha.instanceGroups.html
@@ -180,7 +180,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -328,7 +328,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -452,7 +452,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -666,7 +666,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -738,7 +738,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.instanceTemplates.html b/docs/dyn/compute_alpha.instanceTemplates.html
index f33d6eb3ff1..889a99a358e 100644
--- a/docs/dyn/compute_alpha.instanceTemplates.html
+++ b/docs/dyn/compute_alpha.instanceTemplates.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -222,7 +222,7 @@ <h3>Method Details</h3>
                   # - projects/project/zones/zone/diskTypes/diskType
                   # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
               "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-              "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                   #
                   # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                   #
@@ -239,18 +239,25 @@ <h3>Method Details</h3>
                   # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                   #
                   # global/images/family/my-private-family
+                  #
+                  # If the source image is deleted later, this field will not be set.
               "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
             },
             "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
             "index": 42, # Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.
             "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
+            "diskSizeGb": "A String", # The size of the disk in base-2 GB. This supersedes disk_size_gb in InitializeParams.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
             "licenses": [ # [Output Only] Any valid publicly visible licenses.
               "A String",
             ],
-            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
-            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
             "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                #
+                # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
           },
         ],
         "machineType": "A String", # The machine type to use for instances that are created from this template.
@@ -294,7 +301,7 @@ <h3>Method Details</h3>
                 "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
                 "name": "A String", # Name of this access configuration.
                 "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-                "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
                 "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
                 "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
                 "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
@@ -401,7 +408,7 @@ <h3>Method Details</h3>
                 # - projects/project/zones/zone/diskTypes/diskType
                 # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
             "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-            "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+            "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                 #
                 # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                 #
@@ -418,18 +425,25 @@ <h3>Method Details</h3>
                 # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                 #
                 # global/images/family/my-private-family
+                #
+                # If the source image is deleted later, this field will not be set.
             "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
           },
           "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
           "index": 42, # Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.
           "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
+          "diskSizeGb": "A String", # The size of the disk in base-2 GB. This supersedes disk_size_gb in InitializeParams.
+          "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
+          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
           "licenses": [ # [Output Only] Any valid publicly visible licenses.
             "A String",
           ],
-          "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
-          "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
           "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-          "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+          "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+              #
+              # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+              #
+              # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
         },
       ],
       "machineType": "A String", # The machine type to use for instances that are created from this template.
@@ -473,7 +487,7 @@ <h3>Method Details</h3>
               "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
               "name": "A String", # Name of this access configuration.
               "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-              "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+              "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
               "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
               "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
               "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
@@ -557,7 +571,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -650,7 +664,7 @@ <h3>Method Details</h3>
                       # - projects/project/zones/zone/diskTypes/diskType
                       # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
                   "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-                  "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                       #
                       # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                       #
@@ -667,18 +681,25 @@ <h3>Method Details</h3>
                       # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                       #
                       # global/images/family/my-private-family
+                      #
+                      # If the source image is deleted later, this field will not be set.
                   "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
                 },
                 "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
                 "index": 42, # Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.
                 "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
+                "diskSizeGb": "A String", # The size of the disk in base-2 GB. This supersedes disk_size_gb in InitializeParams.
+                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
+                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
                 "licenses": [ # [Output Only] Any valid publicly visible licenses.
                   "A String",
                 ],
-                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
-                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
                 "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                    #
+                    # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
               },
             ],
             "machineType": "A String", # The machine type to use for instances that are created from this template.
@@ -722,7 +743,7 @@ <h3>Method Details</h3>
                     "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
                     "name": "A String", # Name of this access configuration.
                     "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-                    "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+                    "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
                     "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
                     "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
                     "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
diff --git a/docs/dyn/compute_alpha.instances.html b/docs/dyn/compute_alpha.instances.html
index 4359b5be3fc..e5104a93920 100644
--- a/docs/dyn/compute_alpha.instances.html
+++ b/docs/dyn/compute_alpha.instances.html
@@ -175,7 +175,7 @@ <h3>Method Details</h3>
   "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
   "name": "A String", # Name of this access configuration.
   "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-  "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+  "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
   "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
   "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
   "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -310,7 +310,7 @@ <h3>Method Details</h3>
                     "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
                     "name": "A String", # Name of this access configuration.
                     "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-                    "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+                    "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
                     "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
                     "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
                     "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
@@ -434,7 +434,7 @@ <h3>Method Details</h3>
                       # - projects/project/zones/zone/diskTypes/diskType
                       # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
                   "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-                  "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                       #
                       # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                       #
@@ -451,18 +451,25 @@ <h3>Method Details</h3>
                       # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                       #
                       # global/images/family/my-private-family
+                      #
+                      # If the source image is deleted later, this field will not be set.
                   "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
                 },
                 "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
                 "index": 42, # Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.
                 "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
+                "diskSizeGb": "A String", # The size of the disk in base-2 GB. This supersedes disk_size_gb in InitializeParams.
+                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
+                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
                 "licenses": [ # [Output Only] Any valid publicly visible licenses.
                   "A String",
                 ],
-                "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
-                "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
                 "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                    #
+                    # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
               },
             ],
             "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
@@ -562,7 +569,7 @@ <h3>Method Details</h3>
         # - projects/project/zones/zone/diskTypes/diskType
         # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
     "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-    "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+    "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
         #
         # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
         #
@@ -579,18 +586,25 @@ <h3>Method Details</h3>
         # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
         #
         # global/images/family/my-private-family
+        #
+        # If the source image is deleted later, this field will not be set.
     "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
   },
   "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
   "index": 42, # Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.
   "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
+  "diskSizeGb": "A String", # The size of the disk in base-2 GB. This supersedes disk_size_gb in InitializeParams.
+  "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
+  "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
   "licenses": [ # [Output Only] Any valid publicly visible licenses.
     "A String",
   ],
-  "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
-  "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
   "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-  "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+  "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+      # 
+      # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+      # 
+      # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
 }
 
   forceAttach: boolean, Whether to force attach the disk even if it's currently attached to another instance. This is only available for regional disks.
@@ -641,7 +655,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -700,7 +714,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -761,7 +775,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -821,7 +835,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -882,7 +896,7 @@ <h3>Method Details</h3>
             "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
             "name": "A String", # Name of this access configuration.
             "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-            "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+            "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
             "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
             "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
             "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
@@ -1006,7 +1020,7 @@ <h3>Method Details</h3>
               # - projects/project/zones/zone/diskTypes/diskType
               # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
           "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-          "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
               #
               # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
               #
@@ -1023,18 +1037,25 @@ <h3>Method Details</h3>
               # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
               #
               # global/images/family/my-private-family
+              #
+              # If the source image is deleted later, this field will not be set.
           "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
         },
         "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
         "index": 42, # Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.
         "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
+        "diskSizeGb": "A String", # The size of the disk in base-2 GB. This supersedes disk_size_gb in InitializeParams.
+        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
+        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
         "licenses": [ # [Output Only] Any valid publicly visible licenses.
           "A String",
         ],
-        "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
-        "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
         "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+            #
+            # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
       },
     ],
     "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
@@ -1067,11 +1088,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -1124,6 +1153,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -1215,7 +1246,7 @@ <h3>Method Details</h3>
           "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
           "name": "A String", # Name of this access configuration.
           "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-          "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+          "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
           "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
           "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
           "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
@@ -1339,7 +1370,7 @@ <h3>Method Details</h3>
             # - projects/project/zones/zone/diskTypes/diskType
             # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
         "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-        "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+        "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
             #
             # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
             #
@@ -1356,18 +1387,25 @@ <h3>Method Details</h3>
             # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
             #
             # global/images/family/my-private-family
+            #
+            # If the source image is deleted later, this field will not be set.
         "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
       },
       "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
       "index": 42, # Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.
       "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
+      "diskSizeGb": "A String", # The size of the disk in base-2 GB. This supersedes disk_size_gb in InitializeParams.
+      "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
+      "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
       "licenses": [ # [Output Only] Any valid publicly visible licenses.
         "A String",
       ],
-      "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
-      "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
       "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+          #
+          # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+          #
+          # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
     },
   ],
   "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
@@ -1420,7 +1458,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1499,7 +1537,7 @@ <h3>Method Details</h3>
                 "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
                 "name": "A String", # Name of this access configuration.
                 "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-                "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+                "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
                 "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
                 "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
                 "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
@@ -1623,7 +1661,7 @@ <h3>Method Details</h3>
                   # - projects/project/zones/zone/diskTypes/diskType
                   # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
               "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-              "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                   #
                   # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                   #
@@ -1640,18 +1678,25 @@ <h3>Method Details</h3>
                   # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                   #
                   # global/images/family/my-private-family
+                  #
+                  # If the source image is deleted later, this field will not be set.
               "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
             },
             "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
             "index": 42, # Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.
             "boot": True or False, # Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
+            "diskSizeGb": "A String", # The size of the disk in base-2 GB. This supersedes disk_size_gb in InitializeParams.
+            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
+            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
             "licenses": [ # [Output Only] Any valid publicly visible licenses.
               "A String",
             ],
-            "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
-            "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
             "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                #
+                # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
           },
         ],
         "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
@@ -1732,7 +1777,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1793,7 +1838,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1822,11 +1867,19 @@ <h3>Method Details</h3>
   "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
       # 
       # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-    { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+    { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
       "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
         "A String",
       ],
-      "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      "auditLogConfigs": [ # The configuration for each type of logging
+        { # Provides the configuration for a sub-type of logging.
+          "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
     },
   ],
   "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -1879,6 +1932,8 @@ <h3>Method Details</h3>
           #
           # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
           #
+          #
+          #
           # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
           #
           # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -1909,11 +1964,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -1966,6 +2029,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -2046,7 +2111,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2112,7 +2177,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2185,7 +2250,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2253,7 +2318,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2322,7 +2387,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2393,7 +2458,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2452,7 +2517,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2548,7 +2613,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2608,7 +2673,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2668,7 +2733,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2716,7 +2781,7 @@ <h3>Method Details</h3>
   "kind": "compute#accessConfig", # [Output Only] Type of the resource. Always compute#accessConfig for access configs.
   "name": "A String", # Name of this access configuration.
   "setPublicDns": True or False, # Specifies whether a public DNS ?A? record should be created for the external IP address of this access configuration.
-  "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM , STANDARD. If this field is not specified, it is assumed to be PREMIUM.
+  "networkTier": "A String", # This signifies the networking tier used for configuring this access configuration and can only take the following values: CLOUD_NETWORK_PREMIUM , CLOUD_NETWORK_STANDARD. If this field is not specified, it is assumed to be CLOUD_NETWORK_PREMIUM.
   "ptrDomainName": "A String", # The DNS domain name for the public PTR record. This field can only be set when the set_ptr field is enabled.
   "dnsName": "A String", # [Output Only] The public DNS domain name for the instance.
   "natIP": "A String", # An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
@@ -2771,7 +2836,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.licenses.html b/docs/dyn/compute_alpha.licenses.html
index 6bce5b626c7..3195be3aec3 100644
--- a/docs/dyn/compute_alpha.licenses.html
+++ b/docs/dyn/compute_alpha.licenses.html
@@ -90,9 +90,11 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # A license resource.
-    "chargesUseFee": True or False, # [Output Only] If true, the customer will be charged license fee for running software that contains this license on an instance.
     "kind": "compute#license", # [Output Only] Type of resource. Always compute#license for licenses.
     "name": "A String", # [Output Only] Name of the resource. The name is 1-63 characters long and complies with RFC1035.
+    "chargesUseFee": True or False, # [Output Only] If true, the customer will be charged license fee for running software that contains this license on an instance.
+    "licenseCode": "A String", # [Output Only] The unique code used to attach this license to images, snapshots, and disks.
+    "transferable": True or False, # If false, licenses will not be copied from the source resource when creating an image from a disk, disk from snapshot, or snapshot from disk.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
   }</pre>
 </div>
diff --git a/docs/dyn/compute_alpha.machineTypes.html b/docs/dyn/compute_alpha.machineTypes.html
index 4fdc60e32ea..cfe0ee56335 100644
--- a/docs/dyn/compute_alpha.machineTypes.html
+++ b/docs/dyn/compute_alpha.machineTypes.html
@@ -129,10 +129,10 @@ <h3>Method Details</h3>
             "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
             "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
             "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-              "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+              "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
               "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
               "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
             },
             "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
@@ -196,10 +196,10 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
     "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
@@ -249,10 +249,10 @@ <h3>Method Details</h3>
         "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
         "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
diff --git a/docs/dyn/compute_alpha.networks.html b/docs/dyn/compute_alpha.networks.html
index 86c9db0e2e8..509bf2914ad 100644
--- a/docs/dyn/compute_alpha.networks.html
+++ b/docs/dyn/compute_alpha.networks.html
@@ -74,6 +74,9 @@
 
 <h1><a href="compute_alpha.html">Compute Engine API</a> . <a href="compute_alpha.networks.html">networks</a></h1>
 <h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#addPeering">addPeering(project, network, body)</a></code></p>
+<p class="firstline">Adds a peering to the specified network.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(project, network)</a></code></p>
 <p class="firstline">Deletes the specified network.</p>
@@ -89,6 +92,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#removePeering">removePeering(project, network, body)</a></code></p>
+<p class="firstline">Removes a peering from the specified network.</p>
 <p class="toc_element">
   <code><a href="#switchToCustomMode">switchToCustomMode(project, network)</a></code></p>
 <p class="firstline">Switches the network mode from auto subnet mode to custom subnet mode.</p>
@@ -96,6 +102,73 @@ <h2>Instance Methods</h2>
   <code><a href="#testIamPermissions">testIamPermissions(project, resource, body)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="addPeering">addPeering(project, network, body)</code>
+  <pre>Adds a peering to the specified network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network resource to add peering to. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "peerNetwork": "A String", # URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network.
+    "name": "A String", # Name of the peering, which should conform to RFC1035.
+    "autoCreateRoutes": True or False, # Whether Google Compute Engine manages the routes automatically.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="delete">delete(project, network)</code>
   <pre>Deletes the specified network.
@@ -150,7 +223,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -176,6 +249,15 @@ <h3>Method Details</h3>
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
       "IPv4Range": "A String", # The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created.
       "gatewayIPv4": "A String", # A gateway address for default routing to other networks. This value is read only and is selected by the Google Compute Engine, typically as the first usable address in the IPv4Range.
+      "peerings": [ # [Output Only] List of network peerings for the resource.
+        { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering.
+          "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network.
+          "state": "A String", # [Output Only] State for the peering.
+          "stateDetails": "A String", # [Output Only] Details about the current state of the peering.
+          "name": "A String", # Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+          "autoCreateRoutes": True or False, # Whether full mesh connectivity is created and managed automatically. When it is set to true, Google Compute Engine will automatically create and manage the routes between two networks when the state is ACTIVE. Otherwise, user needs to create routes manually to route packets to peer network.
+        },
+      ],
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
       "autoCreateSubnetworks": True or False, # When set to true, the network is created in "auto subnet mode". When set to false, the network is in "custom subnet mode".
           #
@@ -205,6 +287,15 @@ <h3>Method Details</h3>
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "IPv4Range": "A String", # The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created.
     "gatewayIPv4": "A String", # A gateway address for default routing to other networks. This value is read only and is selected by the Google Compute Engine, typically as the first usable address in the IPv4Range.
+    "peerings": [ # [Output Only] List of network peerings for the resource.
+      { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering.
+        "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network.
+        "state": "A String", # [Output Only] State for the peering.
+        "stateDetails": "A String", # [Output Only] Details about the current state of the peering.
+        "name": "A String", # Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+        "autoCreateRoutes": True or False, # Whether full mesh connectivity is created and managed automatically. When it is set to true, Google Compute Engine will automatically create and manage the routes between two networks when the state is ACTIVE. Otherwise, user needs to create routes manually to route packets to peer network.
+      },
+    ],
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "autoCreateSubnetworks": True or False, # When set to true, the network is created in "auto subnet mode". When set to false, the network is in "custom subnet mode".
         # 
@@ -260,7 +351,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -304,6 +395,15 @@ <h3>Method Details</h3>
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
           "IPv4Range": "A String", # The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created.
           "gatewayIPv4": "A String", # A gateway address for default routing to other networks. This value is read only and is selected by the Google Compute Engine, typically as the first usable address in the IPv4Range.
+          "peerings": [ # [Output Only] List of network peerings for the resource.
+            { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering.
+              "network": "A String", # The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network.
+              "state": "A String", # [Output Only] State for the peering.
+              "stateDetails": "A String", # [Output Only] Details about the current state of the peering.
+              "name": "A String", # Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+              "autoCreateRoutes": True or False, # Whether full mesh connectivity is created and managed automatically. When it is set to true, Google Compute Engine will automatically create and manage the routes between two networks when the state is ACTIVE. Otherwise, user needs to create routes manually to route packets to peer network.
+            },
+          ],
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
           "autoCreateSubnetworks": True or False, # When set to true, the network is created in "auto subnet mode". When set to false, the network is in "custom subnet mode".
               #
@@ -332,6 +432,71 @@ <h3>Method Details</h3>
     </pre>
 </div>
 
+<div class="method">
+    <code class="details" id="removePeering">removePeering(project, network, body)</code>
+  <pre>Removes a peering from the specified network.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network resource to remove peering from. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "name": "A String", # Name of the peering, which should conform to RFC1035.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="switchToCustomMode">switchToCustomMode(project, network)</code>
   <pre>Switches the network mode from auto subnet mode to custom subnet mode.
@@ -386,7 +551,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.projects.html b/docs/dyn/compute_alpha.projects.html
index a7080a95329..8b431f926e8 100644
--- a/docs/dyn/compute_alpha.projects.html
+++ b/docs/dyn/compute_alpha.projects.html
@@ -167,7 +167,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -234,7 +234,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -291,7 +291,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -358,7 +358,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -603,7 +603,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -674,7 +674,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -745,7 +745,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -809,7 +809,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -874,7 +874,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.regionAutoscalers.html b/docs/dyn/compute_alpha.regionAutoscalers.html
index e50baf94c95..031b48b7c7d 100644
--- a/docs/dyn/compute_alpha.regionAutoscalers.html
+++ b/docs/dyn/compute_alpha.regionAutoscalers.html
@@ -154,7 +154,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -344,7 +344,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -572,7 +572,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -720,7 +720,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.regionBackendServices.html b/docs/dyn/compute_alpha.regionBackendServices.html
index 29aa718d185..5551a1e5ea7 100644
--- a/docs/dyn/compute_alpha.regionBackendServices.html
+++ b/docs/dyn/compute_alpha.regionBackendServices.html
@@ -157,7 +157,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -202,7 +202,19 @@ <h3>Method Details</h3>
           # When the protocol is UDP, this field is not used.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-      "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+          "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+            "A String",
+          ],
+          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+            "A String",
+          ],
+          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+        },
+      },
       "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
           #
           # When the load balancing scheme is INTERNAL, this field is not used.
@@ -223,6 +235,7 @@ <h3>Method Details</h3>
           "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
               #
               # This cannot be used for internal load balancing.
+          "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
           "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
               #
               # This cannot be used for internal load balancing.
@@ -250,19 +263,9 @@ <h3>Method Details</h3>
         "oauth2ClientSecretSha256": "A String",
       },
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-      "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-        "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-          "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-          "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-          "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-            "A String",
-          ],
-          "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-            "A String",
-          ],
-          "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-        },
-      },
+      "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+        "A String",
+      ],
       "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
       "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
           #
@@ -270,6 +273,7 @@ <h3>Method Details</h3>
       "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
       "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
       "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+      "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
     }</pre>
 </div>
@@ -345,7 +349,19 @@ <h3>Method Details</h3>
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      },
+    },
     "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -366,6 +382,7 @@ <h3>Method Details</h3>
         "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
             #
             # This cannot be used for internal load balancing.
+        "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
         "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
@@ -393,19 +410,9 @@ <h3>Method Details</h3>
       "oauth2ClientSecretSha256": "A String",
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-      },
-    },
+    "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+      "A String",
+    ],
     "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
     "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
         # 
@@ -413,6 +420,7 @@ <h3>Method Details</h3>
     "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
   }
 
@@ -463,7 +471,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -526,7 +534,19 @@ <h3>Method Details</h3>
               # When the protocol is UDP, this field is not used.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-          "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+          "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+            "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+              "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+              "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+              "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+                "A String",
+              ],
+              "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+                "A String",
+              ],
+              "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+            },
+          },
           "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
               #
               # When the load balancing scheme is INTERNAL, this field is not used.
@@ -547,6 +567,7 @@ <h3>Method Details</h3>
               "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
                   #
                   # This cannot be used for internal load balancing.
+              "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
               "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
                   #
                   # This cannot be used for internal load balancing.
@@ -574,19 +595,9 @@ <h3>Method Details</h3>
             "oauth2ClientSecretSha256": "A String",
           },
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-          "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-            "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-              "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-              "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-              "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-                "A String",
-              ],
-              "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-                "A String",
-              ],
-              "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-            },
-          },
+          "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+            "A String",
+          ],
           "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
           "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
               #
@@ -594,6 +605,7 @@ <h3>Method Details</h3>
           "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
           "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
           "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+          "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
           "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
         },
     ],
@@ -657,7 +669,19 @@ <h3>Method Details</h3>
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      },
+    },
     "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -678,6 +702,7 @@ <h3>Method Details</h3>
         "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
             #
             # This cannot be used for internal load balancing.
+        "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
         "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
@@ -705,19 +730,9 @@ <h3>Method Details</h3>
       "oauth2ClientSecretSha256": "A String",
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-      },
-    },
+    "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+      "A String",
+    ],
     "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
     "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
         # 
@@ -725,6 +740,7 @@ <h3>Method Details</h3>
     "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
   }
 
@@ -775,7 +791,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -847,7 +863,19 @@ <h3>Method Details</h3>
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService.
+      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
+        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
+        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
+        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
+          "A String",
+        ],
+        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
+      },
+    },
     "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -868,6 +896,7 @@ <h3>Method Details</h3>
         "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
             #
             # This cannot be used for internal load balancing.
+        "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
         "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
@@ -895,19 +924,9 @@ <h3>Method Details</h3>
       "oauth2ClientSecretSha256": "A String",
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN Coniguration for this BackendService.
-      "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
-        "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
-        "includeHost": True or False, # If true, requests to different hosts will be cached separately.
-        "queryStringBlacklist": [ # Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "queryStringWhitelist": [ # Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.
-          "A String",
-        ],
-        "includeProtocol": True or False, # If true, http and https requests will be cached separately.
-      },
-    },
+    "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
+      "A String",
+    ],
     "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
     "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
         # 
@@ -915,6 +934,7 @@ <h3>Method Details</h3>
     "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
   }
 
@@ -965,7 +985,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.regionDiskTypes.html b/docs/dyn/compute_alpha.regionDiskTypes.html
index 83f856fd91a..edb039098d3 100644
--- a/docs/dyn/compute_alpha.regionDiskTypes.html
+++ b/docs/dyn/compute_alpha.regionDiskTypes.html
@@ -102,10 +102,10 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
     "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
@@ -152,10 +152,10 @@ <h3>Method Details</h3>
         "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
         "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
diff --git a/docs/dyn/compute_alpha.regionDisks.html b/docs/dyn/compute_alpha.regionDisks.html
index a1dd0c28394..6bcc0b1895f 100644
--- a/docs/dyn/compute_alpha.regionDisks.html
+++ b/docs/dyn/compute_alpha.regionDisks.html
@@ -211,7 +211,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -270,7 +270,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -533,7 +533,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -564,7 +564,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    {
+    { # A list of Disk resources.
     "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
     "items": [ # [Output Only] A list of persistent disks.
       { # A Disk resource.
@@ -661,7 +661,7 @@ <h3>Method Details</h3>
               # global/images/family/my-private-family
         },
     ],
-    "kind": "compute#regionDiskList", # [Output Only] Type of resource. Always compute#regionDiskList for lists of region disks.
+    "kind": "compute#diskList", # [Output Only] Type of resource. Always compute#diskList for lists of disks.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
   }</pre>
@@ -743,7 +743,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -812,7 +812,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.regionInstanceGroupManagers.html b/docs/dyn/compute_alpha.regionInstanceGroupManagers.html
index bcd6d5ce118..a1e9d371162 100644
--- a/docs/dyn/compute_alpha.regionInstanceGroupManagers.html
+++ b/docs/dyn/compute_alpha.regionInstanceGroupManagers.html
@@ -93,7 +93,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Retrieves the list of managed instance groups that are contained within the specified region.</p>
 <p class="toc_element">
-  <code><a href="#listManagedInstances">listManagedInstances(project, region, instanceGroupManager)</a></code></p>
+  <code><a href="#listManagedInstances">listManagedInstances(project, region, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -187,7 +187,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -246,7 +246,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -314,7 +314,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -331,56 +331,19 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Instance Group Manager resource.
-      "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-        "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-        "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-        "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-            #
-            # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-        "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-        "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-        "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-        "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-        "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-      },
-      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-      "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-      "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-        {
-          "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-            "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-            "fixed": 42, # fixed must be non-negative.
-            "percent": 42, # percent must belong to [0, 100].
-          },
-          "instanceTemplate": "A String",
-          "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-        },
-      ],
-      "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-        {
-          "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-          "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-          "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-            "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-            "fixed": 42, # fixed must be non-negative.
-            "percent": 42, # percent must belong to [0, 100].
-          },
-        },
-      ],
-      "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
       "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-      "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-      "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-      "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-        "A String",
-      ],
-      "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
       "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
         "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
         "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
         "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
         "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
       },
+      "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+      "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+      "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+      "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+      "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+      "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
       "updatePolicy": { # The update policy for this managed instance group.
         "type": "A String",
         "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -396,19 +359,58 @@ <h3>Method Details</h3>
         },
         "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
       },
-      "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-      "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+      "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+        "A String",
+      ],
       "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
         { # The named port. For example: .
           "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
           "port": 42, # The port number, which can be a value between 1 and 65535.
         },
       ],
-      "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-      "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-      "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+        {
+          "healthCheck": "A String", # The URL for the health check that signals autohealing.
+          "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+          "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+            "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+            "fixed": 42, # fixed must be non-negative.
+            "percent": 42, # percent must belong to [0, 100].
+          },
+        },
+      ],
+      "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+      "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+      "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+      "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+        "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+        "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+        "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+            #
+            # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+        "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+        "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+        "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+        "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+        "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+        "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+      },
       "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+      "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+        {
+          "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+            "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+            "fixed": 42, # fixed must be non-negative.
+            "percent": 42, # percent must belong to [0, 100].
+          },
+          "instanceTemplate": "A String",
+          "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+        },
+      ],
+      "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+      "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
     }</pre>
 </div>
 
@@ -423,56 +425,19 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Instance Group Manager resource.
-    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-          #
-          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-    },
-    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-      {
-        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-        "instanceTemplate": "A String",
-        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-      },
-    ],
-    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-      {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-      },
-    ],
-    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-      "A String",
-    ],
-    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
       "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
       "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
       "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
       "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
     },
+    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "updatePolicy": { # The update policy for this managed instance group.
       "type": "A String",
       "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -488,19 +453,58 @@ <h3>Method Details</h3>
       },
       "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
     },
-    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+      "A String",
+    ],
     "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
       { # The named port. For example: .
         "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
         "port": 42, # The port number, which can be a value between 1 and 65535.
       },
     ],
-    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+      {
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
+        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+      },
+    ],
+    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+          #
+          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+      "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+    },
     "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+      {
+        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+        "instanceTemplate": "A String",
+        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+      },
+    ],
+    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
   }
 
 
@@ -550,7 +554,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -585,56 +589,19 @@ <h3>Method Details</h3>
     "nextPageToken": "A String", # [Output only] A token used to continue a truncated list request.
     "items": [ # A list of managed instance groups.
       { # An Instance Group Manager resource.
-          "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-            "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-            "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-            "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-                #
-                # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-            "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-            "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-            "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-            "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-            "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-          },
-          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-          "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-          "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-            {
-              "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-                "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-                "fixed": 42, # fixed must be non-negative.
-                "percent": 42, # percent must belong to [0, 100].
-              },
-              "instanceTemplate": "A String",
-              "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-            },
-          ],
-          "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-            {
-              "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-              "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-              "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-                "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-                "fixed": 42, # fixed must be non-negative.
-                "percent": 42, # percent must belong to [0, 100].
-              },
-            },
-          ],
-          "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
           "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-          "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-          "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-          "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-            "A String",
-          ],
-          "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
           "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
             "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
             "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
             "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
             "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
           },
+          "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+          "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+          "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+          "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+          "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+          "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
           "updatePolicy": { # The update policy for this managed instance group.
             "type": "A String",
             "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -650,19 +617,58 @@ <h3>Method Details</h3>
             },
             "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
           },
-          "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-          "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-          "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+          "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+            "A String",
+          ],
           "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
             { # The named port. For example: .
               "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
               "port": 42, # The port number, which can be a value between 1 and 65535.
             },
           ],
-          "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-          "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-          "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+            {
+              "healthCheck": "A String", # The URL for the health check that signals autohealing.
+              "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+              "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+                "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+                "fixed": 42, # fixed must be non-negative.
+                "percent": 42, # percent must belong to [0, 100].
+              },
+            },
+          ],
+          "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+          "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+          "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+          "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+          "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+            "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+            "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+            "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+                #
+                # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+            "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+            "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+            "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+            "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+            "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+            "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+          },
           "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+          "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+            {
+              "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+                "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+                "fixed": 42, # fixed must be non-negative.
+                "percent": 42, # percent must belong to [0, 100].
+              },
+              "instanceTemplate": "A String",
+              "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+            },
+          ],
+          "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+          "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
         },
     ],
     "kind": "compute#regionInstanceGroupManagerList", # [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups that exist in th regional scope.
@@ -672,13 +678,17 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="listManagedInstances">listManagedInstances(project, region, instanceGroupManager)</code>
+    <code class="details" id="listManagedInstances">listManagedInstances(project, region, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances.
 
 Args:
   project: string, Project ID for this request. (required)
   region: string, Name of the region scoping this request. (required)
   instanceGroupManager: string, The name of the managed instance group. (required)
+  order_by: string, A parameter
+  maxResults: integer, A parameter
+  pageToken: string, A parameter
+  filter: string, A parameter
 
 Returns:
   An object of the form:
@@ -743,56 +753,19 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Instance Group Manager resource.
-    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-          #
-          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-    },
-    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-      {
-        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-        "instanceTemplate": "A String",
-        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-      },
-    ],
-    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-      {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-      },
-    ],
-    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-      "A String",
-    ],
-    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
       "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
       "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
       "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
       "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
     },
+    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "updatePolicy": { # The update policy for this managed instance group.
       "type": "A String",
       "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -808,19 +781,58 @@ <h3>Method Details</h3>
       },
       "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
     },
-    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+      "A String",
+    ],
     "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
       { # The named port. For example: .
         "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
         "port": 42, # The port number, which can be a value between 1 and 65535.
       },
     ],
-    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+      {
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
+        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+      },
+    ],
+    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+          #
+          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+      "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+    },
     "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+      {
+        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+        "instanceTemplate": "A String",
+        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+      },
+    ],
+    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
   }
 
 
@@ -870,7 +882,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -938,7 +950,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -998,7 +1010,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1016,7 +1028,7 @@ <h3>Method Details</h3>
 {
     "autoHealingPolicies": [
       {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
         "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
         "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
           "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
@@ -1074,7 +1086,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1140,7 +1152,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1209,7 +1221,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1253,56 +1265,19 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Instance Group Manager resource.
-    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
-      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
-      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
-      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
-          #
-          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
-      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
-      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
-      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
-      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
-      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
-    },
-    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
-    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
-    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
-      {
-        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-        "instanceTemplate": "A String",
-        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
-      },
-    ],
-    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
-      {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
-        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
-        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
-          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
-          "fixed": 42, # fixed must be non-negative.
-          "percent": 42, # percent must belong to [0, 100].
-        },
-      },
-    ],
-    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
-    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
-    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
-    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
-      "A String",
-    ],
-    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "pendingActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are pending for each of those actions.
       "recreating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be recreated.
       "deleting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be deleted.
       "creating": 42, # [Output Only] The number of instances in the managed instance group that are pending to be created.
       "restarting": 42, # [Output Only] The number of instances in the managed instance group that are pending to be restarted.
     },
+    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
+    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
     "updatePolicy": { # The update policy for this managed instance group.
       "type": "A String",
       "maxSurge": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be created above the InstanceGroupManager.targetSize during the update process. By default, a fixed value of 1 is used. Using maxSurge > 0 will cause instance names to change during the update process. At least one of { maxSurge, maxUnavailable } must be greater than 0.
@@ -1318,19 +1293,58 @@ <h3>Method Details</h3>
       },
       "minReadySec": 42, # Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600].
     },
-    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
-    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
-    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+      "A String",
+    ],
     "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
       { # The named port. For example: .
         "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
         "port": 42, # The port number, which can be a value between 1 and 65535.
       },
     ],
-    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
-    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
-    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
+      {
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
+        "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
+        "maxUnavailable": { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when auto-healing. The instance is considered available if all of the following conditions are satisfied: 1. instance's status is RUNNING 2. instance's liveness health check result was observed to be HEALTHY at least once By default, a percent value of 100% is used.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+      },
+    ],
+    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+          #
+          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+      "verifying": 42, # [Output Only] The number of instances in the managed instance group that are being verified.
+      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+    },
     "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+    "versions": [ # Versions supported by this IGM. User should set this field if they need fine-grained control over how many instances in each version are run by this IGM. Versions are keyed by instanceTemplate. Every instanceTemplate can appear at most once. This field overrides instanceTemplate field. If both instanceTemplate and versions are set, the user receives a warning. "instanceTemplate: X" is semantically equivalent to "versions [ { instanceTemplate: X } ]". Exactly one version must have targetSize field left unset. Size of such a version will be calculated automatically.
+      {
+        "targetSize": { # Encapsulates numeric value that can be either absolute or relative. # Intended number of instances that are created from instanceTemplate. The final number of instances created from instanceTemplate will be equal to: * if expressed as fixed number: min(targetSize.fixed, instanceGroupManager.targetSize), * if expressed as percent: ceiling(targetSize.percent * InstanceGroupManager.targetSize). If unset, this version will handle all the remaining instances.
+          "calculated": 42, # [Output Only] Absolute value calculated based on mode: mode = fixed -> calculated = fixed = percent -> calculated = ceiling(percent/100 * base_value)
+          "fixed": 42, # fixed must be non-negative.
+          "percent": 42, # percent must belong to [0, 100].
+        },
+        "instanceTemplate": "A String",
+        "tag": "A String", # Tag describing the version. Used to trigger rollout of a target version even if instance_template remains unchanged.
+      },
+    ],
+    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
   }
 
 
@@ -1380,7 +1394,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.regionInstanceGroups.html b/docs/dyn/compute_alpha.regionInstanceGroups.html
index e5beafd4e6c..4dbba653a08 100644
--- a/docs/dyn/compute_alpha.regionInstanceGroups.html
+++ b/docs/dyn/compute_alpha.regionInstanceGroups.html
@@ -347,7 +347,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.regionOperations.html b/docs/dyn/compute_alpha.regionOperations.html
index f4d6d08aa74..b2d8dc2ce13 100644
--- a/docs/dyn/compute_alpha.regionOperations.html
+++ b/docs/dyn/compute_alpha.regionOperations.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_alpha.regions.html b/docs/dyn/compute_alpha.regions.html
index 5fe9c449f71..557afce23d9 100644
--- a/docs/dyn/compute_alpha.regions.html
+++ b/docs/dyn/compute_alpha.regions.html
@@ -100,10 +100,10 @@ <h3>Method Details</h3>
     "kind": "compute#region", # [Output Only] Type of the resource. Always compute#region for regions.
     "description": "A String", # [Output Only] Textual description of the resource.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this region.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "quotas": [ # [Output Only] Quotas assigned to this region.
@@ -157,10 +157,10 @@ <h3>Method Details</h3>
         "kind": "compute#region", # [Output Only] Type of the resource. Always compute#region for regions.
         "description": "A String", # [Output Only] Textual description of the resource.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this region.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "quotas": [ # [Output Only] Quotas assigned to this region.
diff --git a/docs/dyn/compute_alpha.routers.html b/docs/dyn/compute_alpha.routers.html
index c1af5cf54b4..a38474fa8e2 100644
--- a/docs/dyn/compute_alpha.routers.html
+++ b/docs/dyn/compute_alpha.routers.html
@@ -261,7 +261,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -348,6 +348,7 @@ <h3>Method Details</h3>
               "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example:
                   # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
               "priority": 42, # The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In the case of two routes with equal prefix length, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535.
+              "nextHopPeering": "A String", # [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035.
               "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
               "network": "A String", # Fully-qualified URL of the network that this route applies to.
               "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
@@ -393,6 +394,7 @@ <h3>Method Details</h3>
           "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example:
               # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
           "priority": 42, # The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In the case of two routes with equal prefix length, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535.
+          "nextHopPeering": "A String", # [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035.
           "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
           "network": "A String", # Fully-qualified URL of the network that this route applies to.
           "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
@@ -508,7 +510,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -682,7 +684,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -883,7 +885,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.routes.html b/docs/dyn/compute_alpha.routes.html
index 11011730284..7220a8ed80b 100644
--- a/docs/dyn/compute_alpha.routes.html
+++ b/docs/dyn/compute_alpha.routes.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -177,6 +177,7 @@ <h3>Method Details</h3>
     "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example:
         # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
     "priority": 42, # The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In the case of two routes with equal prefix length, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535.
+    "nextHopPeering": "A String", # [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035.
     "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
     "network": "A String", # Fully-qualified URL of the network that this route applies to.
     "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
@@ -225,6 +226,7 @@ <h3>Method Details</h3>
   "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example:
       # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
   "priority": 42, # The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In the case of two routes with equal prefix length, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535.
+  "nextHopPeering": "A String", # [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035.
   "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
   "network": "A String", # Fully-qualified URL of the network that this route applies to.
   "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
@@ -295,7 +297,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -343,6 +345,7 @@ <h3>Method Details</h3>
         "nextHopInstance": "A String", # The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example:
             # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
         "priority": 42, # The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In the case of two routes with equal prefix length, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535.
+        "nextHopPeering": "A String", # [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035.
         "nextHopNetwork": "A String", # The URL of the local network if it should handle matching packets.
         "network": "A String", # Fully-qualified URL of the network that this route applies to.
         "selfLink": "A String", # [Output Only] Server-defined fully-qualified URL for this resource.
diff --git a/docs/dyn/compute_alpha.snapshots.html b/docs/dyn/compute_alpha.snapshots.html
index d0288fdf9a8..eca6c94a38e 100644
--- a/docs/dyn/compute_alpha.snapshots.html
+++ b/docs/dyn/compute_alpha.snapshots.html
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -378,7 +378,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.sslCertificates.html b/docs/dyn/compute_alpha.sslCertificates.html
index 94f3a58a42e..0a07b53e62c 100644
--- a/docs/dyn/compute_alpha.sslCertificates.html
+++ b/docs/dyn/compute_alpha.sslCertificates.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -166,7 +166,7 @@ <h3>Method Details</h3>
       "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
       "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
       "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-      "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+      "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
       "selfLink": "A String", # [Output only] Server-defined URL for the resource.
@@ -187,7 +187,7 @@ <h3>Method Details</h3>
     "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-    "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+    "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "selfLink": "A String", # [Output only] Server-defined URL for the resource.
@@ -241,7 +241,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -278,7 +278,7 @@ <h3>Method Details</h3>
           "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
           "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
           "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-          "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+          "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
           "selfLink": "A String", # [Output only] Server-defined URL for the resource.
diff --git a/docs/dyn/compute_alpha.subnetworks.html b/docs/dyn/compute_alpha.subnetworks.html
index 400c72e553a..e217f750be5 100644
--- a/docs/dyn/compute_alpha.subnetworks.html
+++ b/docs/dyn/compute_alpha.subnetworks.html
@@ -250,7 +250,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -316,7 +316,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -379,11 +379,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -436,6 +444,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -526,7 +536,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -625,11 +635,19 @@ <h3>Method Details</h3>
   "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
       # 
       # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-    { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+    { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
       "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
         "A String",
       ],
-      "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      "auditLogConfigs": [ # The configuration for each type of logging
+        { # Provides the configuration for a sub-type of logging.
+          "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
     },
   ],
   "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -682,6 +700,8 @@ <h3>Method Details</h3>
           #
           # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
           #
+          #
+          #
           # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
           #
           # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -712,11 +732,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -769,6 +797,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -844,7 +874,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.targetHttpProxies.html b/docs/dyn/compute_alpha.targetHttpProxies.html
index eb211c60f08..10a0d18e7e0 100644
--- a/docs/dyn/compute_alpha.targetHttpProxies.html
+++ b/docs/dyn/compute_alpha.targetHttpProxies.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -242,7 +242,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -366,7 +366,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.targetHttpsProxies.html b/docs/dyn/compute_alpha.targetHttpsProxies.html
index c53bc13ac54..5faeb04a12c 100644
--- a/docs/dyn/compute_alpha.targetHttpsProxies.html
+++ b/docs/dyn/compute_alpha.targetHttpsProxies.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -259,7 +259,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -392,7 +392,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -457,7 +457,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.targetInstances.html b/docs/dyn/compute_alpha.targetInstances.html
index 37ad245bead..217e65bf135 100644
--- a/docs/dyn/compute_alpha.targetInstances.html
+++ b/docs/dyn/compute_alpha.targetInstances.html
@@ -233,7 +233,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -337,7 +337,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.targetPools.html b/docs/dyn/compute_alpha.targetPools.html
index de82b7e007c..a76c46328e6 100644
--- a/docs/dyn/compute_alpha.targetPools.html
+++ b/docs/dyn/compute_alpha.targetPools.html
@@ -186,7 +186,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -259,7 +259,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -412,7 +412,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -578,7 +578,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -734,7 +734,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -804,7 +804,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -871,7 +871,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.targetSslProxies.html b/docs/dyn/compute_alpha.targetSslProxies.html
index dee0a2b522c..6568e02b5e7 100644
--- a/docs/dyn/compute_alpha.targetSslProxies.html
+++ b/docs/dyn/compute_alpha.targetSslProxies.html
@@ -156,7 +156,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -258,7 +258,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -387,7 +387,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -452,7 +452,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -519,7 +519,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.targetTcpProxies.html b/docs/dyn/compute_alpha.targetTcpProxies.html
index 95db6617e2d..6b2b031e2d4 100644
--- a/docs/dyn/compute_alpha.targetTcpProxies.html
+++ b/docs/dyn/compute_alpha.targetTcpProxies.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -247,7 +247,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -372,7 +372,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -437,7 +437,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.targetVpnGateways.html b/docs/dyn/compute_alpha.targetVpnGateways.html
index 3453a1d008d..1f75644e74a 100644
--- a/docs/dyn/compute_alpha.targetVpnGateways.html
+++ b/docs/dyn/compute_alpha.targetVpnGateways.html
@@ -236,7 +236,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -346,7 +346,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.urlMaps.html b/docs/dyn/compute_alpha.urlMaps.html
index 8c44b76e20a..fc172a96a23 100644
--- a/docs/dyn/compute_alpha.urlMaps.html
+++ b/docs/dyn/compute_alpha.urlMaps.html
@@ -159,7 +159,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -323,7 +323,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -389,7 +389,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -591,7 +591,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -725,7 +725,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.vpnTunnels.html b/docs/dyn/compute_alpha.vpnTunnels.html
index 8e153baf1a3..db21a8f976a 100644
--- a/docs/dyn/compute_alpha.vpnTunnels.html
+++ b/docs/dyn/compute_alpha.vpnTunnels.html
@@ -248,7 +248,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -382,7 +382,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_alpha.zoneOperations.html b/docs/dyn/compute_alpha.zoneOperations.html
index 6a5cb37c8b2..4feaca16c2c 100644
--- a/docs/dyn/compute_alpha.zoneOperations.html
+++ b/docs/dyn/compute_alpha.zoneOperations.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_alpha.zones.html b/docs/dyn/compute_alpha.zones.html
index 7f366dead5e..ef4e4c3f411 100644
--- a/docs/dyn/compute_alpha.zones.html
+++ b/docs/dyn/compute_alpha.zones.html
@@ -100,10 +100,10 @@ <h3>Method Details</h3>
     "kind": "compute#zone", # [Output Only] Type of the resource. Always compute#zone for zones.
     "description": "A String", # [Output Only] Textual description of the resource.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
@@ -148,10 +148,10 @@ <h3>Method Details</h3>
         "kind": "compute#zone", # [Output Only] Type of the resource. Always compute#zone for zones.
         "description": "A String", # [Output Only] Textual description of the resource.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
diff --git a/docs/dyn/compute_beta.addresses.html b/docs/dyn/compute_beta.addresses.html
index 5fd99baeeaa..320cd50c58a 100644
--- a/docs/dyn/compute_beta.addresses.html
+++ b/docs/dyn/compute_beta.addresses.html
@@ -233,7 +233,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -337,7 +337,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.autoscalers.html b/docs/dyn/compute_beta.autoscalers.html
index 961db441950..130e8764c40 100644
--- a/docs/dyn/compute_beta.autoscalers.html
+++ b/docs/dyn/compute_beta.autoscalers.html
@@ -274,7 +274,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -448,7 +448,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -660,7 +660,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -800,7 +800,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.backendBuckets.html b/docs/dyn/compute_beta.backendBuckets.html
new file mode 100644
index 00000000000..666fb95665d
--- /dev/null
+++ b/docs/dyn/compute_beta.backendBuckets.html
@@ -0,0 +1,455 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="compute_beta.html">Compute Engine API</a> . <a href="compute_beta.backendBuckets.html">backendBuckets</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(project, backendBucket)</a></code></p>
+<p class="firstline">Deletes the specified BackendBucket resource.</p>
+<p class="toc_element">
+  <code><a href="#get">get(project, backendBucket)</a></code></p>
+<p class="firstline">Returns the specified BackendBucket resource. Get a list of available backend buckets by making a list() request.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(project, body)</a></code></p>
+<p class="firstline">Creates a BackendBucket resource in the specified project using the data included in the request.</p>
+<p class="toc_element">
+  <code><a href="#list">list(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves the list of BackendBucket resources available to the specified project.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(project, backendBucket, body)</a></code></p>
+<p class="firstline">Updates the specified BackendBucket resource with the data included in the request. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(project, backendBucket, body)</a></code></p>
+<p class="firstline">Updates the specified BackendBucket resource with the data included in the request.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(project, backendBucket)</code>
+  <pre>Deletes the specified BackendBucket resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket resource to delete. (required)
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(project, backendBucket)</code>
+  <pre>Returns the specified BackendBucket resource. Get a list of available backend buckets by making a list() request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket resource to return. (required)
+
+Returns:
+  An object of the form:
+
+    { # A BackendBucket resource. This resource defines a Cloud Storage bucket.
+      "kind": "compute#backendBucket", # Type of the resource.
+      "description": "A String", # An optional textual description of the resource; provided by the client when the resource is created.
+      "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+      "bucketName": "A String", # Cloud Storage bucket name.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+      "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(project, body)</code>
+  <pre>Creates a BackendBucket resource in the specified project using the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # A BackendBucket resource. This resource defines a Cloud Storage bucket.
+    "kind": "compute#backendBucket", # Type of the resource.
+    "description": "A String", # An optional textual description of the resource; provided by the client when the resource is created.
+    "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+    "bucketName": "A String", # Cloud Storage bucket name.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves the list of BackendBucket resources available to the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of BackendBucket resources.
+    "nextPageToken": "A String", # [Output Only] A token used to continue a truncated list request.
+    "items": [ # A list of BackendBucket resources.
+      { # A BackendBucket resource. This resource defines a Cloud Storage bucket.
+          "kind": "compute#backendBucket", # Type of the resource.
+          "description": "A String", # An optional textual description of the resource; provided by the client when the resource is created.
+          "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+          "bucketName": "A String", # Cloud Storage bucket name.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+          "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+        },
+    ],
+    "kind": "compute#backendBucketList", # Type of resource.
+    "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(project, backendBucket, body)</code>
+  <pre>Updates the specified BackendBucket resource with the data included in the request. This method supports patch semantics.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket resource to update. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # A BackendBucket resource. This resource defines a Cloud Storage bucket.
+    "kind": "compute#backendBucket", # Type of the resource.
+    "description": "A String", # An optional textual description of the resource; provided by the client when the resource is created.
+    "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+    "bucketName": "A String", # Cloud Storage bucket name.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(project, backendBucket, body)</code>
+  <pre>Updates the specified BackendBucket resource with the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  backendBucket: string, Name of the BackendBucket resource to update. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # A BackendBucket resource. This resource defines a Cloud Storage bucket.
+    "kind": "compute#backendBucket", # Type of the resource.
+    "description": "A String", # An optional textual description of the resource; provided by the client when the resource is created.
+    "enableCdn": True or False, # If true, enable Cloud CDN for this BackendBucket.
+    "bucketName": "A String", # Cloud Storage bucket name.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/compute_beta.backendServices.html b/docs/dyn/compute_beta.backendServices.html
index 43e35c18c34..7132a80bb17 100644
--- a/docs/dyn/compute_beta.backendServices.html
+++ b/docs/dyn/compute_beta.backendServices.html
@@ -170,6 +170,7 @@ <h3>Method Details</h3>
               "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
                   #
                   # When the load balancing scheme is INTERNAL, this field is not used.
+              "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
               "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
                   #
                   # This cannot be used for internal load balancing.
@@ -221,7 +222,12 @@ <h3>Method Details</h3>
                   #
                   # When the protocol is UDP, this field is not used.
               "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-              "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+              "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+                "oauth2ClientId": "A String",
+                "enabled": True or False,
+                "oauth2ClientSecret": "A String",
+                "oauth2ClientSecretSha256": "A String",
+              },
               "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
               "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
             },
@@ -302,7 +308,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -337,6 +343,7 @@ <h3>Method Details</h3>
       "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
           #
           # When the load balancing scheme is INTERNAL, this field is not used.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
       "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
           #
           # This cannot be used for internal load balancing.
@@ -388,7 +395,12 @@ <h3>Method Details</h3>
           #
           # When the protocol is UDP, this field is not used.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+      "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+        "oauth2ClientId": "A String",
+        "enabled": True or False,
+        "oauth2ClientSecret": "A String",
+        "oauth2ClientSecretSha256": "A String",
+      },
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
       "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     }</pre>
@@ -454,6 +466,7 @@ <h3>Method Details</h3>
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
         # 
         # This cannot be used for internal load balancing.
@@ -505,7 +518,12 @@ <h3>Method Details</h3>
         # 
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+      "oauth2ClientId": "A String",
+      "enabled": True or False,
+      "oauth2ClientSecret": "A String",
+      "oauth2ClientSecretSha256": "A String",
+    },
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   }
@@ -557,7 +575,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -610,6 +628,7 @@ <h3>Method Details</h3>
           "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
               #
               # When the load balancing scheme is INTERNAL, this field is not used.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
           "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
               #
               # This cannot be used for internal load balancing.
@@ -661,7 +680,12 @@ <h3>Method Details</h3>
               #
               # When the protocol is UDP, this field is not used.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+          "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+            "oauth2ClientId": "A String",
+            "enabled": True or False,
+            "oauth2ClientSecret": "A String",
+            "oauth2ClientSecretSha256": "A String",
+          },
           "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
           "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
         },
@@ -716,6 +740,7 @@ <h3>Method Details</h3>
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
         # 
         # This cannot be used for internal load balancing.
@@ -767,7 +792,12 @@ <h3>Method Details</h3>
         # 
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+      "oauth2ClientId": "A String",
+      "enabled": True or False,
+      "oauth2ClientSecret": "A String",
+      "oauth2ClientSecretSha256": "A String",
+    },
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   }
@@ -819,7 +849,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -880,6 +910,7 @@ <h3>Method Details</h3>
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
         # 
         # This cannot be used for internal load balancing.
@@ -931,7 +962,12 @@ <h3>Method Details</h3>
         # 
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+      "oauth2ClientId": "A String",
+      "enabled": True or False,
+      "oauth2ClientSecret": "A String",
+      "oauth2ClientSecretSha256": "A String",
+    },
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   }
@@ -983,7 +1019,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.diskTypes.html b/docs/dyn/compute_beta.diskTypes.html
index d9dcd1f7d3d..d720f4cf59e 100644
--- a/docs/dyn/compute_beta.diskTypes.html
+++ b/docs/dyn/compute_beta.diskTypes.html
@@ -138,10 +138,10 @@ <h3>Method Details</h3>
             "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
             "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
             "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-              "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+              "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
               "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
               "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
             },
             "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
@@ -191,10 +191,10 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
     "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
@@ -241,10 +241,10 @@ <h3>Method Details</h3>
         "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
         "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
diff --git a/docs/dyn/compute_beta.disks.html b/docs/dyn/compute_beta.disks.html
index f4b58b6da1c..a81f87b7f17 100644
--- a/docs/dyn/compute_beta.disks.html
+++ b/docs/dyn/compute_beta.disks.html
@@ -371,7 +371,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -430,7 +430,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -685,7 +685,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -891,7 +891,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -960,7 +960,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.firewalls.html b/docs/dyn/compute_beta.firewalls.html
index 5a714575410..f073024688f 100644
--- a/docs/dyn/compute_beta.firewalls.html
+++ b/docs/dyn/compute_beta.firewalls.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -293,7 +293,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -471,7 +471,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -593,7 +593,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.forwardingRules.html b/docs/dyn/compute_beta.forwardingRules.html
index efbd7375952..152f94c8b46 100644
--- a/docs/dyn/compute_beta.forwardingRules.html
+++ b/docs/dyn/compute_beta.forwardingRules.html
@@ -264,7 +264,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -424,7 +424,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -583,7 +583,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.globalAddresses.html b/docs/dyn/compute_beta.globalAddresses.html
index 830259931d8..92f4ba716eb 100644
--- a/docs/dyn/compute_beta.globalAddresses.html
+++ b/docs/dyn/compute_beta.globalAddresses.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -249,7 +249,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.globalForwardingRules.html b/docs/dyn/compute_beta.globalForwardingRules.html
index d8b367076b5..9f2ca847855 100644
--- a/docs/dyn/compute_beta.globalForwardingRules.html
+++ b/docs/dyn/compute_beta.globalForwardingRules.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -308,7 +308,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -465,7 +465,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.globalOperations.html b/docs/dyn/compute_beta.globalOperations.html
index 8983a9d2ee0..0655a216bef 100644
--- a/docs/dyn/compute_beta.globalOperations.html
+++ b/docs/dyn/compute_beta.globalOperations.html
@@ -167,7 +167,7 @@ <h3>Method Details</h3>
             },
             "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
             "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-            "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+            "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
           },
         ],
         "warning": { # [Output Only] Informational warning which replaces the list of operations when the list is empty.
@@ -267,7 +267,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -343,7 +343,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_beta.healthChecks.html b/docs/dyn/compute_beta.healthChecks.html
index 58ecb907d78..ca4fc9f7203 100644
--- a/docs/dyn/compute_beta.healthChecks.html
+++ b/docs/dyn/compute_beta.healthChecks.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -170,9 +170,15 @@ <h3>Method Details</h3>
 
     { # An HealthCheck resource. This resource defines a template for how individual virtual machines should be checked for health, via one of the supported protocols.
       "kind": "compute#healthCheck", # Type of the resource.
+      "udpHealthCheck": {
+        "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
+        "request": "A String", # Raw data of request to send in payload of UDP packet. It is an error if this is empty. The request data can only be ASCII.
+        "port": 42, # The UDP port number for the health check request.
+        "response": "A String", # The bytes to match against the beginning of the response data. It is an error if this is empty. The response data can only be ASCII.
+      },
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-      "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+      "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
       "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
       "tcpHealthCheck": {
         "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -196,13 +202,6 @@ <h3>Method Details</h3>
         "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
       },
       "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-      "http2HealthCheck": {
-        "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-        "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-        "port": 42, # The TCP port number for the health check request. The default value is 443.
-        "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-      },
       "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
       "sslHealthCheck": {
         "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -229,9 +228,15 @@ <h3>Method Details</h3>
 
 { # An HealthCheck resource. This resource defines a template for how individual virtual machines should be checked for health, via one of the supported protocols.
     "kind": "compute#healthCheck", # Type of the resource.
+    "udpHealthCheck": {
+      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
+      "request": "A String", # Raw data of request to send in payload of UDP packet. It is an error if this is empty. The request data can only be ASCII.
+      "port": 42, # The UDP port number for the health check request.
+      "response": "A String", # The bytes to match against the beginning of the response data. It is an error if this is empty. The response data can only be ASCII.
+    },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -255,13 +260,6 @@ <h3>Method Details</h3>
       "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
     },
     "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-    "http2HealthCheck": {
-      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-      "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-      "port": 42, # The TCP port number for the health check request. The default value is 443.
-      "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-    },
     "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
     "sslHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -323,7 +321,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -358,9 +356,15 @@ <h3>Method Details</h3>
     "items": [ # A list of HealthCheck resources.
       { # An HealthCheck resource. This resource defines a template for how individual virtual machines should be checked for health, via one of the supported protocols.
           "kind": "compute#healthCheck", # Type of the resource.
+          "udpHealthCheck": {
+            "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
+            "request": "A String", # Raw data of request to send in payload of UDP packet. It is an error if this is empty. The request data can only be ASCII.
+            "port": 42, # The UDP port number for the health check request.
+            "response": "A String", # The bytes to match against the beginning of the response data. It is an error if this is empty. The response data can only be ASCII.
+          },
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
           "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-          "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+          "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
           "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
           "tcpHealthCheck": {
             "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -384,13 +388,6 @@ <h3>Method Details</h3>
             "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
           },
           "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-          "http2HealthCheck": {
-            "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-            "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-            "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-            "port": 42, # The TCP port number for the health check request. The default value is 443.
-            "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-          },
           "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
           "sslHealthCheck": {
             "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -437,9 +434,15 @@ <h3>Method Details</h3>
 
 { # An HealthCheck resource. This resource defines a template for how individual virtual machines should be checked for health, via one of the supported protocols.
     "kind": "compute#healthCheck", # Type of the resource.
+    "udpHealthCheck": {
+      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
+      "request": "A String", # Raw data of request to send in payload of UDP packet. It is an error if this is empty. The request data can only be ASCII.
+      "port": 42, # The UDP port number for the health check request.
+      "response": "A String", # The bytes to match against the beginning of the response data. It is an error if this is empty. The response data can only be ASCII.
+    },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -463,13 +466,6 @@ <h3>Method Details</h3>
       "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
     },
     "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-    "http2HealthCheck": {
-      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-      "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-      "port": 42, # The TCP port number for the health check request. The default value is 443.
-      "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-    },
     "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
     "sslHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -531,7 +527,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -574,9 +570,15 @@ <h3>Method Details</h3>
 
 { # An HealthCheck resource. This resource defines a template for how individual virtual machines should be checked for health, via one of the supported protocols.
     "kind": "compute#healthCheck", # Type of the resource.
+    "udpHealthCheck": {
+      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
+      "request": "A String", # Raw data of request to send in payload of UDP packet. It is an error if this is empty. The request data can only be ASCII.
+      "port": 42, # The UDP port number for the health check request.
+      "response": "A String", # The bytes to match against the beginning of the response data. It is an error if this is empty. The response data can only be ASCII.
+    },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -600,13 +602,6 @@ <h3>Method Details</h3>
       "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
     },
     "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-    "http2HealthCheck": {
-      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-      "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-      "port": 42, # The TCP port number for the health check request. The default value is 443.
-      "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-    },
     "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
     "sslHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -668,7 +663,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.html b/docs/dyn/compute_beta.html
index 025623f522b..00a78a4161f 100644
--- a/docs/dyn/compute_beta.html
+++ b/docs/dyn/compute_beta.html
@@ -84,6 +84,11 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the autoscalers Resource.</p>
 
+<p class="toc_element">
+  <code><a href="compute_beta.backendBuckets.html">backendBuckets()</a></code>
+</p>
+<p class="firstline">Returns the backendBuckets Resource.</p>
+
 <p class="toc_element">
   <code><a href="compute_beta.backendServices.html">backendServices()</a></code>
 </p>
diff --git a/docs/dyn/compute_beta.httpHealthChecks.html b/docs/dyn/compute_beta.httpHealthChecks.html
index 22298ff5263..32ac2f350e2 100644
--- a/docs/dyn/compute_beta.httpHealthChecks.html
+++ b/docs/dyn/compute_beta.httpHealthChecks.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -257,7 +257,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -399,7 +399,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -503,7 +503,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.httpsHealthChecks.html b/docs/dyn/compute_beta.httpsHealthChecks.html
index 47edcb73e33..87cae5fef4a 100644
--- a/docs/dyn/compute_beta.httpsHealthChecks.html
+++ b/docs/dyn/compute_beta.httpsHealthChecks.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -257,7 +257,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -399,7 +399,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -503,7 +503,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.images.html b/docs/dyn/compute_beta.images.html
index f2c59975d09..1f3efe38102 100644
--- a/docs/dyn/compute_beta.images.html
+++ b/docs/dyn/compute_beta.images.html
@@ -156,7 +156,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -173,10 +173,10 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Deprecation status for a public resource.
-  "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-  "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+  "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+  "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
   "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-  "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+  "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
   "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
 }
 
@@ -227,7 +227,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -243,7 +243,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Image resource.
-      "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+      "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
           # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
           # - projects/project/zones/zone/disks/disk
           # - zones/zone/disks/disk
@@ -262,10 +262,10 @@ <h3>Method Details</h3>
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
       "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-        "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
         "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
         "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
       },
       "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.
@@ -276,9 +276,11 @@ <h3>Method Details</h3>
       },
       "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
       "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
-      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature is supported, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+          #
+          # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
         { # Guest OS features.
-          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported.
+          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
         },
       ],
       "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
@@ -326,7 +328,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Image resource.
-      "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+      "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
           # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
           # - projects/project/zones/zone/disks/disk
           # - zones/zone/disks/disk
@@ -345,10 +347,10 @@ <h3>Method Details</h3>
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
       "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-        "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
         "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
         "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
       },
       "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.
@@ -359,9 +361,11 @@ <h3>Method Details</h3>
       },
       "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
       "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
-      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature is supported, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+          #
+          # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
         { # Guest OS features.
-          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported.
+          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
         },
       ],
       "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
@@ -407,7 +411,7 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Image resource.
-    "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+    "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
         # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
         # - projects/project/zones/zone/disks/disk
         # - zones/zone/disks/disk
@@ -426,10 +430,10 @@ <h3>Method Details</h3>
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
     "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.
@@ -440,9 +444,11 @@ <h3>Method Details</h3>
     },
     "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
     "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
-    "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature is supported, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+    "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+        # 
+        # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
       { # Guest OS features.
-        "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported.
+        "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
       },
     ],
     "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
@@ -524,7 +530,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -558,7 +564,7 @@ <h3>Method Details</h3>
     "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
     "items": [ # [Output Only] A list of Image resources.
       { # An Image resource.
-          "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+          "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
               # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
               # - projects/project/zones/zone/disks/disk
               # - zones/zone/disks/disk
@@ -577,10 +583,10 @@ <h3>Method Details</h3>
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
           "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
           "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-            "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+            "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
             "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
             "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
           },
           "labelFingerprint": "A String", # A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels.
@@ -591,9 +597,11 @@ <h3>Method Details</h3>
           },
           "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
           "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
-          "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature is supported, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+          "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+              #
+              # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
             { # Guest OS features.
-              "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported.
+              "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
             },
           ],
           "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
@@ -712,7 +720,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.instanceGroupManagers.html b/docs/dyn/compute_beta.instanceGroupManagers.html
index 8c93a0e3d81..1cb21a2f459 100644
--- a/docs/dyn/compute_beta.instanceGroupManagers.html
+++ b/docs/dyn/compute_beta.instanceGroupManagers.html
@@ -99,7 +99,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list(project, zone, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Retrieves a list of managed instance groups that are contained within the specified project and zone.</p>
 <p class="toc_element">
-  <code><a href="#listManagedInstances">listManagedInstances(project, zone, instanceGroupManager)</a></code></p>
+  <code><a href="#listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -190,7 +190,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -253,13 +253,14 @@ <h3>Method Details</h3>
               "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
               "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
                 {
-                  "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+                  "healthCheck": "A String", # The URL for the health check that signals autohealing.
                   "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
                 },
               ],
               "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
               "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
               "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+              "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
               "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
               "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
                 "A String",
@@ -357,7 +358,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -425,7 +426,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -458,13 +459,14 @@ <h3>Method Details</h3>
       "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
       "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
         {
-          "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+          "healthCheck": "A String", # The URL for the health check that signals autohealing.
           "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
         },
       ],
       "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
       "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
       "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+      "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
       "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
       "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
         "A String",
@@ -513,13 +515,14 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
     "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
       {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
         "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
       },
     ],
     "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
     "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
     "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
     "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
       "A String",
@@ -587,7 +590,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -638,13 +641,14 @@ <h3>Method Details</h3>
           "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
           "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
             {
-              "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+              "healthCheck": "A String", # The URL for the health check that signals autohealing.
               "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
             },
           ],
           "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
           "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
           "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+          "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
           "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
           "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
             "A String",
@@ -672,13 +676,17 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="listManagedInstances">listManagedInstances(project, zone, instanceGroupManager)</code>
+    <code class="details" id="listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.
 
 Args:
   project: string, Project ID for this request. (required)
   zone: string, The name of the zone where the managed instance group is located. (required)
   instanceGroupManager: string, The name of the managed instance group. (required)
+  order_by: string, A parameter
+  maxResults: integer, A parameter
+  pageToken: string, A parameter
+  filter: string, A parameter
 
 Returns:
   An object of the form:
@@ -792,7 +800,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -852,7 +860,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -927,7 +935,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -945,7 +953,7 @@ <h3>Method Details</h3>
 {
     "autoHealingPolicies": [
       {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
         "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
       },
     ],
@@ -998,7 +1006,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1064,7 +1072,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1133,7 +1141,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.instanceGroups.html b/docs/dyn/compute_beta.instanceGroups.html
index a6040061af5..a2bcfaca97d 100644
--- a/docs/dyn/compute_beta.instanceGroups.html
+++ b/docs/dyn/compute_beta.instanceGroups.html
@@ -180,7 +180,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -328,7 +328,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -452,7 +452,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -666,7 +666,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -738,7 +738,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.instanceTemplates.html b/docs/dyn/compute_beta.instanceTemplates.html
index 1212738e854..98100197f60 100644
--- a/docs/dyn/compute_beta.instanceTemplates.html
+++ b/docs/dyn/compute_beta.instanceTemplates.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -219,7 +219,7 @@ <h3>Method Details</h3>
                   # - projects/project/zones/zone/diskTypes/diskType
                   # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
               "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-              "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                   #
                   # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                   #
@@ -236,6 +236,8 @@ <h3>Method Details</h3>
                   # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                   #
                   # global/images/family/my-private-family
+                  #
+                  # If the source image is deleted later, this field will not be set.
               "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
             },
             "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
@@ -247,7 +249,11 @@ <h3>Method Details</h3>
             "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
             "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
             "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                #
+                # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
           },
         ],
         "machineType": "A String", # The machine type to use for instances that are created from this template.
@@ -384,7 +390,7 @@ <h3>Method Details</h3>
                 # - projects/project/zones/zone/diskTypes/diskType
                 # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
             "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-            "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+            "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                 #
                 # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                 #
@@ -401,6 +407,8 @@ <h3>Method Details</h3>
                 # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                 #
                 # global/images/family/my-private-family
+                #
+                # If the source image is deleted later, this field will not be set.
             "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
           },
           "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
@@ -412,7 +420,11 @@ <h3>Method Details</h3>
           "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
           "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
           "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-          "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+          "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+              #
+              # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+              #
+              # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
         },
       ],
       "machineType": "A String", # The machine type to use for instances that are created from this template.
@@ -529,7 +541,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -619,7 +631,7 @@ <h3>Method Details</h3>
                       # - projects/project/zones/zone/diskTypes/diskType
                       # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
                   "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-                  "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                       #
                       # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                       #
@@ -636,6 +648,8 @@ <h3>Method Details</h3>
                       # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                       #
                       # global/images/family/my-private-family
+                      #
+                      # If the source image is deleted later, this field will not be set.
                   "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
                 },
                 "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
@@ -647,7 +661,11 @@ <h3>Method Details</h3>
                 "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
                 "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
                 "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                    #
+                    # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
               },
             ],
             "machineType": "A String", # The machine type to use for instances that are created from this template.
diff --git a/docs/dyn/compute_beta.instances.html b/docs/dyn/compute_beta.instances.html
index 9d6834e90e0..2b858322549 100644
--- a/docs/dyn/compute_beta.instances.html
+++ b/docs/dyn/compute_beta.instances.html
@@ -128,6 +128,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#setScheduling">setScheduling(project, zone, instance, body)</a></code></p>
 <p class="firstline">Sets an instance's scheduling options.</p>
+<p class="toc_element">
+  <code><a href="#setServiceAccount">setServiceAccount(project, zone, instance, body)</a></code></p>
+<p class="firstline">Sets the service account on the instance.</p>
 <p class="toc_element">
   <code><a href="#setTags">setTags(project, zone, instance, body)</a></code></p>
 <p class="firstline">Sets tags for the specified instance to the data included in the request.</p>
@@ -210,7 +213,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -317,7 +320,7 @@ <h3>Method Details</h3>
                       # - projects/project/zones/zone/diskTypes/diskType
                       # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
                   "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-                  "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                       #
                       # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                       #
@@ -334,6 +337,8 @@ <h3>Method Details</h3>
                       # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                       #
                       # global/images/family/my-private-family
+                      #
+                      # If the source image is deleted later, this field will not be set.
                   "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
                 },
                 "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
@@ -345,7 +350,11 @@ <h3>Method Details</h3>
                 "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
                 "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
                 "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                    #
+                    # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
               },
             ],
             "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
@@ -508,7 +517,7 @@ <h3>Method Details</h3>
         # - projects/project/zones/zone/diskTypes/diskType
         # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
     "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-    "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+    "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
         #
         # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
         #
@@ -525,6 +534,8 @@ <h3>Method Details</h3>
         # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
         #
         # global/images/family/my-private-family
+        #
+        # If the source image is deleted later, this field will not be set.
     "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
   },
   "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
@@ -536,7 +547,11 @@ <h3>Method Details</h3>
   "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
   "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
   "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-  "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+  "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+      # 
+      # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+      # 
+      # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
 }
 
 
@@ -586,7 +601,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -645,7 +660,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -706,7 +721,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -766,7 +781,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -854,7 +869,7 @@ <h3>Method Details</h3>
               # - projects/project/zones/zone/diskTypes/diskType
               # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
           "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-          "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
               #
               # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
               #
@@ -871,6 +886,8 @@ <h3>Method Details</h3>
               # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
               #
               # global/images/family/my-private-family
+              #
+              # If the source image is deleted later, this field will not be set.
           "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
         },
         "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
@@ -882,7 +899,11 @@ <h3>Method Details</h3>
         "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
         "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
         "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+            #
+            # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
       },
     ],
     "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
@@ -1057,7 +1078,7 @@ <h3>Method Details</h3>
             # - projects/project/zones/zone/diskTypes/diskType
             # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
         "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-        "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+        "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
             #
             # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
             #
@@ -1074,6 +1095,8 @@ <h3>Method Details</h3>
             # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
             #
             # global/images/family/my-private-family
+            #
+            # If the source image is deleted later, this field will not be set.
         "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
       },
       "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
@@ -1085,7 +1108,11 @@ <h3>Method Details</h3>
       "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
       "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
       "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+          #
+          # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+          #
+          # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
     },
   ],
   "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
@@ -1201,7 +1228,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1307,7 +1334,7 @@ <h3>Method Details</h3>
                   # - projects/project/zones/zone/diskTypes/diskType
                   # - zones/zone/diskTypes/diskType  Note that for InstanceTemplate, this is the name of the disk type, not URL.
               "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
-              "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                   #
                   # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                   #
@@ -1324,6 +1351,8 @@ <h3>Method Details</h3>
                   # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                   #
                   # global/images/family/my-private-family
+                  #
+                  # If the source image is deleted later, this field will not be set.
               "diskStorageType": "A String", # [Deprecated] Storage type of the disk.
             },
             "autoDelete": True or False, # Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
@@ -1335,7 +1364,11 @@ <h3>Method Details</h3>
             "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
             "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
             "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                #
+                # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
           },
         ],
         "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
@@ -1479,7 +1512,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1540,7 +1573,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1611,7 +1644,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1677,7 +1710,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1750,7 +1783,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1818,7 +1851,76 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="setServiceAccount">setServiceAccount(project, zone, instance, body)</code>
+  <pre>Sets the service account on the instance.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  instance: string, Name of the instance resource to start. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "scopes": [ # The list of scopes to be made available for this service account.
+      "A String",
+    ],
+    "email": "A String", # Email address of the service account.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1889,7 +1991,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1948,7 +2050,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2032,7 +2134,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -2091,7 +2193,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.machineTypes.html b/docs/dyn/compute_beta.machineTypes.html
index decdd48acc5..573ca473b8f 100644
--- a/docs/dyn/compute_beta.machineTypes.html
+++ b/docs/dyn/compute_beta.machineTypes.html
@@ -129,10 +129,10 @@ <h3>Method Details</h3>
             "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
             "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
             "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-              "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+              "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
               "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
               "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
             },
             "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
@@ -196,10 +196,10 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
     "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
@@ -249,10 +249,10 @@ <h3>Method Details</h3>
         "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
         "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
diff --git a/docs/dyn/compute_beta.networks.html b/docs/dyn/compute_beta.networks.html
index b04bd488e5a..419f3c88df6 100644
--- a/docs/dyn/compute_beta.networks.html
+++ b/docs/dyn/compute_beta.networks.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -256,7 +256,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -380,7 +380,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.projects.html b/docs/dyn/compute_beta.projects.html
index 4dda76f8fe9..11caddce8a7 100644
--- a/docs/dyn/compute_beta.projects.html
+++ b/docs/dyn/compute_beta.projects.html
@@ -77,6 +77,12 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#get">get(project)</a></code></p>
 <p class="firstline">Returns the specified Project resource.</p>
+<p class="toc_element">
+  <code><a href="#getXpnHost">getXpnHost(project)</a></code></p>
+<p class="firstline">Get the XPN host project that this project links to. May be empty if no link exists.</p>
+<p class="toc_element">
+  <code><a href="#listXpnHosts">listXpnHosts(project, body)</a></code></p>
+<p class="firstline">List all XPN host projects visible to the user in an organization.</p>
 <p class="toc_element">
   <code><a href="#moveDisk">moveDisk(project, body)</a></code></p>
 <p class="firstline">Moves a persistent disk from one zone to another.</p>
@@ -125,9 +131,55 @@ <h3>Method Details</h3>
     ],
     "name": "A String", # The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine.
     "usageExportLocation": { # The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix. # The naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored.
-        "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket.
-        "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.
+      "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket.
+      "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.
+    },
+    "xpnProjectStatus": "A String", # [Output Only] The role this project has in a Cross Project Network (XPN) configuration. Currently only HOST projects are differentiated.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server. This is not the project ID, and is just a unique ID used by Compute Engine to identify resources.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "description": "A String", # An optional textual description of the resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="getXpnHost">getXpnHost(project)</code>
+  <pre>Get the XPN host project that this project links to. May be empty if no link exists.
+
+Args:
+  project: string, Project ID for this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # A Project resource. Projects can only be created in the Google Cloud Platform Console. Unless marked otherwise, values can only be modified in the console.
+    "kind": "compute#project", # [Output Only] Type of the resource. Always compute#project for projects.
+    "defaultServiceAccount": "A String", # [Output Only] Default service account used by VMs running in this project.
+    "enabledFeatures": [ # Restricted features enabled for use on this project.
+      "A String",
+    ],
+    "commonInstanceMetadata": { # A metadata key/value entry. # Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information.
+      "items": [ # Array of key/value pairs. The total size of all keys and values must be less than 512 KB.
+        {
+          "value": "A String", # Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 32768 bytes.
+          "key": "A String", # Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project.
+        },
+      ],
+      "kind": "compute#metadata", # [Output Only] Type of the resource. Always compute#metadata for metadata.
+      "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata.
+    },
+    "quotas": [ # [Output Only] Quotas assigned to this project.
+      { # A quotas entry.
+        "usage": 3.14, # [Output Only] Current usage of this metric.
+        "metric": "A String", # [Output Only] Name of the quota metric.
+        "limit": 3.14, # [Output Only] Quota limit for this metric.
       },
+    ],
+    "name": "A String", # The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine.
+    "usageExportLocation": { # The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix. # The naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored.
+      "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket.
+      "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.
+    },
     "xpnProjectStatus": "A String", # [Output Only] The role this project has in a Cross Project Network (XPN) configuration. Currently only HOST projects are differentiated.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server. This is not the project ID, and is just a unique ID used by Compute Engine to identify resources.
@@ -136,6 +188,67 @@ <h3>Method Details</h3>
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="listXpnHosts">listXpnHosts(project, body)</code>
+  <pre>List all XPN host projects visible to the user in an organization.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "organization": "A String", # Optional organization ID managed by Cloud Resource Manager, for which to list XPN host projects. If not specified, the organization will be inferred from the project.
+  }
+
+
+Returns:
+  An object of the form:
+
+    {
+    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+    "items": [ # [Output Only] A list of XPN host project URLs.
+      { # A Project resource. Projects can only be created in the Google Cloud Platform Console. Unless marked otherwise, values can only be modified in the console.
+        "kind": "compute#project", # [Output Only] Type of the resource. Always compute#project for projects.
+        "defaultServiceAccount": "A String", # [Output Only] Default service account used by VMs running in this project.
+        "enabledFeatures": [ # Restricted features enabled for use on this project.
+          "A String",
+        ],
+        "commonInstanceMetadata": { # A metadata key/value entry. # Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information.
+          "items": [ # Array of key/value pairs. The total size of all keys and values must be less than 512 KB.
+            {
+              "value": "A String", # Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 32768 bytes.
+              "key": "A String", # Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project.
+            },
+          ],
+          "kind": "compute#metadata", # [Output Only] Type of the resource. Always compute#metadata for metadata.
+          "fingerprint": "A String", # Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata.
+        },
+        "quotas": [ # [Output Only] Quotas assigned to this project.
+          { # A quotas entry.
+            "usage": 3.14, # [Output Only] Current usage of this metric.
+            "metric": "A String", # [Output Only] Name of the quota metric.
+            "limit": 3.14, # [Output Only] Quota limit for this metric.
+          },
+        ],
+        "name": "A String", # The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine.
+        "usageExportLocation": { # The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix. # The naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored.
+          "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket.
+          "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.
+        },
+        "xpnProjectStatus": "A String", # [Output Only] The role this project has in a Cross Project Network (XPN) configuration. Currently only HOST projects are differentiated.
+        "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+        "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server. This is not the project ID, and is just a unique ID used by Compute Engine to identify resources.
+        "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+        "description": "A String", # An optional textual description of the resource.
+      },
+    ],
+    "kind": "compute#xpnHostList", # [Output Only] Type of resource. Always compute#xpnHostList for lists of XPN hosts.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="moveDisk">moveDisk(project, body)</code>
   <pre>Moves a persistent disk from one zone to another.
@@ -203,7 +316,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -274,7 +387,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -345,7 +458,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -359,9 +472,9 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix.
-    "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket.
-    "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.
-  }
+  "bucketName": "A String", # The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket.
+  "reportNamePrefix": "A String", # An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.
+}
 
 
 Returns:
@@ -410,7 +523,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.regionAutoscalers.html b/docs/dyn/compute_beta.regionAutoscalers.html
index 5f54f7e6682..25815e67540 100644
--- a/docs/dyn/compute_beta.regionAutoscalers.html
+++ b/docs/dyn/compute_beta.regionAutoscalers.html
@@ -154,7 +154,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -328,7 +328,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -540,7 +540,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -680,7 +680,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.regionBackendServices.html b/docs/dyn/compute_beta.regionBackendServices.html
index 042048957cf..c3ad5ee08b7 100644
--- a/docs/dyn/compute_beta.regionBackendServices.html
+++ b/docs/dyn/compute_beta.regionBackendServices.html
@@ -157,7 +157,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -193,6 +193,7 @@ <h3>Method Details</h3>
       "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
           #
           # When the load balancing scheme is INTERNAL, this field is not used.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
       "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
           #
           # This cannot be used for internal load balancing.
@@ -244,7 +245,12 @@ <h3>Method Details</h3>
           #
           # When the protocol is UDP, this field is not used.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+      "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+        "oauth2ClientId": "A String",
+        "enabled": True or False,
+        "oauth2ClientSecret": "A String",
+        "oauth2ClientSecretSha256": "A String",
+      },
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
       "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     }</pre>
@@ -312,6 +318,7 @@ <h3>Method Details</h3>
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
         # 
         # This cannot be used for internal load balancing.
@@ -363,7 +370,12 @@ <h3>Method Details</h3>
         # 
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+      "oauth2ClientId": "A String",
+      "enabled": True or False,
+      "oauth2ClientSecret": "A String",
+      "oauth2ClientSecretSha256": "A String",
+    },
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   }
@@ -415,7 +427,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -469,6 +481,7 @@ <h3>Method Details</h3>
           "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
               #
               # When the load balancing scheme is INTERNAL, this field is not used.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
           "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
               #
               # This cannot be used for internal load balancing.
@@ -520,7 +533,12 @@ <h3>Method Details</h3>
               #
               # When the protocol is UDP, this field is not used.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+          "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+            "oauth2ClientId": "A String",
+            "enabled": True or False,
+            "oauth2ClientSecret": "A String",
+            "oauth2ClientSecretSha256": "A String",
+          },
           "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
           "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
         },
@@ -576,6 +594,7 @@ <h3>Method Details</h3>
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
         # 
         # This cannot be used for internal load balancing.
@@ -627,7 +646,12 @@ <h3>Method Details</h3>
         # 
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+      "oauth2ClientId": "A String",
+      "enabled": True or False,
+      "oauth2ClientSecret": "A String",
+      "oauth2ClientSecretSha256": "A String",
+    },
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   }
@@ -679,7 +703,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -742,6 +766,7 @@ <h3>Method Details</h3>
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
         # 
         # This cannot be used for internal load balancing.
@@ -793,7 +818,12 @@ <h3>Method Details</h3>
         # 
         # When the protocol is UDP, this field is not used.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
-    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "iap": { # Identity-Aware Proxy (Cloud Gatekeeper)
+      "oauth2ClientId": "A String",
+      "enabled": True or False,
+      "oauth2ClientSecret": "A String",
+      "oauth2ClientSecretSha256": "A String",
+    },
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   }
@@ -845,7 +875,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.regionInstanceGroupManagers.html b/docs/dyn/compute_beta.regionInstanceGroupManagers.html
index d481d29f61e..d2f56b60075 100644
--- a/docs/dyn/compute_beta.regionInstanceGroupManagers.html
+++ b/docs/dyn/compute_beta.regionInstanceGroupManagers.html
@@ -93,7 +93,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Retrieves the list of managed instance groups that are contained within the specified region.</p>
 <p class="toc_element">
-  <code><a href="#listManagedInstances">listManagedInstances(project, region, instanceGroupManager)</a></code></p>
+  <code><a href="#listManagedInstances">listManagedInstances(project, region, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -187,7 +187,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -246,7 +246,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -314,7 +314,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -347,13 +347,14 @@ <h3>Method Details</h3>
       "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
       "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
         {
-          "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+          "healthCheck": "A String", # The URL for the health check that signals autohealing.
           "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
         },
       ],
       "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
       "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
       "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+      "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
       "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
       "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
         "A String",
@@ -402,13 +403,14 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
     "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
       {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
         "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
       },
     ],
     "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
     "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
     "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
     "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
       "A String",
@@ -476,7 +478,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -527,13 +529,14 @@ <h3>Method Details</h3>
           "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
           "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
             {
-              "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+              "healthCheck": "A String", # The URL for the health check that signals autohealing.
               "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
             },
           ],
           "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
           "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
           "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+          "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
           "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
           "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
             "A String",
@@ -561,13 +564,17 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="listManagedInstances">listManagedInstances(project, region, instanceGroupManager)</code>
+    <code class="details" id="listManagedInstances">listManagedInstances(project, region, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances.
 
 Args:
   project: string, Project ID for this request. (required)
   region: string, Name of the region scoping this request. (required)
   instanceGroupManager: string, The name of the managed instance group. (required)
+  order_by: string, A parameter
+  maxResults: integer, A parameter
+  pageToken: string, A parameter
+  filter: string, A parameter
 
 Returns:
   An object of the form:
@@ -645,13 +652,14 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
     "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
       {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
         "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
       },
     ],
     "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
     "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
     "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
     "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
       "A String",
@@ -719,7 +727,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -787,7 +795,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -847,7 +855,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -865,7 +873,7 @@ <h3>Method Details</h3>
 {
     "autoHealingPolicies": [
       {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
         "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
       },
     ],
@@ -918,7 +926,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -984,7 +992,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1053,7 +1061,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1113,13 +1121,14 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
     "autoHealingPolicies": [ # The autohealing policy for this managed instance group. You can specify only one value.
       {
-        "healthCheck": "A String", # The URL for the HealthCheck that signals autohealing.
+        "healthCheck": "A String", # The URL for the health check that signals autohealing.
         "initialDelaySec": 42, # The number of seconds that the managed instance group waits before it applies autohealing policies to new instances or recently recreated instances. This initial delay allows instances to initialize and run their startup scripts before the instance group determines that they are UNHEALTHY. This prevents the managed instance group from recreating its instances prematurely. This value must be from range [0, 3600].
       },
     ],
     "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
     "failoverAction": "A String", # The action to perform in case of zone failure. Only one value is supported, NO_FAILOVER. The default is NO_FAILOVER.
     "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "serviceAccount": "A String", # Service account will be used as credentials for all operations performed by managed instance group on instances. The service accounts needs all permissions required to create and delete instances. When not specified, the service account {projectNumber}@cloudservices.gserviceaccount.com will be used.
     "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
     "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
       "A String",
@@ -1187,7 +1196,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.regionInstanceGroups.html b/docs/dyn/compute_beta.regionInstanceGroups.html
index 6710238e357..bee2fa46487 100644
--- a/docs/dyn/compute_beta.regionInstanceGroups.html
+++ b/docs/dyn/compute_beta.regionInstanceGroups.html
@@ -347,7 +347,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.regionOperations.html b/docs/dyn/compute_beta.regionOperations.html
index d63320d2aa3..c5c5eb50fb7 100644
--- a/docs/dyn/compute_beta.regionOperations.html
+++ b/docs/dyn/compute_beta.regionOperations.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_beta.regions.html b/docs/dyn/compute_beta.regions.html
index a64166b8922..f4021c0daef 100644
--- a/docs/dyn/compute_beta.regions.html
+++ b/docs/dyn/compute_beta.regions.html
@@ -100,10 +100,10 @@ <h3>Method Details</h3>
     "kind": "compute#region", # [Output Only] Type of the resource. Always compute#region for regions.
     "description": "A String", # [Output Only] Textual description of the resource.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this region.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "quotas": [ # [Output Only] Quotas assigned to this region.
@@ -157,10 +157,10 @@ <h3>Method Details</h3>
         "kind": "compute#region", # [Output Only] Type of the resource. Always compute#region for regions.
         "description": "A String", # [Output Only] Textual description of the resource.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this region.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "quotas": [ # [Output Only] Quotas assigned to this region.
diff --git a/docs/dyn/compute_beta.routers.html b/docs/dyn/compute_beta.routers.html
index 67e9b94ccad..487170dd2f3 100644
--- a/docs/dyn/compute_beta.routers.html
+++ b/docs/dyn/compute_beta.routers.html
@@ -261,7 +261,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -508,7 +508,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -682,7 +682,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -883,7 +883,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.routes.html b/docs/dyn/compute_beta.routes.html
index 716a9c310e3..df705548f86 100644
--- a/docs/dyn/compute_beta.routes.html
+++ b/docs/dyn/compute_beta.routes.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -295,7 +295,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.snapshots.html b/docs/dyn/compute_beta.snapshots.html
index 939724b4753..f3e7e7b5d98 100644
--- a/docs/dyn/compute_beta.snapshots.html
+++ b/docs/dyn/compute_beta.snapshots.html
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -378,7 +378,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.sslCertificates.html b/docs/dyn/compute_beta.sslCertificates.html
index 8802b043d2c..3fe340f56f8 100644
--- a/docs/dyn/compute_beta.sslCertificates.html
+++ b/docs/dyn/compute_beta.sslCertificates.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -166,7 +166,7 @@ <h3>Method Details</h3>
       "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
       "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
       "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-      "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+      "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
       "selfLink": "A String", # [Output only] Server-defined URL for the resource.
@@ -187,7 +187,7 @@ <h3>Method Details</h3>
     "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-    "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+    "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "selfLink": "A String", # [Output only] Server-defined URL for the resource.
@@ -241,7 +241,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -278,7 +278,7 @@ <h3>Method Details</h3>
           "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
           "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
           "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-          "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+          "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
           "selfLink": "A String", # [Output only] Server-defined URL for the resource.
diff --git a/docs/dyn/compute_beta.subnetworks.html b/docs/dyn/compute_beta.subnetworks.html
index 8190ee37d8f..cf8e71ba418 100644
--- a/docs/dyn/compute_beta.subnetworks.html
+++ b/docs/dyn/compute_beta.subnetworks.html
@@ -89,6 +89,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#get">get(project, region, subnetwork)</a></code></p>
 <p class="firstline">Returns the specified subnetwork. Get a list of available subnetworks list() request.</p>
+<p class="toc_element">
+  <code><a href="#getIamPolicy">getIamPolicy(project, region, resource)</a></code></p>
+<p class="firstline">Gets the access control policy for a resource. May be empty if no such policy or resource exists.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(project, region, body)</a></code></p>
 <p class="firstline">Creates a subnetwork in the specified project using the data included in the request.</p>
@@ -98,6 +101,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#setIamPolicy">setIamPolicy(project, region, resource, body)</a></code></p>
+<p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy.</p>
 <p class="toc_element">
   <code><a href="#testIamPermissions">testIamPermissions(project, region, resource, body)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
@@ -234,7 +240,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -300,7 +306,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -330,6 +336,112 @@ <h3>Method Details</h3>
     }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="getIamPolicy">getIamPolicy(project, region, resource)</code>
+  <pre>Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  resource: string, Name of the resource for this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.
+      #
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM.
+      #
+      # **Example**
+      #
+      # { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] }
+      #
+      # For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
+    "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
+        #
+        # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
+        "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
+          "A String",
+        ],
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
+      { # A rule to be applied in a Policy.
+        "logConfigs": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries that match the LOG action.
+          { # Specifies what kind of log the caller must write
+            "counter": { # Options for counters # Counter options.
+              "field": "A String", # The field value to attribute.
+              "metric": "A String", # The metric to update.
+            },
+          },
+        ],
+        "notIns": [ # If one or more 'not_in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
+          "A String",
+        ],
+        "ins": [ # If one or more 'in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
+          "A String",
+        ],
+        "action": "A String", # Required
+        "permissions": [ # A permission is a string of form '..' (e.g., 'storage.buckets.list'). A value of '*' matches all permissions, and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
+          "A String",
+        ],
+        "conditions": [ # Additional restrictions that must be met
+          { # A condition to be met.
+            "iam": "A String", # Trusted attributes supplied by the IAM system.
+            "svc": "A String", # Trusted attributes discharged by the service.
+            "value": "A String", # DEPRECATED. Use 'values' instead.
+            "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses the IAM system for access control.
+            "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
+              "A String",
+            ],
+            "op": "A String", # An operator to apply the subject with.
+          },
+        ],
+        "description": "A String", # Human-readable description of the rule.
+      },
+    ],
+    "version": 42, # Version of the `Policy`. The default version is 0.
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
+    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+      { # Associates `members` with a `role`.
+        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "A String",
+        ],
+      },
+    ],
+    "iamOwned": True or False,
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="insert">insert(project, region, body)</code>
   <pre>Creates a subnetwork in the specified project using the data included in the request.
@@ -400,7 +512,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -467,6 +579,208 @@ <h3>Method Details</h3>
     </pre>
 </div>
 
+<div class="method">
+    <code class="details" id="setIamPolicy">setIamPolicy(project, region, resource, body)</code>
+  <pre>Sets the access control policy on the specified resource. Replaces any existing policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  resource: string, Name of the resource for this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.
+    # 
+    # 
+    # 
+    # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM.
+    # 
+    # **Example**
+    # 
+    # { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] }
+    # 
+    # For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
+  "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
+      # 
+      # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
+    { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
+      "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
+        "A String",
+      ],
+      "auditLogConfigs": [ # The configuration for each type of logging
+        { # Provides the configuration for a sub-type of logging.
+          "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
+    { # A rule to be applied in a Policy.
+      "logConfigs": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries that match the LOG action.
+        { # Specifies what kind of log the caller must write
+          "counter": { # Options for counters # Counter options.
+            "field": "A String", # The field value to attribute.
+            "metric": "A String", # The metric to update.
+          },
+        },
+      ],
+      "notIns": [ # If one or more 'not_in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
+        "A String",
+      ],
+      "ins": [ # If one or more 'in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
+        "A String",
+      ],
+      "action": "A String", # Required
+      "permissions": [ # A permission is a string of form '..' (e.g., 'storage.buckets.list'). A value of '*' matches all permissions, and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
+        "A String",
+      ],
+      "conditions": [ # Additional restrictions that must be met
+        { # A condition to be met.
+          "iam": "A String", # Trusted attributes supplied by the IAM system.
+          "svc": "A String", # Trusted attributes discharged by the service.
+          "value": "A String", # DEPRECATED. Use 'values' instead.
+          "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses the IAM system for access control.
+          "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
+            "A String",
+          ],
+          "op": "A String", # An operator to apply the subject with.
+        },
+      ],
+      "description": "A String", # Human-readable description of the rule.
+    },
+  ],
+  "version": 42, # Version of the `Policy`. The default version is 0.
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy.
+      # 
+      # If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
+  "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Associates `members` with a `role`.
+      "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+      "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values:
+          #
+          # * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account.
+          #
+          # * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account.
+          #
+          # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
+          #
+          #
+          #
+          # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
+          #
+          # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
+          #
+          # * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "A String",
+      ],
+    },
+  ],
+  "iamOwned": True or False,
+}
+
+
+Returns:
+  An object of the form:
+
+    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.
+      #
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM.
+      #
+      # **Example**
+      #
+      # { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] }
+      #
+      # For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
+    "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
+        #
+        # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
+        "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
+          "A String",
+        ],
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
+      { # A rule to be applied in a Policy.
+        "logConfigs": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries that match the LOG action.
+          { # Specifies what kind of log the caller must write
+            "counter": { # Options for counters # Counter options.
+              "field": "A String", # The field value to attribute.
+              "metric": "A String", # The metric to update.
+            },
+          },
+        ],
+        "notIns": [ # If one or more 'not_in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
+          "A String",
+        ],
+        "ins": [ # If one or more 'in' clauses are specified, the rule matches if the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
+          "A String",
+        ],
+        "action": "A String", # Required
+        "permissions": [ # A permission is a string of form '..' (e.g., 'storage.buckets.list'). A value of '*' matches all permissions, and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
+          "A String",
+        ],
+        "conditions": [ # Additional restrictions that must be met
+          { # A condition to be met.
+            "iam": "A String", # Trusted attributes supplied by the IAM system.
+            "svc": "A String", # Trusted attributes discharged by the service.
+            "value": "A String", # DEPRECATED. Use 'values' instead.
+            "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses the IAM system for access control.
+            "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
+              "A String",
+            ],
+            "op": "A String", # An operator to apply the subject with.
+          },
+        ],
+        "description": "A String", # Human-readable description of the rule.
+      },
+    ],
+    "version": 42, # Version of the `Policy`. The default version is 0.
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
+    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+      { # Associates `members` with a `role`.
+        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "A String",
+        ],
+      },
+    ],
+    "iamOwned": True or False,
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="testIamPermissions">testIamPermissions(project, region, resource, body)</code>
   <pre>Returns permissions that a caller has on the specified resource.
diff --git a/docs/dyn/compute_beta.targetHttpProxies.html b/docs/dyn/compute_beta.targetHttpProxies.html
index 5afb30da132..8198d371c99 100644
--- a/docs/dyn/compute_beta.targetHttpProxies.html
+++ b/docs/dyn/compute_beta.targetHttpProxies.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -242,7 +242,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -366,7 +366,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.targetHttpsProxies.html b/docs/dyn/compute_beta.targetHttpsProxies.html
index 0a10a212563..e4499637977 100644
--- a/docs/dyn/compute_beta.targetHttpsProxies.html
+++ b/docs/dyn/compute_beta.targetHttpsProxies.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -257,7 +257,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -389,7 +389,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -454,7 +454,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.targetInstances.html b/docs/dyn/compute_beta.targetInstances.html
index ebf0ab15621..b444c55e21a 100644
--- a/docs/dyn/compute_beta.targetInstances.html
+++ b/docs/dyn/compute_beta.targetInstances.html
@@ -233,7 +233,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -337,7 +337,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.targetPools.html b/docs/dyn/compute_beta.targetPools.html
index 600684f1086..5d4d2a1a465 100644
--- a/docs/dyn/compute_beta.targetPools.html
+++ b/docs/dyn/compute_beta.targetPools.html
@@ -186,7 +186,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -259,7 +259,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -412,7 +412,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -578,7 +578,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -734,7 +734,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -804,7 +804,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -871,7 +871,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.targetSslProxies.html b/docs/dyn/compute_beta.targetSslProxies.html
index a6b272440f8..c44d4ee0a0d 100644
--- a/docs/dyn/compute_beta.targetSslProxies.html
+++ b/docs/dyn/compute_beta.targetSslProxies.html
@@ -156,7 +156,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -256,7 +256,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -384,7 +384,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -449,7 +449,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -516,7 +516,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.targetVpnGateways.html b/docs/dyn/compute_beta.targetVpnGateways.html
index b883dcc8d36..9cbcf15afb9 100644
--- a/docs/dyn/compute_beta.targetVpnGateways.html
+++ b/docs/dyn/compute_beta.targetVpnGateways.html
@@ -236,7 +236,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -346,7 +346,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.urlMaps.html b/docs/dyn/compute_beta.urlMaps.html
index bfa777b10b3..4ca0cb4b7f1 100644
--- a/docs/dyn/compute_beta.urlMaps.html
+++ b/docs/dyn/compute_beta.urlMaps.html
@@ -159,7 +159,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -323,7 +323,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -339,6 +339,7 @@ <h3>Method Details</h3>
 
 {
     "path": "A String",
+    "host": "A String", # If set, this invalidation rule will only apply to requests with a Host header matching host.
   }
 
 
@@ -388,7 +389,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -590,7 +591,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -724,7 +725,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.vpnTunnels.html b/docs/dyn/compute_beta.vpnTunnels.html
index aca6af1cf18..beae6b98856 100644
--- a/docs/dyn/compute_beta.vpnTunnels.html
+++ b/docs/dyn/compute_beta.vpnTunnels.html
@@ -242,7 +242,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -364,7 +364,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_beta.zoneOperations.html b/docs/dyn/compute_beta.zoneOperations.html
index f049ccb28ca..7de36ce8708 100644
--- a/docs/dyn/compute_beta.zoneOperations.html
+++ b/docs/dyn/compute_beta.zoneOperations.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_beta.zones.html b/docs/dyn/compute_beta.zones.html
index 7e1e3593232..a3eedd12082 100644
--- a/docs/dyn/compute_beta.zones.html
+++ b/docs/dyn/compute_beta.zones.html
@@ -100,10 +100,10 @@ <h3>Method Details</h3>
     "kind": "compute#zone", # [Output Only] Type of the resource. Always compute#zone for zones.
     "description": "A String", # [Output Only] Textual description of the resource.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
@@ -148,10 +148,10 @@ <h3>Method Details</h3>
         "kind": "compute#zone", # [Output Only] Type of the resource. Always compute#zone for zones.
         "description": "A String", # [Output Only] Textual description of the resource.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
diff --git a/docs/dyn/compute_v1.addresses.html b/docs/dyn/compute_v1.addresses.html
index ec6feb6b78a..21b9c76ae1e 100644
--- a/docs/dyn/compute_v1.addresses.html
+++ b/docs/dyn/compute_v1.addresses.html
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -334,7 +334,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.autoscalers.html b/docs/dyn/compute_v1.autoscalers.html
index 81f36dd61bd..d552a2fedfe 100644
--- a/docs/dyn/compute_v1.autoscalers.html
+++ b/docs/dyn/compute_v1.autoscalers.html
@@ -264,7 +264,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -424,7 +424,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -622,7 +622,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -727,7 +727,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.backendServices.html b/docs/dyn/compute_v1.backendServices.html
index dc04bc5dea6..91d93dbc314 100644
--- a/docs/dyn/compute_v1.backendServices.html
+++ b/docs/dyn/compute_v1.backendServices.html
@@ -74,6 +74,12 @@
 
 <h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.backendServices.html">backendServices</a></h1>
 <h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#aggregatedList">aggregatedList(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves the list of all BackendService resources, regional and global, available to the specified project.</p>
+<p class="toc_element">
+  <code><a href="#aggregatedList_next">aggregatedList_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(project, backendService)</a></code></p>
 <p class="firstline">Deletes the specified BackendService resource.</p>
@@ -99,6 +105,146 @@ <h2>Instance Methods</h2>
   <code><a href="#update">update(project, backendService, body)</a></code></p>
 <p class="firstline">Updates the specified BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read  Restrictions and Guidelines for more information.</p>
 <h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="aggregatedList">aggregatedList(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves the list of all BackendService resources, regional and global, available to the specified project.
+
+Args:
+  project: string, Name of the project scoping this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of BackendServicesScopedList.
+    "nextPageToken": "A String", # [Output Only] A token used to continue a truncated list request.
+    "items": { # A map of scoped BackendService lists.
+      "a_key": { # Name of the scope containing this set of BackendServices.
+        "warning": { # Informational warning which replaces the list of backend services when the list is empty.
+          "message": "A String", # [Output Only] A human-readable description of the warning code.
+          "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+          "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+              # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+            {
+              "value": "A String", # [Output Only] A warning data value corresponding to the key.
+              "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+            },
+          ],
+        },
+        "backendServices": [ # List of BackendServices contained in this scope.
+          { # A BackendService resource. This resource defines a group of backend virtual machines and their serving capacity.
+              "connectionDraining": { # Message containing connection draining configuration.
+                "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
+              },
+              "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
+              "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+                  #
+                  # Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. The default is HTTP.
+                  #
+                  # For internal load balancing, the possible values are TCP and UDP, and the default is TCP.
+              "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+              "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+              "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
+                  #
+                  # When the load balancing scheme is INTERNAL, this field is not used.
+              "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+              "loadBalancingScheme": "A String",
+              "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
+                  #
+                  # When the load balancing scheme is INTERNAL, this field is not used.
+              "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
+                  #
+                  # This cannot be used for internal load balancing.
+              "backends": [ # The list of backends that serve this BackendService.
+                { # Message containing information of one individual backend.
+                  "group": "A String", # The fully-qualified URL of a zonal Instance Group resource. This instance group defines the list of instances that serve traffic. Member virtual machine instances from each instance group must live in the same zone as the instance group itself. No two backends in a backend service are allowed to use same Instance Group resource.
+                      #
+                      # Note that you must specify an Instance Group resource using the fully-qualified URL, rather than a partial URL.
+                      #
+                      # When the BackendService has load balancing scheme INTERNAL, the instance group must be in a zone within the same region as the BackendService.
+                  "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+                  "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
+                      #
+                      # This cannot be used for internal load balancing.
+                  "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+                      #
+                      # This cannot be used for internal load balancing.
+                  "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+                      #
+                      # This cannot be used for internal load balancing.
+                  "capacityScaler": 3.14, # A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group will serve up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available Capacity. Valid range is [0.0,1.0].
+                      #
+                      # This cannot be used for internal load balancing.
+                  "maxRate": 42, # The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+                      #
+                      # This cannot be used for internal load balancing.
+                  "maxConnections": 42, # The max number of simultaneous connections for the group. Can be used with either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+                      #
+                      # This cannot be used for internal load balancing.
+                  "balancingMode": "A String", # Specifies the balancing mode for this backend. For global HTTP(S) or TCP/SSL load balancing, the default is UTILIZATION. Valid values are UTILIZATION, RATE (for HTTP(S)) and CONNECTION (for TCP/SSL).
+                      #
+                      # This cannot be used for internal load balancing.
+                },
+              ],
+              "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
+              "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
+                  #
+                  # When the load balancing scheme is INTERNAL, this field is not used.
+              "healthChecks": [ # The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService. Currently at most one health check can be specified, and a health check is required.
+                  #
+                  # For internal load balancing, a URL to a HealthCheck resource must be specified instead.
+                "A String",
+              ],
+              "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+                  #
+                  # When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP, or GENERATED_COOKIE.
+                  #
+                  # When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.
+                  #
+                  # When the protocol is UDP, this field is not used.
+              "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+              "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+              "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+              "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+            },
+        ],
+      },
+    },
+    "kind": "compute#backendServiceAggregatedList", # Type of resource.
+    "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="aggregatedList_next">aggregatedList_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
 <div class="method">
     <code class="details" id="delete">delete(project, backendService)</code>
   <pre>Deletes the specified BackendService resource.
@@ -153,7 +299,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -184,6 +330,7 @@ <h3>Method Details</h3>
           #
           # When the load balancing scheme is INTERNAL, this field is not used.
       "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+      "loadBalancingScheme": "A String",
       "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
           #
           # When the load balancing scheme is INTERNAL, this field is not used.
@@ -300,6 +447,7 @@ <h3>Method Details</h3>
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "loadBalancingScheme": "A String",
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -406,7 +554,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -455,6 +603,7 @@ <h3>Method Details</h3>
               #
               # When the load balancing scheme is INTERNAL, this field is not used.
           "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+          "loadBalancingScheme": "A String",
           "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
               #
               # When the load balancing scheme is INTERNAL, this field is not used.
@@ -560,6 +709,7 @@ <h3>Method Details</h3>
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "loadBalancingScheme": "A String",
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -666,7 +816,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -696,6 +846,7 @@ <h3>Method Details</h3>
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
     "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "loadBalancingScheme": "A String",
     "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
         # 
         # When the load balancing scheme is INTERNAL, this field is not used.
@@ -802,7 +953,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.diskTypes.html b/docs/dyn/compute_v1.diskTypes.html
index 0cdac34f926..a5aeed436d7 100644
--- a/docs/dyn/compute_v1.diskTypes.html
+++ b/docs/dyn/compute_v1.diskTypes.html
@@ -138,10 +138,10 @@ <h3>Method Details</h3>
             "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
             "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
             "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-              "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+              "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
               "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
               "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
             },
             "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
@@ -191,10 +191,10 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
     "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
@@ -241,10 +241,10 @@ <h3>Method Details</h3>
         "zone": "A String", # [Output Only] URL of the zone where the disk type resides.
         "validDiskSize": "A String", # [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB".
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "defaultDiskSizeGb": "A String", # [Output Only] Server-defined default disk size in GB.
diff --git a/docs/dyn/compute_v1.disks.html b/docs/dyn/compute_v1.disks.html
index c431128ff52..c3eeade64e6 100644
--- a/docs/dyn/compute_v1.disks.html
+++ b/docs/dyn/compute_v1.disks.html
@@ -321,7 +321,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -380,7 +380,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -585,7 +585,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -766,7 +766,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.firewalls.html b/docs/dyn/compute_v1.firewalls.html
index ae9b0d1b319..219dd84410f 100644
--- a/docs/dyn/compute_v1.firewalls.html
+++ b/docs/dyn/compute_v1.firewalls.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -290,7 +290,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -468,7 +468,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -563,7 +563,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.forwardingRules.html b/docs/dyn/compute_v1.forwardingRules.html
index 0302baf2d1f..d82fd34be2d 100644
--- a/docs/dyn/compute_v1.forwardingRules.html
+++ b/docs/dyn/compute_v1.forwardingRules.html
@@ -139,15 +139,34 @@ <h3>Method Details</h3>
                   #
                   # When the load balancing scheme is INTERNAL, this can only be an RFC 1918 IP address belonging to the network/subnetwork configured for the forwarding rule. A reserved address cannot be used. If the field is empty, the IP address will be automatically allocated from the internal IP range of the subnetwork or network configured for this forwarding rule.
               "region": "A String", # [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules.
+              "ports": [ # This field is not used for external load balancing.
+                  #
+                  # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
+                  #
+                  # You may specify a maximum of up to 5 ports.
+                "A String",
+              ],
+              "network": "A String", # This field is not used for external load balancing.
+                  #
+                  # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
+              "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
               "target": "A String", # The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must live in the same region as the forwarding rule. For global forwarding rules, this target must be a global TargetHttpProxy or TargetHttpsProxy resource. The forwarded traffic must be of a type appropriate to the target object. For example, TargetHttpProxy requires HTTP traffic, and TargetHttpsProxy requires HTTPS traffic.
                   #
                   # This field is not used for internal load balancing.
               "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
                   #
                   # This field is not used for internal load balancing.
+              "backendService": "A String", # This field is not used for external load balancing.
+                  #
+                  # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
               "IPProtocol": "A String", # The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, AH, SCTP or ICMP.
                   #
                   # When the load balancing scheme is INTERNAL</code, only TCP and UDP are valid.
+              "subnetwork": "A String", # This field is not used for external load balancing.
+                  #
+                  # For internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.
+                  #
+                  # If the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified.
               "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
               "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
               "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
@@ -242,7 +261,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -267,15 +286,34 @@ <h3>Method Details</h3>
           #
           # When the load balancing scheme is INTERNAL, this can only be an RFC 1918 IP address belonging to the network/subnetwork configured for the forwarding rule. A reserved address cannot be used. If the field is empty, the IP address will be automatically allocated from the internal IP range of the subnetwork or network configured for this forwarding rule.
       "region": "A String", # [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules.
+      "ports": [ # This field is not used for external load balancing.
+          #
+          # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
+          #
+          # You may specify a maximum of up to 5 ports.
+        "A String",
+      ],
+      "network": "A String", # This field is not used for external load balancing.
+          #
+          # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
+      "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
       "target": "A String", # The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must live in the same region as the forwarding rule. For global forwarding rules, this target must be a global TargetHttpProxy or TargetHttpsProxy resource. The forwarded traffic must be of a type appropriate to the target object. For example, TargetHttpProxy requires HTTP traffic, and TargetHttpsProxy requires HTTPS traffic.
           #
           # This field is not used for internal load balancing.
       "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
           #
           # This field is not used for internal load balancing.
+      "backendService": "A String", # This field is not used for external load balancing.
+          #
+          # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
       "IPProtocol": "A String", # The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, AH, SCTP or ICMP.
           #
           # When the load balancing scheme is INTERNAL</code, only TCP and UDP are valid.
+      "subnetwork": "A String", # This field is not used for external load balancing.
+          #
+          # For internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.
+          #
+          # If the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
@@ -302,15 +340,34 @@ <h3>Method Details</h3>
         # 
         # When the load balancing scheme is INTERNAL, this can only be an RFC 1918 IP address belonging to the network/subnetwork configured for the forwarding rule. A reserved address cannot be used. If the field is empty, the IP address will be automatically allocated from the internal IP range of the subnetwork or network configured for this forwarding rule.
     "region": "A String", # [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules.
+    "ports": [ # This field is not used for external load balancing.
+        # 
+        # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
+        # 
+        # You may specify a maximum of up to 5 ports.
+      "A String",
+    ],
+    "network": "A String", # This field is not used for external load balancing.
+        # 
+        # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
+    "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
     "target": "A String", # The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must live in the same region as the forwarding rule. For global forwarding rules, this target must be a global TargetHttpProxy or TargetHttpsProxy resource. The forwarded traffic must be of a type appropriate to the target object. For example, TargetHttpProxy requires HTTP traffic, and TargetHttpsProxy requires HTTPS traffic.
         # 
         # This field is not used for internal load balancing.
     "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
         # 
         # This field is not used for internal load balancing.
+    "backendService": "A String", # This field is not used for external load balancing.
+        # 
+        # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
     "IPProtocol": "A String", # The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, AH, SCTP or ICMP.
         # 
         # When the load balancing scheme is INTERNAL</code, only TCP and UDP are valid.
+    "subnetwork": "A String", # This field is not used for external load balancing.
+        # 
+        # For internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.
+        # 
+        # If the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
@@ -364,7 +421,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -407,15 +464,34 @@ <h3>Method Details</h3>
               #
               # When the load balancing scheme is INTERNAL, this can only be an RFC 1918 IP address belonging to the network/subnetwork configured for the forwarding rule. A reserved address cannot be used. If the field is empty, the IP address will be automatically allocated from the internal IP range of the subnetwork or network configured for this forwarding rule.
           "region": "A String", # [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules.
+          "ports": [ # This field is not used for external load balancing.
+              #
+              # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
+              #
+              # You may specify a maximum of up to 5 ports.
+            "A String",
+          ],
+          "network": "A String", # This field is not used for external load balancing.
+              #
+              # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
+          "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
           "target": "A String", # The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must live in the same region as the forwarding rule. For global forwarding rules, this target must be a global TargetHttpProxy or TargetHttpsProxy resource. The forwarded traffic must be of a type appropriate to the target object. For example, TargetHttpProxy requires HTTP traffic, and TargetHttpsProxy requires HTTPS traffic.
               #
               # This field is not used for internal load balancing.
           "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
               #
               # This field is not used for internal load balancing.
+          "backendService": "A String", # This field is not used for external load balancing.
+              #
+              # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
           "IPProtocol": "A String", # The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, AH, SCTP or ICMP.
               #
               # When the load balancing scheme is INTERNAL</code, only TCP and UDP are valid.
+          "subnetwork": "A String", # This field is not used for external load balancing.
+              #
+              # For internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.
+              #
+              # If the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
           "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
@@ -504,7 +580,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.globalAddresses.html b/docs/dyn/compute_v1.globalAddresses.html
index 77b4128d86e..7c89c24df5a 100644
--- a/docs/dyn/compute_v1.globalAddresses.html
+++ b/docs/dyn/compute_v1.globalAddresses.html
@@ -144,7 +144,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -246,7 +246,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.globalForwardingRules.html b/docs/dyn/compute_v1.globalForwardingRules.html
index 377a561a035..48f2db3993b 100644
--- a/docs/dyn/compute_v1.globalForwardingRules.html
+++ b/docs/dyn/compute_v1.globalForwardingRules.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -171,15 +171,34 @@ <h3>Method Details</h3>
           #
           # When the load balancing scheme is INTERNAL, this can only be an RFC 1918 IP address belonging to the network/subnetwork configured for the forwarding rule. A reserved address cannot be used. If the field is empty, the IP address will be automatically allocated from the internal IP range of the subnetwork or network configured for this forwarding rule.
       "region": "A String", # [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules.
+      "ports": [ # This field is not used for external load balancing.
+          #
+          # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
+          #
+          # You may specify a maximum of up to 5 ports.
+        "A String",
+      ],
+      "network": "A String", # This field is not used for external load balancing.
+          #
+          # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
+      "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
       "target": "A String", # The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must live in the same region as the forwarding rule. For global forwarding rules, this target must be a global TargetHttpProxy or TargetHttpsProxy resource. The forwarded traffic must be of a type appropriate to the target object. For example, TargetHttpProxy requires HTTP traffic, and TargetHttpsProxy requires HTTPS traffic.
           #
           # This field is not used for internal load balancing.
       "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
           #
           # This field is not used for internal load balancing.
+      "backendService": "A String", # This field is not used for external load balancing.
+          #
+          # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
       "IPProtocol": "A String", # The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, AH, SCTP or ICMP.
           #
           # When the load balancing scheme is INTERNAL</code, only TCP and UDP are valid.
+      "subnetwork": "A String", # This field is not used for external load balancing.
+          #
+          # For internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.
+          #
+          # If the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
@@ -205,15 +224,34 @@ <h3>Method Details</h3>
         # 
         # When the load balancing scheme is INTERNAL, this can only be an RFC 1918 IP address belonging to the network/subnetwork configured for the forwarding rule. A reserved address cannot be used. If the field is empty, the IP address will be automatically allocated from the internal IP range of the subnetwork or network configured for this forwarding rule.
     "region": "A String", # [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules.
+    "ports": [ # This field is not used for external load balancing.
+        # 
+        # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
+        # 
+        # You may specify a maximum of up to 5 ports.
+      "A String",
+    ],
+    "network": "A String", # This field is not used for external load balancing.
+        # 
+        # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
+    "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
     "target": "A String", # The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must live in the same region as the forwarding rule. For global forwarding rules, this target must be a global TargetHttpProxy or TargetHttpsProxy resource. The forwarded traffic must be of a type appropriate to the target object. For example, TargetHttpProxy requires HTTP traffic, and TargetHttpsProxy requires HTTPS traffic.
         # 
         # This field is not used for internal load balancing.
     "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
         # 
         # This field is not used for internal load balancing.
+    "backendService": "A String", # This field is not used for external load balancing.
+        # 
+        # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
     "IPProtocol": "A String", # The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, AH, SCTP or ICMP.
         # 
         # When the load balancing scheme is INTERNAL</code, only TCP and UDP are valid.
+    "subnetwork": "A String", # This field is not used for external load balancing.
+        # 
+        # For internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.
+        # 
+        # If the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
@@ -267,7 +305,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -309,15 +347,34 @@ <h3>Method Details</h3>
               #
               # When the load balancing scheme is INTERNAL, this can only be an RFC 1918 IP address belonging to the network/subnetwork configured for the forwarding rule. A reserved address cannot be used. If the field is empty, the IP address will be automatically allocated from the internal IP range of the subnetwork or network configured for this forwarding rule.
           "region": "A String", # [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules.
+          "ports": [ # This field is not used for external load balancing.
+              #
+              # When the load balancing scheme is INTERNAL, a single port or a comma separated list of ports can be configured. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. If the port list is not provided then all ports are allowed to pass through.
+              #
+              # You may specify a maximum of up to 5 ports.
+            "A String",
+          ],
+          "network": "A String", # This field is not used for external load balancing.
+              #
+              # For internal load balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.
+          "loadBalancingScheme": "A String", # This signifies what the ForwardingRule will be used for and can only take the following values: INTERNAL EXTERNAL The value of INTERNAL means that this will be used for Internal Network Load Balancing (TCP, UDP). The value of EXTERNAL means that this will be used for External Load Balancing (HTTP(S) LB, External TCP/UDP LB, SSL Proxy)
           "target": "A String", # The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must live in the same region as the forwarding rule. For global forwarding rules, this target must be a global TargetHttpProxy or TargetHttpsProxy resource. The forwarded traffic must be of a type appropriate to the target object. For example, TargetHttpProxy requires HTTP traffic, and TargetHttpsProxy requires HTTPS traffic.
               #
               # This field is not used for internal load balancing.
           "portRange": "A String", # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed to ports in the specified range will be forwarded to target. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
               #
               # This field is not used for internal load balancing.
+          "backendService": "A String", # This field is not used for external load balancing.
+              #
+              # For internal load balancing, this field identifies the BackendService resource to receive the matched traffic.
           "IPProtocol": "A String", # The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, AH, SCTP or ICMP.
               #
               # When the load balancing scheme is INTERNAL</code, only TCP and UDP are valid.
+          "subnetwork": "A String", # This field is not used for external load balancing.
+              #
+              # For internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.
+              #
+              # If the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
           "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
@@ -405,7 +462,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.globalOperations.html b/docs/dyn/compute_v1.globalOperations.html
index eaa759bd979..2a6bca82bbb 100644
--- a/docs/dyn/compute_v1.globalOperations.html
+++ b/docs/dyn/compute_v1.globalOperations.html
@@ -167,7 +167,7 @@ <h3>Method Details</h3>
             },
             "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
             "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-            "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+            "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
           },
         ],
         "warning": { # [Output Only] Informational warning which replaces the list of operations when the list is empty.
@@ -267,7 +267,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -343,7 +343,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_v1.healthChecks.html b/docs/dyn/compute_v1.healthChecks.html
index 34872cdb917..c5f73d67dc0 100644
--- a/docs/dyn/compute_v1.healthChecks.html
+++ b/docs/dyn/compute_v1.healthChecks.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -169,7 +169,7 @@ <h3>Method Details</h3>
       "kind": "compute#healthCheck", # Type of the resource.
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-      "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+      "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
       "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
       "tcpHealthCheck": {
         "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -193,13 +193,6 @@ <h3>Method Details</h3>
         "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
       },
       "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-      "http2HealthCheck": {
-        "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-        "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-        "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-        "port": 42, # The TCP port number for the health check request. The default value is 443.
-        "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-      },
       "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
       "sslHealthCheck": {
         "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -228,7 +221,7 @@ <h3>Method Details</h3>
     "kind": "compute#healthCheck", # Type of the resource.
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -252,13 +245,6 @@ <h3>Method Details</h3>
       "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
     },
     "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-    "http2HealthCheck": {
-      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-      "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-      "port": 42, # The TCP port number for the health check request. The default value is 443.
-      "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-    },
     "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
     "sslHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -320,7 +306,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -357,7 +343,7 @@ <h3>Method Details</h3>
           "kind": "compute#healthCheck", # Type of the resource.
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
           "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-          "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+          "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
           "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
           "tcpHealthCheck": {
             "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -381,13 +367,6 @@ <h3>Method Details</h3>
             "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
           },
           "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-          "http2HealthCheck": {
-            "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-            "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-            "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-            "port": 42, # The TCP port number for the health check request. The default value is 443.
-            "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-          },
           "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
           "sslHealthCheck": {
             "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -436,7 +415,7 @@ <h3>Method Details</h3>
     "kind": "compute#healthCheck", # Type of the resource.
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -460,13 +439,6 @@ <h3>Method Details</h3>
       "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
     },
     "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-    "http2HealthCheck": {
-      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-      "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-      "port": 42, # The TCP port number for the health check request. The default value is 443.
-      "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-    },
     "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
     "sslHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -528,7 +500,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -546,7 +518,7 @@ <h3>Method Details</h3>
     "kind": "compute#healthCheck", # Type of the resource.
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "timeoutSec": 42, # How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.
-    "type": "A String", # Specifies the type of the healthCheck, either TCP, UDP, SSL, HTTP, HTTPS or HTTP2. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
+    "type": "A String", # Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not specified, the default is TCP. Exactly one of the protocol-specific health check field must be specified, which must match type field.
     "checkIntervalSec": 42, # How often (in seconds) to send a health check. The default value is 5 seconds.
     "tcpHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -570,13 +542,6 @@ <h3>Method Details</h3>
       "requestPath": "A String", # The request path of the HTTPS health check request. The default value is /.
     },
     "healthyThreshold": 42, # A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.
-    "http2HealthCheck": {
-      "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
-      "host": "A String", # The value of the host header in the HTTP/2 health check request. If left empty (default value), the IP on behalf of which this health check is performed will be used.
-      "proxyHeader": "A String", # Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.
-      "port": 42, # The TCP port number for the health check request. The default value is 443.
-      "requestPath": "A String", # The request path of the HTTP/2 health check request. The default value is /.
-    },
     "unhealthyThreshold": 42, # A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.
     "sslHealthCheck": {
       "portName": "A String", # Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name are defined, port takes precedence.
@@ -638,7 +603,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.html b/docs/dyn/compute_v1.html
index 9b646983013..f0e68865830 100644
--- a/docs/dyn/compute_v1.html
+++ b/docs/dyn/compute_v1.html
@@ -184,6 +184,26 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the projects Resource.</p>
 
+<p class="toc_element">
+  <code><a href="compute_v1.regionAutoscalers.html">regionAutoscalers()</a></code>
+</p>
+<p class="firstline">Returns the regionAutoscalers Resource.</p>
+
+<p class="toc_element">
+  <code><a href="compute_v1.regionBackendServices.html">regionBackendServices()</a></code>
+</p>
+<p class="firstline">Returns the regionBackendServices Resource.</p>
+
+<p class="toc_element">
+  <code><a href="compute_v1.regionInstanceGroupManagers.html">regionInstanceGroupManagers()</a></code>
+</p>
+<p class="firstline">Returns the regionInstanceGroupManagers Resource.</p>
+
+<p class="toc_element">
+  <code><a href="compute_v1.regionInstanceGroups.html">regionInstanceGroups()</a></code>
+</p>
+<p class="firstline">Returns the regionInstanceGroups Resource.</p>
+
 <p class="toc_element">
   <code><a href="compute_v1.regionOperations.html">regionOperations()</a></code>
 </p>
diff --git a/docs/dyn/compute_v1.httpHealthChecks.html b/docs/dyn/compute_v1.httpHealthChecks.html
index 0d247e46ae3..28a7e4998af 100644
--- a/docs/dyn/compute_v1.httpHealthChecks.html
+++ b/docs/dyn/compute_v1.httpHealthChecks.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -254,7 +254,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -396,7 +396,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -473,7 +473,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.httpsHealthChecks.html b/docs/dyn/compute_v1.httpsHealthChecks.html
index 2d7bf59d2fa..d9abfd63f5a 100644
--- a/docs/dyn/compute_v1.httpsHealthChecks.html
+++ b/docs/dyn/compute_v1.httpsHealthChecks.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -254,7 +254,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -396,7 +396,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -473,7 +473,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.images.html b/docs/dyn/compute_v1.images.html
index 5a85a9efba6..9a98b3fd24e 100644
--- a/docs/dyn/compute_v1.images.html
+++ b/docs/dyn/compute_v1.images.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -167,10 +167,10 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Deprecation status for a public resource.
-  "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-  "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+  "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+  "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
   "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-  "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+  "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
   "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
 }
 
@@ -221,7 +221,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -237,7 +237,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Image resource.
-      "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+      "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
           # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
           # - projects/project/zones/zone/disks/disk
           # - zones/zone/disks/disk
@@ -250,10 +250,10 @@ <h3>Method Details</h3>
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
       "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-        "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
         "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
         "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
       },
       "rawDisk": { # The parameters of the raw disk image.
@@ -263,6 +263,13 @@ <h3>Method Details</h3>
       },
       "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
       "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
+      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+          #
+          # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
+        { # Guest OS features.
+          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
+        },
+      ],
       "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
       "imageEncryptionKey": { # Represents a customer-supplied encryption key # Encrypts the image using a customer-supplied encryption key.
           #
@@ -297,7 +304,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # An Image resource.
-      "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+      "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
           # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
           # - projects/project/zones/zone/disks/disk
           # - zones/zone/disks/disk
@@ -310,10 +317,10 @@ <h3>Method Details</h3>
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
       "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-        "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+        "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+        "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
         "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+        "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
         "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
       },
       "rawDisk": { # The parameters of the raw disk image.
@@ -323,6 +330,13 @@ <h3>Method Details</h3>
       },
       "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
       "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
+      "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+          #
+          # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
+        { # Guest OS features.
+          "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
+        },
+      ],
       "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
       "imageEncryptionKey": { # Represents a customer-supplied encryption key # Encrypts the image using a customer-supplied encryption key.
           #
@@ -355,7 +369,7 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # An Image resource.
-    "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+    "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
         # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
         # - projects/project/zones/zone/disks/disk
         # - zones/zone/disks/disk
@@ -368,10 +382,10 @@ <h3>Method Details</h3>
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
     "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "rawDisk": { # The parameters of the raw disk image.
@@ -381,6 +395,13 @@ <h3>Method Details</h3>
     },
     "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
     "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
+    "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+        # 
+        # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
+      { # Guest OS features.
+        "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
+      },
+    ],
     "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
     "imageEncryptionKey": { # Represents a customer-supplied encryption key # Encrypts the image using a customer-supplied encryption key.
         # 
@@ -449,7 +470,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -483,7 +504,7 @@ <h3>Method Details</h3>
     "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
     "items": [ # [Output Only] A list of Image resources.
       { # An Image resource.
-          "sourceDisk": "A String", # URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
+          "sourceDisk": "A String", # URL of the source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:
               # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
               # - projects/project/zones/zone/disks/disk
               # - zones/zone/disks/disk
@@ -496,10 +517,10 @@ <h3>Method Details</h3>
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
           "family": "A String", # The name of the image family to which this image belongs. You can create disks by specifying an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.
           "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this image.
-            "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+            "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+            "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
             "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+            "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
             "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
           },
           "rawDisk": { # The parameters of the raw disk image.
@@ -509,6 +530,13 @@ <h3>Method Details</h3>
           },
           "archiveSizeBytes": "A String", # Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).
           "sourceDiskId": "A String", # The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.
+          "guestOsFeatures": [ # A list of features to enable on the guest OS. Applicable for bootable images only. Currently, only one feature can be enabled, VIRTIO_SCSCI_MULTIQUEUE, which allows each virtual CPU to have its own queue. For Windows images, you can only enable VIRTIO_SCSCI_MULTIQUEUE on images with driver version 1.2.0.1621 or higher. Linux images with kernel versions 3.17 and higher will support VIRTIO_SCSCI_MULTIQUEUE.
+              #
+              # For new Windows images, the server might also populate this field with the value WINDOWS, to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
+            { # Guest OS features.
+              "type": "A String", # The type of supported feature. Currenty only VIRTIO_SCSI_MULTIQUEUE is supported. For newer Windows images, the server might also populate this property with the value WINDOWS to indicate that this is a Windows image. This value is purely informational and does not enable or disable any features.
+            },
+          ],
           "diskSizeGb": "A String", # Size of the image when restored onto a persistent disk (in GB).
           "imageEncryptionKey": { # Represents a customer-supplied encryption key # Encrypts the image using a customer-supplied encryption key.
               #
diff --git a/docs/dyn/compute_v1.instanceGroupManagers.html b/docs/dyn/compute_v1.instanceGroupManagers.html
index 3068e0b2d49..3b92f3c0f80 100644
--- a/docs/dyn/compute_v1.instanceGroupManagers.html
+++ b/docs/dyn/compute_v1.instanceGroupManagers.html
@@ -99,7 +99,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list(project, zone, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Retrieves a list of managed instance groups that are contained within the specified project and zone.</p>
 <p class="toc_element">
-  <code><a href="#listManagedInstances">listManagedInstances(project, zone, instanceGroupManager)</a></code></p>
+  <code><a href="#listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -181,7 +181,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -341,7 +341,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -409,7 +409,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -557,7 +557,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -635,13 +635,17 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="listManagedInstances">listManagedInstances(project, zone, instanceGroupManager)</code>
+    <code class="details" id="listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.
 
 Args:
   project: string, Project ID for this request. (required)
   zone: string, The name of the zone where the managed instance group is located. (required)
   instanceGroupManager: string, The name of the managed instance group. (required)
+  order_by: string, A parameter
+  maxResults: integer, A parameter
+  pageToken: string, A parameter
+  filter: string, A parameter
 
 Returns:
   An object of the form:
@@ -755,7 +759,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -815,7 +819,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -881,7 +885,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -950,7 +954,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.instanceGroups.html b/docs/dyn/compute_v1.instanceGroups.html
index 85fc2a3ea77..9c294f6ba8f 100644
--- a/docs/dyn/compute_v1.instanceGroups.html
+++ b/docs/dyn/compute_v1.instanceGroups.html
@@ -177,7 +177,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -325,7 +325,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -449,7 +449,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -663,7 +663,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -735,7 +735,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.instanceTemplates.html b/docs/dyn/compute_v1.instanceTemplates.html
index 05075d4510d..1d041789e56 100644
--- a/docs/dyn/compute_v1.instanceTemplates.html
+++ b/docs/dyn/compute_v1.instanceTemplates.html
@@ -144,7 +144,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -206,7 +206,7 @@ <h3>Method Details</h3>
               },
               "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
               "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name of the instance.
-              "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                   #
                   # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                   #
@@ -223,6 +223,8 @@ <h3>Method Details</h3>
                   # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                   #
                   # global/images/family/my-private-family
+                  #
+                  # If the source image is deleted later, this field will not be set.
               "diskType": "A String", # Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:
                   #
                   # https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard
@@ -241,7 +243,11 @@ <h3>Method Details</h3>
             "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
             "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
             "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                #
+                # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
           },
         ],
         "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from this template.
@@ -355,7 +361,7 @@ <h3>Method Details</h3>
             },
             "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
             "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name of the instance.
-            "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+            "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                 #
                 # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                 #
@@ -372,6 +378,8 @@ <h3>Method Details</h3>
                 # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                 #
                 # global/images/family/my-private-family
+                #
+                # If the source image is deleted later, this field will not be set.
             "diskType": "A String", # Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:
                 #
                 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard
@@ -390,7 +398,11 @@ <h3>Method Details</h3>
           "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
           "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
           "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-          "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+          "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+              #
+              # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+              #
+              # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
         },
       ],
       "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from this template.
@@ -494,7 +506,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -574,7 +586,7 @@ <h3>Method Details</h3>
                   },
                   "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
                   "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name of the instance.
-                  "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                       #
                       # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                       #
@@ -591,6 +603,8 @@ <h3>Method Details</h3>
                       # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                       #
                       # global/images/family/my-private-family
+                      #
+                      # If the source image is deleted later, this field will not be set.
                   "diskType": "A String", # Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:
                       #
                       # https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard
@@ -609,7 +623,11 @@ <h3>Method Details</h3>
                 "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
                 "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
                 "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                    #
+                    # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
               },
             ],
             "scheduling": { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from this template.
diff --git a/docs/dyn/compute_v1.instances.html b/docs/dyn/compute_v1.instances.html
index f3db40d1c06..340a16fc876 100644
--- a/docs/dyn/compute_v1.instances.html
+++ b/docs/dyn/compute_v1.instances.html
@@ -99,7 +99,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(project, zone, instance)</a></code></p>
 <p class="firstline">Returns the specified Instance resource. Get a list of available instances by making a list() request.</p>
 <p class="toc_element">
-  <code><a href="#getSerialPortOutput">getSerialPortOutput(project, zone, instance, port=None)</a></code></p>
+  <code><a href="#getSerialPortOutput">getSerialPortOutput(project, zone, instance, start=None, port=None)</a></code></p>
 <p class="firstline">Returns the specified instance's serial port output.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(project, zone, body)</a></code></p>
@@ -204,7 +204,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -285,7 +285,7 @@ <h3>Method Details</h3>
                   },
                   "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
                   "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name of the instance.
-                  "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+                  "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                       #
                       # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                       #
@@ -302,6 +302,8 @@ <h3>Method Details</h3>
                       # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                       #
                       # global/images/family/my-private-family
+                      #
+                      # If the source image is deleted later, this field will not be set.
                   "diskType": "A String", # Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:
                       #
                       # https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard
@@ -320,7 +322,11 @@ <h3>Method Details</h3>
                 "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
                 "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
                 "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+                "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                    #
+                    # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                    #
+                    # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
               },
             ],
             "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
@@ -463,7 +469,7 @@ <h3>Method Details</h3>
     },
     "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
     "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name of the instance.
-    "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+    "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
         #
         # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
         #
@@ -480,6 +486,8 @@ <h3>Method Details</h3>
         # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
         #
         # global/images/family/my-private-family
+        #
+        # If the source image is deleted later, this field will not be set.
     "diskType": "A String", # Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:
         #
         # https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard
@@ -498,7 +506,11 @@ <h3>Method Details</h3>
   "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
   "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
   "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-  "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+  "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+      # 
+      # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+      # 
+      # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
 }
 
 
@@ -548,7 +560,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -607,7 +619,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -668,7 +680,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -728,7 +740,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -790,7 +802,7 @@ <h3>Method Details</h3>
           },
           "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
           "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name of the instance.
-          "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+          "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
               #
               # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
               #
@@ -807,6 +819,8 @@ <h3>Method Details</h3>
               # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
               #
               # global/images/family/my-private-family
+              #
+              # If the source image is deleted later, this field will not be set.
           "diskType": "A String", # Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:
               #
               # https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard
@@ -825,7 +839,11 @@ <h3>Method Details</h3>
         "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
         "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
         "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+        "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+            #
+            # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+            #
+            # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
       },
     ],
     "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
@@ -896,22 +914,25 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="getSerialPortOutput">getSerialPortOutput(project, zone, instance, port=None)</code>
+    <code class="details" id="getSerialPortOutput">getSerialPortOutput(project, zone, instance, start=None, port=None)</code>
   <pre>Returns the specified instance's serial port output.
 
 Args:
   project: string, Project ID for this request. (required)
   zone: string, The name of the zone for this request. (required)
   instance: string, Name of the instance scoping this request. (required)
+  start: string, For the initial request, leave this field unspecified. For subsequent calls, this field should be set to the next value that was returned in the previous call.
   port: integer, Specifies which COM or serial port to retrieve data from.
 
 Returns:
   An object of the form:
 
     { # An instance's serial console output.
+    "start": "A String", # [Output Only] The starting byte position of the output that was returned. This should match the start parameter sent with the request. If the serial console output exceeds the size of the buffer, older output will be overwritten by newer content and the start values will be mismatched.
     "kind": "compute#serialPortOutput", # [Output Only] Type of the resource. Always compute#serialPortOutput for serial port output.
     "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
     "contents": "A String", # [Output Only] The contents of the console output.
+    "next": "A String", # [Output Only] The position of the next byte of content from the serial console output. Use this value in the next request as the start parameter.
   }</pre>
 </div>
 
@@ -971,7 +992,7 @@ <h3>Method Details</h3>
         },
         "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
         "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name of the instance.
-        "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+        "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
             #
             # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
             #
@@ -988,6 +1009,8 @@ <h3>Method Details</h3>
             # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
             #
             # global/images/family/my-private-family
+            #
+            # If the source image is deleted later, this field will not be set.
         "diskType": "A String", # Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:
             #
             # https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard
@@ -1006,7 +1029,11 @@ <h3>Method Details</h3>
       "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
       "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
       "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+      "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+          #
+          # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+          #
+          # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
     },
   ],
   "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
@@ -1122,7 +1149,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1202,7 +1229,7 @@ <h3>Method Details</h3>
               },
               "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB.
               "diskName": "A String", # Specifies the disk name. If not specified, the default is to use the name of the instance.
-              "sourceImage": "A String", # The source image used to create this disk. If the source image is deleted, this field will not be set.
+              "sourceImage": "A String", # The source image to create this disk. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
                   #
                   # To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-8 to use the latest Debian 8 image:
                   #
@@ -1219,6 +1246,8 @@ <h3>Method Details</h3>
                   # You can also specify a private image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name:
                   #
                   # global/images/family/my-private-family
+                  #
+                  # If the source image is deleted later, this field will not be set.
               "diskType": "A String", # Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:
                   #
                   # https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard
@@ -1237,7 +1266,11 @@ <h3>Method Details</h3>
             "mode": "A String", # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.
             "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.
             "type": "A String", # Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
-            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. Note that for InstanceTemplate, it is just disk name, not URL for the disk.
+            "source": "A String", # Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or disks.source is required.
+                #
+                # If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
+                #
+                # Note that for InstanceTemplate, specify the disk name, not the URL for the disk.
           },
         ],
         "name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
@@ -1381,7 +1414,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1442,7 +1475,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1508,7 +1541,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1581,7 +1614,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1649,7 +1682,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1720,7 +1753,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1779,7 +1812,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1857,7 +1890,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1916,7 +1949,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.machineTypes.html b/docs/dyn/compute_v1.machineTypes.html
index e213d7cdc4f..c1d797e9d10 100644
--- a/docs/dyn/compute_v1.machineTypes.html
+++ b/docs/dyn/compute_v1.machineTypes.html
@@ -130,10 +130,10 @@ <h3>Method Details</h3>
             "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
             "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
             "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-              "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+              "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
               "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
               "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
             },
             "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
@@ -203,10 +203,10 @@ <h3>Method Details</h3>
     "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
     "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
@@ -262,10 +262,10 @@ <h3>Method Details</h3>
         "zone": "A String", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
         "maximumPersistentDisks": 42, # [Output Only] Maximum persistent disks allowed.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "memoryMb": 42, # [Output Only] The amount of physical memory available to the instance, defined in MB.
diff --git a/docs/dyn/compute_v1.networks.html b/docs/dyn/compute_v1.networks.html
index 383e07beab5..3e01b03d869 100644
--- a/docs/dyn/compute_v1.networks.html
+++ b/docs/dyn/compute_v1.networks.html
@@ -89,6 +89,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#switchToCustomMode">switchToCustomMode(project, network)</a></code></p>
+<p class="firstline">Switches the network mode from auto subnet mode to custom subnet mode.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="delete">delete(project, network)</code>
@@ -144,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -250,7 +253,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -320,4 +323,62 @@ <h3>Method Details</h3>
     </pre>
 </div>
 
+<div class="method">
+    <code class="details" id="switchToCustomMode">switchToCustomMode(project, network)</code>
+  <pre>Switches the network mode from auto subnet mode to custom subnet mode.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network to be updated. (required)
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/compute_v1.projects.html b/docs/dyn/compute_v1.projects.html
index 8bc5d1251f2..a446ec918cb 100644
--- a/docs/dyn/compute_v1.projects.html
+++ b/docs/dyn/compute_v1.projects.html
@@ -202,7 +202,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -273,7 +273,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -344,7 +344,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -409,7 +409,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.regionAutoscalers.html b/docs/dyn/compute_v1.regionAutoscalers.html
new file mode 100644
index 00000000000..c97c18b6e1a
--- /dev/null
+++ b/docs/dyn/compute_v1.regionAutoscalers.html
@@ -0,0 +1,621 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.regionAutoscalers.html">regionAutoscalers</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(project, region, autoscaler)</a></code></p>
+<p class="firstline">Deletes the specified autoscaler.</p>
+<p class="toc_element">
+  <code><a href="#get">get(project, region, autoscaler)</a></code></p>
+<p class="firstline">Returns the specified autoscaler.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(project, region, body)</a></code></p>
+<p class="firstline">Creates an autoscaler in the specified project using the data included in the request.</p>
+<p class="toc_element">
+  <code><a href="#list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves a list of autoscalers contained within the specified region.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(project, region, autoscaler, body)</a></code></p>
+<p class="firstline">Updates an autoscaler in the specified project using the data included in the request. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(project, region, body, autoscaler=None)</a></code></p>
+<p class="firstline">Updates an autoscaler in the specified project using the data included in the request.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(project, region, autoscaler)</code>
+  <pre>Deletes the specified autoscaler.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  autoscaler: string, Name of the autoscaler to delete. (required)
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(project, region, autoscaler)</code>
+  <pre>Returns the specified autoscaler.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  autoscaler: string, Name of the autoscaler to return. (required)
+
+Returns:
+  An object of the form:
+
+    { # Represents an Autoscaler resource. Autoscalers allow you to automatically scale virtual machine instances in managed instance groups according to an autoscaling policy that you define. For more information, read Autoscaling Groups of Instances.
+      "kind": "compute#autoscaler", # [Output Only] Type of the resource. Always compute#autoscaler for autoscalers.
+      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "zone": "A String", # [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope).
+      "region": "A String", # [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope).
+      "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define one or more of the policies for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.
+          #
+          # If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%.
+        "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale up to. This is required when creating or updating an autoscaler. The maximum number of replicas should not be lower than minimal number of replicas.
+        "coolDownPeriodSec": 42, # The number of seconds that the autoscaler should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. The default time autoscaler waits is 60 seconds.
+            #
+            # Virtual machine initialization times might vary because of numerous factors. We recommend that you test how long an instance may take to initialize. To do this, create an instance and time the startup process.
+        "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+          "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(s) load balancing configuration) that autoscaler should maintain. Must be a positive float value. If not defined, the default is 0.8.
+        },
+        "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+          { # Custom utilization metric policy.
+            "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+                #
+                # For example, the following is a valid metric:
+                # compute.googleapis.com/instance/network/received_bytes_count
+                # The following is not a valid metric because it does not increase or decrease based on usage:
+                # compute.googleapis.com/instance/cpu/reserved_cores
+            "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
+            "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+          },
+        ],
+        "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
+          "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler should maintain. Must be a float value in the range (0, 1]. If not specified, the default is 0.6.
+              #
+              # If the CPU level is below the target utilization, the autoscaler scales down the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization.
+              #
+              # If the average CPU is above the target utilization, the autoscaler scales up until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization.
+        },
+        "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale down to. This cannot be less than 0. If not provided, autoscaler will choose a default value depending on maximum number of instances allowed.
+      },
+      "target": "A String", # URL of the managed instance group that this autoscaler will scale.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(project, region, body)</code>
+  <pre>Creates an autoscaler in the specified project using the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents an Autoscaler resource. Autoscalers allow you to automatically scale virtual machine instances in managed instance groups according to an autoscaling policy that you define. For more information, read Autoscaling Groups of Instances.
+    "kind": "compute#autoscaler", # [Output Only] Type of the resource. Always compute#autoscaler for autoscalers.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "zone": "A String", # [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope).
+    "region": "A String", # [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope).
+    "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define one or more of the policies for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.
+        # 
+        # If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%.
+      "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale up to. This is required when creating or updating an autoscaler. The maximum number of replicas should not be lower than minimal number of replicas.
+      "coolDownPeriodSec": 42, # The number of seconds that the autoscaler should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. The default time autoscaler waits is 60 seconds.
+          #
+          # Virtual machine initialization times might vary because of numerous factors. We recommend that you test how long an instance may take to initialize. To do this, create an instance and time the startup process.
+      "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+        "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(s) load balancing configuration) that autoscaler should maintain. Must be a positive float value. If not defined, the default is 0.8.
+      },
+      "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+        { # Custom utilization metric policy.
+          "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+              #
+              # For example, the following is a valid metric:
+              # compute.googleapis.com/instance/network/received_bytes_count
+              # The following is not a valid metric because it does not increase or decrease based on usage:
+              # compute.googleapis.com/instance/cpu/reserved_cores
+          "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
+          "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+        },
+      ],
+      "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
+        "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler should maintain. Must be a float value in the range (0, 1]. If not specified, the default is 0.6.
+            #
+            # If the CPU level is below the target utilization, the autoscaler scales down the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization.
+            #
+            # If the average CPU is above the target utilization, the autoscaler scales up until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization.
+      },
+      "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale down to. This cannot be less than 0. If not provided, autoscaler will choose a default value depending on maximum number of instances allowed.
+    },
+    "target": "A String", # URL of the managed instance group that this autoscaler will scale.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves a list of autoscalers contained within the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of autoscalers.
+    "nextPageToken": "A String", # [Output Only] A token used to continue a truncated list request.
+    "items": [ # A list of autoscalers.
+      { # Represents an Autoscaler resource. Autoscalers allow you to automatically scale virtual machine instances in managed instance groups according to an autoscaling policy that you define. For more information, read Autoscaling Groups of Instances.
+          "kind": "compute#autoscaler", # [Output Only] Type of the resource. Always compute#autoscaler for autoscalers.
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "zone": "A String", # [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope).
+          "region": "A String", # [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope).
+          "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define one or more of the policies for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.
+              #
+              # If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%.
+            "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale up to. This is required when creating or updating an autoscaler. The maximum number of replicas should not be lower than minimal number of replicas.
+            "coolDownPeriodSec": 42, # The number of seconds that the autoscaler should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. The default time autoscaler waits is 60 seconds.
+                #
+                # Virtual machine initialization times might vary because of numerous factors. We recommend that you test how long an instance may take to initialize. To do this, create an instance and time the startup process.
+            "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+              "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(s) load balancing configuration) that autoscaler should maintain. Must be a positive float value. If not defined, the default is 0.8.
+            },
+            "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+              { # Custom utilization metric policy.
+                "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+                    #
+                    # For example, the following is a valid metric:
+                    # compute.googleapis.com/instance/network/received_bytes_count
+                    # The following is not a valid metric because it does not increase or decrease based on usage:
+                    # compute.googleapis.com/instance/cpu/reserved_cores
+                "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
+                "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+              },
+            ],
+            "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
+              "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler should maintain. Must be a float value in the range (0, 1]. If not specified, the default is 0.6.
+                  #
+                  # If the CPU level is below the target utilization, the autoscaler scales down the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization.
+                  #
+                  # If the average CPU is above the target utilization, the autoscaler scales up until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization.
+            },
+            "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale down to. This cannot be less than 0. If not provided, autoscaler will choose a default value depending on maximum number of instances allowed.
+          },
+          "target": "A String", # URL of the managed instance group that this autoscaler will scale.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+        },
+    ],
+    "kind": "compute#regionAutoscalerList", # Type of resource.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(project, region, autoscaler, body)</code>
+  <pre>Updates an autoscaler in the specified project using the data included in the request. This method supports patch semantics.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  autoscaler: string, Name of the autoscaler to update. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents an Autoscaler resource. Autoscalers allow you to automatically scale virtual machine instances in managed instance groups according to an autoscaling policy that you define. For more information, read Autoscaling Groups of Instances.
+    "kind": "compute#autoscaler", # [Output Only] Type of the resource. Always compute#autoscaler for autoscalers.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "zone": "A String", # [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope).
+    "region": "A String", # [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope).
+    "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define one or more of the policies for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.
+        # 
+        # If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%.
+      "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale up to. This is required when creating or updating an autoscaler. The maximum number of replicas should not be lower than minimal number of replicas.
+      "coolDownPeriodSec": 42, # The number of seconds that the autoscaler should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. The default time autoscaler waits is 60 seconds.
+          #
+          # Virtual machine initialization times might vary because of numerous factors. We recommend that you test how long an instance may take to initialize. To do this, create an instance and time the startup process.
+      "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+        "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(s) load balancing configuration) that autoscaler should maintain. Must be a positive float value. If not defined, the default is 0.8.
+      },
+      "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+        { # Custom utilization metric policy.
+          "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+              #
+              # For example, the following is a valid metric:
+              # compute.googleapis.com/instance/network/received_bytes_count
+              # The following is not a valid metric because it does not increase or decrease based on usage:
+              # compute.googleapis.com/instance/cpu/reserved_cores
+          "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
+          "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+        },
+      ],
+      "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
+        "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler should maintain. Must be a float value in the range (0, 1]. If not specified, the default is 0.6.
+            #
+            # If the CPU level is below the target utilization, the autoscaler scales down the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization.
+            #
+            # If the average CPU is above the target utilization, the autoscaler scales up until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization.
+      },
+      "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale down to. This cannot be less than 0. If not provided, autoscaler will choose a default value depending on maximum number of instances allowed.
+    },
+    "target": "A String", # URL of the managed instance group that this autoscaler will scale.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(project, region, body, autoscaler=None)</code>
+  <pre>Updates an autoscaler in the specified project using the data included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents an Autoscaler resource. Autoscalers allow you to automatically scale virtual machine instances in managed instance groups according to an autoscaling policy that you define. For more information, read Autoscaling Groups of Instances.
+    "kind": "compute#autoscaler", # [Output Only] Type of the resource. Always compute#autoscaler for autoscalers.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "zone": "A String", # [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope).
+    "region": "A String", # [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope).
+    "autoscalingPolicy": { # Cloud Autoscaler policy. # The configuration parameters for the autoscaling algorithm. You can define one or more of the policies for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.
+        # 
+        # If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%.
+      "maxNumReplicas": 42, # The maximum number of instances that the autoscaler can scale up to. This is required when creating or updating an autoscaler. The maximum number of replicas should not be lower than minimal number of replicas.
+      "coolDownPeriodSec": 42, # The number of seconds that the autoscaler should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. The default time autoscaler waits is 60 seconds.
+          #
+          # Virtual machine initialization times might vary because of numerous factors. We recommend that you test how long an instance may take to initialize. To do this, create an instance and time the startup process.
+      "loadBalancingUtilization": { # Configuration parameters of autoscaling based on load balancing. # Configuration parameters of autoscaling based on load balancer.
+        "utilizationTarget": 3.14, # Fraction of backend capacity utilization (set in HTTP(s) load balancing configuration) that autoscaler should maintain. Must be a positive float value. If not defined, the default is 0.8.
+      },
+      "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
+        { # Custom utilization metric policy.
+          "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+              #
+              # For example, the following is a valid metric:
+              # compute.googleapis.com/instance/network/received_bytes_count
+              # The following is not a valid metric because it does not increase or decrease based on usage:
+              # compute.googleapis.com/instance/cpu/reserved_cores
+          "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
+          "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+        },
+      ],
+      "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
+        "utilizationTarget": 3.14, # The target CPU utilization that the autoscaler should maintain. Must be a float value in the range (0, 1]. If not specified, the default is 0.6.
+            #
+            # If the CPU level is below the target utilization, the autoscaler scales down the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization.
+            #
+            # If the average CPU is above the target utilization, the autoscaler scales up until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization.
+      },
+      "minNumReplicas": 42, # The minimum number of replicas that the autoscaler can scale down to. This cannot be less than 0. If not provided, autoscaler will choose a default value depending on maximum number of instances allowed.
+    },
+    "target": "A String", # URL of the managed instance group that this autoscaler will scale.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+  autoscaler: string, Name of the autoscaler to update.
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/compute_v1.regionBackendServices.html b/docs/dyn/compute_v1.regionBackendServices.html
new file mode 100644
index 00000000000..b5f6eba50cc
--- /dev/null
+++ b/docs/dyn/compute_v1.regionBackendServices.html
@@ -0,0 +1,821 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.regionBackendServices.html">regionBackendServices</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(project, region, backendService)</a></code></p>
+<p class="firstline">Deletes the specified regional BackendService resource.</p>
+<p class="toc_element">
+  <code><a href="#get">get(project, region, backendService)</a></code></p>
+<p class="firstline">Returns the specified regional BackendService resource.</p>
+<p class="toc_element">
+  <code><a href="#getHealth">getHealth(project, region, backendService, body)</a></code></p>
+<p class="firstline">Gets the most recent health check results for this regional BackendService.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(project, region, body)</a></code></p>
+<p class="firstline">Creates a regional BackendService resource in the specified project using the data included in the request. There are several restrictions and guidelines to keep in mind when creating a regional backend service. Read  Restrictions and Guidelines for more information.</p>
+<p class="toc_element">
+  <code><a href="#list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves the list of regional BackendService resources available to the specified project in the given region.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(project, region, backendService, body)</a></code></p>
+<p class="firstline">Updates the specified regional BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read  Restrictions and Guidelines for more information. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(project, region, backendService, body)</a></code></p>
+<p class="firstline">Updates the specified regional BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read  Restrictions and Guidelines for more information.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(project, region, backendService)</code>
+  <pre>Deletes the specified regional BackendService resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService resource to delete. (required)
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(project, region, backendService)</code>
+  <pre>Returns the specified regional BackendService resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService resource to return. (required)
+
+Returns:
+  An object of the form:
+
+    { # A BackendService resource. This resource defines a group of backend virtual machines and their serving capacity.
+      "connectionDraining": { # Message containing connection draining configuration.
+        "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
+      },
+      "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
+      "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+          #
+          # Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. The default is HTTP.
+          #
+          # For internal load balancing, the possible values are TCP and UDP, and the default is TCP.
+      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+      "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
+          #
+          # When the load balancing scheme is INTERNAL, this field is not used.
+      "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+      "loadBalancingScheme": "A String",
+      "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
+          #
+          # When the load balancing scheme is INTERNAL, this field is not used.
+      "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
+          #
+          # This cannot be used for internal load balancing.
+      "backends": [ # The list of backends that serve this BackendService.
+        { # Message containing information of one individual backend.
+          "group": "A String", # The fully-qualified URL of a zonal Instance Group resource. This instance group defines the list of instances that serve traffic. Member virtual machine instances from each instance group must live in the same zone as the instance group itself. No two backends in a backend service are allowed to use same Instance Group resource.
+              #
+              # Note that you must specify an Instance Group resource using the fully-qualified URL, rather than a partial URL.
+              #
+              # When the BackendService has load balancing scheme INTERNAL, the instance group must be in a zone within the same region as the BackendService.
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
+              #
+              # This cannot be used for internal load balancing.
+          "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+              #
+              # This cannot be used for internal load balancing.
+          "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+              #
+              # This cannot be used for internal load balancing.
+          "capacityScaler": 3.14, # A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group will serve up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available Capacity. Valid range is [0.0,1.0].
+              #
+              # This cannot be used for internal load balancing.
+          "maxRate": 42, # The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+              #
+              # This cannot be used for internal load balancing.
+          "maxConnections": 42, # The max number of simultaneous connections for the group. Can be used with either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+              #
+              # This cannot be used for internal load balancing.
+          "balancingMode": "A String", # Specifies the balancing mode for this backend. For global HTTP(S) or TCP/SSL load balancing, the default is UTILIZATION. Valid values are UTILIZATION, RATE (for HTTP(S)) and CONNECTION (for TCP/SSL).
+              #
+              # This cannot be used for internal load balancing.
+        },
+      ],
+      "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
+      "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
+          #
+          # When the load balancing scheme is INTERNAL, this field is not used.
+      "healthChecks": [ # The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService. Currently at most one health check can be specified, and a health check is required.
+          #
+          # For internal load balancing, a URL to a HealthCheck resource must be specified instead.
+        "A String",
+      ],
+      "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+          #
+          # When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP, or GENERATED_COOKIE.
+          #
+          # When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.
+          #
+          # When the protocol is UDP, this field is not used.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+      "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="getHealth">getHealth(project, region, backendService, body)</code>
+  <pre>Gets the most recent health check results for this regional BackendService.
+
+Args:
+  project: string, A parameter (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService resource to which the queried instance belongs. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "group": "A String", # A URI referencing one of the instance groups listed in the backend service.
+  }
+
+
+Returns:
+  An object of the form:
+
+    {
+    "kind": "compute#backendServiceGroupHealth", # [Output Only] Type of resource. Always compute#backendServiceGroupHealth for the health of backend services.
+    "healthStatus": [
+      {
+        "instance": "A String", # URL of the instance resource.
+        "healthState": "A String", # Health state of the instance.
+        "ipAddress": "A String", # The IP address represented by this resource.
+        "port": 42, # The port on the instance.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(project, region, body)</code>
+  <pre>Creates a regional BackendService resource in the specified project using the data included in the request. There are several restrictions and guidelines to keep in mind when creating a regional backend service. Read  Restrictions and Guidelines for more information.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # A BackendService resource. This resource defines a group of backend virtual machines and their serving capacity.
+    "connectionDraining": { # Message containing connection draining configuration.
+      "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
+    },
+    "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
+    "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+        # 
+        # Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. The default is HTTP.
+        # 
+        # For internal load balancing, the possible values are TCP and UDP, and the default is TCP.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "loadBalancingScheme": "A String",
+    "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
+        # 
+        # This cannot be used for internal load balancing.
+    "backends": [ # The list of backends that serve this BackendService.
+      { # Message containing information of one individual backend.
+        "group": "A String", # The fully-qualified URL of a zonal Instance Group resource. This instance group defines the list of instances that serve traffic. Member virtual machine instances from each instance group must live in the same zone as the instance group itself. No two backends in a backend service are allowed to use same Instance Group resource.
+            #
+            # Note that you must specify an Instance Group resource using the fully-qualified URL, rather than a partial URL.
+            #
+            # When the BackendService has load balancing scheme INTERNAL, the instance group must be in a zone within the same region as the BackendService.
+        "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+        "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
+            #
+            # This cannot be used for internal load balancing.
+        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "capacityScaler": 3.14, # A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group will serve up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available Capacity. Valid range is [0.0,1.0].
+            #
+            # This cannot be used for internal load balancing.
+        "maxRate": 42, # The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "maxConnections": 42, # The max number of simultaneous connections for the group. Can be used with either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "balancingMode": "A String", # Specifies the balancing mode for this backend. For global HTTP(S) or TCP/SSL load balancing, the default is UTILIZATION. Valid values are UTILIZATION, RATE (for HTTP(S)) and CONNECTION (for TCP/SSL).
+            #
+            # This cannot be used for internal load balancing.
+      },
+    ],
+    "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
+    "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "healthChecks": [ # The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService. Currently at most one health check can be specified, and a health check is required.
+        # 
+        # For internal load balancing, a URL to a HealthCheck resource must be specified instead.
+      "A String",
+    ],
+    "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+        # 
+        # When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP, or GENERATED_COOKIE.
+        # 
+        # When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.
+        # 
+        # When the protocol is UDP, this field is not used.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves the list of regional BackendService resources available to the specified project in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of BackendService resources.
+    "nextPageToken": "A String", # [Output Only] A token used to continue a truncated list request.
+    "items": [ # A list of BackendService resources.
+      { # A BackendService resource. This resource defines a group of backend virtual machines and their serving capacity.
+          "connectionDraining": { # Message containing connection draining configuration.
+            "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
+          },
+          "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
+          "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+              #
+              # Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. The default is HTTP.
+              #
+              # For internal load balancing, the possible values are TCP and UDP, and the default is TCP.
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+          "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
+              #
+              # When the load balancing scheme is INTERNAL, this field is not used.
+          "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+          "loadBalancingScheme": "A String",
+          "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
+              #
+              # When the load balancing scheme is INTERNAL, this field is not used.
+          "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
+              #
+              # This cannot be used for internal load balancing.
+          "backends": [ # The list of backends that serve this BackendService.
+            { # Message containing information of one individual backend.
+              "group": "A String", # The fully-qualified URL of a zonal Instance Group resource. This instance group defines the list of instances that serve traffic. Member virtual machine instances from each instance group must live in the same zone as the instance group itself. No two backends in a backend service are allowed to use same Instance Group resource.
+                  #
+                  # Note that you must specify an Instance Group resource using the fully-qualified URL, rather than a partial URL.
+                  #
+                  # When the BackendService has load balancing scheme INTERNAL, the instance group must be in a zone within the same region as the BackendService.
+              "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+              "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
+                  #
+                  # This cannot be used for internal load balancing.
+              "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+                  #
+                  # This cannot be used for internal load balancing.
+              "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+                  #
+                  # This cannot be used for internal load balancing.
+              "capacityScaler": 3.14, # A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group will serve up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available Capacity. Valid range is [0.0,1.0].
+                  #
+                  # This cannot be used for internal load balancing.
+              "maxRate": 42, # The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+                  #
+                  # This cannot be used for internal load balancing.
+              "maxConnections": 42, # The max number of simultaneous connections for the group. Can be used with either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+                  #
+                  # This cannot be used for internal load balancing.
+              "balancingMode": "A String", # Specifies the balancing mode for this backend. For global HTTP(S) or TCP/SSL load balancing, the default is UTILIZATION. Valid values are UTILIZATION, RATE (for HTTP(S)) and CONNECTION (for TCP/SSL).
+                  #
+                  # This cannot be used for internal load balancing.
+            },
+          ],
+          "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
+          "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
+              #
+              # When the load balancing scheme is INTERNAL, this field is not used.
+          "healthChecks": [ # The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService. Currently at most one health check can be specified, and a health check is required.
+              #
+              # For internal load balancing, a URL to a HealthCheck resource must be specified instead.
+            "A String",
+          ],
+          "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+              #
+              # When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP, or GENERATED_COOKIE.
+              #
+              # When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.
+              #
+              # When the protocol is UDP, this field is not used.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+        },
+    ],
+    "kind": "compute#backendServiceList", # [Output Only] Type of resource. Always compute#backendServiceList for lists of backend services.
+    "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(project, region, backendService, body)</code>
+  <pre>Updates the specified regional BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read  Restrictions and Guidelines for more information. This method supports patch semantics.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService resource to update. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # A BackendService resource. This resource defines a group of backend virtual machines and their serving capacity.
+    "connectionDraining": { # Message containing connection draining configuration.
+      "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
+    },
+    "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
+    "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+        # 
+        # Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. The default is HTTP.
+        # 
+        # For internal load balancing, the possible values are TCP and UDP, and the default is TCP.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "loadBalancingScheme": "A String",
+    "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
+        # 
+        # This cannot be used for internal load balancing.
+    "backends": [ # The list of backends that serve this BackendService.
+      { # Message containing information of one individual backend.
+        "group": "A String", # The fully-qualified URL of a zonal Instance Group resource. This instance group defines the list of instances that serve traffic. Member virtual machine instances from each instance group must live in the same zone as the instance group itself. No two backends in a backend service are allowed to use same Instance Group resource.
+            #
+            # Note that you must specify an Instance Group resource using the fully-qualified URL, rather than a partial URL.
+            #
+            # When the BackendService has load balancing scheme INTERNAL, the instance group must be in a zone within the same region as the BackendService.
+        "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+        "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
+            #
+            # This cannot be used for internal load balancing.
+        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "capacityScaler": 3.14, # A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group will serve up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available Capacity. Valid range is [0.0,1.0].
+            #
+            # This cannot be used for internal load balancing.
+        "maxRate": 42, # The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "maxConnections": 42, # The max number of simultaneous connections for the group. Can be used with either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "balancingMode": "A String", # Specifies the balancing mode for this backend. For global HTTP(S) or TCP/SSL load balancing, the default is UTILIZATION. Valid values are UTILIZATION, RATE (for HTTP(S)) and CONNECTION (for TCP/SSL).
+            #
+            # This cannot be used for internal load balancing.
+      },
+    ],
+    "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
+    "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "healthChecks": [ # The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService. Currently at most one health check can be specified, and a health check is required.
+        # 
+        # For internal load balancing, a URL to a HealthCheck resource must be specified instead.
+      "A String",
+    ],
+    "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+        # 
+        # When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP, or GENERATED_COOKIE.
+        # 
+        # When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.
+        # 
+        # When the protocol is UDP, this field is not used.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(project, region, backendService, body)</code>
+  <pre>Updates the specified regional BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read  Restrictions and Guidelines for more information.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  backendService: string, Name of the BackendService resource to update. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # A BackendService resource. This resource defines a group of backend virtual machines and their serving capacity.
+    "connectionDraining": { # Message containing connection draining configuration.
+      "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
+    },
+    "kind": "compute#backendService", # [Output Only] Type of resource. Always compute#backendService for backend services.
+    "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
+        # 
+        # Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. The default is HTTP.
+        # 
+        # For internal load balancing, the possible values are TCP and UDP, and the default is TCP.
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "timeoutSec": 42, # How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
+    "enableCDN": True or False, # If true, enable Cloud CDN for this BackendService.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "region": "A String", # [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
+    "loadBalancingScheme": "A String",
+    "affinityCookieTtlSec": 42, # Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.
+        # 
+        # This cannot be used for internal load balancing.
+    "backends": [ # The list of backends that serve this BackendService.
+      { # Message containing information of one individual backend.
+        "group": "A String", # The fully-qualified URL of a zonal Instance Group resource. This instance group defines the list of instances that serve traffic. Member virtual machine instances from each instance group must live in the same zone as the instance group itself. No two backends in a backend service are allowed to use same Instance Group resource.
+            #
+            # Note that you must specify an Instance Group resource using the fully-qualified URL, rather than a partial URL.
+            #
+            # When the BackendService has load balancing scheme INTERNAL, the instance group must be in a zone within the same region as the BackendService.
+        "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+        "maxUtilization": 3.14, # Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].
+            #
+            # This cannot be used for internal load balancing.
+        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "capacityScaler": 3.14, # A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group will serve up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available Capacity. Valid range is [0.0,1.0].
+            #
+            # This cannot be used for internal load balancing.
+        "maxRate": 42, # The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "maxConnections": 42, # The max number of simultaneous connections for the group. Can be used with either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
+            #
+            # This cannot be used for internal load balancing.
+        "balancingMode": "A String", # Specifies the balancing mode for this backend. For global HTTP(S) or TCP/SSL load balancing, the default is UTILIZATION. Valid values are UTILIZATION, RATE (for HTTP(S)) and CONNECTION (for TCP/SSL).
+            #
+            # This cannot be used for internal load balancing.
+      },
+    ],
+    "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService.
+    "portName": "A String", # Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL.
+        # 
+        # When the load balancing scheme is INTERNAL, this field is not used.
+    "healthChecks": [ # The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService. Currently at most one health check can be specified, and a health check is required.
+        # 
+        # For internal load balancing, a URL to a HealthCheck resource must be specified instead.
+      "A String",
+    ],
+    "sessionAffinity": "A String", # Type of session affinity to use. The default is NONE.
+        # 
+        # When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP, or GENERATED_COOKIE.
+        # 
+        # When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.
+        # 
+        # When the protocol is UDP, this field is not used.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/compute_v1.regionInstanceGroupManagers.html b/docs/dyn/compute_v1.regionInstanceGroupManagers.html
new file mode 100644
index 00000000000..a73e04c6129
--- /dev/null
+++ b/docs/dyn/compute_v1.regionInstanceGroupManagers.html
@@ -0,0 +1,854 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.regionInstanceGroupManagers.html">regionInstanceGroupManagers</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#abandonInstances">abandonInstances(project, region, instanceGroupManager, body)</a></code></p>
+<p class="firstline">Schedules a group action to remove the specified instances from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.</p>
+<p class="toc_element">
+  <code><a href="#delete">delete(project, region, instanceGroupManager)</a></code></p>
+<p class="firstline">Deletes the specified managed instance group and all of the instances in that group.</p>
+<p class="toc_element">
+  <code><a href="#deleteInstances">deleteInstances(project, region, instanceGroupManager, body)</a></code></p>
+<p class="firstline">Schedules a group action to delete the specified instances in the managed instance group. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.</p>
+<p class="toc_element">
+  <code><a href="#get">get(project, region, instanceGroupManager)</a></code></p>
+<p class="firstline">Returns all of the details about the specified managed instance group.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(project, region, body)</a></code></p>
+<p class="firstline">Creates a managed instance group using the information that you specify in the request. After the group is created, it schedules an action to create instances in the group using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.</p>
+<p class="toc_element">
+  <code><a href="#list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves the list of managed instance groups that are contained within the specified region.</p>
+<p class="toc_element">
+  <code><a href="#listManagedInstances">listManagedInstances(project, region, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#recreateInstances">recreateInstances(project, region, instanceGroupManager, body)</a></code></p>
+<p class="firstline">Schedules a group action to recreate the specified instances in the managed instance group. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the action is scheduled even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method.</p>
+<p class="toc_element">
+  <code><a href="#resize">resize(project, region, instanceGroupManager, size)</a></code></p>
+<p class="firstline">Changes the intended size for the managed instance group. If you increase the size, the group schedules actions to create new instances using the current instance template. If you decrease the size, the group schedules delete actions on one or more instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.</p>
+<p class="toc_element">
+  <code><a href="#setInstanceTemplate">setInstanceTemplate(project, region, instanceGroupManager, body)</a></code></p>
+<p class="firstline">Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected.</p>
+<p class="toc_element">
+  <code><a href="#setTargetPools">setTargetPools(project, region, instanceGroupManager, body)</a></code></p>
+<p class="firstline">Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="abandonInstances">abandonInstances(project, region, instanceGroupManager, body)</code>
+  <pre>Schedules a group action to remove the specified instances from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "instances": [ # The names of one or more instances to abandon.
+      "A String",
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="delete">delete(project, region, instanceGroupManager)</code>
+  <pre>Deletes the specified managed instance group and all of the instances in that group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group to delete. (required)
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="deleteInstances">deleteInstances(project, region, instanceGroupManager, body)</code>
+  <pre>Schedules a group action to delete the specified instances in the managed instance group. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "instances": [ # The names of one or more instances to delete.
+      "A String",
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(project, region, instanceGroupManager)</code>
+  <pre>Returns all of the details about the specified managed instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group to return. (required)
+
+Returns:
+  An object of the form:
+
+    { # An Instance Group Manager resource.
+      "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+        "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+        "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+        "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+            #
+            # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+        "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+        "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+        "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+        "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+        "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+      },
+      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+      "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+      "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+      "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+      "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+      "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+        "A String",
+      ],
+      "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
+      "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+      "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+      "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
+        { # The named port. For example: .
+          "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
+          "port": 42, # The port number, which can be a value between 1 and 65535.
+        },
+      ],
+      "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+      "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+      "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+      "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(project, region, body)</code>
+  <pre>Creates a managed instance group using the information that you specify in the request. After the group is created, it schedules an action to create instances in the group using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # An Instance Group Manager resource.
+    "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+      "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+      "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+      "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+          #
+          # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+      "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+      "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+      "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+      "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+      "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+    },
+    "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+    "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+    "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+    "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+    "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+    "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+    "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+      "A String",
+    ],
+    "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
+    "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+    "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+    "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
+      { # The named port. For example: .
+        "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
+        "port": 42, # The port number, which can be a value between 1 and 65535.
+      },
+    ],
+    "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+    "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+    "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+    "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves the list of managed instance groups that are contained within the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of managed instance groups.
+    "nextPageToken": "A String", # [Output only] A token used to continue a truncated list request.
+    "items": [ # A list of managed instance groups.
+      { # An Instance Group Manager resource.
+          "currentActions": { # [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.
+            "none": 42, # [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.
+            "recreating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.
+            "creating": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully.
+                #
+                # If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.
+            "restarting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.
+            "abandoning": 42, # [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.
+            "deleting": 42, # [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.
+            "creatingWithoutRetries": 42, # [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.
+            "refreshing": 42, # [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.
+          },
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "zone": "A String", # [Output Only] The URL of the zone where the managed instance group is located (for zonal resources).
+          "targetSize": 42, # The target number of running instances for this managed instance group. Deleting or abandoning instances reduces this number. Resizing the group changes this number.
+          "region": "A String", # [Output Only] The URL of the region where the managed instance group resides (for regional resources).
+          "instanceGroup": "A String", # [Output Only] The URL of the Instance Group resource.
+          "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
+          "targetPools": [ # The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+            "A String",
+          ],
+          "baseInstanceName": "A String", # The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.
+          "fingerprint": "A String", # [Output Only] The fingerprint of the resource data. You can use this optional field for optimistic locking when you update the resource.
+          "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group.
+          "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
+            { # The named port. For example: .
+              "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
+              "port": 42, # The port number, which can be a value between 1 and 65535.
+            },
+          ],
+          "creationTimestamp": "A String", # [Output Only] The creation timestamp for this managed instance group in RFC3339 text format.
+          "id": "A String", # [Output Only] A unique identifier for this resource type. The server generates this identifier.
+          "selfLink": "A String", # [Output Only] The URL for this managed instance group. The server defines this URL.
+          "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
+        },
+    ],
+    "kind": "compute#regionInstanceGroupManagerList", # [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups that exist in th regional scope.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output only] The URL for this resource type. The server generates this URL.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="listManagedInstances">listManagedInstances(project, region, instanceGroupManager, order_by=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  order_by: string, A parameter
+  maxResults: integer, A parameter
+  pageToken: string, A parameter
+  filter: string, A parameter
+
+Returns:
+  An object of the form:
+
+    {
+    "managedInstances": [ # List of managed instances.
+      {
+        "currentAction": "A String", # [Output Only] The current action that the managed instance group has scheduled for the instance. Possible values:
+            # - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance.
+            # - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful.
+            # - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead.
+            # - RECREATING The managed instance group is recreating this instance.
+            # - DELETING The managed instance group is permanently deleting this instance.
+            # - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group.
+            # - RESTARTING The managed instance group is restarting the instance.
+            # - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance.
+        "instance": "A String", # [Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created.
+        "lastAttempt": { # [Output Only] Information about the last attempt to create or delete the instance.
+          "errors": { # [Output Only] Encountered errors during the last attempt to create or delete the instance.
+            "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+              {
+                "message": "A String", # [Output Only] An optional, human-readable error message.
+                "code": "A String", # [Output Only] The error type identifier for this error.
+                "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+              },
+            ],
+          },
+        },
+        "id": "A String", # [Output only] The unique identifier for this resource. This field is empty when instance does not exist.
+        "instanceStatus": "A String", # [Output Only] The status of the instance. This field is empty when the instance does not exist.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="recreateInstances">recreateInstances(project, region, instanceGroupManager, body)</code>
+  <pre>Schedules a group action to recreate the specified instances in the managed instance group. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the action is scheduled even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "instances": [ # The URL for one or more instances to recreate.
+      "A String",
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="resize">resize(project, region, instanceGroupManager, size)</code>
+  <pre>Changes the intended size for the managed instance group. If you increase the size, the group schedules actions to create new instances using the current instance template. If you decrease the size, the group schedules delete actions on one or more instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  size: integer, Number of instances that should exist in this instance group manager. (required)
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="setInstanceTemplate">setInstanceTemplate(project, region, instanceGroupManager, body)</code>
+  <pre>Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, The name of the managed instance group. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "instanceTemplate": "A String", # URL of the InstanceTemplate resource from which all new instances will be created.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="setTargetPools">setTargetPools(project, region, instanceGroupManager, body)</code>
+  <pre>Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroupManager: string, Name of the managed instance group. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "targetPools": [ # The URL of all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.
+      "A String",
+    ],
+    "fingerprint": "A String", # Fingerprint of the target pools information, which is a hash of the contents. This field is used for optimistic locking when you update the target pool entries. This field is optional.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/compute_v1.regionInstanceGroups.html b/docs/dyn/compute_v1.regionInstanceGroups.html
new file mode 100644
index 00000000000..e0980863cde
--- /dev/null
+++ b/docs/dyn/compute_v1.regionInstanceGroups.html
@@ -0,0 +1,351 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.regionInstanceGroups.html">regionInstanceGroups</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(project, region, instanceGroup)</a></code></p>
+<p class="firstline">Returns the specified instance group resource.</p>
+<p class="toc_element">
+  <code><a href="#list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Retrieves the list of instance group resources contained within the specified region.</p>
+<p class="toc_element">
+  <code><a href="#listInstances">listInstances(project, region, instanceGroup, body, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
+<p class="firstline">Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running.</p>
+<p class="toc_element">
+  <code><a href="#listInstances_next">listInstances_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#setNamedPorts">setNamedPorts(project, region, instanceGroup, body)</a></code></p>
+<p class="firstline">Sets the named ports for the specified regional instance group.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(project, region, instanceGroup)</code>
+  <pre>Returns the specified instance group resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroup: string, Name of the instance group resource to return. (required)
+
+Returns:
+  An object of the form:
+
+    {
+      "size": 42, # [Output Only] The total number of instances in the instance group.
+      "kind": "compute#instanceGroup", # [Output Only] The resource type, which is always compute#instanceGroup for instance groups.
+      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "zone": "A String", # [Output Only] The URL of the zone where the instance group is located (for zonal resources).
+      "region": "A String", # The URL of the region where the instance group is located (for regional resources).
+      "network": "A String", # The URL of the network to which all instances in the instance group belong.
+      "fingerprint": "A String", # [Output Only] The fingerprint of the named ports. The system uses this fingerprint to detect conflicts when multiple users change the named ports concurrently.
+      "subnetwork": "A String", # The URL of the subnetwork to which all instances in the instance group belong.
+      "namedPorts": [ # Assigns a name to a port number. For example: {name: "http", port: 80}
+          #
+          # This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "http", port: 80},{name: "http", port: 8080}]
+          #
+          # Named ports apply to all instances in this instance group.
+        { # The named port. For example: .
+          "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
+          "port": 42, # The port number, which can be a value between 1 and 65535.
+        },
+      ],
+      "creationTimestamp": "A String", # [Output Only] The creation timestamp for this instance group in RFC3339 text format.
+      "id": "A String", # [Output Only] A unique identifier for this instance group, generated by the server.
+      "selfLink": "A String", # [Output Only] The URL for this instance group. The server generates this URL.
+      "name": "A String", # The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(project, region, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Retrieves the list of instance group resources contained within the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of InstanceGroup resources.
+    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+    "items": [ # A list of InstanceGroup resources.
+      {
+          "size": 42, # [Output Only] The total number of instances in the instance group.
+          "kind": "compute#instanceGroup", # [Output Only] The resource type, which is always compute#instanceGroup for instance groups.
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "zone": "A String", # [Output Only] The URL of the zone where the instance group is located (for zonal resources).
+          "region": "A String", # The URL of the region where the instance group is located (for regional resources).
+          "network": "A String", # The URL of the network to which all instances in the instance group belong.
+          "fingerprint": "A String", # [Output Only] The fingerprint of the named ports. The system uses this fingerprint to detect conflicts when multiple users change the named ports concurrently.
+          "subnetwork": "A String", # The URL of the subnetwork to which all instances in the instance group belong.
+          "namedPorts": [ # Assigns a name to a port number. For example: {name: "http", port: 80}
+              #
+              # This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "http", port: 80},{name: "http", port: 8080}]
+              #
+              # Named ports apply to all instances in this instance group.
+            { # The named port. For example: .
+              "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
+              "port": 42, # The port number, which can be a value between 1 and 65535.
+            },
+          ],
+          "creationTimestamp": "A String", # [Output Only] The creation timestamp for this instance group in RFC3339 text format.
+          "id": "A String", # [Output Only] A unique identifier for this instance group, generated by the server.
+          "selfLink": "A String", # [Output Only] The URL for this instance group. The server generates this URL.
+          "name": "A String", # The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035.
+        },
+    ],
+    "kind": "compute#regionInstanceGroupList", # The resource type.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "selfLink": "A String", # [Output Only] The URL for this resource type. The server generates this URL.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="listInstances">listInstances(project, region, instanceGroup, body, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
+  <pre>Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroup: string, Name of the regional instance group for which we want to list the instances. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "portName": "A String", # Name of port user is interested in. It is optional. If it is set, only information about this ports will be returned. If it is not set, all the named ports will be returned. Always lists all instances.
+    "instanceState": "A String", # Instances in which state should be returned. Valid options are: 'ALL', 'RUNNING'. By default, it lists all instances.
+  }
+
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
+  pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
+  filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
+
+The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.
+
+You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
+
+To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
+
+Returns:
+  An object of the form:
+
+    {
+    "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+    "items": [ # A list of instances and any named ports that are assigned to those instances.
+      {
+        "status": "A String", # [Output Only] The status of the instance.
+        "instance": "A String", # [Output Only] The URL of the instance.
+        "namedPorts": [ # [Output Only] The named ports that belong to this instance group.
+          { # The named port. For example: .
+            "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
+            "port": 42, # The port number, which can be a value between 1 and 65535.
+          },
+        ],
+      },
+    ],
+    "kind": "compute#regionInstanceGroupsListInstances", # The resource type.
+    "id": "A String", # [Output Only] Unique identifier for the resource. Defined by the server.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="listInstances_next">listInstances_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="setNamedPorts">setNamedPorts(project, region, instanceGroup, body)</code>
+  <pre>Sets the named ports for the specified regional instance group.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  instanceGroup: string, The name of the regional instance group where the named ports are updated. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "namedPorts": [ # The list of named ports to set for this instance group.
+      { # The named port. For example: .
+        "name": "A String", # The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.
+        "port": 42, # The port number, which can be a value between 1 and 65535.
+      },
+    ],
+    "fingerprint": "A String", # The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/compute_v1.regionOperations.html b/docs/dyn/compute_v1.regionOperations.html
index 1f37609ea1b..53f83c55a5e 100644
--- a/docs/dyn/compute_v1.regionOperations.html
+++ b/docs/dyn/compute_v1.regionOperations.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_v1.regions.html b/docs/dyn/compute_v1.regions.html
index a89d89e8317..5945c8e0204 100644
--- a/docs/dyn/compute_v1.regions.html
+++ b/docs/dyn/compute_v1.regions.html
@@ -100,10 +100,10 @@ <h3>Method Details</h3>
     "kind": "compute#region", # [Output Only] Type of the resource. Always compute#region for regions.
     "description": "A String", # [Output Only] Textual description of the resource.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this region.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "quotas": [ # [Output Only] Quotas assigned to this region.
@@ -157,10 +157,10 @@ <h3>Method Details</h3>
         "kind": "compute#region", # [Output Only] Type of the resource. Always compute#region for regions.
         "description": "A String", # [Output Only] Textual description of the resource.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this region.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "quotas": [ # [Output Only] Quotas assigned to this region.
diff --git a/docs/dyn/compute_v1.routers.html b/docs/dyn/compute_v1.routers.html
index 155ca21f0b8..7466d4caf6d 100644
--- a/docs/dyn/compute_v1.routers.html
+++ b/docs/dyn/compute_v1.routers.html
@@ -258,7 +258,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -505,7 +505,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -679,7 +679,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -852,7 +852,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.routes.html b/docs/dyn/compute_v1.routes.html
index c42e09ea9b4..aafc04cf45c 100644
--- a/docs/dyn/compute_v1.routes.html
+++ b/docs/dyn/compute_v1.routes.html
@@ -144,7 +144,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -292,7 +292,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.snapshots.html b/docs/dyn/compute_v1.snapshots.html
index e038b1fc320..5eeeb5c82fd 100644
--- a/docs/dyn/compute_v1.snapshots.html
+++ b/docs/dyn/compute_v1.snapshots.html
@@ -143,7 +143,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.sslCertificates.html b/docs/dyn/compute_v1.sslCertificates.html
index e2fec84647f..79fe9fdf4ae 100644
--- a/docs/dyn/compute_v1.sslCertificates.html
+++ b/docs/dyn/compute_v1.sslCertificates.html
@@ -144,7 +144,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -163,7 +163,7 @@ <h3>Method Details</h3>
       "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
       "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
       "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-      "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+      "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
       "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
       "selfLink": "A String", # [Output only] Server-defined URL for the resource.
@@ -184,7 +184,7 @@ <h3>Method Details</h3>
     "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
     "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
     "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-    "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+    "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
     "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
     "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
     "selfLink": "A String", # [Output only] Server-defined URL for the resource.
@@ -238,7 +238,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -275,7 +275,7 @@ <h3>Method Details</h3>
           "kind": "compute#sslCertificate", # [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.
           "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
           "certificate": "A String", # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
-          "privateKey": "A String", # A write-only private key in PEM format. Only insert RPCs will include this field.
+          "privateKey": "A String", # A write-only private key in PEM format. Only insert requests will include this field.
           "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
           "selfLink": "A String", # [Output only] Server-defined URL for the resource.
diff --git a/docs/dyn/compute_v1.subnetworks.html b/docs/dyn/compute_v1.subnetworks.html
index 4d52f0f5550..9ff1e95d3e0 100644
--- a/docs/dyn/compute_v1.subnetworks.html
+++ b/docs/dyn/compute_v1.subnetworks.html
@@ -83,6 +83,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#delete">delete(project, region, subnetwork)</a></code></p>
 <p class="firstline">Deletes the specified subnetwork.</p>
+<p class="toc_element">
+  <code><a href="#expandIpCidrRange">expandIpCidrRange(project, region, subnetwork, body)</a></code></p>
+<p class="firstline">Expands the IP CIDR range of the subnetwork to a specified value.</p>
 <p class="toc_element">
   <code><a href="#get">get(project, region, subnetwork)</a></code></p>
 <p class="firstline">Returns the specified subnetwork. Get a list of available subnetworks list() request.</p>
@@ -228,7 +231,73 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="expandIpCidrRange">expandIpCidrRange(project, region, subnetwork, body)</code>
+  <pre>Expands the IP CIDR range of the subnetwork to a specified value.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  subnetwork: string, Name of the Subnetwork resource to update. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "ipCidrRange": "A String", # The IP (in CIDR format or netmask) of internal addresses that are legal on this Subnetwork. This range should be disjoint from other subnetworks within this network. This range can only be larger than (i.e. a superset of) the range previously defined before the update.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operation resource, used to manage asynchronous API requests.
+    "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+    "clientOperationId": "A String", # [Output Only] Reserved for future use.
+    "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+    "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+    "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.
+    "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+    "operationType": "A String", # [Output Only] The type of operation, such as insert, update, or delete, and so on.
+    "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.
+    "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+    "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a 404 means the resource was not found.
+    "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+    "status": "A String", # [Output Only] The status of the operation, which can be one of the following: PENDING, RUNNING, or DONE.
+    "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+    "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+      {
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example:
+            # "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          },
+        ],
+      },
+    ],
+    "user": "A String", # [Output Only] User who requested the operation, for example: user@example.com.
+    "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+    "kind": "compute#operation", # [Output Only] Type of the resource. Always compute#operation for Operation resources.
+    "name": "A String", # [Output Only] Name of the resource.
+    "region": "A String", # [Output Only] The URL of the region where the operation resides. Only available when performing regional operations.
+    "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+      "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+        {
+          "message": "A String", # [Output Only] An optional, human-readable error message.
+          "code": "A String", # [Output Only] The error type identifier for this error.
+          "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        },
+      ],
+    },
+    "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -328,7 +397,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.targetHttpProxies.html b/docs/dyn/compute_v1.targetHttpProxies.html
index 75d76fff4da..a5f3379e50d 100644
--- a/docs/dyn/compute_v1.targetHttpProxies.html
+++ b/docs/dyn/compute_v1.targetHttpProxies.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -239,7 +239,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -363,7 +363,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.targetHttpsProxies.html b/docs/dyn/compute_v1.targetHttpsProxies.html
index f252cf0e032..c3b8cae1644 100644
--- a/docs/dyn/compute_v1.targetHttpsProxies.html
+++ b/docs/dyn/compute_v1.targetHttpsProxies.html
@@ -150,7 +150,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -254,7 +254,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -386,7 +386,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -451,7 +451,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.targetInstances.html b/docs/dyn/compute_v1.targetInstances.html
index c8c988283d9..b89ef3d36af 100644
--- a/docs/dyn/compute_v1.targetInstances.html
+++ b/docs/dyn/compute_v1.targetInstances.html
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -334,7 +334,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.targetPools.html b/docs/dyn/compute_v1.targetPools.html
index a2272ad9b66..dd70efb3c13 100644
--- a/docs/dyn/compute_v1.targetPools.html
+++ b/docs/dyn/compute_v1.targetPools.html
@@ -183,7 +183,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -256,7 +256,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -409,7 +409,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -575,7 +575,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -731,7 +731,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -801,7 +801,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -868,7 +868,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.targetSslProxies.html b/docs/dyn/compute_v1.targetSslProxies.html
index 91e8850ae3d..30021353644 100644
--- a/docs/dyn/compute_v1.targetSslProxies.html
+++ b/docs/dyn/compute_v1.targetSslProxies.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -253,7 +253,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -381,7 +381,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -446,7 +446,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -513,7 +513,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.targetVpnGateways.html b/docs/dyn/compute_v1.targetVpnGateways.html
index 781e38e2153..5f8f8340b84 100644
--- a/docs/dyn/compute_v1.targetVpnGateways.html
+++ b/docs/dyn/compute_v1.targetVpnGateways.html
@@ -233,7 +233,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -343,7 +343,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.urlMaps.html b/docs/dyn/compute_v1.urlMaps.html
index 9857a33b88e..f41378ad1c7 100644
--- a/docs/dyn/compute_v1.urlMaps.html
+++ b/docs/dyn/compute_v1.urlMaps.html
@@ -156,7 +156,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -320,7 +320,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -336,6 +336,7 @@ <h3>Method Details</h3>
 
 {
     "path": "A String",
+    "host": "A String", # If set, this invalidation rule will only apply to requests with a Host header matching host.
   }
 
 
@@ -385,7 +386,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -587,7 +588,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -694,7 +695,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.vpnTunnels.html b/docs/dyn/compute_v1.vpnTunnels.html
index 1198a10f0a9..31541f761b2 100644
--- a/docs/dyn/compute_v1.vpnTunnels.html
+++ b/docs/dyn/compute_v1.vpnTunnels.html
@@ -239,7 +239,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -361,7 +361,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/compute_v1.zoneOperations.html b/docs/dyn/compute_v1.zoneOperations.html
index e056a116bce..7988522abfd 100644
--- a/docs/dyn/compute_v1.zoneOperations.html
+++ b/docs/dyn/compute_v1.zoneOperations.html
@@ -153,7 +153,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
     "kind": "compute#operationList", # [Output Only] Type of resource. Always compute#operations for Operations resource.
diff --git a/docs/dyn/compute_v1.zones.html b/docs/dyn/compute_v1.zones.html
index 5981a1a4d0b..f34034f8237 100644
--- a/docs/dyn/compute_v1.zones.html
+++ b/docs/dyn/compute_v1.zones.html
@@ -100,10 +100,10 @@ <h3>Method Details</h3>
     "kind": "compute#zone", # [Output Only] Type of the resource. Always compute#zone for zones.
     "description": "A String", # [Output Only] Textual description of the resource.
     "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
-      "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+      "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+      "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
       "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+      "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
       "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
     },
     "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
@@ -148,10 +148,10 @@ <h3>Method Details</h3>
         "kind": "compute#zone", # [Output Only] Type of the resource. Always compute#zone for zones.
         "description": "A String", # [Output Only] Textual description of the resource.
         "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
-          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
-          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
+          "deleted": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.
+          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
           "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
-          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
+          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
           "replacement": "A String", # The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
         },
         "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
diff --git a/docs/dyn/consumersurveys_v2.mobileapppanels.html b/docs/dyn/consumersurveys_v2.mobileapppanels.html
index da0d114deff..79a74e74a41 100644
--- a/docs/dyn/consumersurveys_v2.mobileapppanels.html
+++ b/docs/dyn/consumersurveys_v2.mobileapppanels.html
@@ -94,15 +94,15 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Representation of an individual pre-defined panel object defining a targeted audience of opinion rewards mobile app users.
-    "owners": [ # List of email addresses for users who can target members of this panel. Must contain at least the address of the user making the API call for panels that are not public. This field will be empty for public panels.
+    {
+    "owners": [
       "A String",
     ],
-    "mobileAppPanelId": "A String", # Unique panel ID string. This corresponds to the mobile_app_panel_id used in Survey Insert requests.
-    "name": "A String", # Human readable name of the audience panel.
-    "language": "A String", # Language code that the panel can target. For instance, 'en-US'. Uses standard BCP47 language codes. See specification. Any survey created targeting this panel must also target the corresponding language.
-    "country": "A String", # Country code for the country of the users that the panel contains. Uses standard ISO 3166-1 2-character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom. Any survey created targeting this panel must also target the corresponding country.
-    "isPublicPanel": True or False, # Whether or not the panel is accessible to all API users.
+    "mobileAppPanelId": "A String",
+    "name": "A String",
+    "language": "A String",
+    "country": "A String",
+    "isPublicPanel": True or False,
   }</pre>
 </div>
 
@@ -129,15 +129,15 @@ <h3>Method Details</h3>
       "resultPerPage": 42,
     },
     "resources": [ # An individual predefined panel of Opinion Rewards mobile users.
-      { # Representation of an individual pre-defined panel object defining a targeted audience of opinion rewards mobile app users.
-        "owners": [ # List of email addresses for users who can target members of this panel. Must contain at least the address of the user making the API call for panels that are not public. This field will be empty for public panels.
+      {
+        "owners": [
           "A String",
         ],
-        "mobileAppPanelId": "A String", # Unique panel ID string. This corresponds to the mobile_app_panel_id used in Survey Insert requests.
-        "name": "A String", # Human readable name of the audience panel.
-        "language": "A String", # Language code that the panel can target. For instance, 'en-US'. Uses standard BCP47 language codes. See specification. Any survey created targeting this panel must also target the corresponding language.
-        "country": "A String", # Country code for the country of the users that the panel contains. Uses standard ISO 3166-1 2-character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom. Any survey created targeting this panel must also target the corresponding country.
-        "isPublicPanel": True or False, # Whether or not the panel is accessible to all API users.
+        "mobileAppPanelId": "A String",
+        "name": "A String",
+        "language": "A String",
+        "country": "A String",
+        "isPublicPanel": True or False,
       },
     ],
     "requestId": "A String", # Unique request ID used for logging and debugging. Please include in any error reporting or troubleshooting requests.
@@ -153,30 +153,30 @@ <h3>Method Details</h3>
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Representation of an individual pre-defined panel object defining a targeted audience of opinion rewards mobile app users.
-  "owners": [ # List of email addresses for users who can target members of this panel. Must contain at least the address of the user making the API call for panels that are not public. This field will be empty for public panels.
+{
+  "owners": [
     "A String",
   ],
-  "mobileAppPanelId": "A String", # Unique panel ID string. This corresponds to the mobile_app_panel_id used in Survey Insert requests.
-  "name": "A String", # Human readable name of the audience panel.
-  "language": "A String", # Language code that the panel can target. For instance, 'en-US'. Uses standard BCP47 language codes. See specification. Any survey created targeting this panel must also target the corresponding language.
-  "country": "A String", # Country code for the country of the users that the panel contains. Uses standard ISO 3166-1 2-character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom. Any survey created targeting this panel must also target the corresponding country.
-  "isPublicPanel": True or False, # Whether or not the panel is accessible to all API users.
+  "mobileAppPanelId": "A String",
+  "name": "A String",
+  "language": "A String",
+  "country": "A String",
+  "isPublicPanel": True or False,
 }
 
 
 Returns:
   An object of the form:
 
-    { # Representation of an individual pre-defined panel object defining a targeted audience of opinion rewards mobile app users.
-    "owners": [ # List of email addresses for users who can target members of this panel. Must contain at least the address of the user making the API call for panels that are not public. This field will be empty for public panels.
+    {
+    "owners": [
       "A String",
     ],
-    "mobileAppPanelId": "A String", # Unique panel ID string. This corresponds to the mobile_app_panel_id used in Survey Insert requests.
-    "name": "A String", # Human readable name of the audience panel.
-    "language": "A String", # Language code that the panel can target. For instance, 'en-US'. Uses standard BCP47 language codes. See specification. Any survey created targeting this panel must also target the corresponding language.
-    "country": "A String", # Country code for the country of the users that the panel contains. Uses standard ISO 3166-1 2-character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom. Any survey created targeting this panel must also target the corresponding country.
-    "isPublicPanel": True or False, # Whether or not the panel is accessible to all API users.
+    "mobileAppPanelId": "A String",
+    "name": "A String",
+    "language": "A String",
+    "country": "A String",
+    "isPublicPanel": True or False,
   }</pre>
 </div>
 
diff --git a/docs/dyn/consumersurveys_v2.results.html b/docs/dyn/consumersurveys_v2.results.html
index 713ea0a80ff..1cfc415a590 100644
--- a/docs/dyn/consumersurveys_v2.results.html
+++ b/docs/dyn/consumersurveys_v2.results.html
@@ -91,9 +91,9 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Reference to the current results for a given survey.
-    "status": "A String", # Human readable string describing the status of the request.
-    "surveyUrlId": "A String", # External survey ID as viewable by survey owners in the editor view.
+    {
+    "status": "A String",
+    "surveyUrlId": "A String",
   }</pre>
 </div>
 
diff --git a/docs/dyn/consumersurveys_v2.surveys.html b/docs/dyn/consumersurveys_v2.surveys.html
index 35155c7b764..1bfcda43447 100644
--- a/docs/dyn/consumersurveys_v2.surveys.html
+++ b/docs/dyn/consumersurveys_v2.surveys.html
@@ -121,72 +121,72 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Representation of an individual survey object.
-      "owners": [ # List of email addresses for survey owners. Must contain at least the address of the user making the API call.
+    {
+      "owners": [
         "A String",
       ],
-      "description": "A String", # Text description of the survey.
-      "title": "A String", # Optional name that will be given to the survey.
-      "customerData": "A String", # Additional information to store on behalf of the API consumer and associate with this question. This binary blob is treated as opaque. This field is limited to 64K bytes.
-      "state": "A String", # State that the survey is in.
-      "audience": { # Specifications for the target audience of a survey run through the API. # Targeting-criteria message containing demographic information
-        "countrySubdivision": "A String", # Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).
-        "mobileAppPanelId": "A String", # Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.
-        "country": "A String", # Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.
-        "ages": [ # Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']
+      "description": "A String",
+      "title": "A String",
+      "customerData": "A String",
+      "state": "A String",
+      "audience": {
+        "countrySubdivision": "A String",
+        "mobileAppPanelId": "A String",
+        "country": "A String",
+        "ages": [
           "A String",
         ],
-        "populationSource": "A String", # Online population source where the respondents are sampled from.
-        "languages": [ # Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.
+        "populationSource": "A String",
+        "languages": [
           "A String",
         ],
-        "gender": "A String", # Optional gender to target.
+        "gender": "A String",
       },
-      "cost": { # Message defining the cost to run a given survey through API. # Cost to run the survey and collect the necessary number of responses.
-        "nanos": "A String", # Cost of survey in nano units of the given currency. DEPRECATED in favor of cost_per_response_nanos
-        "currencyCode": "A String", # Currency code that the cost is given in.
-        "costPerResponseNanos": "A String", # Cost per survey response in nano units of the given currency. To get the total cost for a survey, multiply this value by wanted_response_count.
-        "maxCostPerResponseNanos": "A String", # Threshold to start a survey automatically if the quoted price is at most this value. When a survey has a Screener (threshold) question, it must go through an incidence pricing test to determine the final cost per response. Typically you will have to make a followup call to start the survey giving the final computed cost per response. If the survey has no threshold_answers, setting this property will return an error. By specifying this property, you indicate the max price per response you are willing to pay in advance of the incidence test. If the price turns out to be lower than the specified value, the survey will begin immediately and you will be charged at the rate determined by the incidence pricing test. If the price turns out to be greater than the specified value the survey will not be started and you will instead be notified what price was determined by the incidence test. At that point, you must raise the value of this property to be greater than or equal to that cost before attempting to start the survey again. This will immediately start the survey as long the incidence test was run within the last 21 days.
+      "cost": {
+        "nanos": "A String",
+        "currencyCode": "A String",
+        "costPerResponseNanos": "A String",
+        "maxCostPerResponseNanos": "A String",
       },
-      "surveyUrlId": "A String", # Unique survey ID, that is viewable in the URL of the Survey Creator UI
-      "questions": [ # List of questions defining the survey.
-        { # Message defining the question specifications.
-          "highValueLabel": "A String", # For rating questions, the text for the higher end of the scale, such as 'Best'. For numeric questions, a string representing a floating-point that is the maximum allowed number for a response.
-          "mustPickSuggestion": True or False, # Option to force the user to pick one of the open text suggestions. This requires that suggestions are provided for this question.
-          "thresholdAnswers": [ # The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.
+      "surveyUrlId": "A String",
+      "questions": [
+        {
+          "highValueLabel": "A String",
+          "mustPickSuggestion": True or False,
+          "thresholdAnswers": [
             "A String",
           ],
-          "sentimentText": "A String", # Used by the Rating Scale with Text question type. This text goes along with the question field that is presented to the respondent, and is the actual text that the respondent is asked to rate.
-          "question": "A String", # Required question text shown to the respondent.
-          "numStars": "A String", # Number of stars to use for ratings questions.
-          "lowValueLabel": "A String", # For rating questions, the text for the lower end of the scale, such as 'Worst'. For numeric questions, a string representing a floating-point that is the minimum allowed number for a response.
-          "videoId": "A String", # The YouTube video ID to be show in video questions.
-          "answers": [ # Required list of answer options for a question.
+          "sentimentText": "A String",
+          "question": "A String",
+          "numStars": "A String",
+          "lowValueLabel": "A String",
+          "videoId": "A String",
+          "answers": [
             "A String",
           ],
-          "lastAnswerPositionPinned": True or False, # Currently only support pinning an answer option to the last position.
-          "hasOther": True or False, # Option to allow open-ended text box for Single Answer and Multiple Answer question types. This can be used with SINGLE_ANSWER, SINGLE_ANSWER_WITH_IMAGE, MULTIPLE_ANSWERS, and MULTIPLE_ANSWERS_WITH_IMAGE question types.
-          "unitOfMeasurementLabel": "A String", # Optional unit of measurement for display (for example: hours, people, miles).
+          "lastAnswerPositionPinned": True or False,
+          "hasOther": True or False,
+          "unitOfMeasurementLabel": "A String",
           "images": [
-            { # Container object for image data and alt_text.
-              "url": "A String", # The read-only URL for the hosted images.
-              "altText": "A String", # The alt text property used in image tags is required for all images.
-              "data": "A String", # Inline jpeg, gif, tiff, bmp, or png image raw bytes for an image question types.
+            {
+              "url": "A String",
+              "altText": "A String",
+              "data": "A String",
             },
           ],
-          "singleLineResponse": True or False, # Option to allow multiple line open text responses instead of a single line response. Note that we don't show auto-complete suggestions with multiple line responses.
-          "openTextSuggestions": [ # A list of suggested answers for open text question auto-complete. This is only valid if single_line_response is true.
+          "singleLineResponse": True or False,
+          "openTextSuggestions": [
             "A String",
           ],
-          "type": "A String", # Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.
-          "answerOrder": "A String", # The randomization option for multiple choice and multi-select questions. If not specified, this option defaults to randomize.
-          "openTextPlaceholder": "A String", # Placeholder text for an open text question.
+          "type": "A String",
+          "answerOrder": "A String",
+          "openTextPlaceholder": "A String",
         },
       ],
-      "wantedResponseCount": 42, # Number of responses desired for the survey.
-      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
-        "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-        "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+      "wantedResponseCount": 42,
+      "rejectionReason": {
+        "explanation": "A String",
+        "type": "A String",
       },
     }</pre>
 </div>
@@ -199,72 +199,72 @@ <h3>Method Details</h3>
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Representation of an individual survey object.
-    "owners": [ # List of email addresses for survey owners. Must contain at least the address of the user making the API call.
+{
+    "owners": [
       "A String",
     ],
-    "description": "A String", # Text description of the survey.
-    "title": "A String", # Optional name that will be given to the survey.
-    "customerData": "A String", # Additional information to store on behalf of the API consumer and associate with this question. This binary blob is treated as opaque. This field is limited to 64K bytes.
-    "state": "A String", # State that the survey is in.
-    "audience": { # Specifications for the target audience of a survey run through the API. # Targeting-criteria message containing demographic information
-      "countrySubdivision": "A String", # Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).
-      "mobileAppPanelId": "A String", # Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.
-      "country": "A String", # Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.
-      "ages": [ # Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']
+    "description": "A String",
+    "title": "A String",
+    "customerData": "A String",
+    "state": "A String",
+    "audience": {
+      "countrySubdivision": "A String",
+      "mobileAppPanelId": "A String",
+      "country": "A String",
+      "ages": [
         "A String",
       ],
-      "populationSource": "A String", # Online population source where the respondents are sampled from.
-      "languages": [ # Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.
+      "populationSource": "A String",
+      "languages": [
         "A String",
       ],
-      "gender": "A String", # Optional gender to target.
+      "gender": "A String",
     },
-    "cost": { # Message defining the cost to run a given survey through API. # Cost to run the survey and collect the necessary number of responses.
-      "nanos": "A String", # Cost of survey in nano units of the given currency. DEPRECATED in favor of cost_per_response_nanos
-      "currencyCode": "A String", # Currency code that the cost is given in.
-      "costPerResponseNanos": "A String", # Cost per survey response in nano units of the given currency. To get the total cost for a survey, multiply this value by wanted_response_count.
-      "maxCostPerResponseNanos": "A String", # Threshold to start a survey automatically if the quoted price is at most this value. When a survey has a Screener (threshold) question, it must go through an incidence pricing test to determine the final cost per response. Typically you will have to make a followup call to start the survey giving the final computed cost per response. If the survey has no threshold_answers, setting this property will return an error. By specifying this property, you indicate the max price per response you are willing to pay in advance of the incidence test. If the price turns out to be lower than the specified value, the survey will begin immediately and you will be charged at the rate determined by the incidence pricing test. If the price turns out to be greater than the specified value the survey will not be started and you will instead be notified what price was determined by the incidence test. At that point, you must raise the value of this property to be greater than or equal to that cost before attempting to start the survey again. This will immediately start the survey as long the incidence test was run within the last 21 days.
+    "cost": {
+      "nanos": "A String",
+      "currencyCode": "A String",
+      "costPerResponseNanos": "A String",
+      "maxCostPerResponseNanos": "A String",
     },
-    "surveyUrlId": "A String", # Unique survey ID, that is viewable in the URL of the Survey Creator UI
-    "questions": [ # List of questions defining the survey.
-      { # Message defining the question specifications.
-        "highValueLabel": "A String", # For rating questions, the text for the higher end of the scale, such as 'Best'. For numeric questions, a string representing a floating-point that is the maximum allowed number for a response.
-        "mustPickSuggestion": True or False, # Option to force the user to pick one of the open text suggestions. This requires that suggestions are provided for this question.
-        "thresholdAnswers": [ # The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.
+    "surveyUrlId": "A String",
+    "questions": [
+      {
+        "highValueLabel": "A String",
+        "mustPickSuggestion": True or False,
+        "thresholdAnswers": [
           "A String",
         ],
-        "sentimentText": "A String", # Used by the Rating Scale with Text question type. This text goes along with the question field that is presented to the respondent, and is the actual text that the respondent is asked to rate.
-        "question": "A String", # Required question text shown to the respondent.
-        "numStars": "A String", # Number of stars to use for ratings questions.
-        "lowValueLabel": "A String", # For rating questions, the text for the lower end of the scale, such as 'Worst'. For numeric questions, a string representing a floating-point that is the minimum allowed number for a response.
-        "videoId": "A String", # The YouTube video ID to be show in video questions.
-        "answers": [ # Required list of answer options for a question.
+        "sentimentText": "A String",
+        "question": "A String",
+        "numStars": "A String",
+        "lowValueLabel": "A String",
+        "videoId": "A String",
+        "answers": [
           "A String",
         ],
-        "lastAnswerPositionPinned": True or False, # Currently only support pinning an answer option to the last position.
-        "hasOther": True or False, # Option to allow open-ended text box for Single Answer and Multiple Answer question types. This can be used with SINGLE_ANSWER, SINGLE_ANSWER_WITH_IMAGE, MULTIPLE_ANSWERS, and MULTIPLE_ANSWERS_WITH_IMAGE question types.
-        "unitOfMeasurementLabel": "A String", # Optional unit of measurement for display (for example: hours, people, miles).
+        "lastAnswerPositionPinned": True or False,
+        "hasOther": True or False,
+        "unitOfMeasurementLabel": "A String",
         "images": [
-          { # Container object for image data and alt_text.
-            "url": "A String", # The read-only URL for the hosted images.
-            "altText": "A String", # The alt text property used in image tags is required for all images.
-            "data": "A String", # Inline jpeg, gif, tiff, bmp, or png image raw bytes for an image question types.
+          {
+            "url": "A String",
+            "altText": "A String",
+            "data": "A String",
           },
         ],
-        "singleLineResponse": True or False, # Option to allow multiple line open text responses instead of a single line response. Note that we don't show auto-complete suggestions with multiple line responses.
-        "openTextSuggestions": [ # A list of suggested answers for open text question auto-complete. This is only valid if single_line_response is true.
+        "singleLineResponse": True or False,
+        "openTextSuggestions": [
           "A String",
         ],
-        "type": "A String", # Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.
-        "answerOrder": "A String", # The randomization option for multiple choice and multi-select questions. If not specified, this option defaults to randomize.
-        "openTextPlaceholder": "A String", # Placeholder text for an open text question.
+        "type": "A String",
+        "answerOrder": "A String",
+        "openTextPlaceholder": "A String",
       },
     ],
-    "wantedResponseCount": 42, # Number of responses desired for the survey.
-    "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
-      "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-      "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+    "wantedResponseCount": 42,
+    "rejectionReason": {
+      "explanation": "A String",
+      "type": "A String",
     },
   }
 
@@ -272,72 +272,72 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Representation of an individual survey object.
-      "owners": [ # List of email addresses for survey owners. Must contain at least the address of the user making the API call.
+    {
+      "owners": [
         "A String",
       ],
-      "description": "A String", # Text description of the survey.
-      "title": "A String", # Optional name that will be given to the survey.
-      "customerData": "A String", # Additional information to store on behalf of the API consumer and associate with this question. This binary blob is treated as opaque. This field is limited to 64K bytes.
-      "state": "A String", # State that the survey is in.
-      "audience": { # Specifications for the target audience of a survey run through the API. # Targeting-criteria message containing demographic information
-        "countrySubdivision": "A String", # Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).
-        "mobileAppPanelId": "A String", # Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.
-        "country": "A String", # Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.
-        "ages": [ # Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']
+      "description": "A String",
+      "title": "A String",
+      "customerData": "A String",
+      "state": "A String",
+      "audience": {
+        "countrySubdivision": "A String",
+        "mobileAppPanelId": "A String",
+        "country": "A String",
+        "ages": [
           "A String",
         ],
-        "populationSource": "A String", # Online population source where the respondents are sampled from.
-        "languages": [ # Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.
+        "populationSource": "A String",
+        "languages": [
           "A String",
         ],
-        "gender": "A String", # Optional gender to target.
+        "gender": "A String",
       },
-      "cost": { # Message defining the cost to run a given survey through API. # Cost to run the survey and collect the necessary number of responses.
-        "nanos": "A String", # Cost of survey in nano units of the given currency. DEPRECATED in favor of cost_per_response_nanos
-        "currencyCode": "A String", # Currency code that the cost is given in.
-        "costPerResponseNanos": "A String", # Cost per survey response in nano units of the given currency. To get the total cost for a survey, multiply this value by wanted_response_count.
-        "maxCostPerResponseNanos": "A String", # Threshold to start a survey automatically if the quoted price is at most this value. When a survey has a Screener (threshold) question, it must go through an incidence pricing test to determine the final cost per response. Typically you will have to make a followup call to start the survey giving the final computed cost per response. If the survey has no threshold_answers, setting this property will return an error. By specifying this property, you indicate the max price per response you are willing to pay in advance of the incidence test. If the price turns out to be lower than the specified value, the survey will begin immediately and you will be charged at the rate determined by the incidence pricing test. If the price turns out to be greater than the specified value the survey will not be started and you will instead be notified what price was determined by the incidence test. At that point, you must raise the value of this property to be greater than or equal to that cost before attempting to start the survey again. This will immediately start the survey as long the incidence test was run within the last 21 days.
+      "cost": {
+        "nanos": "A String",
+        "currencyCode": "A String",
+        "costPerResponseNanos": "A String",
+        "maxCostPerResponseNanos": "A String",
       },
-      "surveyUrlId": "A String", # Unique survey ID, that is viewable in the URL of the Survey Creator UI
-      "questions": [ # List of questions defining the survey.
-        { # Message defining the question specifications.
-          "highValueLabel": "A String", # For rating questions, the text for the higher end of the scale, such as 'Best'. For numeric questions, a string representing a floating-point that is the maximum allowed number for a response.
-          "mustPickSuggestion": True or False, # Option to force the user to pick one of the open text suggestions. This requires that suggestions are provided for this question.
-          "thresholdAnswers": [ # The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.
+      "surveyUrlId": "A String",
+      "questions": [
+        {
+          "highValueLabel": "A String",
+          "mustPickSuggestion": True or False,
+          "thresholdAnswers": [
             "A String",
           ],
-          "sentimentText": "A String", # Used by the Rating Scale with Text question type. This text goes along with the question field that is presented to the respondent, and is the actual text that the respondent is asked to rate.
-          "question": "A String", # Required question text shown to the respondent.
-          "numStars": "A String", # Number of stars to use for ratings questions.
-          "lowValueLabel": "A String", # For rating questions, the text for the lower end of the scale, such as 'Worst'. For numeric questions, a string representing a floating-point that is the minimum allowed number for a response.
-          "videoId": "A String", # The YouTube video ID to be show in video questions.
-          "answers": [ # Required list of answer options for a question.
+          "sentimentText": "A String",
+          "question": "A String",
+          "numStars": "A String",
+          "lowValueLabel": "A String",
+          "videoId": "A String",
+          "answers": [
             "A String",
           ],
-          "lastAnswerPositionPinned": True or False, # Currently only support pinning an answer option to the last position.
-          "hasOther": True or False, # Option to allow open-ended text box for Single Answer and Multiple Answer question types. This can be used with SINGLE_ANSWER, SINGLE_ANSWER_WITH_IMAGE, MULTIPLE_ANSWERS, and MULTIPLE_ANSWERS_WITH_IMAGE question types.
-          "unitOfMeasurementLabel": "A String", # Optional unit of measurement for display (for example: hours, people, miles).
+          "lastAnswerPositionPinned": True or False,
+          "hasOther": True or False,
+          "unitOfMeasurementLabel": "A String",
           "images": [
-            { # Container object for image data and alt_text.
-              "url": "A String", # The read-only URL for the hosted images.
-              "altText": "A String", # The alt text property used in image tags is required for all images.
-              "data": "A String", # Inline jpeg, gif, tiff, bmp, or png image raw bytes for an image question types.
+            {
+              "url": "A String",
+              "altText": "A String",
+              "data": "A String",
             },
           ],
-          "singleLineResponse": True or False, # Option to allow multiple line open text responses instead of a single line response. Note that we don't show auto-complete suggestions with multiple line responses.
-          "openTextSuggestions": [ # A list of suggested answers for open text question auto-complete. This is only valid if single_line_response is true.
+          "singleLineResponse": True or False,
+          "openTextSuggestions": [
             "A String",
           ],
-          "type": "A String", # Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.
-          "answerOrder": "A String", # The randomization option for multiple choice and multi-select questions. If not specified, this option defaults to randomize.
-          "openTextPlaceholder": "A String", # Placeholder text for an open text question.
+          "type": "A String",
+          "answerOrder": "A String",
+          "openTextPlaceholder": "A String",
         },
       ],
-      "wantedResponseCount": 42, # Number of responses desired for the survey.
-      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
-        "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-        "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+      "wantedResponseCount": 42,
+      "rejectionReason": {
+        "explanation": "A String",
+        "type": "A String",
       },
     }</pre>
 </div>
@@ -365,72 +365,72 @@ <h3>Method Details</h3>
       "resultPerPage": 42,
     },
     "resources": [ # An individual survey resource.
-      { # Representation of an individual survey object.
-          "owners": [ # List of email addresses for survey owners. Must contain at least the address of the user making the API call.
+      {
+          "owners": [
             "A String",
           ],
-          "description": "A String", # Text description of the survey.
-          "title": "A String", # Optional name that will be given to the survey.
-          "customerData": "A String", # Additional information to store on behalf of the API consumer and associate with this question. This binary blob is treated as opaque. This field is limited to 64K bytes.
-          "state": "A String", # State that the survey is in.
-          "audience": { # Specifications for the target audience of a survey run through the API. # Targeting-criteria message containing demographic information
-            "countrySubdivision": "A String", # Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).
-            "mobileAppPanelId": "A String", # Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.
-            "country": "A String", # Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.
-            "ages": [ # Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']
+          "description": "A String",
+          "title": "A String",
+          "customerData": "A String",
+          "state": "A String",
+          "audience": {
+            "countrySubdivision": "A String",
+            "mobileAppPanelId": "A String",
+            "country": "A String",
+            "ages": [
               "A String",
             ],
-            "populationSource": "A String", # Online population source where the respondents are sampled from.
-            "languages": [ # Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.
+            "populationSource": "A String",
+            "languages": [
               "A String",
             ],
-            "gender": "A String", # Optional gender to target.
+            "gender": "A String",
           },
-          "cost": { # Message defining the cost to run a given survey through API. # Cost to run the survey and collect the necessary number of responses.
-            "nanos": "A String", # Cost of survey in nano units of the given currency. DEPRECATED in favor of cost_per_response_nanos
-            "currencyCode": "A String", # Currency code that the cost is given in.
-            "costPerResponseNanos": "A String", # Cost per survey response in nano units of the given currency. To get the total cost for a survey, multiply this value by wanted_response_count.
-            "maxCostPerResponseNanos": "A String", # Threshold to start a survey automatically if the quoted price is at most this value. When a survey has a Screener (threshold) question, it must go through an incidence pricing test to determine the final cost per response. Typically you will have to make a followup call to start the survey giving the final computed cost per response. If the survey has no threshold_answers, setting this property will return an error. By specifying this property, you indicate the max price per response you are willing to pay in advance of the incidence test. If the price turns out to be lower than the specified value, the survey will begin immediately and you will be charged at the rate determined by the incidence pricing test. If the price turns out to be greater than the specified value the survey will not be started and you will instead be notified what price was determined by the incidence test. At that point, you must raise the value of this property to be greater than or equal to that cost before attempting to start the survey again. This will immediately start the survey as long the incidence test was run within the last 21 days.
+          "cost": {
+            "nanos": "A String",
+            "currencyCode": "A String",
+            "costPerResponseNanos": "A String",
+            "maxCostPerResponseNanos": "A String",
           },
-          "surveyUrlId": "A String", # Unique survey ID, that is viewable in the URL of the Survey Creator UI
-          "questions": [ # List of questions defining the survey.
-            { # Message defining the question specifications.
-              "highValueLabel": "A String", # For rating questions, the text for the higher end of the scale, such as 'Best'. For numeric questions, a string representing a floating-point that is the maximum allowed number for a response.
-              "mustPickSuggestion": True or False, # Option to force the user to pick one of the open text suggestions. This requires that suggestions are provided for this question.
-              "thresholdAnswers": [ # The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.
+          "surveyUrlId": "A String",
+          "questions": [
+            {
+              "highValueLabel": "A String",
+              "mustPickSuggestion": True or False,
+              "thresholdAnswers": [
                 "A String",
               ],
-              "sentimentText": "A String", # Used by the Rating Scale with Text question type. This text goes along with the question field that is presented to the respondent, and is the actual text that the respondent is asked to rate.
-              "question": "A String", # Required question text shown to the respondent.
-              "numStars": "A String", # Number of stars to use for ratings questions.
-              "lowValueLabel": "A String", # For rating questions, the text for the lower end of the scale, such as 'Worst'. For numeric questions, a string representing a floating-point that is the minimum allowed number for a response.
-              "videoId": "A String", # The YouTube video ID to be show in video questions.
-              "answers": [ # Required list of answer options for a question.
+              "sentimentText": "A String",
+              "question": "A String",
+              "numStars": "A String",
+              "lowValueLabel": "A String",
+              "videoId": "A String",
+              "answers": [
                 "A String",
               ],
-              "lastAnswerPositionPinned": True or False, # Currently only support pinning an answer option to the last position.
-              "hasOther": True or False, # Option to allow open-ended text box for Single Answer and Multiple Answer question types. This can be used with SINGLE_ANSWER, SINGLE_ANSWER_WITH_IMAGE, MULTIPLE_ANSWERS, and MULTIPLE_ANSWERS_WITH_IMAGE question types.
-              "unitOfMeasurementLabel": "A String", # Optional unit of measurement for display (for example: hours, people, miles).
+              "lastAnswerPositionPinned": True or False,
+              "hasOther": True or False,
+              "unitOfMeasurementLabel": "A String",
               "images": [
-                { # Container object for image data and alt_text.
-                  "url": "A String", # The read-only URL for the hosted images.
-                  "altText": "A String", # The alt text property used in image tags is required for all images.
-                  "data": "A String", # Inline jpeg, gif, tiff, bmp, or png image raw bytes for an image question types.
+                {
+                  "url": "A String",
+                  "altText": "A String",
+                  "data": "A String",
                 },
               ],
-              "singleLineResponse": True or False, # Option to allow multiple line open text responses instead of a single line response. Note that we don't show auto-complete suggestions with multiple line responses.
-              "openTextSuggestions": [ # A list of suggested answers for open text question auto-complete. This is only valid if single_line_response is true.
+              "singleLineResponse": True or False,
+              "openTextSuggestions": [
                 "A String",
               ],
-              "type": "A String", # Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.
-              "answerOrder": "A String", # The randomization option for multiple choice and multi-select questions. If not specified, this option defaults to randomize.
-              "openTextPlaceholder": "A String", # Placeholder text for an open text question.
+              "type": "A String",
+              "answerOrder": "A String",
+              "openTextPlaceholder": "A String",
             },
           ],
-          "wantedResponseCount": 42, # Number of responses desired for the survey.
-          "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
-            "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-            "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+          "wantedResponseCount": 42,
+          "rejectionReason": {
+            "explanation": "A String",
+            "type": "A String",
           },
         },
     ],
@@ -456,72 +456,72 @@ <h3>Method Details</h3>
   An object of the form:
 
     {
-    "resource": { # Representation of an individual survey object. # Survey object containing the specification of the started Survey.
-        "owners": [ # List of email addresses for survey owners. Must contain at least the address of the user making the API call.
+    "resource": { # Survey object containing the specification of the started Survey.
+        "owners": [
           "A String",
         ],
-        "description": "A String", # Text description of the survey.
-        "title": "A String", # Optional name that will be given to the survey.
-        "customerData": "A String", # Additional information to store on behalf of the API consumer and associate with this question. This binary blob is treated as opaque. This field is limited to 64K bytes.
-        "state": "A String", # State that the survey is in.
-        "audience": { # Specifications for the target audience of a survey run through the API. # Targeting-criteria message containing demographic information
-          "countrySubdivision": "A String", # Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).
-          "mobileAppPanelId": "A String", # Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.
-          "country": "A String", # Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.
-          "ages": [ # Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']
+        "description": "A String",
+        "title": "A String",
+        "customerData": "A String",
+        "state": "A String",
+        "audience": {
+          "countrySubdivision": "A String",
+          "mobileAppPanelId": "A String",
+          "country": "A String",
+          "ages": [
             "A String",
           ],
-          "populationSource": "A String", # Online population source where the respondents are sampled from.
-          "languages": [ # Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.
+          "populationSource": "A String",
+          "languages": [
             "A String",
           ],
-          "gender": "A String", # Optional gender to target.
+          "gender": "A String",
         },
-        "cost": { # Message defining the cost to run a given survey through API. # Cost to run the survey and collect the necessary number of responses.
-          "nanos": "A String", # Cost of survey in nano units of the given currency. DEPRECATED in favor of cost_per_response_nanos
-          "currencyCode": "A String", # Currency code that the cost is given in.
-          "costPerResponseNanos": "A String", # Cost per survey response in nano units of the given currency. To get the total cost for a survey, multiply this value by wanted_response_count.
-          "maxCostPerResponseNanos": "A String", # Threshold to start a survey automatically if the quoted price is at most this value. When a survey has a Screener (threshold) question, it must go through an incidence pricing test to determine the final cost per response. Typically you will have to make a followup call to start the survey giving the final computed cost per response. If the survey has no threshold_answers, setting this property will return an error. By specifying this property, you indicate the max price per response you are willing to pay in advance of the incidence test. If the price turns out to be lower than the specified value, the survey will begin immediately and you will be charged at the rate determined by the incidence pricing test. If the price turns out to be greater than the specified value the survey will not be started and you will instead be notified what price was determined by the incidence test. At that point, you must raise the value of this property to be greater than or equal to that cost before attempting to start the survey again. This will immediately start the survey as long the incidence test was run within the last 21 days.
+        "cost": {
+          "nanos": "A String",
+          "currencyCode": "A String",
+          "costPerResponseNanos": "A String",
+          "maxCostPerResponseNanos": "A String",
         },
-        "surveyUrlId": "A String", # Unique survey ID, that is viewable in the URL of the Survey Creator UI
-        "questions": [ # List of questions defining the survey.
-          { # Message defining the question specifications.
-            "highValueLabel": "A String", # For rating questions, the text for the higher end of the scale, such as 'Best'. For numeric questions, a string representing a floating-point that is the maximum allowed number for a response.
-            "mustPickSuggestion": True or False, # Option to force the user to pick one of the open text suggestions. This requires that suggestions are provided for this question.
-            "thresholdAnswers": [ # The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.
+        "surveyUrlId": "A String",
+        "questions": [
+          {
+            "highValueLabel": "A String",
+            "mustPickSuggestion": True or False,
+            "thresholdAnswers": [
               "A String",
             ],
-            "sentimentText": "A String", # Used by the Rating Scale with Text question type. This text goes along with the question field that is presented to the respondent, and is the actual text that the respondent is asked to rate.
-            "question": "A String", # Required question text shown to the respondent.
-            "numStars": "A String", # Number of stars to use for ratings questions.
-            "lowValueLabel": "A String", # For rating questions, the text for the lower end of the scale, such as 'Worst'. For numeric questions, a string representing a floating-point that is the minimum allowed number for a response.
-            "videoId": "A String", # The YouTube video ID to be show in video questions.
-            "answers": [ # Required list of answer options for a question.
+            "sentimentText": "A String",
+            "question": "A String",
+            "numStars": "A String",
+            "lowValueLabel": "A String",
+            "videoId": "A String",
+            "answers": [
               "A String",
             ],
-            "lastAnswerPositionPinned": True or False, # Currently only support pinning an answer option to the last position.
-            "hasOther": True or False, # Option to allow open-ended text box for Single Answer and Multiple Answer question types. This can be used with SINGLE_ANSWER, SINGLE_ANSWER_WITH_IMAGE, MULTIPLE_ANSWERS, and MULTIPLE_ANSWERS_WITH_IMAGE question types.
-            "unitOfMeasurementLabel": "A String", # Optional unit of measurement for display (for example: hours, people, miles).
+            "lastAnswerPositionPinned": True or False,
+            "hasOther": True or False,
+            "unitOfMeasurementLabel": "A String",
             "images": [
-              { # Container object for image data and alt_text.
-                "url": "A String", # The read-only URL for the hosted images.
-                "altText": "A String", # The alt text property used in image tags is required for all images.
-                "data": "A String", # Inline jpeg, gif, tiff, bmp, or png image raw bytes for an image question types.
+              {
+                "url": "A String",
+                "altText": "A String",
+                "data": "A String",
               },
             ],
-            "singleLineResponse": True or False, # Option to allow multiple line open text responses instead of a single line response. Note that we don't show auto-complete suggestions with multiple line responses.
-            "openTextSuggestions": [ # A list of suggested answers for open text question auto-complete. This is only valid if single_line_response is true.
+            "singleLineResponse": True or False,
+            "openTextSuggestions": [
               "A String",
             ],
-            "type": "A String", # Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.
-            "answerOrder": "A String", # The randomization option for multiple choice and multi-select questions. If not specified, this option defaults to randomize.
-            "openTextPlaceholder": "A String", # Placeholder text for an open text question.
+            "type": "A String",
+            "answerOrder": "A String",
+            "openTextPlaceholder": "A String",
           },
         ],
-        "wantedResponseCount": 42, # Number of responses desired for the survey.
-        "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
-          "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-          "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+        "wantedResponseCount": 42,
+        "rejectionReason": {
+          "explanation": "A String",
+          "type": "A String",
         },
       },
     "requestId": "A String", # Unique request ID used for logging and debugging. Please include in any error reporting or troubleshooting requests.
@@ -539,72 +539,72 @@ <h3>Method Details</h3>
   An object of the form:
 
     {
-    "resource": { # Representation of an individual survey object. # Survey object containing the specification of the stopped Survey.
-        "owners": [ # List of email addresses for survey owners. Must contain at least the address of the user making the API call.
+    "resource": { # Survey object containing the specification of the stopped Survey.
+        "owners": [
           "A String",
         ],
-        "description": "A String", # Text description of the survey.
-        "title": "A String", # Optional name that will be given to the survey.
-        "customerData": "A String", # Additional information to store on behalf of the API consumer and associate with this question. This binary blob is treated as opaque. This field is limited to 64K bytes.
-        "state": "A String", # State that the survey is in.
-        "audience": { # Specifications for the target audience of a survey run through the API. # Targeting-criteria message containing demographic information
-          "countrySubdivision": "A String", # Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).
-          "mobileAppPanelId": "A String", # Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.
-          "country": "A String", # Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.
-          "ages": [ # Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']
+        "description": "A String",
+        "title": "A String",
+        "customerData": "A String",
+        "state": "A String",
+        "audience": {
+          "countrySubdivision": "A String",
+          "mobileAppPanelId": "A String",
+          "country": "A String",
+          "ages": [
             "A String",
           ],
-          "populationSource": "A String", # Online population source where the respondents are sampled from.
-          "languages": [ # Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.
+          "populationSource": "A String",
+          "languages": [
             "A String",
           ],
-          "gender": "A String", # Optional gender to target.
+          "gender": "A String",
         },
-        "cost": { # Message defining the cost to run a given survey through API. # Cost to run the survey and collect the necessary number of responses.
-          "nanos": "A String", # Cost of survey in nano units of the given currency. DEPRECATED in favor of cost_per_response_nanos
-          "currencyCode": "A String", # Currency code that the cost is given in.
-          "costPerResponseNanos": "A String", # Cost per survey response in nano units of the given currency. To get the total cost for a survey, multiply this value by wanted_response_count.
-          "maxCostPerResponseNanos": "A String", # Threshold to start a survey automatically if the quoted price is at most this value. When a survey has a Screener (threshold) question, it must go through an incidence pricing test to determine the final cost per response. Typically you will have to make a followup call to start the survey giving the final computed cost per response. If the survey has no threshold_answers, setting this property will return an error. By specifying this property, you indicate the max price per response you are willing to pay in advance of the incidence test. If the price turns out to be lower than the specified value, the survey will begin immediately and you will be charged at the rate determined by the incidence pricing test. If the price turns out to be greater than the specified value the survey will not be started and you will instead be notified what price was determined by the incidence test. At that point, you must raise the value of this property to be greater than or equal to that cost before attempting to start the survey again. This will immediately start the survey as long the incidence test was run within the last 21 days.
+        "cost": {
+          "nanos": "A String",
+          "currencyCode": "A String",
+          "costPerResponseNanos": "A String",
+          "maxCostPerResponseNanos": "A String",
         },
-        "surveyUrlId": "A String", # Unique survey ID, that is viewable in the URL of the Survey Creator UI
-        "questions": [ # List of questions defining the survey.
-          { # Message defining the question specifications.
-            "highValueLabel": "A String", # For rating questions, the text for the higher end of the scale, such as 'Best'. For numeric questions, a string representing a floating-point that is the maximum allowed number for a response.
-            "mustPickSuggestion": True or False, # Option to force the user to pick one of the open text suggestions. This requires that suggestions are provided for this question.
-            "thresholdAnswers": [ # The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.
+        "surveyUrlId": "A String",
+        "questions": [
+          {
+            "highValueLabel": "A String",
+            "mustPickSuggestion": True or False,
+            "thresholdAnswers": [
               "A String",
             ],
-            "sentimentText": "A String", # Used by the Rating Scale with Text question type. This text goes along with the question field that is presented to the respondent, and is the actual text that the respondent is asked to rate.
-            "question": "A String", # Required question text shown to the respondent.
-            "numStars": "A String", # Number of stars to use for ratings questions.
-            "lowValueLabel": "A String", # For rating questions, the text for the lower end of the scale, such as 'Worst'. For numeric questions, a string representing a floating-point that is the minimum allowed number for a response.
-            "videoId": "A String", # The YouTube video ID to be show in video questions.
-            "answers": [ # Required list of answer options for a question.
+            "sentimentText": "A String",
+            "question": "A String",
+            "numStars": "A String",
+            "lowValueLabel": "A String",
+            "videoId": "A String",
+            "answers": [
               "A String",
             ],
-            "lastAnswerPositionPinned": True or False, # Currently only support pinning an answer option to the last position.
-            "hasOther": True or False, # Option to allow open-ended text box for Single Answer and Multiple Answer question types. This can be used with SINGLE_ANSWER, SINGLE_ANSWER_WITH_IMAGE, MULTIPLE_ANSWERS, and MULTIPLE_ANSWERS_WITH_IMAGE question types.
-            "unitOfMeasurementLabel": "A String", # Optional unit of measurement for display (for example: hours, people, miles).
+            "lastAnswerPositionPinned": True or False,
+            "hasOther": True or False,
+            "unitOfMeasurementLabel": "A String",
             "images": [
-              { # Container object for image data and alt_text.
-                "url": "A String", # The read-only URL for the hosted images.
-                "altText": "A String", # The alt text property used in image tags is required for all images.
-                "data": "A String", # Inline jpeg, gif, tiff, bmp, or png image raw bytes for an image question types.
+              {
+                "url": "A String",
+                "altText": "A String",
+                "data": "A String",
               },
             ],
-            "singleLineResponse": True or False, # Option to allow multiple line open text responses instead of a single line response. Note that we don't show auto-complete suggestions with multiple line responses.
-            "openTextSuggestions": [ # A list of suggested answers for open text question auto-complete. This is only valid if single_line_response is true.
+            "singleLineResponse": True or False,
+            "openTextSuggestions": [
               "A String",
             ],
-            "type": "A String", # Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.
-            "answerOrder": "A String", # The randomization option for multiple choice and multi-select questions. If not specified, this option defaults to randomize.
-            "openTextPlaceholder": "A String", # Placeholder text for an open text question.
+            "type": "A String",
+            "answerOrder": "A String",
+            "openTextPlaceholder": "A String",
           },
         ],
-        "wantedResponseCount": 42, # Number of responses desired for the survey.
-        "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
-          "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-          "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+        "wantedResponseCount": 42,
+        "rejectionReason": {
+          "explanation": "A String",
+          "type": "A String",
         },
       },
     "requestId": "A String", # Unique request ID used for logging and debugging. Please include in any error reporting or troubleshooting requests.
@@ -620,72 +620,72 @@ <h3>Method Details</h3>
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Representation of an individual survey object.
-    "owners": [ # List of email addresses for survey owners. Must contain at least the address of the user making the API call.
+{
+    "owners": [
       "A String",
     ],
-    "description": "A String", # Text description of the survey.
-    "title": "A String", # Optional name that will be given to the survey.
-    "customerData": "A String", # Additional information to store on behalf of the API consumer and associate with this question. This binary blob is treated as opaque. This field is limited to 64K bytes.
-    "state": "A String", # State that the survey is in.
-    "audience": { # Specifications for the target audience of a survey run through the API. # Targeting-criteria message containing demographic information
-      "countrySubdivision": "A String", # Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).
-      "mobileAppPanelId": "A String", # Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.
-      "country": "A String", # Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.
-      "ages": [ # Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']
+    "description": "A String",
+    "title": "A String",
+    "customerData": "A String",
+    "state": "A String",
+    "audience": {
+      "countrySubdivision": "A String",
+      "mobileAppPanelId": "A String",
+      "country": "A String",
+      "ages": [
         "A String",
       ],
-      "populationSource": "A String", # Online population source where the respondents are sampled from.
-      "languages": [ # Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.
+      "populationSource": "A String",
+      "languages": [
         "A String",
       ],
-      "gender": "A String", # Optional gender to target.
+      "gender": "A String",
     },
-    "cost": { # Message defining the cost to run a given survey through API. # Cost to run the survey and collect the necessary number of responses.
-      "nanos": "A String", # Cost of survey in nano units of the given currency. DEPRECATED in favor of cost_per_response_nanos
-      "currencyCode": "A String", # Currency code that the cost is given in.
-      "costPerResponseNanos": "A String", # Cost per survey response in nano units of the given currency. To get the total cost for a survey, multiply this value by wanted_response_count.
-      "maxCostPerResponseNanos": "A String", # Threshold to start a survey automatically if the quoted price is at most this value. When a survey has a Screener (threshold) question, it must go through an incidence pricing test to determine the final cost per response. Typically you will have to make a followup call to start the survey giving the final computed cost per response. If the survey has no threshold_answers, setting this property will return an error. By specifying this property, you indicate the max price per response you are willing to pay in advance of the incidence test. If the price turns out to be lower than the specified value, the survey will begin immediately and you will be charged at the rate determined by the incidence pricing test. If the price turns out to be greater than the specified value the survey will not be started and you will instead be notified what price was determined by the incidence test. At that point, you must raise the value of this property to be greater than or equal to that cost before attempting to start the survey again. This will immediately start the survey as long the incidence test was run within the last 21 days.
+    "cost": {
+      "nanos": "A String",
+      "currencyCode": "A String",
+      "costPerResponseNanos": "A String",
+      "maxCostPerResponseNanos": "A String",
     },
-    "surveyUrlId": "A String", # Unique survey ID, that is viewable in the URL of the Survey Creator UI
-    "questions": [ # List of questions defining the survey.
-      { # Message defining the question specifications.
-        "highValueLabel": "A String", # For rating questions, the text for the higher end of the scale, such as 'Best'. For numeric questions, a string representing a floating-point that is the maximum allowed number for a response.
-        "mustPickSuggestion": True or False, # Option to force the user to pick one of the open text suggestions. This requires that suggestions are provided for this question.
-        "thresholdAnswers": [ # The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.
+    "surveyUrlId": "A String",
+    "questions": [
+      {
+        "highValueLabel": "A String",
+        "mustPickSuggestion": True or False,
+        "thresholdAnswers": [
           "A String",
         ],
-        "sentimentText": "A String", # Used by the Rating Scale with Text question type. This text goes along with the question field that is presented to the respondent, and is the actual text that the respondent is asked to rate.
-        "question": "A String", # Required question text shown to the respondent.
-        "numStars": "A String", # Number of stars to use for ratings questions.
-        "lowValueLabel": "A String", # For rating questions, the text for the lower end of the scale, such as 'Worst'. For numeric questions, a string representing a floating-point that is the minimum allowed number for a response.
-        "videoId": "A String", # The YouTube video ID to be show in video questions.
-        "answers": [ # Required list of answer options for a question.
+        "sentimentText": "A String",
+        "question": "A String",
+        "numStars": "A String",
+        "lowValueLabel": "A String",
+        "videoId": "A String",
+        "answers": [
           "A String",
         ],
-        "lastAnswerPositionPinned": True or False, # Currently only support pinning an answer option to the last position.
-        "hasOther": True or False, # Option to allow open-ended text box for Single Answer and Multiple Answer question types. This can be used with SINGLE_ANSWER, SINGLE_ANSWER_WITH_IMAGE, MULTIPLE_ANSWERS, and MULTIPLE_ANSWERS_WITH_IMAGE question types.
-        "unitOfMeasurementLabel": "A String", # Optional unit of measurement for display (for example: hours, people, miles).
+        "lastAnswerPositionPinned": True or False,
+        "hasOther": True or False,
+        "unitOfMeasurementLabel": "A String",
         "images": [
-          { # Container object for image data and alt_text.
-            "url": "A String", # The read-only URL for the hosted images.
-            "altText": "A String", # The alt text property used in image tags is required for all images.
-            "data": "A String", # Inline jpeg, gif, tiff, bmp, or png image raw bytes for an image question types.
+          {
+            "url": "A String",
+            "altText": "A String",
+            "data": "A String",
           },
         ],
-        "singleLineResponse": True or False, # Option to allow multiple line open text responses instead of a single line response. Note that we don't show auto-complete suggestions with multiple line responses.
-        "openTextSuggestions": [ # A list of suggested answers for open text question auto-complete. This is only valid if single_line_response is true.
+        "singleLineResponse": True or False,
+        "openTextSuggestions": [
           "A String",
         ],
-        "type": "A String", # Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.
-        "answerOrder": "A String", # The randomization option for multiple choice and multi-select questions. If not specified, this option defaults to randomize.
-        "openTextPlaceholder": "A String", # Placeholder text for an open text question.
+        "type": "A String",
+        "answerOrder": "A String",
+        "openTextPlaceholder": "A String",
       },
     ],
-    "wantedResponseCount": 42, # Number of responses desired for the survey.
-    "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
-      "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-      "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+    "wantedResponseCount": 42,
+    "rejectionReason": {
+      "explanation": "A String",
+      "type": "A String",
     },
   }
 
@@ -693,72 +693,72 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Representation of an individual survey object.
-      "owners": [ # List of email addresses for survey owners. Must contain at least the address of the user making the API call.
+    {
+      "owners": [
         "A String",
       ],
-      "description": "A String", # Text description of the survey.
-      "title": "A String", # Optional name that will be given to the survey.
-      "customerData": "A String", # Additional information to store on behalf of the API consumer and associate with this question. This binary blob is treated as opaque. This field is limited to 64K bytes.
-      "state": "A String", # State that the survey is in.
-      "audience": { # Specifications for the target audience of a survey run through the API. # Targeting-criteria message containing demographic information
-        "countrySubdivision": "A String", # Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).
-        "mobileAppPanelId": "A String", # Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.
-        "country": "A String", # Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.
-        "ages": [ # Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']
+      "description": "A String",
+      "title": "A String",
+      "customerData": "A String",
+      "state": "A String",
+      "audience": {
+        "countrySubdivision": "A String",
+        "mobileAppPanelId": "A String",
+        "country": "A String",
+        "ages": [
           "A String",
         ],
-        "populationSource": "A String", # Online population source where the respondents are sampled from.
-        "languages": [ # Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.
+        "populationSource": "A String",
+        "languages": [
           "A String",
         ],
-        "gender": "A String", # Optional gender to target.
+        "gender": "A String",
       },
-      "cost": { # Message defining the cost to run a given survey through API. # Cost to run the survey and collect the necessary number of responses.
-        "nanos": "A String", # Cost of survey in nano units of the given currency. DEPRECATED in favor of cost_per_response_nanos
-        "currencyCode": "A String", # Currency code that the cost is given in.
-        "costPerResponseNanos": "A String", # Cost per survey response in nano units of the given currency. To get the total cost for a survey, multiply this value by wanted_response_count.
-        "maxCostPerResponseNanos": "A String", # Threshold to start a survey automatically if the quoted price is at most this value. When a survey has a Screener (threshold) question, it must go through an incidence pricing test to determine the final cost per response. Typically you will have to make a followup call to start the survey giving the final computed cost per response. If the survey has no threshold_answers, setting this property will return an error. By specifying this property, you indicate the max price per response you are willing to pay in advance of the incidence test. If the price turns out to be lower than the specified value, the survey will begin immediately and you will be charged at the rate determined by the incidence pricing test. If the price turns out to be greater than the specified value the survey will not be started and you will instead be notified what price was determined by the incidence test. At that point, you must raise the value of this property to be greater than or equal to that cost before attempting to start the survey again. This will immediately start the survey as long the incidence test was run within the last 21 days.
+      "cost": {
+        "nanos": "A String",
+        "currencyCode": "A String",
+        "costPerResponseNanos": "A String",
+        "maxCostPerResponseNanos": "A String",
       },
-      "surveyUrlId": "A String", # Unique survey ID, that is viewable in the URL of the Survey Creator UI
-      "questions": [ # List of questions defining the survey.
-        { # Message defining the question specifications.
-          "highValueLabel": "A String", # For rating questions, the text for the higher end of the scale, such as 'Best'. For numeric questions, a string representing a floating-point that is the maximum allowed number for a response.
-          "mustPickSuggestion": True or False, # Option to force the user to pick one of the open text suggestions. This requires that suggestions are provided for this question.
-          "thresholdAnswers": [ # The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.
+      "surveyUrlId": "A String",
+      "questions": [
+        {
+          "highValueLabel": "A String",
+          "mustPickSuggestion": True or False,
+          "thresholdAnswers": [
             "A String",
           ],
-          "sentimentText": "A String", # Used by the Rating Scale with Text question type. This text goes along with the question field that is presented to the respondent, and is the actual text that the respondent is asked to rate.
-          "question": "A String", # Required question text shown to the respondent.
-          "numStars": "A String", # Number of stars to use for ratings questions.
-          "lowValueLabel": "A String", # For rating questions, the text for the lower end of the scale, such as 'Worst'. For numeric questions, a string representing a floating-point that is the minimum allowed number for a response.
-          "videoId": "A String", # The YouTube video ID to be show in video questions.
-          "answers": [ # Required list of answer options for a question.
+          "sentimentText": "A String",
+          "question": "A String",
+          "numStars": "A String",
+          "lowValueLabel": "A String",
+          "videoId": "A String",
+          "answers": [
             "A String",
           ],
-          "lastAnswerPositionPinned": True or False, # Currently only support pinning an answer option to the last position.
-          "hasOther": True or False, # Option to allow open-ended text box for Single Answer and Multiple Answer question types. This can be used with SINGLE_ANSWER, SINGLE_ANSWER_WITH_IMAGE, MULTIPLE_ANSWERS, and MULTIPLE_ANSWERS_WITH_IMAGE question types.
-          "unitOfMeasurementLabel": "A String", # Optional unit of measurement for display (for example: hours, people, miles).
+          "lastAnswerPositionPinned": True or False,
+          "hasOther": True or False,
+          "unitOfMeasurementLabel": "A String",
           "images": [
-            { # Container object for image data and alt_text.
-              "url": "A String", # The read-only URL for the hosted images.
-              "altText": "A String", # The alt text property used in image tags is required for all images.
-              "data": "A String", # Inline jpeg, gif, tiff, bmp, or png image raw bytes for an image question types.
+            {
+              "url": "A String",
+              "altText": "A String",
+              "data": "A String",
             },
           ],
-          "singleLineResponse": True or False, # Option to allow multiple line open text responses instead of a single line response. Note that we don't show auto-complete suggestions with multiple line responses.
-          "openTextSuggestions": [ # A list of suggested answers for open text question auto-complete. This is only valid if single_line_response is true.
+          "singleLineResponse": True or False,
+          "openTextSuggestions": [
             "A String",
           ],
-          "type": "A String", # Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.
-          "answerOrder": "A String", # The randomization option for multiple choice and multi-select questions. If not specified, this option defaults to randomize.
-          "openTextPlaceholder": "A String", # Placeholder text for an open text question.
+          "type": "A String",
+          "answerOrder": "A String",
+          "openTextPlaceholder": "A String",
         },
       ],
-      "wantedResponseCount": 42, # Number of responses desired for the survey.
-      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
-        "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-        "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+      "wantedResponseCount": 42,
+      "rejectionReason": {
+        "explanation": "A String",
+        "type": "A String",
       },
     }</pre>
 </div>
diff --git a/docs/dyn/content_v2.accounts.html b/docs/dyn/content_v2.accounts.html
index ea13e2fb50d..0a01c5f2162 100644
--- a/docs/dyn/content_v2.accounts.html
+++ b/docs/dyn/content_v2.accounts.html
@@ -82,25 +82,25 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(merchantId, accountId, dryRun=None)</a></code></p>
-<p class="firstline">Deletes a Merchant Center sub-account.</p>
+<p class="firstline">Deletes a Merchant Center sub-account. This method can only be called for multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, accountId)</a></code></p>
-<p class="firstline">Retrieves a Merchant Center account.</p>
+<p class="firstline">Retrieves a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(merchantId, body, dryRun=None)</a></code></p>
-<p class="firstline">Creates a Merchant Center sub-account.</p>
+<p class="firstline">Creates a Merchant Center sub-account. This method can only be called for multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the sub-accounts in your Merchant Center account.</p>
+<p class="firstline">Lists the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(merchantId, accountId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates a Merchant Center account. This method supports patch semantics.</p>
+<p class="firstline">Updates a Merchant Center account. This method can only be called for multi-client accounts. This method supports patch semantics.</p>
 <p class="toc_element">
   <code><a href="#update">update(merchantId, accountId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates a Merchant Center account.</p>
+<p class="firstline">Updates a Merchant Center account. This method can only be called for multi-client accounts.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="authinfo">authinfo()</code>
@@ -215,7 +215,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="delete">delete(merchantId, accountId, dryRun=None)</code>
-  <pre>Deletes a Merchant Center sub-account.
+  <pre>Deletes a Merchant Center sub-account. This method can only be called for multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -226,7 +226,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, accountId)</code>
-  <pre>Retrieves a Merchant Center account.
+  <pre>Retrieves a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -260,7 +260,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="insert">insert(merchantId, body, dryRun=None)</code>
-  <pre>Creates a Merchant Center sub-account.
+  <pre>Creates a Merchant Center sub-account. This method can only be called for multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -319,7 +319,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code>
-  <pre>Lists the sub-accounts in your Merchant Center account.
+  <pre>Lists the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -374,7 +374,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="patch">patch(merchantId, accountId, body, dryRun=None)</code>
-  <pre>Updates a Merchant Center account. This method supports patch semantics.
+  <pre>Updates a Merchant Center account. This method can only be called for multi-client accounts. This method supports patch semantics.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -434,7 +434,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="update">update(merchantId, accountId, body, dryRun=None)</code>
-  <pre>Updates a Merchant Center account.
+  <pre>Updates a Merchant Center account. This method can only be called for multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2.accountshipping.html b/docs/dyn/content_v2.accountshipping.html
index 40ba27f5efe..e5e11b6c98c 100644
--- a/docs/dyn/content_v2.accountshipping.html
+++ b/docs/dyn/content_v2.accountshipping.html
@@ -79,19 +79,19 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves and updates the shipping settings of multiple accounts in a single request.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, accountId)</a></code></p>
-<p class="firstline">Retrieves the shipping settings of the account.</p>
+<p class="firstline">Retrieves the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the shipping settings of the sub-accounts in your Merchant Center account.</p>
+<p class="firstline">Lists the shipping settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(merchantId, accountId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates the shipping settings of the account. This method supports patch semantics.</p>
+<p class="firstline">Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.</p>
 <p class="toc_element">
   <code><a href="#update">update(merchantId, accountId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates the shipping settings of the account.</p>
+<p class="firstline">Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="custombatch">custombatch(body, dryRun=None)</code>
@@ -405,7 +405,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, accountId)</code>
-  <pre>Retrieves the shipping settings of the account.
+  <pre>Retrieves the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -550,7 +550,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code>
-  <pre>Lists the shipping settings of the sub-accounts in your Merchant Center account.
+  <pre>Lists the shipping settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -716,7 +716,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="patch">patch(merchantId, accountId, body, dryRun=None)</code>
-  <pre>Updates the shipping settings of the account. This method supports patch semantics.
+  <pre>Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -998,7 +998,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="update">update(merchantId, accountId, body, dryRun=None)</code>
-  <pre>Updates the shipping settings of the account.
+  <pre>Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2.accountstatuses.html b/docs/dyn/content_v2.accountstatuses.html
index c8d2ad1dc62..88fcdd3dc88 100644
--- a/docs/dyn/content_v2.accountstatuses.html
+++ b/docs/dyn/content_v2.accountstatuses.html
@@ -79,10 +79,10 @@ <h2>Instance Methods</h2>
 <p class="firstline">A description of how to use this function</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, accountId)</a></code></p>
-<p class="firstline">Retrieves the status of a Merchant Center account.</p>
+<p class="firstline">Retrieves the status of a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the statuses of the sub-accounts in your Merchant Center account.</p>
+<p class="firstline">Lists the statuses of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -157,7 +157,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, accountId)</code>
-  <pre>Retrieves the status of a Merchant Center account.
+  <pre>Retrieves the status of a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -194,7 +194,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code>
-  <pre>Lists the statuses of the sub-accounts in your Merchant Center account.
+  <pre>Lists the statuses of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2.accounttax.html b/docs/dyn/content_v2.accounttax.html
index aa93539d15a..4f4c97d4b87 100644
--- a/docs/dyn/content_v2.accounttax.html
+++ b/docs/dyn/content_v2.accounttax.html
@@ -79,19 +79,19 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves and updates tax settings of multiple accounts in a single request.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, accountId)</a></code></p>
-<p class="firstline">Retrieves the tax settings of the account.</p>
+<p class="firstline">Retrieves the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the tax settings of the sub-accounts in your Merchant Center account.</p>
+<p class="firstline">Lists the tax settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(merchantId, accountId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates the tax settings of the account. This method supports patch semantics.</p>
+<p class="firstline">Updates the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.</p>
 <p class="toc_element">
   <code><a href="#update">update(merchantId, accountId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates the tax settings of the account.</p>
+<p class="firstline">Updates the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="custombatch">custombatch(body, dryRun=None)</code>
@@ -167,7 +167,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, accountId)</code>
-  <pre>Retrieves the tax settings of the account.
+  <pre>Retrieves the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -193,7 +193,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code>
-  <pre>Lists the tax settings of the sub-accounts in your Merchant Center account.
+  <pre>Lists the tax settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -240,7 +240,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="patch">patch(merchantId, accountId, body, dryRun=None)</code>
-  <pre>Updates the tax settings of the account. This method supports patch semantics.
+  <pre>Updates the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -284,7 +284,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="update">update(merchantId, accountId, body, dryRun=None)</code>
-  <pre>Updates the tax settings of the account.
+  <pre>Updates the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2.datafeeds.html b/docs/dyn/content_v2.datafeeds.html
index e1c5769d681..7af9439bbd6 100644
--- a/docs/dyn/content_v2.datafeeds.html
+++ b/docs/dyn/content_v2.datafeeds.html
@@ -79,25 +79,25 @@ <h2>Instance Methods</h2>
 <p class="firstline">A description of how to use this function</p>
 <p class="toc_element">
   <code><a href="#delete">delete(merchantId, datafeedId, dryRun=None)</a></code></p>
-<p class="firstline">Deletes a datafeed from your Merchant Center account.</p>
+<p class="firstline">Deletes a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, datafeedId)</a></code></p>
-<p class="firstline">Retrieves a datafeed from your Merchant Center account.</p>
+<p class="firstline">Retrieves a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(merchantId, body, dryRun=None)</a></code></p>
-<p class="firstline">Registers a datafeed with your Merchant Center account.</p>
+<p class="firstline">Registers a datafeed with your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the datafeeds in your Merchant Center account.</p>
+<p class="firstline">Lists the datafeeds in your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(merchantId, datafeedId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates a datafeed of your Merchant Center account. This method supports patch semantics.</p>
+<p class="firstline">Updates a datafeed of your Merchant Center account. This method can only be called for non-multi-client accounts. This method supports patch semantics.</p>
 <p class="toc_element">
   <code><a href="#update">update(merchantId, datafeedId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates a datafeed of your Merchant Center account.</p>
+<p class="firstline">Updates a datafeed of your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="custombatch">custombatch(body, dryRun=None)</code>
@@ -202,7 +202,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="delete">delete(merchantId, datafeedId, dryRun=None)</code>
-  <pre>Deletes a datafeed from your Merchant Center account.
+  <pre>Deletes a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, A parameter (required)
@@ -213,7 +213,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, datafeedId)</code>
-  <pre>Retrieves a datafeed from your Merchant Center account.
+  <pre>Retrieves a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, A parameter (required)
@@ -254,7 +254,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="insert">insert(merchantId, body, dryRun=None)</code>
-  <pre>Registers a datafeed with your Merchant Center account.
+  <pre>Registers a datafeed with your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, A parameter (required)
@@ -327,7 +327,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code>
-  <pre>Lists the datafeeds in your Merchant Center account.
+  <pre>Lists the datafeeds in your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -389,7 +389,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="patch">patch(merchantId, datafeedId, body, dryRun=None)</code>
-  <pre>Updates a datafeed of your Merchant Center account. This method supports patch semantics.
+  <pre>Updates a datafeed of your Merchant Center account. This method can only be called for non-multi-client accounts. This method supports patch semantics.
 
 Args:
   merchantId: string, A parameter (required)
@@ -463,7 +463,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="update">update(merchantId, datafeedId, body, dryRun=None)</code>
-  <pre>Updates a datafeed of your Merchant Center account.
+  <pre>Updates a datafeed of your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, A parameter (required)
diff --git a/docs/dyn/content_v2.datafeedstatuses.html b/docs/dyn/content_v2.datafeedstatuses.html
index 1221ee75426..529185bf962 100644
--- a/docs/dyn/content_v2.datafeedstatuses.html
+++ b/docs/dyn/content_v2.datafeedstatuses.html
@@ -79,10 +79,10 @@ <h2>Instance Methods</h2>
 <p class="firstline">A description of how to use this function</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, datafeedId)</a></code></p>
-<p class="firstline">Retrieves the status of a datafeed from your Merchant Center account.</p>
+<p class="firstline">Retrieves the status of a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the statuses of the datafeeds in your Merchant Center account.</p>
+<p class="firstline">Lists the statuses of the datafeeds in your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -169,7 +169,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, datafeedId)</code>
-  <pre>Retrieves the status of a datafeed from your Merchant Center account.
+  <pre>Retrieves the status of a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, A parameter (required)
@@ -218,7 +218,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code>
-  <pre>Lists the statuses of the datafeeds in your Merchant Center account.
+  <pre>Lists the statuses of the datafeeds in your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2.inventory.html b/docs/dyn/content_v2.inventory.html
index fe84a24b478..f543ed259bd 100644
--- a/docs/dyn/content_v2.inventory.html
+++ b/docs/dyn/content_v2.inventory.html
@@ -76,14 +76,14 @@ <h1><a href="content_v2.html">Content API for Shopping</a> . <a href="content_v2
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#custombatch">custombatch(body, dryRun=None)</a></code></p>
-<p class="firstline">Updates price and availability for multiple products or stores in a single request. This operation does not update the expiration date of the products.</p>
+<p class="firstline">Updates price and availability for multiple products or stores in a single request. This operation does not update the expiration date of the products. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#set">set(merchantId, storeCode, productId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates price and availability of a product in your Merchant Center account. This operation does not update the expiration date of the product.</p>
+<p class="firstline">Updates price and availability of a product in your Merchant Center account. This operation does not update the expiration date of the product. This method can only be called for non-multi-client accounts.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="custombatch">custombatch(body, dryRun=None)</code>
-  <pre>Updates price and availability for multiple products or stores in a single request. This operation does not update the expiration date of the products.
+  <pre>Updates price and availability for multiple products or stores in a single request. This operation does not update the expiration date of the products. This method can only be called for non-multi-client accounts.
 
 Args:
   body: object, The request body. (required)
@@ -110,6 +110,10 @@ <h3>Method Details</h3>
             "value": "A String", # The price represented as a number.
           },
           "sellOnGoogleQuantity": 42, # The quantity of the product that is reserved for sell-on-google ads. Supported only for online products.
+          "pickup": { # Store pickup information. Only supported for local inventory. Not setting pickup means "don't update" while setting it to the empty value ({} in JSON) means "delete". Otherwise, pickupMethod and pickupSla must be set together, unless pickupMethod is "not supported".
+            "pickupMethod": "A String", # Whether store pickup is available for this offer and whether the pickup option should be shown as buy, reserve, or not supported. Only supported for local inventory. Unless the value is "not supported", must be submitted together with pickupSla.
+            "pickupSla": "A String", # The expected date that an order will be ready for pickup, relative to when the order is placed. Only supported for local inventory. Must be submitted together with pickupMethod.
+          },
           "salePrice": { # The sale price of the product. Mandatory if sale_price_effective_date is defined.
             "currency": "A String", # The currency of the price.
             "value": "A String", # The price represented as a number.
@@ -156,7 +160,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="set">set(merchantId, storeCode, productId, body, dryRun=None)</code>
-  <pre>Updates price and availability of a product in your Merchant Center account. This operation does not update the expiration date of the product.
+  <pre>Updates price and availability of a product in your Merchant Center account. This operation does not update the expiration date of the product. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -179,6 +183,10 @@ <h3>Method Details</h3>
       "value": "A String", # The price represented as a number.
     },
     "sellOnGoogleQuantity": 42, # The quantity of the product that is reserved for sell-on-google ads. Supported only for online products.
+    "pickup": { # Store pickup information. Only supported for local inventory. Not setting pickup means "don't update" while setting it to the empty value ({} in JSON) means "delete". Otherwise, pickupMethod and pickupSla must be set together, unless pickupMethod is "not supported".
+      "pickupMethod": "A String", # Whether store pickup is available for this offer and whether the pickup option should be shown as buy, reserve, or not supported. Only supported for local inventory. Unless the value is "not supported", must be submitted together with pickupSla.
+      "pickupSla": "A String", # The expected date that an order will be ready for pickup, relative to when the order is placed. Only supported for local inventory. Must be submitted together with pickupMethod.
+    },
     "salePrice": { # The sale price of the product. Mandatory if sale_price_effective_date is defined.
       "currency": "A String", # The currency of the price.
       "value": "A String", # The price represented as a number.
diff --git a/docs/dyn/content_v2.orders.html b/docs/dyn/content_v2.orders.html
index 84b800e3e10..e5fad2d8d21 100644
--- a/docs/dyn/content_v2.orders.html
+++ b/docs/dyn/content_v2.orders.html
@@ -76,56 +76,56 @@ <h1><a href="content_v2.html">Content API for Shopping</a> . <a href="content_v2
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#acknowledge">acknowledge(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Marks an order as acknowledged.</p>
+<p class="firstline">Marks an order as acknowledged. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#advancetestorder">advancetestorder(merchantId, orderId)</a></code></p>
-<p class="firstline">Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment".</p>
+<p class="firstline">Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment". This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#cancel">cancel(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Cancels all line items in an order.</p>
+<p class="firstline">Cancels all line items in an order. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#cancellineitem">cancellineitem(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Cancels a line item.</p>
+<p class="firstline">Cancels a line item. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#createtestorder">createtestorder(merchantId, body)</a></code></p>
-<p class="firstline">Sandbox only. Creates a test order.</p>
+<p class="firstline">Sandbox only. Creates a test order. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#custombatch">custombatch(body)</a></code></p>
-<p class="firstline">Retrieves or modifies multiple orders in a single request.</p>
+<p class="firstline">Retrieves or modifies multiple orders in a single request. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, orderId)</a></code></p>
-<p class="firstline">Retrieves an order from your Merchant Center account.</p>
+<p class="firstline">Retrieves an order from your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#getbymerchantorderid">getbymerchantorderid(merchantId, merchantOrderId)</a></code></p>
-<p class="firstline">Retrieves an order using merchant order id.</p>
+<p class="firstline">Retrieves an order using merchant order id. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#gettestordertemplate">gettestordertemplate(merchantId, templateName)</a></code></p>
-<p class="firstline">Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox.</p>
+<p class="firstline">Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, orderBy=None, pageToken=None, placedDateEnd=None, acknowledged=None, maxResults=None, placedDateStart=None, statuses=None)</a></code></p>
-<p class="firstline">Lists the orders in your Merchant Center account.</p>
+<p class="firstline">Lists the orders in your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#refund">refund(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Refund a portion of the order, up to the full amount paid.</p>
+<p class="firstline">Refund a portion of the order, up to the full amount paid. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#returnlineitem">returnlineitem(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Returns a line item.</p>
+<p class="firstline">Returns a line item. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#shiplineitems">shiplineitems(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Marks line item(s) as shipped.</p>
+<p class="firstline">Marks line item(s) as shipped. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#updatemerchantorderid">updatemerchantorderid(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Updates the merchant order ID for a given order.</p>
+<p class="firstline">Updates the merchant order ID for a given order. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#updateshipment">updateshipment(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Updates a shipment's status, carrier, and/or tracking ID.</p>
+<p class="firstline">Updates a shipment's status, carrier, and/or tracking ID. This method can only be called for non-multi-client accounts.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="acknowledge">acknowledge(merchantId, orderId, body)</code>
-  <pre>Marks an order as acknowledged.
+  <pre>Marks an order as acknowledged. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="advancetestorder">advancetestorder(merchantId, orderId)</code>
-  <pre>Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment".
+  <pre>Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment". This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -165,7 +165,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="cancel">cancel(merchantId, orderId, body)</code>
-  <pre>Cancels all line items in an order.
+  <pre>Cancels all line items in an order. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -191,7 +191,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="cancellineitem">cancellineitem(merchantId, orderId, body)</code>
-  <pre>Cancels a line item.
+  <pre>Cancels a line item. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -223,7 +223,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="createtestorder">createtestorder(merchantId, body)</code>
-  <pre>Sandbox only. Creates a test order.
+  <pre>Sandbox only. Creates a test order. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -233,7 +233,7 @@ <h3>Method Details</h3>
 {
     "testOrder": { # The test order to create.
       "customer": { # The details of the customer who placed the order.
-        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow. Optional.
+        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. Optional.
         "fullName": "A String", # Full name of the customer.
         "email": "A String", # Email address of the customer.
       },
@@ -346,7 +346,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="custombatch">custombatch(body)</code>
-  <pre>Retrieves or modifies multiple orders in a single request.
+  <pre>Retrieves or modifies multiple orders in a single request. This method can only be called for non-multi-client accounts.
 
 Args:
   body: object, The request body. (required)
@@ -433,7 +433,7 @@ <h3>Method Details</h3>
         },
         "order": { # The retrieved order. Only defined if the method is get and if the request was successful.
           "customer": { # The details of the customer who placed the order.
-            "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.
+            "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.
             "fullName": "A String", # Full name of the customer.
             "email": "A String", # Email address of the customer.
           },
@@ -647,7 +647,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, orderId)</code>
-  <pre>Retrieves an order from your Merchant Center account.
+  <pre>Retrieves an order from your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -658,7 +658,7 @@ <h3>Method Details</h3>
 
     {
     "customer": { # The details of the customer who placed the order.
-      "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.
+      "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.
       "fullName": "A String", # Full name of the customer.
       "email": "A String", # Email address of the customer.
     },
@@ -868,7 +868,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="getbymerchantorderid">getbymerchantorderid(merchantId, merchantOrderId)</code>
-  <pre>Retrieves an order using merchant order id.
+  <pre>Retrieves an order using merchant order id. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -881,7 +881,7 @@ <h3>Method Details</h3>
     "kind": "content#ordersGetByMerchantOrderIdResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetByMerchantOrderIdResponse".
     "order": { # The requested order.
       "customer": { # The details of the customer who placed the order.
-        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.
+        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.
         "fullName": "A String", # Full name of the customer.
         "email": "A String", # Email address of the customer.
       },
@@ -1092,7 +1092,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="gettestordertemplate">gettestordertemplate(merchantId, templateName)</code>
-  <pre>Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox.
+  <pre>Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1110,7 +1110,7 @@ <h3>Method Details</h3>
     "kind": "content#ordersGetTestOrderTemplateResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetTestOrderTemplateResponse".
     "template": { # The requested test order template.
       "customer": { # The details of the customer who placed the order.
-        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow. Optional.
+        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. Optional.
         "fullName": "A String", # Full name of the customer.
         "email": "A String", # Email address of the customer.
       },
@@ -1213,7 +1213,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, orderBy=None, pageToken=None, placedDateEnd=None, acknowledged=None, maxResults=None, placedDateStart=None, statuses=None)</code>
-  <pre>Lists the orders in your Merchant Center account.
+  <pre>Lists the orders in your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1251,7 +1251,7 @@ <h3>Method Details</h3>
     "resources": [
       {
         "customer": { # The details of the customer who placed the order.
-          "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.
+          "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.
           "fullName": "A String", # Full name of the customer.
           "email": "A String", # Email address of the customer.
         },
@@ -1477,7 +1477,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="refund">refund(merchantId, orderId, body)</code>
-  <pre>Refund a portion of the order, up to the full amount paid.
+  <pre>Refund a portion of the order, up to the full amount paid. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1507,7 +1507,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="returnlineitem">returnlineitem(merchantId, orderId, body)</code>
-  <pre>Returns a line item.
+  <pre>Returns a line item. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1535,7 +1535,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="shiplineitems">shiplineitems(merchantId, orderId, body)</code>
-  <pre>Marks line item(s) as shipped.
+  <pre>Marks line item(s) as shipped. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1568,7 +1568,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="updatemerchantorderid">updatemerchantorderid(merchantId, orderId, body)</code>
-  <pre>Updates the merchant order ID for a given order.
+  <pre>Updates the merchant order ID for a given order. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1593,7 +1593,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="updateshipment">updateshipment(merchantId, orderId, body)</code>
-  <pre>Updates a shipment's status, carrier, and/or tracking ID.
+  <pre>Updates a shipment's status, carrier, and/or tracking ID. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2.products.html b/docs/dyn/content_v2.products.html
index 6ce9b32eff6..e6fbeec70bf 100644
--- a/docs/dyn/content_v2.products.html
+++ b/docs/dyn/content_v2.products.html
@@ -76,26 +76,26 @@ <h1><a href="content_v2.html">Content API for Shopping</a> . <a href="content_v2
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#custombatch">custombatch(body, dryRun=None)</a></code></p>
-<p class="firstline">Retrieves, inserts, and deletes multiple products in a single request.</p>
+<p class="firstline">Retrieves, inserts, and deletes multiple products in a single request. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(merchantId, productId, dryRun=None)</a></code></p>
-<p class="firstline">Deletes a product from your Merchant Center account.</p>
+<p class="firstline">Deletes a product from your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, productId)</a></code></p>
-<p class="firstline">Retrieves a product from your Merchant Center account.</p>
+<p class="firstline">Retrieves a product from your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(merchantId, body, dryRun=None)</a></code></p>
-<p class="firstline">Uploads a product to your Merchant Center account.</p>
+<p class="firstline">Uploads a product to your Merchant Center account. If an item with the same channel, contentLanguage, offerId, and targetCountry already exists, this method updates that entry. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, includeInvalidInsertedItems=None, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the products in your Merchant Center account.</p>
+<p class="firstline">Lists the products in your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="custombatch">custombatch(body, dryRun=None)</code>
-  <pre>Retrieves, inserts, and deletes multiple products in a single request.
+  <pre>Retrieves, inserts, and deletes multiple products in a single request. This method can only be called for non-multi-client accounts.
 
 Args:
   body: object, The request body. (required)
@@ -525,7 +525,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="delete">delete(merchantId, productId, dryRun=None)</code>
-  <pre>Deletes a product from your Merchant Center account.
+  <pre>Deletes a product from your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -536,7 +536,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, productId)</code>
-  <pre>Retrieves a product from your Merchant Center account.
+  <pre>Retrieves a product from your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -741,7 +741,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="insert">insert(merchantId, body, dryRun=None)</code>
-  <pre>Uploads a product to your Merchant Center account.
+  <pre>Uploads a product to your Merchant Center account. If an item with the same channel, contentLanguage, offerId, and targetCountry already exists, this method updates that entry. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1142,7 +1142,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, includeInvalidInsertedItems=None, pageToken=None, maxResults=None)</code>
-  <pre>Lists the products in your Merchant Center account.
+  <pre>Lists the products in your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2.productstatuses.html b/docs/dyn/content_v2.productstatuses.html
index 3b2cc9647bb..7977fd4ddc4 100644
--- a/docs/dyn/content_v2.productstatuses.html
+++ b/docs/dyn/content_v2.productstatuses.html
@@ -76,20 +76,20 @@ <h1><a href="content_v2.html">Content API for Shopping</a> . <a href="content_v2
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#custombatch">custombatch(body)</a></code></p>
-<p class="firstline">Gets the statuses of multiple products in a single request.</p>
+<p class="firstline">Gets the statuses of multiple products in a single request. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, productId)</a></code></p>
-<p class="firstline">Gets the status of a product from your Merchant Center account.</p>
+<p class="firstline">Gets the status of a product from your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, includeInvalidInsertedItems=None, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the statuses of the products in your Merchant Center account.</p>
+<p class="firstline">Lists the statuses of the products in your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="custombatch">custombatch(body)</code>
-  <pre>Gets the statuses of multiple products in a single request.
+  <pre>Gets the statuses of multiple products in a single request. This method can only be called for non-multi-client accounts.
 
 Args:
   body: object, The request body. (required)
@@ -162,7 +162,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, productId)</code>
-  <pre>Gets the status of a product from your Merchant Center account.
+  <pre>Gets the status of a product from your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -203,7 +203,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, includeInvalidInsertedItems=None, pageToken=None, maxResults=None)</code>
-  <pre>Lists the statuses of the products in your Merchant Center account.
+  <pre>Lists the statuses of the products in your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2.shippingsettings.html b/docs/dyn/content_v2.shippingsettings.html
index e846056d70d..bf4e978bd47 100644
--- a/docs/dyn/content_v2.shippingsettings.html
+++ b/docs/dyn/content_v2.shippingsettings.html
@@ -79,22 +79,22 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves and updates the shipping settings of multiple accounts in a single request.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, accountId)</a></code></p>
-<p class="firstline">Retrieves the shipping settings of the account.</p>
+<p class="firstline">Retrieves the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.</p>
 <p class="toc_element">
   <code><a href="#getsupportedcarriers">getsupportedcarriers(merchantId)</a></code></p>
 <p class="firstline">Retrieves supported carriers and carrier services for an account.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p>
-<p class="firstline">Lists the shipping settings of the sub-accounts in your Merchant Center account.</p>
+<p class="firstline">Lists the shipping settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(merchantId, accountId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates the shipping settings of the account. This method supports patch semantics.</p>
+<p class="firstline">Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.</p>
 <p class="toc_element">
   <code><a href="#update">update(merchantId, accountId, body, dryRun=None)</a></code></p>
-<p class="firstline">Updates the shipping settings of the account.</p>
+<p class="firstline">Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="custombatch">custombatch(body, dryRun=None)</code>
@@ -554,7 +554,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, accountId)</code>
-  <pre>Retrieves the shipping settings of the account.
+  <pre>Retrieves the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -796,7 +796,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code>
-  <pre>Lists the shipping settings of the sub-accounts in your Merchant Center account.
+  <pre>Lists the shipping settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1035,7 +1035,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="patch">patch(merchantId, accountId, body, dryRun=None)</code>
-  <pre>Updates the shipping settings of the account. This method supports patch semantics.
+  <pre>Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1463,7 +1463,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="update">update(merchantId, accountId, body, dryRun=None)</code>
-  <pre>Updates the shipping settings of the account.
+  <pre>Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/content_v2sandbox.orders.html b/docs/dyn/content_v2sandbox.orders.html
index dc30f33be77..f11416eba57 100644
--- a/docs/dyn/content_v2sandbox.orders.html
+++ b/docs/dyn/content_v2sandbox.orders.html
@@ -76,56 +76,56 @@ <h1><a href="content_v2sandbox.html">Content API for Shopping</a> . <a href="con
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#acknowledge">acknowledge(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Marks an order as acknowledged.</p>
+<p class="firstline">Marks an order as acknowledged. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#advancetestorder">advancetestorder(merchantId, orderId)</a></code></p>
-<p class="firstline">Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment".</p>
+<p class="firstline">Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment". This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#cancel">cancel(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Cancels all line items in an order.</p>
+<p class="firstline">Cancels all line items in an order. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#cancellineitem">cancellineitem(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Cancels a line item.</p>
+<p class="firstline">Cancels a line item. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#createtestorder">createtestorder(merchantId, body)</a></code></p>
-<p class="firstline">Sandbox only. Creates a test order.</p>
+<p class="firstline">Sandbox only. Creates a test order. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#custombatch">custombatch(body)</a></code></p>
-<p class="firstline">Retrieves or modifies multiple orders in a single request.</p>
+<p class="firstline">Retrieves or modifies multiple orders in a single request. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#get">get(merchantId, orderId)</a></code></p>
-<p class="firstline">Retrieves an order from your Merchant Center account.</p>
+<p class="firstline">Retrieves an order from your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#getbymerchantorderid">getbymerchantorderid(merchantId, merchantOrderId)</a></code></p>
-<p class="firstline">Retrieves an order using merchant order id.</p>
+<p class="firstline">Retrieves an order using merchant order id. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#gettestordertemplate">gettestordertemplate(merchantId, templateName)</a></code></p>
-<p class="firstline">Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox.</p>
+<p class="firstline">Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list">list(merchantId, orderBy=None, pageToken=None, placedDateEnd=None, acknowledged=None, maxResults=None, placedDateStart=None, statuses=None)</a></code></p>
-<p class="firstline">Lists the orders in your Merchant Center account.</p>
+<p class="firstline">Lists the orders in your Merchant Center account. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#refund">refund(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Refund a portion of the order, up to the full amount paid.</p>
+<p class="firstline">Refund a portion of the order, up to the full amount paid. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#returnlineitem">returnlineitem(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Returns a line item.</p>
+<p class="firstline">Returns a line item. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#shiplineitems">shiplineitems(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Marks line item(s) as shipped.</p>
+<p class="firstline">Marks line item(s) as shipped. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#updatemerchantorderid">updatemerchantorderid(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Updates the merchant order ID for a given order.</p>
+<p class="firstline">Updates the merchant order ID for a given order. This method can only be called for non-multi-client accounts.</p>
 <p class="toc_element">
   <code><a href="#updateshipment">updateshipment(merchantId, orderId, body)</a></code></p>
-<p class="firstline">Updates a shipment's status, carrier, and/or tracking ID.</p>
+<p class="firstline">Updates a shipment's status, carrier, and/or tracking ID. This method can only be called for non-multi-client accounts.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="acknowledge">acknowledge(merchantId, orderId, body)</code>
-  <pre>Marks an order as acknowledged.
+  <pre>Marks an order as acknowledged. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="advancetestorder">advancetestorder(merchantId, orderId)</code>
-  <pre>Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment".
+  <pre>Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment". This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -165,7 +165,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="cancel">cancel(merchantId, orderId, body)</code>
-  <pre>Cancels all line items in an order.
+  <pre>Cancels all line items in an order. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -191,7 +191,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="cancellineitem">cancellineitem(merchantId, orderId, body)</code>
-  <pre>Cancels a line item.
+  <pre>Cancels a line item. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -223,7 +223,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="createtestorder">createtestorder(merchantId, body)</code>
-  <pre>Sandbox only. Creates a test order.
+  <pre>Sandbox only. Creates a test order. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -233,7 +233,7 @@ <h3>Method Details</h3>
 {
     "testOrder": { # The test order to create.
       "customer": { # The details of the customer who placed the order.
-        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow. Optional.
+        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. Optional.
         "fullName": "A String", # Full name of the customer.
         "email": "A String", # Email address of the customer.
       },
@@ -346,7 +346,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="custombatch">custombatch(body)</code>
-  <pre>Retrieves or modifies multiple orders in a single request.
+  <pre>Retrieves or modifies multiple orders in a single request. This method can only be called for non-multi-client accounts.
 
 Args:
   body: object, The request body. (required)
@@ -433,7 +433,7 @@ <h3>Method Details</h3>
         },
         "order": { # The retrieved order. Only defined if the method is get and if the request was successful.
           "customer": { # The details of the customer who placed the order.
-            "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.
+            "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.
             "fullName": "A String", # Full name of the customer.
             "email": "A String", # Email address of the customer.
           },
@@ -647,7 +647,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(merchantId, orderId)</code>
-  <pre>Retrieves an order from your Merchant Center account.
+  <pre>Retrieves an order from your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -658,7 +658,7 @@ <h3>Method Details</h3>
 
     {
     "customer": { # The details of the customer who placed the order.
-      "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.
+      "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.
       "fullName": "A String", # Full name of the customer.
       "email": "A String", # Email address of the customer.
     },
@@ -868,7 +868,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="getbymerchantorderid">getbymerchantorderid(merchantId, merchantOrderId)</code>
-  <pre>Retrieves an order using merchant order id.
+  <pre>Retrieves an order using merchant order id. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -881,7 +881,7 @@ <h3>Method Details</h3>
     "kind": "content#ordersGetByMerchantOrderIdResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetByMerchantOrderIdResponse".
     "order": { # The requested order.
       "customer": { # The details of the customer who placed the order.
-        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.
+        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.
         "fullName": "A String", # Full name of the customer.
         "email": "A String", # Email address of the customer.
       },
@@ -1092,7 +1092,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="gettestordertemplate">gettestordertemplate(merchantId, templateName)</code>
-  <pre>Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox.
+  <pre>Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1110,7 +1110,7 @@ <h3>Method Details</h3>
     "kind": "content#ordersGetTestOrderTemplateResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetTestOrderTemplateResponse".
     "template": { # The requested test order template.
       "customer": { # The details of the customer who placed the order.
-        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow. Optional.
+        "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. Optional.
         "fullName": "A String", # Full name of the customer.
         "email": "A String", # Email address of the customer.
       },
@@ -1213,7 +1213,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(merchantId, orderBy=None, pageToken=None, placedDateEnd=None, acknowledged=None, maxResults=None, placedDateStart=None, statuses=None)</code>
-  <pre>Lists the orders in your Merchant Center account.
+  <pre>Lists the orders in your Merchant Center account. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1251,7 +1251,7 @@ <h3>Method Details</h3>
     "resources": [
       {
         "customer": { # The details of the customer who placed the order.
-          "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.
+          "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.
           "fullName": "A String", # Full name of the customer.
           "email": "A String", # Email address of the customer.
         },
@@ -1477,7 +1477,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="refund">refund(merchantId, orderId, body)</code>
-  <pre>Refund a portion of the order, up to the full amount paid.
+  <pre>Refund a portion of the order, up to the full amount paid. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1507,7 +1507,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="returnlineitem">returnlineitem(merchantId, orderId, body)</code>
-  <pre>Returns a line item.
+  <pre>Returns a line item. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1535,7 +1535,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="shiplineitems">shiplineitems(merchantId, orderId, body)</code>
-  <pre>Marks line item(s) as shipped.
+  <pre>Marks line item(s) as shipped. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1568,7 +1568,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="updatemerchantorderid">updatemerchantorderid(merchantId, orderId, body)</code>
-  <pre>Updates the merchant order ID for a given order.
+  <pre>Updates the merchant order ID for a given order. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
@@ -1593,7 +1593,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="updateshipment">updateshipment(merchantId, orderId, body)</code>
-  <pre>Updates a shipment's status, carrier, and/or tracking ID.
+  <pre>Updates a shipment's status, carrier, and/or tracking ID. This method can only be called for non-multi-client accounts.
 
 Args:
   merchantId: string, The ID of the managing account. (required)
diff --git a/docs/dyn/dataflow_v1b3.projects.html b/docs/dyn/dataflow_v1b3.projects.html
index 341d3efeb45..6323230d027 100644
--- a/docs/dyn/dataflow_v1b3.projects.html
+++ b/docs/dyn/dataflow_v1b3.projects.html
@@ -79,6 +79,11 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the jobs Resource.</p>
 
+<p class="toc_element">
+  <code><a href="dataflow_v1b3.projects.locations.html">locations()</a></code>
+</p>
+<p class="firstline">Returns the locations Resource.</p>
+
 <p class="toc_element">
   <code><a href="dataflow_v1b3.projects.templates.html">templates()</a></code>
 </p>
diff --git a/docs/dyn/dataflow_v1b3.projects.jobs.html b/docs/dyn/dataflow_v1b3.projects.jobs.html
index 40bf9647a24..767ca769796 100644
--- a/docs/dyn/dataflow_v1b3.projects.jobs.html
+++ b/docs/dyn/dataflow_v1b3.projects.jobs.html
@@ -90,26 +90,26 @@ <h2>Instance Methods</h2>
 <p class="firstline">Returns the workItems Resource.</p>
 
 <p class="toc_element">
-  <code><a href="#create">create(projectId, body, x__xgafv=None, replaceJobId=None, view=None)</a></code></p>
+  <code><a href="#create">create(projectId, body, location=None, x__xgafv=None, replaceJobId=None, view=None)</a></code></p>
 <p class="firstline">Creates a dataflow job.</p>
 <p class="toc_element">
-  <code><a href="#get">get(projectId, jobId, x__xgafv=None, view=None)</a></code></p>
+  <code><a href="#get">get(projectId, jobId, location=None, x__xgafv=None, view=None)</a></code></p>
 <p class="firstline">Gets the state of the specified dataflow job.</p>
 <p class="toc_element">
-  <code><a href="#getMetrics">getMetrics(projectId, jobId, startTime=None, x__xgafv=None)</a></code></p>
+  <code><a href="#getMetrics">getMetrics(projectId, jobId, startTime=None, location=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Request the job status.</p>
 <p class="toc_element">
-  <code><a href="#list">list(projectId, pageSize=None, filter=None, pageToken=None, x__xgafv=None, view=None)</a></code></p>
+  <code><a href="#list">list(projectId, pageSize=None, x__xgafv=None, pageToken=None, location=None, filter=None, view=None)</a></code></p>
 <p class="firstline">List the jobs of a project</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#update">update(projectId, jobId, body, x__xgafv=None)</a></code></p>
+  <code><a href="#update">update(projectId, jobId, body, location=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Updates the state of an existing dataflow job.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(projectId, body, x__xgafv=None, replaceJobId=None, view=None)</code>
+    <code class="details" id="create">create(projectId, body, location=None, x__xgafv=None, replaceJobId=None, view=None)</code>
   <pre>Creates a dataflow job.
 
 Args:
@@ -121,6 +121,7 @@ <h3>Method Details</h3>
     "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
     "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
     "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+    "location": "A String", # The location which contains this job.
     "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
     "projectId": "A String", # The project which owns the job.
     "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
@@ -252,6 +253,7 @@ <h3>Method Details</h3>
     },
   }
 
+  location: string, The location which contains this job.
   x__xgafv: string, V1 error format.
   replaceJobId: string, DEPRECATED. This field is now on the Job message.
   view: string, Level of information requested in response.
@@ -263,6 +265,7 @@ <h3>Method Details</h3>
       "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
       "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
       "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+      "location": "A String", # The location which contains this job.
       "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
       "projectId": "A String", # The project which owns the job.
       "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
@@ -396,12 +399,13 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="get">get(projectId, jobId, x__xgafv=None, view=None)</code>
+    <code class="details" id="get">get(projectId, jobId, location=None, x__xgafv=None, view=None)</code>
   <pre>Gets the state of the specified dataflow job.
 
 Args:
   projectId: string, The project which owns the job. (required)
   jobId: string, Identifies a single job. (required)
+  location: string, The location which contains this job.
   x__xgafv: string, V1 error format.
   view: string, Level of information requested in response.
 
@@ -412,6 +416,7 @@ <h3>Method Details</h3>
       "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
       "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
       "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+      "location": "A String", # The location which contains this job.
       "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
       "projectId": "A String", # The project which owns the job.
       "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
@@ -545,13 +550,14 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="getMetrics">getMetrics(projectId, jobId, startTime=None, x__xgafv=None)</code>
+    <code class="details" id="getMetrics">getMetrics(projectId, jobId, startTime=None, location=None, x__xgafv=None)</code>
   <pre>Request the job status.
 
 Args:
   projectId: string, A project id. (required)
   jobId: string, The job to get messages for. (required)
   startTime: string, Return only metric data that has changed since this time. Default is to return all information about all metrics for the job.
+  location: string, The location which contains the job specified by job_id.
   x__xgafv: string, V1 error format.
 
 Returns:
@@ -583,15 +589,16 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(projectId, pageSize=None, filter=None, pageToken=None, x__xgafv=None, view=None)</code>
+    <code class="details" id="list">list(projectId, pageSize=None, x__xgafv=None, pageToken=None, location=None, filter=None, view=None)</code>
   <pre>List the jobs of a project
 
 Args:
   projectId: string, The project which owns the jobs. (required)
   pageSize: integer, If there are many jobs, limit response to at most this many. The actual number of jobs returned will be the lesser of max_responses and an unspecified server-defined limit.
-  filter: string, The kind of filter to use.
-  pageToken: string, Set this to the 'next_page_token' field of a previous response to request additional results in a long list.
   x__xgafv: string, V1 error format.
+  pageToken: string, Set this to the 'next_page_token' field of a previous response to request additional results in a long list.
+  location: string, The location which contains this job.
+  filter: string, The kind of filter to use.
   view: string, Level of information requested in response. Default is SUMMARY.
 
 Returns:
@@ -599,11 +606,17 @@ <h3>Method Details</h3>
 
     { # Response to a request to list Dataflow jobs. This may be a partial response, depending on the page size in the ListJobsRequest.
     "nextPageToken": "A String", # Set if there may be more results than fit in this response.
+    "failedLocation": [ # Zero or more messages describing locations that failed to respond.
+      { # FailedLocation indicates which location failed to respond to a request for data.
+        "name": "A String", # The name of the failed location.
+      },
+    ],
     "jobs": [ # A subset of the requested job information.
       { # Defines a job to be run by the Dataflow service.
           "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
           "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
           "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+          "location": "A String", # The location which contains this job.
           "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
           "projectId": "A String", # The project which owns the job.
           "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
@@ -753,7 +766,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(projectId, jobId, body, x__xgafv=None)</code>
+    <code class="details" id="update">update(projectId, jobId, body, location=None, x__xgafv=None)</code>
   <pre>Updates the state of an existing dataflow job.
 
 Args:
@@ -766,6 +779,7 @@ <h3>Method Details</h3>
     "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
     "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
     "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+    "location": "A String", # The location which contains this job.
     "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
     "projectId": "A String", # The project which owns the job.
     "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
@@ -897,6 +911,7 @@ <h3>Method Details</h3>
     },
   }
 
+  location: string, The location which contains this job.
   x__xgafv: string, V1 error format.
 
 Returns:
@@ -906,6 +921,7 @@ <h3>Method Details</h3>
       "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
       "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
       "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+      "location": "A String", # The location which contains this job.
       "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
       "projectId": "A String", # The project which owns the job.
       "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
diff --git a/docs/dyn/dataflow_v1b3.projects.jobs.messages.html b/docs/dyn/dataflow_v1b3.projects.jobs.messages.html
index a33e7cd30d7..86bed2f3771 100644
--- a/docs/dyn/dataflow_v1b3.projects.jobs.messages.html
+++ b/docs/dyn/dataflow_v1b3.projects.jobs.messages.html
@@ -75,14 +75,14 @@
 <h1><a href="dataflow_v1b3.html">Google Dataflow API</a> . <a href="dataflow_v1b3.projects.html">projects</a> . <a href="dataflow_v1b3.projects.jobs.html">jobs</a> . <a href="dataflow_v1b3.projects.jobs.messages.html">messages</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#list">list(projectId, jobId, startTime=None, pageSize=None, x__xgafv=None, pageToken=None, minimumImportance=None, endTime=None)</a></code></p>
+  <code><a href="#list">list(projectId, jobId, startTime=None, pageSize=None, x__xgafv=None, pageToken=None, location=None, minimumImportance=None, endTime=None)</a></code></p>
 <p class="firstline">Request the job status.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="list">list(projectId, jobId, startTime=None, pageSize=None, x__xgafv=None, pageToken=None, minimumImportance=None, endTime=None)</code>
+    <code class="details" id="list">list(projectId, jobId, startTime=None, pageSize=None, x__xgafv=None, pageToken=None, location=None, minimumImportance=None, endTime=None)</code>
   <pre>Request the job status.
 
 Args:
@@ -92,6 +92,7 @@ <h3>Method Details</h3>
   pageSize: integer, If specified, determines the maximum number of messages to return. If unspecified, the service may choose an appropriate default, or may return an arbitrarily large number of results.
   x__xgafv: string, V1 error format.
   pageToken: string, If supplied, this should be the value of next_page_token returned by an earlier call. This will cause the next page of results to be returned.
+  location: string, The location which contains the job specified by job_id.
   minimumImportance: string, Filter to only get messages with importance >= level
   endTime: string, Return only messages with timestamps < end_time. The default is now (i.e. return up to the latest messages available).
 
diff --git a/docs/dyn/dataflow_v1b3.projects.jobs.workItems.html b/docs/dyn/dataflow_v1b3.projects.jobs.workItems.html
index fdd8cef7a67..73d834ab2b6 100644
--- a/docs/dyn/dataflow_v1b3.projects.jobs.workItems.html
+++ b/docs/dyn/dataflow_v1b3.projects.jobs.workItems.html
@@ -95,12 +95,13 @@ <h3>Method Details</h3>
     "workItemTypes": [ # Filter for WorkItem type.
       "A String",
     ],
-    "requestedLeaseDuration": "A String", # The initial lease period.
     "workerCapabilities": [ # Worker capabilities. WorkItems might be limited to workers with specific capabilities.
       "A String",
     ],
-    "currentWorkerTime": "A String", # The current timestamp at the worker.
+    "requestedLeaseDuration": "A String", # The initial lease period.
     "workerId": "A String", # Identifies the worker leasing work -- typically the ID of the virtual machine running the worker.
+    "currentWorkerTime": "A String", # The current timestamp at the worker.
+    "location": "A String", # The location which contains the WorkItem's job.
   }
 
   x__xgafv: string, V1 error format.
@@ -406,6 +407,7 @@ <h3>Method Details</h3>
                       "topic": "A String", # A pubsub topic, in the form of "pubsub.googleapis.com/topics/
                           # /"
                       "trackingSubscription": "A String", # If set, specifies the pubsub subscription that will be used for tracking custom time timestamps for watermark estimation.
+                      "withAttributes": True or False, # If true, then the client has requested to get pubsub attributes.
                       "subscription": "A String", # A pubsub subscription, in the form of "pubsub.googleapis.com/subscriptions/
                           # /"
                     },
@@ -441,6 +443,7 @@ <h3>Method Details</h3>
                       "topic": "A String", # A pubsub topic, in the form of "pubsub.googleapis.com/topics/
                           # /"
                       "trackingSubscription": "A String", # If set, specifies the pubsub subscription that will be used for tracking custom time timestamps for watermark estimation.
+                      "withAttributes": True or False, # If true, then the client has requested to get pubsub attributes.
                       "subscription": "A String", # A pubsub subscription, in the form of "pubsub.googleapis.com/subscriptions/
                           # /"
                     },
@@ -1021,6 +1024,7 @@ <h3>Method Details</h3>
         },
       },
     ],
+    "location": "A String", # The location which contains the WorkItem's job.
   }
 
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/dataflow_v1b3.projects.locations.html b/docs/dyn/dataflow_v1b3.projects.locations.html
new file mode 100644
index 00000000000..fa802c37dd2
--- /dev/null
+++ b/docs/dyn/dataflow_v1b3.projects.locations.html
@@ -0,0 +1,82 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dataflow_v1b3.html">Google Dataflow API</a> . <a href="dataflow_v1b3.projects.html">projects</a> . <a href="dataflow_v1b3.projects.locations.html">locations</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="dataflow_v1b3.projects.locations.jobs.html">jobs()</a></code>
+</p>
+<p class="firstline">Returns the jobs Resource.</p>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dataflow_v1b3.projects.locations.jobs.html b/docs/dyn/dataflow_v1b3.projects.locations.jobs.html
new file mode 100644
index 00000000000..0382ca7cea5
--- /dev/null
+++ b/docs/dyn/dataflow_v1b3.projects.locations.jobs.html
@@ -0,0 +1,1052 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dataflow_v1b3.html">Google Dataflow API</a> . <a href="dataflow_v1b3.projects.html">projects</a> . <a href="dataflow_v1b3.projects.locations.html">locations</a> . <a href="dataflow_v1b3.projects.locations.jobs.html">jobs</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="dataflow_v1b3.projects.locations.jobs.messages.html">messages()</a></code>
+</p>
+<p class="firstline">Returns the messages Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dataflow_v1b3.projects.locations.jobs.workItems.html">workItems()</a></code>
+</p>
+<p class="firstline">Returns the workItems Resource.</p>
+
+<p class="toc_element">
+  <code><a href="#create">create(projectId, location, body, x__xgafv=None, replaceJobId=None, view=None)</a></code></p>
+<p class="firstline">Creates a dataflow job.</p>
+<p class="toc_element">
+  <code><a href="#get">get(projectId, location, jobId, x__xgafv=None, view=None)</a></code></p>
+<p class="firstline">Gets the state of the specified dataflow job.</p>
+<p class="toc_element">
+  <code><a href="#getMetrics">getMetrics(projectId, location, jobId, startTime=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Request the job status.</p>
+<p class="toc_element">
+  <code><a href="#list">list(projectId, location, pageSize=None, x__xgafv=None, pageToken=None, filter=None, view=None)</a></code></p>
+<p class="firstline">List the jobs of a project</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#update">update(projectId, location, jobId, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates the state of an existing dataflow job.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="create">create(projectId, location, body, x__xgafv=None, replaceJobId=None, view=None)</code>
+  <pre>Creates a dataflow job.
+
+Args:
+  projectId: string, The project which owns the job. (required)
+  location: string, The location which contains this job. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Defines a job to be run by the Dataflow service.
+    "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
+    "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
+    "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+    "location": "A String", # The location which contains this job.
+    "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
+    "projectId": "A String", # The project which owns the job.
+    "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
+      "a_key": "A String",
+    },
+    "transformNameMapping": { # Map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.
+      "a_key": "A String",
+    },
+    "createTime": "A String", # Timestamp when job was initially created. Immutable, set by the Dataflow service.
+    "environment": { # Describes the environment in which a Dataflow Job runs. # Environment for the job.
+      "version": { # A structure describing which components and their versions of the service are required in order to run the job.
+        "a_key": "", # Properties of the object.
+      },
+      "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The system will append the suffix "/temp-{JOBNAME} to this resource prefix, where {JOBNAME} is the value of the job_name field. The resulting bucket and object prefix is used as the prefix of the resources used to store temporary data needed during the job execution. NOTE: This will override the value in taskrunner_settings. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+      "internalExperiments": { # Experimental settings.
+        "a_key": "", # Properties of the object. Contains field @type with type URL.
+      },
+      "dataset": "A String", # The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset}
+      "experiments": [ # The list of experiments to enable.
+        "A String",
+      ],
+      "serviceAccountEmail": "A String", # Identity to run virtual machines as. Defaults to the default account.
+      "sdkPipelineOptions": { # The Dataflow SDK pipeline options specified by the user. These options are passed through the service and are used to recreate the SDK pipeline options on the worker in a language agnostic and platform independent way.
+        "a_key": "", # Properties of the object.
+      },
+      "userAgent": { # A description of the process that generated the request.
+        "a_key": "", # Properties of the object.
+      },
+      "clusterManagerApiService": "A String", # The type of cluster manager API to use. If unknown or unspecified, the service will attempt to choose a reasonable default. This should be in the form of the API service name, e.g. "compute.googleapis.com".
+      "workerPools": [ # Worker pools. At least one "harness" worker pool must be specified in order for the job to have workers.
+        { # Describes one particular pool of Dataflow workers to be instantiated by the Dataflow service in order to perform the computations required by a job. Note that a workflow job may use multiple pools, in order to match the various computational requirements of the various stages of the job.
+          "diskSourceImage": "A String", # Fully qualified source image for disks.
+          "taskrunnerSettings": { # Taskrunner configuration settings. # Settings passed through to Google Compute Engine workers when using the standard Dataflow task runner. Users should ignore this field.
+            "workflowFileName": "A String", # Store the workflow in this file.
+            "logUploadLocation": "A String", # Indicates where to put logs. If this is not specified, the logs will not be uploaded. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+            "commandlinesFileName": "A String", # Store preprocessing commands in this file.
+            "parallelWorkerSettings": { # Provides data to pass through to the worker harness. # Settings to pass to the parallel worker harness.
+              "reportingEnabled": True or False, # Send work progress updates to service.
+              "shuffleServicePath": "A String", # The Shuffle service path relative to the root URL, for example, "shuffle/v1beta1".
+              "workerId": "A String", # ID of the worker running this pipeline.
+              "baseUrl": "A String", # The base URL for accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+              "servicePath": "A String", # The Dataflow service path relative to the root URL, for example, "dataflow/v1b3/projects".
+              "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+            },
+            "vmId": "A String", # ID string of VM.
+            "baseTaskDir": "A String", # Location on the worker for task-specific subdirectories.
+            "continueOnException": True or False, # Do we continue taskrunner if an exception is hit?
+            "baseUrl": "A String", # The base URL for the taskrunner to use when accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+            "taskUser": "A String", # The UNIX user ID on the worker VM to use for tasks launched by taskrunner; e.g. "root".
+            "taskGroup": "A String", # The UNIX group ID on the worker VM to use for tasks launched by taskrunner; e.g. "wheel".
+            "oauthScopes": [ # OAuth2 scopes to be requested by the taskrunner in order to access the dataflow API.
+              "A String",
+            ],
+            "languageHint": "A String", # Suggested backend language.
+            "logToSerialconsole": True or False, # Send taskrunner log into to Google Compute Engine VM serial console?
+            "streamingWorkerMainClass": "A String", # Streaming worker main class name.
+            "logDir": "A String", # Directory on the VM to store logs.
+            "dataflowApiVersion": "A String", # API version of endpoint, e.g. "v1b3"
+            "harnessCommand": "A String", # Command to launch the worker harness.
+            "tempStoragePrefix": "A String", # The prefix of the resources the taskrunner should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+            "alsologtostderr": True or False, # Also send taskrunner log info to stderr?
+          },
+          "kind": "A String", # The kind of the worker pool; currently only 'harness' and 'shuffle' are supported.
+          "machineType": "A String", # Machine type (e.g. "n1-standard-1"). If empty or unspecified, the service will attempt to choose a reasonable default.
+          "network": "A String", # Network to which VMs will be assigned. If empty or unspecified, the service will use the network "default".
+          "zone": "A String", # Zone to run the worker pools in. If empty or unspecified, the service will attempt to choose a reasonable default.
+          "numThreadsPerWorker": 42, # The number of threads per worker harness. If empty or unspecified, the service will choose a number of threads (according to the number of cores on the selected machine type for batch, or 1 by convention for streaming).
+          "ipConfiguration": "A String", # Configuration for VM IPs.
+          "onHostMaintenance": "A String", # The action to take on host maintenance, as defined by the Google Compute Engine API.
+          "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default.
+          "teardownPolicy": "A String", # Sets the policy for determining when to turndown worker pool. Allowed values are: TEARDOWN_ALWAYS, TEARDOWN_ON_SUCCESS, and TEARDOWN_NEVER. TEARDOWN_ALWAYS means workers are always torn down regardless of whether the job succeeds. TEARDOWN_ON_SUCCESS means workers are torn down if the job succeeds. TEARDOWN_NEVER means the workers are never torn down. If the workers are not torn down by the service, they will continue to run and use Google Compute Engine VM resources in the user's project until they are explicitly terminated by the user. Because of this, Google recommends using the TEARDOWN_ALWAYS policy except for small, manually supervised test jobs. If unknown or unspecified, the service will attempt to choose a reasonable default.
+          "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+          "metadata": { # Metadata to set on the Google Compute Engine VMs.
+            "a_key": "A String",
+          },
+          "poolArgs": { # Extra arguments for this worker pool.
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+          "numWorkers": 42, # Number of Google Compute Engine workers in this pool needed to execute the job. If zero or unspecified, the service will attempt to choose a reasonable default.
+          "workerHarnessContainerImage": "A String", # Docker container image that executes Dataflow worker harness, residing in Google Container Registry. Required.
+          "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language.
+          "packages": [ # Packages to be installed on workers.
+            { # Packages that need to be installed in order for a worker to run the steps of the Dataflow job which will be assigned to its worker pool. This is the mechanism by which the SDK causes code to be loaded onto the workers. For example, the Dataflow Java SDK might use this to install jars containing the user's code and all of the various dependencies (libraries, data files, etc) required in order for that code to run.
+              "name": "A String", # The name of the package.
+              "location": "A String", # The resource to read the package from. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket} bucket.storage.googleapis.com/
+            },
+          ],
+          "autoscalingSettings": { # Settings for WorkerPool autoscaling. # Settings for autoscaling of this WorkerPool.
+            "maxNumWorkers": 42, # The maximum number of workers to cap scaling at.
+            "algorithm": "A String", # The algorithm to use for autoscaling.
+          },
+          "subnetwork": "A String", # Subnetwork to which VMs will be assigned, if desired. Expected to be of the form "regions/REGION/subnetworks/SUBNETWORK".
+          "dataDisks": [ # Data disks that are used by a VM in this workflow.
+            { # Describes the data disk used by a workflow job.
+              "mountPoint": "A String", # Directory in a VM where disk is mounted.
+              "sizeGb": 42, # Size of disk in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+              "diskType": "A String", # Disk storage type, as defined by Google Compute Engine. This must be a disk type appropriate to the project and zone in which the workers will run. If unknown or unspecified, the service will attempt to choose a reasonable default. For example, the standard persistent disk type is a resource name typically ending in "pd-standard". If SSD persistent disks are available, the resource name typically ends with "pd-ssd". The actual valid values are defined the Google Compute Engine API, not by the Dataflow API; consult the Google Compute Engine documentation for more information about determining the set of available disk types for a particular project and zone. Google Compute Engine Disk types are local to a particular project in a particular zone, and so the resource name will typically look something like this: compute.googleapis.com/projects/
+                  # /zones//diskTypes/pd-standard
+            },
+          ],
+        },
+      ],
+    },
+    "replaceJobId": "A String", # If this job is an update of an existing job, this field will be the ID of the job it replaced. When sending a CreateJobRequest, you can update a job by specifying it here. The job named here will be stopped, and its intermediate state transferred to this job.
+    "steps": [ # The top-level steps that constitute the entire job.
+      { # Defines a particular step within a Dataflow job. A job consists of multiple steps, each of which performs some specific operation as part of the overall job. Data is typically passed from one step to another as part of the job. Here's an example of a sequence of steps which together implement a Map-Reduce job: * Read a collection of data from some source, parsing the collection's elements. * Validate the elements. * Apply a user-defined function to map each element to some value and extract an element-specific key value. * Group elements with the same key into a single element with that key, transforming a multiply-keyed collection into a uniquely-keyed collection. * Write the elements out to some data sink. (Note that the Dataflow service may be used to run many different types of jobs, not just Map-Reduce).
+        "kind": "A String", # The kind of step in the dataflow Job.
+        "name": "A String", # Name identifying the step. This must be unique for each step with respect to all other steps in the dataflow Job.
+        "properties": { # Named properties associated with the step. Each kind of predefined step has its own required set of properties.
+          "a_key": "", # Properties of the object.
+        },
+      },
+    ],
+    "currentStateTime": "A String", # The timestamp associated with the current state.
+    "tempFiles": [ # A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported. The supported files are: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+      "A String",
+    ],
+    "type": "A String", # The type of dataflow job.
+    "id": "A String", # The unique ID of this job. This field is set by the Dataflow service when the Job is created, and is immutable for the life of the Job.
+    "currentState": "A String", # The current state of the job. Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified. A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. Once a job has reached a terminal state, no further state updates may be made. This field may be mutated by the Dataflow service; callers cannot mutate it.
+    "executionInfo": { # Additional information about how a Dataflow job will be executed which isn’t contained in the submitted job. # Information about how the Dataflow service will actually run the job.
+      "stages": { # A mapping from each stage to the information about that stage.
+        "a_key": { # Contains information about how a particular google.dataflow.v1beta3.Step will be executed.
+          "stepName": [ # The steps associated with the execution stage. Note that stages may have several steps, and that a given step might be run by more than one stage.
+            "A String",
+          ],
+        },
+      },
+    },
+  }
+
+  x__xgafv: string, V1 error format.
+  replaceJobId: string, DEPRECATED. This field is now on the Job message.
+  view: string, Level of information requested in response.
+
+Returns:
+  An object of the form:
+
+    { # Defines a job to be run by the Dataflow service.
+      "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
+      "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
+      "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+      "location": "A String", # The location which contains this job.
+      "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
+      "projectId": "A String", # The project which owns the job.
+      "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
+        "a_key": "A String",
+      },
+      "transformNameMapping": { # Map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.
+        "a_key": "A String",
+      },
+      "createTime": "A String", # Timestamp when job was initially created. Immutable, set by the Dataflow service.
+      "environment": { # Describes the environment in which a Dataflow Job runs. # Environment for the job.
+        "version": { # A structure describing which components and their versions of the service are required in order to run the job.
+          "a_key": "", # Properties of the object.
+        },
+        "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The system will append the suffix "/temp-{JOBNAME} to this resource prefix, where {JOBNAME} is the value of the job_name field. The resulting bucket and object prefix is used as the prefix of the resources used to store temporary data needed during the job execution. NOTE: This will override the value in taskrunner_settings. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+        "internalExperiments": { # Experimental settings.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
+        },
+        "dataset": "A String", # The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset}
+        "experiments": [ # The list of experiments to enable.
+          "A String",
+        ],
+        "serviceAccountEmail": "A String", # Identity to run virtual machines as. Defaults to the default account.
+        "sdkPipelineOptions": { # The Dataflow SDK pipeline options specified by the user. These options are passed through the service and are used to recreate the SDK pipeline options on the worker in a language agnostic and platform independent way.
+          "a_key": "", # Properties of the object.
+        },
+        "userAgent": { # A description of the process that generated the request.
+          "a_key": "", # Properties of the object.
+        },
+        "clusterManagerApiService": "A String", # The type of cluster manager API to use. If unknown or unspecified, the service will attempt to choose a reasonable default. This should be in the form of the API service name, e.g. "compute.googleapis.com".
+        "workerPools": [ # Worker pools. At least one "harness" worker pool must be specified in order for the job to have workers.
+          { # Describes one particular pool of Dataflow workers to be instantiated by the Dataflow service in order to perform the computations required by a job. Note that a workflow job may use multiple pools, in order to match the various computational requirements of the various stages of the job.
+            "diskSourceImage": "A String", # Fully qualified source image for disks.
+            "taskrunnerSettings": { # Taskrunner configuration settings. # Settings passed through to Google Compute Engine workers when using the standard Dataflow task runner. Users should ignore this field.
+              "workflowFileName": "A String", # Store the workflow in this file.
+              "logUploadLocation": "A String", # Indicates where to put logs. If this is not specified, the logs will not be uploaded. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              "commandlinesFileName": "A String", # Store preprocessing commands in this file.
+              "parallelWorkerSettings": { # Provides data to pass through to the worker harness. # Settings to pass to the parallel worker harness.
+                "reportingEnabled": True or False, # Send work progress updates to service.
+                "shuffleServicePath": "A String", # The Shuffle service path relative to the root URL, for example, "shuffle/v1beta1".
+                "workerId": "A String", # ID of the worker running this pipeline.
+                "baseUrl": "A String", # The base URL for accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+                "servicePath": "A String", # The Dataflow service path relative to the root URL, for example, "dataflow/v1b3/projects".
+                "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              },
+              "vmId": "A String", # ID string of VM.
+              "baseTaskDir": "A String", # Location on the worker for task-specific subdirectories.
+              "continueOnException": True or False, # Do we continue taskrunner if an exception is hit?
+              "baseUrl": "A String", # The base URL for the taskrunner to use when accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+              "taskUser": "A String", # The UNIX user ID on the worker VM to use for tasks launched by taskrunner; e.g. "root".
+              "taskGroup": "A String", # The UNIX group ID on the worker VM to use for tasks launched by taskrunner; e.g. "wheel".
+              "oauthScopes": [ # OAuth2 scopes to be requested by the taskrunner in order to access the dataflow API.
+                "A String",
+              ],
+              "languageHint": "A String", # Suggested backend language.
+              "logToSerialconsole": True or False, # Send taskrunner log into to Google Compute Engine VM serial console?
+              "streamingWorkerMainClass": "A String", # Streaming worker main class name.
+              "logDir": "A String", # Directory on the VM to store logs.
+              "dataflowApiVersion": "A String", # API version of endpoint, e.g. "v1b3"
+              "harnessCommand": "A String", # Command to launch the worker harness.
+              "tempStoragePrefix": "A String", # The prefix of the resources the taskrunner should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              "alsologtostderr": True or False, # Also send taskrunner log info to stderr?
+            },
+            "kind": "A String", # The kind of the worker pool; currently only 'harness' and 'shuffle' are supported.
+            "machineType": "A String", # Machine type (e.g. "n1-standard-1"). If empty or unspecified, the service will attempt to choose a reasonable default.
+            "network": "A String", # Network to which VMs will be assigned. If empty or unspecified, the service will use the network "default".
+            "zone": "A String", # Zone to run the worker pools in. If empty or unspecified, the service will attempt to choose a reasonable default.
+            "numThreadsPerWorker": 42, # The number of threads per worker harness. If empty or unspecified, the service will choose a number of threads (according to the number of cores on the selected machine type for batch, or 1 by convention for streaming).
+            "ipConfiguration": "A String", # Configuration for VM IPs.
+            "onHostMaintenance": "A String", # The action to take on host maintenance, as defined by the Google Compute Engine API.
+            "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default.
+            "teardownPolicy": "A String", # Sets the policy for determining when to turndown worker pool. Allowed values are: TEARDOWN_ALWAYS, TEARDOWN_ON_SUCCESS, and TEARDOWN_NEVER. TEARDOWN_ALWAYS means workers are always torn down regardless of whether the job succeeds. TEARDOWN_ON_SUCCESS means workers are torn down if the job succeeds. TEARDOWN_NEVER means the workers are never torn down. If the workers are not torn down by the service, they will continue to run and use Google Compute Engine VM resources in the user's project until they are explicitly terminated by the user. Because of this, Google recommends using the TEARDOWN_ALWAYS policy except for small, manually supervised test jobs. If unknown or unspecified, the service will attempt to choose a reasonable default.
+            "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+            "metadata": { # Metadata to set on the Google Compute Engine VMs.
+              "a_key": "A String",
+            },
+            "poolArgs": { # Extra arguments for this worker pool.
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+            "numWorkers": 42, # Number of Google Compute Engine workers in this pool needed to execute the job. If zero or unspecified, the service will attempt to choose a reasonable default.
+            "workerHarnessContainerImage": "A String", # Docker container image that executes Dataflow worker harness, residing in Google Container Registry. Required.
+            "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language.
+            "packages": [ # Packages to be installed on workers.
+              { # Packages that need to be installed in order for a worker to run the steps of the Dataflow job which will be assigned to its worker pool. This is the mechanism by which the SDK causes code to be loaded onto the workers. For example, the Dataflow Java SDK might use this to install jars containing the user's code and all of the various dependencies (libraries, data files, etc) required in order for that code to run.
+                "name": "A String", # The name of the package.
+                "location": "A String", # The resource to read the package from. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket} bucket.storage.googleapis.com/
+              },
+            ],
+            "autoscalingSettings": { # Settings for WorkerPool autoscaling. # Settings for autoscaling of this WorkerPool.
+              "maxNumWorkers": 42, # The maximum number of workers to cap scaling at.
+              "algorithm": "A String", # The algorithm to use for autoscaling.
+            },
+            "subnetwork": "A String", # Subnetwork to which VMs will be assigned, if desired. Expected to be of the form "regions/REGION/subnetworks/SUBNETWORK".
+            "dataDisks": [ # Data disks that are used by a VM in this workflow.
+              { # Describes the data disk used by a workflow job.
+                "mountPoint": "A String", # Directory in a VM where disk is mounted.
+                "sizeGb": 42, # Size of disk in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+                "diskType": "A String", # Disk storage type, as defined by Google Compute Engine. This must be a disk type appropriate to the project and zone in which the workers will run. If unknown or unspecified, the service will attempt to choose a reasonable default. For example, the standard persistent disk type is a resource name typically ending in "pd-standard". If SSD persistent disks are available, the resource name typically ends with "pd-ssd". The actual valid values are defined the Google Compute Engine API, not by the Dataflow API; consult the Google Compute Engine documentation for more information about determining the set of available disk types for a particular project and zone. Google Compute Engine Disk types are local to a particular project in a particular zone, and so the resource name will typically look something like this: compute.googleapis.com/projects/
+                    # /zones//diskTypes/pd-standard
+              },
+            ],
+          },
+        ],
+      },
+      "replaceJobId": "A String", # If this job is an update of an existing job, this field will be the ID of the job it replaced. When sending a CreateJobRequest, you can update a job by specifying it here. The job named here will be stopped, and its intermediate state transferred to this job.
+      "steps": [ # The top-level steps that constitute the entire job.
+        { # Defines a particular step within a Dataflow job. A job consists of multiple steps, each of which performs some specific operation as part of the overall job. Data is typically passed from one step to another as part of the job. Here's an example of a sequence of steps which together implement a Map-Reduce job: * Read a collection of data from some source, parsing the collection's elements. * Validate the elements. * Apply a user-defined function to map each element to some value and extract an element-specific key value. * Group elements with the same key into a single element with that key, transforming a multiply-keyed collection into a uniquely-keyed collection. * Write the elements out to some data sink. (Note that the Dataflow service may be used to run many different types of jobs, not just Map-Reduce).
+          "kind": "A String", # The kind of step in the dataflow Job.
+          "name": "A String", # Name identifying the step. This must be unique for each step with respect to all other steps in the dataflow Job.
+          "properties": { # Named properties associated with the step. Each kind of predefined step has its own required set of properties.
+            "a_key": "", # Properties of the object.
+          },
+        },
+      ],
+      "currentStateTime": "A String", # The timestamp associated with the current state.
+      "tempFiles": [ # A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported. The supported files are: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+        "A String",
+      ],
+      "type": "A String", # The type of dataflow job.
+      "id": "A String", # The unique ID of this job. This field is set by the Dataflow service when the Job is created, and is immutable for the life of the Job.
+      "currentState": "A String", # The current state of the job. Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified. A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. Once a job has reached a terminal state, no further state updates may be made. This field may be mutated by the Dataflow service; callers cannot mutate it.
+      "executionInfo": { # Additional information about how a Dataflow job will be executed which isn’t contained in the submitted job. # Information about how the Dataflow service will actually run the job.
+        "stages": { # A mapping from each stage to the information about that stage.
+          "a_key": { # Contains information about how a particular google.dataflow.v1beta3.Step will be executed.
+            "stepName": [ # The steps associated with the execution stage. Note that stages may have several steps, and that a given step might be run by more than one stage.
+              "A String",
+            ],
+          },
+        },
+      },
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(projectId, location, jobId, x__xgafv=None, view=None)</code>
+  <pre>Gets the state of the specified dataflow job.
+
+Args:
+  projectId: string, The project which owns the job. (required)
+  location: string, The location which contains this job. (required)
+  jobId: string, Identifies a single job. (required)
+  x__xgafv: string, V1 error format.
+  view: string, Level of information requested in response.
+
+Returns:
+  An object of the form:
+
+    { # Defines a job to be run by the Dataflow service.
+      "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
+      "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
+      "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+      "location": "A String", # The location which contains this job.
+      "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
+      "projectId": "A String", # The project which owns the job.
+      "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
+        "a_key": "A String",
+      },
+      "transformNameMapping": { # Map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.
+        "a_key": "A String",
+      },
+      "createTime": "A String", # Timestamp when job was initially created. Immutable, set by the Dataflow service.
+      "environment": { # Describes the environment in which a Dataflow Job runs. # Environment for the job.
+        "version": { # A structure describing which components and their versions of the service are required in order to run the job.
+          "a_key": "", # Properties of the object.
+        },
+        "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The system will append the suffix "/temp-{JOBNAME} to this resource prefix, where {JOBNAME} is the value of the job_name field. The resulting bucket and object prefix is used as the prefix of the resources used to store temporary data needed during the job execution. NOTE: This will override the value in taskrunner_settings. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+        "internalExperiments": { # Experimental settings.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
+        },
+        "dataset": "A String", # The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset}
+        "experiments": [ # The list of experiments to enable.
+          "A String",
+        ],
+        "serviceAccountEmail": "A String", # Identity to run virtual machines as. Defaults to the default account.
+        "sdkPipelineOptions": { # The Dataflow SDK pipeline options specified by the user. These options are passed through the service and are used to recreate the SDK pipeline options on the worker in a language agnostic and platform independent way.
+          "a_key": "", # Properties of the object.
+        },
+        "userAgent": { # A description of the process that generated the request.
+          "a_key": "", # Properties of the object.
+        },
+        "clusterManagerApiService": "A String", # The type of cluster manager API to use. If unknown or unspecified, the service will attempt to choose a reasonable default. This should be in the form of the API service name, e.g. "compute.googleapis.com".
+        "workerPools": [ # Worker pools. At least one "harness" worker pool must be specified in order for the job to have workers.
+          { # Describes one particular pool of Dataflow workers to be instantiated by the Dataflow service in order to perform the computations required by a job. Note that a workflow job may use multiple pools, in order to match the various computational requirements of the various stages of the job.
+            "diskSourceImage": "A String", # Fully qualified source image for disks.
+            "taskrunnerSettings": { # Taskrunner configuration settings. # Settings passed through to Google Compute Engine workers when using the standard Dataflow task runner. Users should ignore this field.
+              "workflowFileName": "A String", # Store the workflow in this file.
+              "logUploadLocation": "A String", # Indicates where to put logs. If this is not specified, the logs will not be uploaded. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              "commandlinesFileName": "A String", # Store preprocessing commands in this file.
+              "parallelWorkerSettings": { # Provides data to pass through to the worker harness. # Settings to pass to the parallel worker harness.
+                "reportingEnabled": True or False, # Send work progress updates to service.
+                "shuffleServicePath": "A String", # The Shuffle service path relative to the root URL, for example, "shuffle/v1beta1".
+                "workerId": "A String", # ID of the worker running this pipeline.
+                "baseUrl": "A String", # The base URL for accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+                "servicePath": "A String", # The Dataflow service path relative to the root URL, for example, "dataflow/v1b3/projects".
+                "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              },
+              "vmId": "A String", # ID string of VM.
+              "baseTaskDir": "A String", # Location on the worker for task-specific subdirectories.
+              "continueOnException": True or False, # Do we continue taskrunner if an exception is hit?
+              "baseUrl": "A String", # The base URL for the taskrunner to use when accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+              "taskUser": "A String", # The UNIX user ID on the worker VM to use for tasks launched by taskrunner; e.g. "root".
+              "taskGroup": "A String", # The UNIX group ID on the worker VM to use for tasks launched by taskrunner; e.g. "wheel".
+              "oauthScopes": [ # OAuth2 scopes to be requested by the taskrunner in order to access the dataflow API.
+                "A String",
+              ],
+              "languageHint": "A String", # Suggested backend language.
+              "logToSerialconsole": True or False, # Send taskrunner log into to Google Compute Engine VM serial console?
+              "streamingWorkerMainClass": "A String", # Streaming worker main class name.
+              "logDir": "A String", # Directory on the VM to store logs.
+              "dataflowApiVersion": "A String", # API version of endpoint, e.g. "v1b3"
+              "harnessCommand": "A String", # Command to launch the worker harness.
+              "tempStoragePrefix": "A String", # The prefix of the resources the taskrunner should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              "alsologtostderr": True or False, # Also send taskrunner log info to stderr?
+            },
+            "kind": "A String", # The kind of the worker pool; currently only 'harness' and 'shuffle' are supported.
+            "machineType": "A String", # Machine type (e.g. "n1-standard-1"). If empty or unspecified, the service will attempt to choose a reasonable default.
+            "network": "A String", # Network to which VMs will be assigned. If empty or unspecified, the service will use the network "default".
+            "zone": "A String", # Zone to run the worker pools in. If empty or unspecified, the service will attempt to choose a reasonable default.
+            "numThreadsPerWorker": 42, # The number of threads per worker harness. If empty or unspecified, the service will choose a number of threads (according to the number of cores on the selected machine type for batch, or 1 by convention for streaming).
+            "ipConfiguration": "A String", # Configuration for VM IPs.
+            "onHostMaintenance": "A String", # The action to take on host maintenance, as defined by the Google Compute Engine API.
+            "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default.
+            "teardownPolicy": "A String", # Sets the policy for determining when to turndown worker pool. Allowed values are: TEARDOWN_ALWAYS, TEARDOWN_ON_SUCCESS, and TEARDOWN_NEVER. TEARDOWN_ALWAYS means workers are always torn down regardless of whether the job succeeds. TEARDOWN_ON_SUCCESS means workers are torn down if the job succeeds. TEARDOWN_NEVER means the workers are never torn down. If the workers are not torn down by the service, they will continue to run and use Google Compute Engine VM resources in the user's project until they are explicitly terminated by the user. Because of this, Google recommends using the TEARDOWN_ALWAYS policy except for small, manually supervised test jobs. If unknown or unspecified, the service will attempt to choose a reasonable default.
+            "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+            "metadata": { # Metadata to set on the Google Compute Engine VMs.
+              "a_key": "A String",
+            },
+            "poolArgs": { # Extra arguments for this worker pool.
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+            "numWorkers": 42, # Number of Google Compute Engine workers in this pool needed to execute the job. If zero or unspecified, the service will attempt to choose a reasonable default.
+            "workerHarnessContainerImage": "A String", # Docker container image that executes Dataflow worker harness, residing in Google Container Registry. Required.
+            "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language.
+            "packages": [ # Packages to be installed on workers.
+              { # Packages that need to be installed in order for a worker to run the steps of the Dataflow job which will be assigned to its worker pool. This is the mechanism by which the SDK causes code to be loaded onto the workers. For example, the Dataflow Java SDK might use this to install jars containing the user's code and all of the various dependencies (libraries, data files, etc) required in order for that code to run.
+                "name": "A String", # The name of the package.
+                "location": "A String", # The resource to read the package from. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket} bucket.storage.googleapis.com/
+              },
+            ],
+            "autoscalingSettings": { # Settings for WorkerPool autoscaling. # Settings for autoscaling of this WorkerPool.
+              "maxNumWorkers": 42, # The maximum number of workers to cap scaling at.
+              "algorithm": "A String", # The algorithm to use for autoscaling.
+            },
+            "subnetwork": "A String", # Subnetwork to which VMs will be assigned, if desired. Expected to be of the form "regions/REGION/subnetworks/SUBNETWORK".
+            "dataDisks": [ # Data disks that are used by a VM in this workflow.
+              { # Describes the data disk used by a workflow job.
+                "mountPoint": "A String", # Directory in a VM where disk is mounted.
+                "sizeGb": 42, # Size of disk in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+                "diskType": "A String", # Disk storage type, as defined by Google Compute Engine. This must be a disk type appropriate to the project and zone in which the workers will run. If unknown or unspecified, the service will attempt to choose a reasonable default. For example, the standard persistent disk type is a resource name typically ending in "pd-standard". If SSD persistent disks are available, the resource name typically ends with "pd-ssd". The actual valid values are defined the Google Compute Engine API, not by the Dataflow API; consult the Google Compute Engine documentation for more information about determining the set of available disk types for a particular project and zone. Google Compute Engine Disk types are local to a particular project in a particular zone, and so the resource name will typically look something like this: compute.googleapis.com/projects/
+                    # /zones//diskTypes/pd-standard
+              },
+            ],
+          },
+        ],
+      },
+      "replaceJobId": "A String", # If this job is an update of an existing job, this field will be the ID of the job it replaced. When sending a CreateJobRequest, you can update a job by specifying it here. The job named here will be stopped, and its intermediate state transferred to this job.
+      "steps": [ # The top-level steps that constitute the entire job.
+        { # Defines a particular step within a Dataflow job. A job consists of multiple steps, each of which performs some specific operation as part of the overall job. Data is typically passed from one step to another as part of the job. Here's an example of a sequence of steps which together implement a Map-Reduce job: * Read a collection of data from some source, parsing the collection's elements. * Validate the elements. * Apply a user-defined function to map each element to some value and extract an element-specific key value. * Group elements with the same key into a single element with that key, transforming a multiply-keyed collection into a uniquely-keyed collection. * Write the elements out to some data sink. (Note that the Dataflow service may be used to run many different types of jobs, not just Map-Reduce).
+          "kind": "A String", # The kind of step in the dataflow Job.
+          "name": "A String", # Name identifying the step. This must be unique for each step with respect to all other steps in the dataflow Job.
+          "properties": { # Named properties associated with the step. Each kind of predefined step has its own required set of properties.
+            "a_key": "", # Properties of the object.
+          },
+        },
+      ],
+      "currentStateTime": "A String", # The timestamp associated with the current state.
+      "tempFiles": [ # A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported. The supported files are: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+        "A String",
+      ],
+      "type": "A String", # The type of dataflow job.
+      "id": "A String", # The unique ID of this job. This field is set by the Dataflow service when the Job is created, and is immutable for the life of the Job.
+      "currentState": "A String", # The current state of the job. Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified. A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. Once a job has reached a terminal state, no further state updates may be made. This field may be mutated by the Dataflow service; callers cannot mutate it.
+      "executionInfo": { # Additional information about how a Dataflow job will be executed which isn’t contained in the submitted job. # Information about how the Dataflow service will actually run the job.
+        "stages": { # A mapping from each stage to the information about that stage.
+          "a_key": { # Contains information about how a particular google.dataflow.v1beta3.Step will be executed.
+            "stepName": [ # The steps associated with the execution stage. Note that stages may have several steps, and that a given step might be run by more than one stage.
+              "A String",
+            ],
+          },
+        },
+      },
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="getMetrics">getMetrics(projectId, location, jobId, startTime=None, x__xgafv=None)</code>
+  <pre>Request the job status.
+
+Args:
+  projectId: string, A project id. (required)
+  location: string, The location which contains the job specified by job_id. (required)
+  jobId: string, The job to get messages for. (required)
+  startTime: string, Return only metric data that has changed since this time. Default is to return all information about all metrics for the job.
+  x__xgafv: string, V1 error format.
+
+Returns:
+  An object of the form:
+
+    { # JobMetrics contains a collection of metrics descibing the detailed progress of a Dataflow job. Metrics correspond to user-defined and system-defined metrics in the job. This resource captures only the most recent values of each metric; time-series data can be queried for them (under the same metric names) from Cloud Monitoring.
+    "metrics": [ # All metrics for this job.
+      { # Describes the state of a metric.
+        "meanCount": "", # Worker-computed aggregate value for the "Mean" aggregation kind. This holds the count of the aggregated values and is used in combination with mean_sum above to obtain the actual mean aggregate value. The only possible value type is Long.
+        "kind": "A String", # Metric aggregation kind. The possible metric aggregation kinds are "Sum", "Max", "Min", "Mean", "Set", "And", and "Or". The specified aggregation kind is case-insensitive. If omitted, this is not an aggregated value but instead a single metric sample value.
+        "set": "", # Worker-computed aggregate value for the "Set" aggregation kind. The only possible value type is a list of Values whose type can be Long, Double, or String, according to the metric's type. All Values in the list must be of the same type.
+        "name": { # Identifies a metric, by describing the source which generated the metric. # Name of the metric.
+          "origin": "A String", # Origin (namespace) of metric name. May be blank for user-define metrics; will be "dataflow" for metrics defined by the Dataflow service or SDK.
+          "name": "A String", # Worker-defined metric name.
+          "context": { # Zero or more labeled fields which identify the part of the job this metric is associated with, such as the name of a step or collection. For example, built-in counters associated with steps will have context['step'] = . Counters associated with PCollections in the SDK will have context['pcollection'] =
+              # .
+            "a_key": "A String",
+          },
+        },
+        "cumulative": True or False, # True if this metric is reported as the total cumulative aggregate value accumulated since the worker started working on this WorkItem. By default this is false, indicating that this metric is reported as a delta that is not associated with any WorkItem.
+        "updateTime": "A String", # Timestamp associated with the metric value. Optional when workers are reporting work progress; it will be filled in responses from the metrics API.
+        "scalar": "", # Worker-computed aggregate value for aggregation kinds "Sum", "Max", "Min", "And", and "Or". The possible value types are Long, Double, and Boolean.
+        "meanSum": "", # Worker-computed aggregate value for the "Mean" aggregation kind. This holds the sum of the aggregated values and is used in combination with mean_count below to obtain the actual mean aggregate value. The only possible value types are Long and Double.
+        "internal": "", # Worker-computed aggregate value for internal use by the Dataflow service.
+      },
+    ],
+    "metricTime": "A String", # Timestamp as of which metric values are current.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(projectId, location, pageSize=None, x__xgafv=None, pageToken=None, filter=None, view=None)</code>
+  <pre>List the jobs of a project
+
+Args:
+  projectId: string, The project which owns the jobs. (required)
+  location: string, The location which contains this job. (required)
+  pageSize: integer, If there are many jobs, limit response to at most this many. The actual number of jobs returned will be the lesser of max_responses and an unspecified server-defined limit.
+  x__xgafv: string, V1 error format.
+  pageToken: string, Set this to the 'next_page_token' field of a previous response to request additional results in a long list.
+  filter: string, The kind of filter to use.
+  view: string, Level of information requested in response. Default is SUMMARY.
+
+Returns:
+  An object of the form:
+
+    { # Response to a request to list Dataflow jobs. This may be a partial response, depending on the page size in the ListJobsRequest.
+    "nextPageToken": "A String", # Set if there may be more results than fit in this response.
+    "failedLocation": [ # Zero or more messages describing locations that failed to respond.
+      { # FailedLocation indicates which location failed to respond to a request for data.
+        "name": "A String", # The name of the failed location.
+      },
+    ],
+    "jobs": [ # A subset of the requested job information.
+      { # Defines a job to be run by the Dataflow service.
+          "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
+          "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
+          "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+          "location": "A String", # The location which contains this job.
+          "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
+          "projectId": "A String", # The project which owns the job.
+          "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
+            "a_key": "A String",
+          },
+          "transformNameMapping": { # Map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.
+            "a_key": "A String",
+          },
+          "createTime": "A String", # Timestamp when job was initially created. Immutable, set by the Dataflow service.
+          "environment": { # Describes the environment in which a Dataflow Job runs. # Environment for the job.
+            "version": { # A structure describing which components and their versions of the service are required in order to run the job.
+              "a_key": "", # Properties of the object.
+            },
+            "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The system will append the suffix "/temp-{JOBNAME} to this resource prefix, where {JOBNAME} is the value of the job_name field. The resulting bucket and object prefix is used as the prefix of the resources used to store temporary data needed during the job execution. NOTE: This will override the value in taskrunner_settings. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+            "internalExperiments": { # Experimental settings.
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+            "dataset": "A String", # The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset}
+            "experiments": [ # The list of experiments to enable.
+              "A String",
+            ],
+            "serviceAccountEmail": "A String", # Identity to run virtual machines as. Defaults to the default account.
+            "sdkPipelineOptions": { # The Dataflow SDK pipeline options specified by the user. These options are passed through the service and are used to recreate the SDK pipeline options on the worker in a language agnostic and platform independent way.
+              "a_key": "", # Properties of the object.
+            },
+            "userAgent": { # A description of the process that generated the request.
+              "a_key": "", # Properties of the object.
+            },
+            "clusterManagerApiService": "A String", # The type of cluster manager API to use. If unknown or unspecified, the service will attempt to choose a reasonable default. This should be in the form of the API service name, e.g. "compute.googleapis.com".
+            "workerPools": [ # Worker pools. At least one "harness" worker pool must be specified in order for the job to have workers.
+              { # Describes one particular pool of Dataflow workers to be instantiated by the Dataflow service in order to perform the computations required by a job. Note that a workflow job may use multiple pools, in order to match the various computational requirements of the various stages of the job.
+                "diskSourceImage": "A String", # Fully qualified source image for disks.
+                "taskrunnerSettings": { # Taskrunner configuration settings. # Settings passed through to Google Compute Engine workers when using the standard Dataflow task runner. Users should ignore this field.
+                  "workflowFileName": "A String", # Store the workflow in this file.
+                  "logUploadLocation": "A String", # Indicates where to put logs. If this is not specified, the logs will not be uploaded. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+                  "commandlinesFileName": "A String", # Store preprocessing commands in this file.
+                  "parallelWorkerSettings": { # Provides data to pass through to the worker harness. # Settings to pass to the parallel worker harness.
+                    "reportingEnabled": True or False, # Send work progress updates to service.
+                    "shuffleServicePath": "A String", # The Shuffle service path relative to the root URL, for example, "shuffle/v1beta1".
+                    "workerId": "A String", # ID of the worker running this pipeline.
+                    "baseUrl": "A String", # The base URL for accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+                    "servicePath": "A String", # The Dataflow service path relative to the root URL, for example, "dataflow/v1b3/projects".
+                    "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+                  },
+                  "vmId": "A String", # ID string of VM.
+                  "baseTaskDir": "A String", # Location on the worker for task-specific subdirectories.
+                  "continueOnException": True or False, # Do we continue taskrunner if an exception is hit?
+                  "baseUrl": "A String", # The base URL for the taskrunner to use when accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+                  "taskUser": "A String", # The UNIX user ID on the worker VM to use for tasks launched by taskrunner; e.g. "root".
+                  "taskGroup": "A String", # The UNIX group ID on the worker VM to use for tasks launched by taskrunner; e.g. "wheel".
+                  "oauthScopes": [ # OAuth2 scopes to be requested by the taskrunner in order to access the dataflow API.
+                    "A String",
+                  ],
+                  "languageHint": "A String", # Suggested backend language.
+                  "logToSerialconsole": True or False, # Send taskrunner log into to Google Compute Engine VM serial console?
+                  "streamingWorkerMainClass": "A String", # Streaming worker main class name.
+                  "logDir": "A String", # Directory on the VM to store logs.
+                  "dataflowApiVersion": "A String", # API version of endpoint, e.g. "v1b3"
+                  "harnessCommand": "A String", # Command to launch the worker harness.
+                  "tempStoragePrefix": "A String", # The prefix of the resources the taskrunner should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+                  "alsologtostderr": True or False, # Also send taskrunner log info to stderr?
+                },
+                "kind": "A String", # The kind of the worker pool; currently only 'harness' and 'shuffle' are supported.
+                "machineType": "A String", # Machine type (e.g. "n1-standard-1"). If empty or unspecified, the service will attempt to choose a reasonable default.
+                "network": "A String", # Network to which VMs will be assigned. If empty or unspecified, the service will use the network "default".
+                "zone": "A String", # Zone to run the worker pools in. If empty or unspecified, the service will attempt to choose a reasonable default.
+                "numThreadsPerWorker": 42, # The number of threads per worker harness. If empty or unspecified, the service will choose a number of threads (according to the number of cores on the selected machine type for batch, or 1 by convention for streaming).
+                "ipConfiguration": "A String", # Configuration for VM IPs.
+                "onHostMaintenance": "A String", # The action to take on host maintenance, as defined by the Google Compute Engine API.
+                "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default.
+                "teardownPolicy": "A String", # Sets the policy for determining when to turndown worker pool. Allowed values are: TEARDOWN_ALWAYS, TEARDOWN_ON_SUCCESS, and TEARDOWN_NEVER. TEARDOWN_ALWAYS means workers are always torn down regardless of whether the job succeeds. TEARDOWN_ON_SUCCESS means workers are torn down if the job succeeds. TEARDOWN_NEVER means the workers are never torn down. If the workers are not torn down by the service, they will continue to run and use Google Compute Engine VM resources in the user's project until they are explicitly terminated by the user. Because of this, Google recommends using the TEARDOWN_ALWAYS policy except for small, manually supervised test jobs. If unknown or unspecified, the service will attempt to choose a reasonable default.
+                "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+                "metadata": { # Metadata to set on the Google Compute Engine VMs.
+                  "a_key": "A String",
+                },
+                "poolArgs": { # Extra arguments for this worker pool.
+                  "a_key": "", # Properties of the object. Contains field @type with type URL.
+                },
+                "numWorkers": 42, # Number of Google Compute Engine workers in this pool needed to execute the job. If zero or unspecified, the service will attempt to choose a reasonable default.
+                "workerHarnessContainerImage": "A String", # Docker container image that executes Dataflow worker harness, residing in Google Container Registry. Required.
+                "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language.
+                "packages": [ # Packages to be installed on workers.
+                  { # Packages that need to be installed in order for a worker to run the steps of the Dataflow job which will be assigned to its worker pool. This is the mechanism by which the SDK causes code to be loaded onto the workers. For example, the Dataflow Java SDK might use this to install jars containing the user's code and all of the various dependencies (libraries, data files, etc) required in order for that code to run.
+                    "name": "A String", # The name of the package.
+                    "location": "A String", # The resource to read the package from. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket} bucket.storage.googleapis.com/
+                  },
+                ],
+                "autoscalingSettings": { # Settings for WorkerPool autoscaling. # Settings for autoscaling of this WorkerPool.
+                  "maxNumWorkers": 42, # The maximum number of workers to cap scaling at.
+                  "algorithm": "A String", # The algorithm to use for autoscaling.
+                },
+                "subnetwork": "A String", # Subnetwork to which VMs will be assigned, if desired. Expected to be of the form "regions/REGION/subnetworks/SUBNETWORK".
+                "dataDisks": [ # Data disks that are used by a VM in this workflow.
+                  { # Describes the data disk used by a workflow job.
+                    "mountPoint": "A String", # Directory in a VM where disk is mounted.
+                    "sizeGb": 42, # Size of disk in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+                    "diskType": "A String", # Disk storage type, as defined by Google Compute Engine. This must be a disk type appropriate to the project and zone in which the workers will run. If unknown or unspecified, the service will attempt to choose a reasonable default. For example, the standard persistent disk type is a resource name typically ending in "pd-standard". If SSD persistent disks are available, the resource name typically ends with "pd-ssd". The actual valid values are defined the Google Compute Engine API, not by the Dataflow API; consult the Google Compute Engine documentation for more information about determining the set of available disk types for a particular project and zone. Google Compute Engine Disk types are local to a particular project in a particular zone, and so the resource name will typically look something like this: compute.googleapis.com/projects/
+                        # /zones//diskTypes/pd-standard
+                  },
+                ],
+              },
+            ],
+          },
+          "replaceJobId": "A String", # If this job is an update of an existing job, this field will be the ID of the job it replaced. When sending a CreateJobRequest, you can update a job by specifying it here. The job named here will be stopped, and its intermediate state transferred to this job.
+          "steps": [ # The top-level steps that constitute the entire job.
+            { # Defines a particular step within a Dataflow job. A job consists of multiple steps, each of which performs some specific operation as part of the overall job. Data is typically passed from one step to another as part of the job. Here's an example of a sequence of steps which together implement a Map-Reduce job: * Read a collection of data from some source, parsing the collection's elements. * Validate the elements. * Apply a user-defined function to map each element to some value and extract an element-specific key value. * Group elements with the same key into a single element with that key, transforming a multiply-keyed collection into a uniquely-keyed collection. * Write the elements out to some data sink. (Note that the Dataflow service may be used to run many different types of jobs, not just Map-Reduce).
+              "kind": "A String", # The kind of step in the dataflow Job.
+              "name": "A String", # Name identifying the step. This must be unique for each step with respect to all other steps in the dataflow Job.
+              "properties": { # Named properties associated with the step. Each kind of predefined step has its own required set of properties.
+                "a_key": "", # Properties of the object.
+              },
+            },
+          ],
+          "currentStateTime": "A String", # The timestamp associated with the current state.
+          "tempFiles": [ # A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported. The supported files are: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+            "A String",
+          ],
+          "type": "A String", # The type of dataflow job.
+          "id": "A String", # The unique ID of this job. This field is set by the Dataflow service when the Job is created, and is immutable for the life of the Job.
+          "currentState": "A String", # The current state of the job. Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified. A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. Once a job has reached a terminal state, no further state updates may be made. This field may be mutated by the Dataflow service; callers cannot mutate it.
+          "executionInfo": { # Additional information about how a Dataflow job will be executed which isn’t contained in the submitted job. # Information about how the Dataflow service will actually run the job.
+            "stages": { # A mapping from each stage to the information about that stage.
+              "a_key": { # Contains information about how a particular google.dataflow.v1beta3.Step will be executed.
+                "stepName": [ # The steps associated with the execution stage. Note that stages may have several steps, and that a given step might be run by more than one stage.
+                  "A String",
+                ],
+              },
+            },
+          },
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(projectId, location, jobId, body, x__xgafv=None)</code>
+  <pre>Updates the state of an existing dataflow job.
+
+Args:
+  projectId: string, The project which owns the job. (required)
+  location: string, The location which contains this job. (required)
+  jobId: string, Identifies a single job. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Defines a job to be run by the Dataflow service.
+    "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
+    "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
+    "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+    "location": "A String", # The location which contains this job.
+    "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
+    "projectId": "A String", # The project which owns the job.
+    "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
+      "a_key": "A String",
+    },
+    "transformNameMapping": { # Map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.
+      "a_key": "A String",
+    },
+    "createTime": "A String", # Timestamp when job was initially created. Immutable, set by the Dataflow service.
+    "environment": { # Describes the environment in which a Dataflow Job runs. # Environment for the job.
+      "version": { # A structure describing which components and their versions of the service are required in order to run the job.
+        "a_key": "", # Properties of the object.
+      },
+      "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The system will append the suffix "/temp-{JOBNAME} to this resource prefix, where {JOBNAME} is the value of the job_name field. The resulting bucket and object prefix is used as the prefix of the resources used to store temporary data needed during the job execution. NOTE: This will override the value in taskrunner_settings. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+      "internalExperiments": { # Experimental settings.
+        "a_key": "", # Properties of the object. Contains field @type with type URL.
+      },
+      "dataset": "A String", # The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset}
+      "experiments": [ # The list of experiments to enable.
+        "A String",
+      ],
+      "serviceAccountEmail": "A String", # Identity to run virtual machines as. Defaults to the default account.
+      "sdkPipelineOptions": { # The Dataflow SDK pipeline options specified by the user. These options are passed through the service and are used to recreate the SDK pipeline options on the worker in a language agnostic and platform independent way.
+        "a_key": "", # Properties of the object.
+      },
+      "userAgent": { # A description of the process that generated the request.
+        "a_key": "", # Properties of the object.
+      },
+      "clusterManagerApiService": "A String", # The type of cluster manager API to use. If unknown or unspecified, the service will attempt to choose a reasonable default. This should be in the form of the API service name, e.g. "compute.googleapis.com".
+      "workerPools": [ # Worker pools. At least one "harness" worker pool must be specified in order for the job to have workers.
+        { # Describes one particular pool of Dataflow workers to be instantiated by the Dataflow service in order to perform the computations required by a job. Note that a workflow job may use multiple pools, in order to match the various computational requirements of the various stages of the job.
+          "diskSourceImage": "A String", # Fully qualified source image for disks.
+          "taskrunnerSettings": { # Taskrunner configuration settings. # Settings passed through to Google Compute Engine workers when using the standard Dataflow task runner. Users should ignore this field.
+            "workflowFileName": "A String", # Store the workflow in this file.
+            "logUploadLocation": "A String", # Indicates where to put logs. If this is not specified, the logs will not be uploaded. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+            "commandlinesFileName": "A String", # Store preprocessing commands in this file.
+            "parallelWorkerSettings": { # Provides data to pass through to the worker harness. # Settings to pass to the parallel worker harness.
+              "reportingEnabled": True or False, # Send work progress updates to service.
+              "shuffleServicePath": "A String", # The Shuffle service path relative to the root URL, for example, "shuffle/v1beta1".
+              "workerId": "A String", # ID of the worker running this pipeline.
+              "baseUrl": "A String", # The base URL for accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+              "servicePath": "A String", # The Dataflow service path relative to the root URL, for example, "dataflow/v1b3/projects".
+              "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+            },
+            "vmId": "A String", # ID string of VM.
+            "baseTaskDir": "A String", # Location on the worker for task-specific subdirectories.
+            "continueOnException": True or False, # Do we continue taskrunner if an exception is hit?
+            "baseUrl": "A String", # The base URL for the taskrunner to use when accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+            "taskUser": "A String", # The UNIX user ID on the worker VM to use for tasks launched by taskrunner; e.g. "root".
+            "taskGroup": "A String", # The UNIX group ID on the worker VM to use for tasks launched by taskrunner; e.g. "wheel".
+            "oauthScopes": [ # OAuth2 scopes to be requested by the taskrunner in order to access the dataflow API.
+              "A String",
+            ],
+            "languageHint": "A String", # Suggested backend language.
+            "logToSerialconsole": True or False, # Send taskrunner log into to Google Compute Engine VM serial console?
+            "streamingWorkerMainClass": "A String", # Streaming worker main class name.
+            "logDir": "A String", # Directory on the VM to store logs.
+            "dataflowApiVersion": "A String", # API version of endpoint, e.g. "v1b3"
+            "harnessCommand": "A String", # Command to launch the worker harness.
+            "tempStoragePrefix": "A String", # The prefix of the resources the taskrunner should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+            "alsologtostderr": True or False, # Also send taskrunner log info to stderr?
+          },
+          "kind": "A String", # The kind of the worker pool; currently only 'harness' and 'shuffle' are supported.
+          "machineType": "A String", # Machine type (e.g. "n1-standard-1"). If empty or unspecified, the service will attempt to choose a reasonable default.
+          "network": "A String", # Network to which VMs will be assigned. If empty or unspecified, the service will use the network "default".
+          "zone": "A String", # Zone to run the worker pools in. If empty or unspecified, the service will attempt to choose a reasonable default.
+          "numThreadsPerWorker": 42, # The number of threads per worker harness. If empty or unspecified, the service will choose a number of threads (according to the number of cores on the selected machine type for batch, or 1 by convention for streaming).
+          "ipConfiguration": "A String", # Configuration for VM IPs.
+          "onHostMaintenance": "A String", # The action to take on host maintenance, as defined by the Google Compute Engine API.
+          "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default.
+          "teardownPolicy": "A String", # Sets the policy for determining when to turndown worker pool. Allowed values are: TEARDOWN_ALWAYS, TEARDOWN_ON_SUCCESS, and TEARDOWN_NEVER. TEARDOWN_ALWAYS means workers are always torn down regardless of whether the job succeeds. TEARDOWN_ON_SUCCESS means workers are torn down if the job succeeds. TEARDOWN_NEVER means the workers are never torn down. If the workers are not torn down by the service, they will continue to run and use Google Compute Engine VM resources in the user's project until they are explicitly terminated by the user. Because of this, Google recommends using the TEARDOWN_ALWAYS policy except for small, manually supervised test jobs. If unknown or unspecified, the service will attempt to choose a reasonable default.
+          "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+          "metadata": { # Metadata to set on the Google Compute Engine VMs.
+            "a_key": "A String",
+          },
+          "poolArgs": { # Extra arguments for this worker pool.
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+          "numWorkers": 42, # Number of Google Compute Engine workers in this pool needed to execute the job. If zero or unspecified, the service will attempt to choose a reasonable default.
+          "workerHarnessContainerImage": "A String", # Docker container image that executes Dataflow worker harness, residing in Google Container Registry. Required.
+          "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language.
+          "packages": [ # Packages to be installed on workers.
+            { # Packages that need to be installed in order for a worker to run the steps of the Dataflow job which will be assigned to its worker pool. This is the mechanism by which the SDK causes code to be loaded onto the workers. For example, the Dataflow Java SDK might use this to install jars containing the user's code and all of the various dependencies (libraries, data files, etc) required in order for that code to run.
+              "name": "A String", # The name of the package.
+              "location": "A String", # The resource to read the package from. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket} bucket.storage.googleapis.com/
+            },
+          ],
+          "autoscalingSettings": { # Settings for WorkerPool autoscaling. # Settings for autoscaling of this WorkerPool.
+            "maxNumWorkers": 42, # The maximum number of workers to cap scaling at.
+            "algorithm": "A String", # The algorithm to use for autoscaling.
+          },
+          "subnetwork": "A String", # Subnetwork to which VMs will be assigned, if desired. Expected to be of the form "regions/REGION/subnetworks/SUBNETWORK".
+          "dataDisks": [ # Data disks that are used by a VM in this workflow.
+            { # Describes the data disk used by a workflow job.
+              "mountPoint": "A String", # Directory in a VM where disk is mounted.
+              "sizeGb": 42, # Size of disk in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+              "diskType": "A String", # Disk storage type, as defined by Google Compute Engine. This must be a disk type appropriate to the project and zone in which the workers will run. If unknown or unspecified, the service will attempt to choose a reasonable default. For example, the standard persistent disk type is a resource name typically ending in "pd-standard". If SSD persistent disks are available, the resource name typically ends with "pd-ssd". The actual valid values are defined the Google Compute Engine API, not by the Dataflow API; consult the Google Compute Engine documentation for more information about determining the set of available disk types for a particular project and zone. Google Compute Engine Disk types are local to a particular project in a particular zone, and so the resource name will typically look something like this: compute.googleapis.com/projects/
+                  # /zones//diskTypes/pd-standard
+            },
+          ],
+        },
+      ],
+    },
+    "replaceJobId": "A String", # If this job is an update of an existing job, this field will be the ID of the job it replaced. When sending a CreateJobRequest, you can update a job by specifying it here. The job named here will be stopped, and its intermediate state transferred to this job.
+    "steps": [ # The top-level steps that constitute the entire job.
+      { # Defines a particular step within a Dataflow job. A job consists of multiple steps, each of which performs some specific operation as part of the overall job. Data is typically passed from one step to another as part of the job. Here's an example of a sequence of steps which together implement a Map-Reduce job: * Read a collection of data from some source, parsing the collection's elements. * Validate the elements. * Apply a user-defined function to map each element to some value and extract an element-specific key value. * Group elements with the same key into a single element with that key, transforming a multiply-keyed collection into a uniquely-keyed collection. * Write the elements out to some data sink. (Note that the Dataflow service may be used to run many different types of jobs, not just Map-Reduce).
+        "kind": "A String", # The kind of step in the dataflow Job.
+        "name": "A String", # Name identifying the step. This must be unique for each step with respect to all other steps in the dataflow Job.
+        "properties": { # Named properties associated with the step. Each kind of predefined step has its own required set of properties.
+          "a_key": "", # Properties of the object.
+        },
+      },
+    ],
+    "currentStateTime": "A String", # The timestamp associated with the current state.
+    "tempFiles": [ # A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported. The supported files are: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+      "A String",
+    ],
+    "type": "A String", # The type of dataflow job.
+    "id": "A String", # The unique ID of this job. This field is set by the Dataflow service when the Job is created, and is immutable for the life of the Job.
+    "currentState": "A String", # The current state of the job. Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified. A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. Once a job has reached a terminal state, no further state updates may be made. This field may be mutated by the Dataflow service; callers cannot mutate it.
+    "executionInfo": { # Additional information about how a Dataflow job will be executed which isn’t contained in the submitted job. # Information about how the Dataflow service will actually run the job.
+      "stages": { # A mapping from each stage to the information about that stage.
+        "a_key": { # Contains information about how a particular google.dataflow.v1beta3.Step will be executed.
+          "stepName": [ # The steps associated with the execution stage. Note that stages may have several steps, and that a given step might be run by more than one stage.
+            "A String",
+          ],
+        },
+      },
+    },
+  }
+
+  x__xgafv: string, V1 error format.
+
+Returns:
+  An object of the form:
+
+    { # Defines a job to be run by the Dataflow service.
+      "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
+      "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
+      "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+      "location": "A String", # The location which contains this job.
+      "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
+      "projectId": "A String", # The project which owns the job.
+      "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
+        "a_key": "A String",
+      },
+      "transformNameMapping": { # Map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.
+        "a_key": "A String",
+      },
+      "createTime": "A String", # Timestamp when job was initially created. Immutable, set by the Dataflow service.
+      "environment": { # Describes the environment in which a Dataflow Job runs. # Environment for the job.
+        "version": { # A structure describing which components and their versions of the service are required in order to run the job.
+          "a_key": "", # Properties of the object.
+        },
+        "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The system will append the suffix "/temp-{JOBNAME} to this resource prefix, where {JOBNAME} is the value of the job_name field. The resulting bucket and object prefix is used as the prefix of the resources used to store temporary data needed during the job execution. NOTE: This will override the value in taskrunner_settings. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+        "internalExperiments": { # Experimental settings.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
+        },
+        "dataset": "A String", # The dataset for the current project where various workflow related tables are stored. The supported resource type is: Google BigQuery: bigquery.googleapis.com/{dataset}
+        "experiments": [ # The list of experiments to enable.
+          "A String",
+        ],
+        "serviceAccountEmail": "A String", # Identity to run virtual machines as. Defaults to the default account.
+        "sdkPipelineOptions": { # The Dataflow SDK pipeline options specified by the user. These options are passed through the service and are used to recreate the SDK pipeline options on the worker in a language agnostic and platform independent way.
+          "a_key": "", # Properties of the object.
+        },
+        "userAgent": { # A description of the process that generated the request.
+          "a_key": "", # Properties of the object.
+        },
+        "clusterManagerApiService": "A String", # The type of cluster manager API to use. If unknown or unspecified, the service will attempt to choose a reasonable default. This should be in the form of the API service name, e.g. "compute.googleapis.com".
+        "workerPools": [ # Worker pools. At least one "harness" worker pool must be specified in order for the job to have workers.
+          { # Describes one particular pool of Dataflow workers to be instantiated by the Dataflow service in order to perform the computations required by a job. Note that a workflow job may use multiple pools, in order to match the various computational requirements of the various stages of the job.
+            "diskSourceImage": "A String", # Fully qualified source image for disks.
+            "taskrunnerSettings": { # Taskrunner configuration settings. # Settings passed through to Google Compute Engine workers when using the standard Dataflow task runner. Users should ignore this field.
+              "workflowFileName": "A String", # Store the workflow in this file.
+              "logUploadLocation": "A String", # Indicates where to put logs. If this is not specified, the logs will not be uploaded. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              "commandlinesFileName": "A String", # Store preprocessing commands in this file.
+              "parallelWorkerSettings": { # Provides data to pass through to the worker harness. # Settings to pass to the parallel worker harness.
+                "reportingEnabled": True or False, # Send work progress updates to service.
+                "shuffleServicePath": "A String", # The Shuffle service path relative to the root URL, for example, "shuffle/v1beta1".
+                "workerId": "A String", # ID of the worker running this pipeline.
+                "baseUrl": "A String", # The base URL for accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+                "servicePath": "A String", # The Dataflow service path relative to the root URL, for example, "dataflow/v1b3/projects".
+                "tempStoragePrefix": "A String", # The prefix of the resources the system should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              },
+              "vmId": "A String", # ID string of VM.
+              "baseTaskDir": "A String", # Location on the worker for task-specific subdirectories.
+              "continueOnException": True or False, # Do we continue taskrunner if an exception is hit?
+              "baseUrl": "A String", # The base URL for the taskrunner to use when accessing Google Cloud APIs. When workers access Google Cloud APIs, they logically do so via relative URLs. If this field is specified, it supplies the base URL to use for resolving these relative URLs. The normative algorithm used is defined by RFC 1808, "Relative Uniform Resource Locators". If not specified, the default value is "http://www.googleapis.com/"
+              "taskUser": "A String", # The UNIX user ID on the worker VM to use for tasks launched by taskrunner; e.g. "root".
+              "taskGroup": "A String", # The UNIX group ID on the worker VM to use for tasks launched by taskrunner; e.g. "wheel".
+              "oauthScopes": [ # OAuth2 scopes to be requested by the taskrunner in order to access the dataflow API.
+                "A String",
+              ],
+              "languageHint": "A String", # Suggested backend language.
+              "logToSerialconsole": True or False, # Send taskrunner log into to Google Compute Engine VM serial console?
+              "streamingWorkerMainClass": "A String", # Streaming worker main class name.
+              "logDir": "A String", # Directory on the VM to store logs.
+              "dataflowApiVersion": "A String", # API version of endpoint, e.g. "v1b3"
+              "harnessCommand": "A String", # Command to launch the worker harness.
+              "tempStoragePrefix": "A String", # The prefix of the resources the taskrunner should use for temporary storage. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+              "alsologtostderr": True or False, # Also send taskrunner log info to stderr?
+            },
+            "kind": "A String", # The kind of the worker pool; currently only 'harness' and 'shuffle' are supported.
+            "machineType": "A String", # Machine type (e.g. "n1-standard-1"). If empty or unspecified, the service will attempt to choose a reasonable default.
+            "network": "A String", # Network to which VMs will be assigned. If empty or unspecified, the service will use the network "default".
+            "zone": "A String", # Zone to run the worker pools in. If empty or unspecified, the service will attempt to choose a reasonable default.
+            "numThreadsPerWorker": 42, # The number of threads per worker harness. If empty or unspecified, the service will choose a number of threads (according to the number of cores on the selected machine type for batch, or 1 by convention for streaming).
+            "ipConfiguration": "A String", # Configuration for VM IPs.
+            "onHostMaintenance": "A String", # The action to take on host maintenance, as defined by the Google Compute Engine API.
+            "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default.
+            "teardownPolicy": "A String", # Sets the policy for determining when to turndown worker pool. Allowed values are: TEARDOWN_ALWAYS, TEARDOWN_ON_SUCCESS, and TEARDOWN_NEVER. TEARDOWN_ALWAYS means workers are always torn down regardless of whether the job succeeds. TEARDOWN_ON_SUCCESS means workers are torn down if the job succeeds. TEARDOWN_NEVER means the workers are never torn down. If the workers are not torn down by the service, they will continue to run and use Google Compute Engine VM resources in the user's project until they are explicitly terminated by the user. Because of this, Google recommends using the TEARDOWN_ALWAYS policy except for small, manually supervised test jobs. If unknown or unspecified, the service will attempt to choose a reasonable default.
+            "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+            "metadata": { # Metadata to set on the Google Compute Engine VMs.
+              "a_key": "A String",
+            },
+            "poolArgs": { # Extra arguments for this worker pool.
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+            "numWorkers": 42, # Number of Google Compute Engine workers in this pool needed to execute the job. If zero or unspecified, the service will attempt to choose a reasonable default.
+            "workerHarnessContainerImage": "A String", # Docker container image that executes Dataflow worker harness, residing in Google Container Registry. Required.
+            "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language.
+            "packages": [ # Packages to be installed on workers.
+              { # Packages that need to be installed in order for a worker to run the steps of the Dataflow job which will be assigned to its worker pool. This is the mechanism by which the SDK causes code to be loaded onto the workers. For example, the Dataflow Java SDK might use this to install jars containing the user's code and all of the various dependencies (libraries, data files, etc) required in order for that code to run.
+                "name": "A String", # The name of the package.
+                "location": "A String", # The resource to read the package from. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket} bucket.storage.googleapis.com/
+              },
+            ],
+            "autoscalingSettings": { # Settings for WorkerPool autoscaling. # Settings for autoscaling of this WorkerPool.
+              "maxNumWorkers": 42, # The maximum number of workers to cap scaling at.
+              "algorithm": "A String", # The algorithm to use for autoscaling.
+            },
+            "subnetwork": "A String", # Subnetwork to which VMs will be assigned, if desired. Expected to be of the form "regions/REGION/subnetworks/SUBNETWORK".
+            "dataDisks": [ # Data disks that are used by a VM in this workflow.
+              { # Describes the data disk used by a workflow job.
+                "mountPoint": "A String", # Directory in a VM where disk is mounted.
+                "sizeGb": 42, # Size of disk in GB. If zero or unspecified, the service will attempt to choose a reasonable default.
+                "diskType": "A String", # Disk storage type, as defined by Google Compute Engine. This must be a disk type appropriate to the project and zone in which the workers will run. If unknown or unspecified, the service will attempt to choose a reasonable default. For example, the standard persistent disk type is a resource name typically ending in "pd-standard". If SSD persistent disks are available, the resource name typically ends with "pd-ssd". The actual valid values are defined the Google Compute Engine API, not by the Dataflow API; consult the Google Compute Engine documentation for more information about determining the set of available disk types for a particular project and zone. Google Compute Engine Disk types are local to a particular project in a particular zone, and so the resource name will typically look something like this: compute.googleapis.com/projects/
+                    # /zones//diskTypes/pd-standard
+              },
+            ],
+          },
+        ],
+      },
+      "replaceJobId": "A String", # If this job is an update of an existing job, this field will be the ID of the job it replaced. When sending a CreateJobRequest, you can update a job by specifying it here. The job named here will be stopped, and its intermediate state transferred to this job.
+      "steps": [ # The top-level steps that constitute the entire job.
+        { # Defines a particular step within a Dataflow job. A job consists of multiple steps, each of which performs some specific operation as part of the overall job. Data is typically passed from one step to another as part of the job. Here's an example of a sequence of steps which together implement a Map-Reduce job: * Read a collection of data from some source, parsing the collection's elements. * Validate the elements. * Apply a user-defined function to map each element to some value and extract an element-specific key value. * Group elements with the same key into a single element with that key, transforming a multiply-keyed collection into a uniquely-keyed collection. * Write the elements out to some data sink. (Note that the Dataflow service may be used to run many different types of jobs, not just Map-Reduce).
+          "kind": "A String", # The kind of step in the dataflow Job.
+          "name": "A String", # Name identifying the step. This must be unique for each step with respect to all other steps in the dataflow Job.
+          "properties": { # Named properties associated with the step. Each kind of predefined step has its own required set of properties.
+            "a_key": "", # Properties of the object.
+          },
+        },
+      ],
+      "currentStateTime": "A String", # The timestamp associated with the current state.
+      "tempFiles": [ # A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported. The supported files are: Google Cloud Storage: storage.googleapis.com/{bucket}/{object} bucket.storage.googleapis.com/{object}
+        "A String",
+      ],
+      "type": "A String", # The type of dataflow job.
+      "id": "A String", # The unique ID of this job. This field is set by the Dataflow service when the Job is created, and is immutable for the life of the Job.
+      "currentState": "A String", # The current state of the job. Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified. A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. Once a job has reached a terminal state, no further state updates may be made. This field may be mutated by the Dataflow service; callers cannot mutate it.
+      "executionInfo": { # Additional information about how a Dataflow job will be executed which isn’t contained in the submitted job. # Information about how the Dataflow service will actually run the job.
+        "stages": { # A mapping from each stage to the information about that stage.
+          "a_key": { # Contains information about how a particular google.dataflow.v1beta3.Step will be executed.
+            "stepName": [ # The steps associated with the execution stage. Note that stages may have several steps, and that a given step might be run by more than one stage.
+              "A String",
+            ],
+          },
+        },
+      },
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dataflow_v1b3.projects.locations.jobs.messages.html b/docs/dyn/dataflow_v1b3.projects.locations.jobs.messages.html
new file mode 100644
index 00000000000..330e1bb4b1a
--- /dev/null
+++ b/docs/dyn/dataflow_v1b3.projects.locations.jobs.messages.html
@@ -0,0 +1,129 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dataflow_v1b3.html">Google Dataflow API</a> . <a href="dataflow_v1b3.projects.html">projects</a> . <a href="dataflow_v1b3.projects.locations.html">locations</a> . <a href="dataflow_v1b3.projects.locations.jobs.html">jobs</a> . <a href="dataflow_v1b3.projects.locations.jobs.messages.html">messages</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#list">list(projectId, location, jobId, startTime=None, pageSize=None, x__xgafv=None, pageToken=None, minimumImportance=None, endTime=None)</a></code></p>
+<p class="firstline">Request the job status.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="list">list(projectId, location, jobId, startTime=None, pageSize=None, x__xgafv=None, pageToken=None, minimumImportance=None, endTime=None)</code>
+  <pre>Request the job status.
+
+Args:
+  projectId: string, A project id. (required)
+  location: string, The location which contains the job specified by job_id. (required)
+  jobId: string, The job to get messages about. (required)
+  startTime: string, If specified, return only messages with timestamps >= start_time. The default is the job creation time (i.e. beginning of messages).
+  pageSize: integer, If specified, determines the maximum number of messages to return. If unspecified, the service may choose an appropriate default, or may return an arbitrarily large number of results.
+  x__xgafv: string, V1 error format.
+  pageToken: string, If supplied, this should be the value of next_page_token returned by an earlier call. This will cause the next page of results to be returned.
+  minimumImportance: string, Filter to only get messages with importance >= level
+  endTime: string, Return only messages with timestamps < end_time. The default is now (i.e. return up to the latest messages available).
+
+Returns:
+  An object of the form:
+
+    { # Response to a request to list job messages.
+    "nextPageToken": "A String", # The token to obtain the next page of results if there are more.
+    "jobMessages": [ # Messages in ascending timestamp order.
+      { # A particular message pertaining to a Dataflow job.
+        "messageImportance": "A String", # Importance level of the message.
+        "messageText": "A String", # The text of the message.
+        "id": "A String", # Identifies the message. This is automatically generated by the service; the caller should treat it as an opaque string.
+        "time": "A String", # The timestamp of the message.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dataflow_v1b3.projects.locations.jobs.workItems.html b/docs/dyn/dataflow_v1b3.projects.locations.jobs.workItems.html
new file mode 100644
index 00000000000..d147bb30e26
--- /dev/null
+++ b/docs/dyn/dataflow_v1b3.projects.locations.jobs.workItems.html
@@ -0,0 +1,1097 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dataflow_v1b3.html">Google Dataflow API</a> . <a href="dataflow_v1b3.projects.html">projects</a> . <a href="dataflow_v1b3.projects.locations.html">locations</a> . <a href="dataflow_v1b3.projects.locations.jobs.html">jobs</a> . <a href="dataflow_v1b3.projects.locations.jobs.workItems.html">workItems</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#lease">lease(projectId, location, jobId, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Leases a dataflow WorkItem to run.</p>
+<p class="toc_element">
+  <code><a href="#reportStatus">reportStatus(projectId, location, jobId, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Reports the status of dataflow WorkItems leased by a worker.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="lease">lease(projectId, location, jobId, body, x__xgafv=None)</code>
+  <pre>Leases a dataflow WorkItem to run.
+
+Args:
+  projectId: string, Identifies the project this worker belongs to. (required)
+  location: string, The location which contains the WorkItem's job. (required)
+  jobId: string, Identifies the workflow job this worker belongs to. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Request to lease WorkItems.
+    "workItemTypes": [ # Filter for WorkItem type.
+      "A String",
+    ],
+    "workerCapabilities": [ # Worker capabilities. WorkItems might be limited to workers with specific capabilities.
+      "A String",
+    ],
+    "requestedLeaseDuration": "A String", # The initial lease period.
+    "workerId": "A String", # Identifies the worker leasing work -- typically the ID of the virtual machine running the worker.
+    "currentWorkerTime": "A String", # The current timestamp at the worker.
+    "location": "A String", # The location which contains the WorkItem's job.
+  }
+
+  x__xgafv: string, V1 error format.
+
+Returns:
+  An object of the form:
+
+    { # Response to a request to lease WorkItems.
+    "workItems": [ # A list of the leased WorkItems.
+      { # WorkItem represents basic information about a WorkItem to be executed in the cloud.
+        "reportStatusInterval": "A String", # Recommended reporting interval.
+        "leaseExpireTime": "A String", # Time when the lease on this Work will expire.
+        "seqMapTask": { # Describes a particular function to invoke. # Additional information for SeqMapTask WorkItems.
+          "inputs": [ # Information about each of the inputs.
+            { # Information about a side input of a DoFn or an input of a SeqDoFn.
+              "sources": [ # The source(s) to read element(s) from to get the value of this side input. If more than one source, then the elements are taken from the sources, in the specified order if order matters. At least one source is required.
+                { # A source that records can be read and decoded from.
+                  "codec": { # The codec to use to decode data read from the source.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                    {
+                      "a_key": "", # Properties of the object.
+                    },
+                  ],
+                  "spec": { # The source to read from, plus its parameters.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                  "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                    "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                    "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                    "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                  },
+                },
+              ],
+              "kind": { # How to interpret the source element(s) as a side input value.
+                "a_key": "", # Properties of the object.
+              },
+              "tag": "A String", # The id of the tag the user code will access this side input by; this should correspond to the tag of some MultiOutputInfo.
+            },
+          ],
+          "outputInfos": [ # Information about each of the outputs.
+            { # Information about an output of a SeqMapTask.
+              "tag": "A String", # The id of the TupleTag the user code will tag the output value by.
+              "sink": { # A sink that records can be encoded and written to. # The sink to write the output value to.
+                "codec": { # The codec to use to encode data written to the sink.
+                  "a_key": "", # Properties of the object.
+                },
+                "spec": { # The sink to write to, plus its parameters.
+                  "a_key": "", # Properties of the object.
+                },
+              },
+            },
+          ],
+          "stageName": "A String", # System-defined name of the stage containing the SeqDo operation. Unique across the workflow.
+          "systemName": "A String", # System-defined name of the SeqDo operation. Unique across the workflow.
+          "userFn": { # The user function to invoke.
+            "a_key": "", # Properties of the object.
+          },
+          "name": "A String", # The user-provided name of the SeqDo operation.
+        },
+        "projectId": "A String", # Identifies the cloud project this WorkItem belongs to.
+        "sourceOperationTask": { # A work item that represents the different operations that can be performed on a user-defined Source specification. # Additional information for source operation WorkItems.
+          "getMetadata": { # A request to compute the SourceMetadata of a Source. # Information about a request to get metadata about a source.
+            "source": { # A source that records can be read and decoded from. # Specification of the source whose metadata should be computed.
+              "codec": { # The codec to use to decode data read from the source.
+                "a_key": "", # Properties of the object.
+              },
+              "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                {
+                  "a_key": "", # Properties of the object.
+                },
+              ],
+              "spec": { # The source to read from, plus its parameters.
+                "a_key": "", # Properties of the object.
+              },
+              "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+              "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+              },
+            },
+          },
+          "split": { # Represents the operation to split a high-level Source specification into bundles (parts for parallel processing). At a high level, splitting of a source into bundles happens as follows: SourceSplitRequest is applied to the source. If it returns SOURCE_SPLIT_OUTCOME_USE_CURRENT, no further splitting happens and the source is used "as is". Otherwise, splitting is applied recursively to each produced DerivedSource. As an optimization, for any Source, if its does_not_need_splitting is true, the framework assumes that splitting this source would return SOURCE_SPLIT_OUTCOME_USE_CURRENT, and doesn't initiate a SourceSplitRequest. This applies both to the initial source being split and to bundles produced from it. # Information about a request to split a source.
+            "source": { # A source that records can be read and decoded from. # Specification of the source to be split.
+              "codec": { # The codec to use to decode data read from the source.
+                "a_key": "", # Properties of the object.
+              },
+              "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                {
+                  "a_key": "", # Properties of the object.
+                },
+              ],
+              "spec": { # The source to read from, plus its parameters.
+                "a_key": "", # Properties of the object.
+              },
+              "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+              "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+              },
+            },
+            "options": { # Hints for splitting a Source into bundles (parts for parallel processing) using SourceSplitRequest. # Hints for tuning the splitting process.
+              "desiredShardSizeBytes": "A String", # DEPRECATED in favor of desired_bundle_size_bytes.
+              "desiredBundleSizeBytes": "A String", # The source should be split into a set of bundles where the estimated size of each is approximately this many bytes.
+            },
+          },
+        },
+        "initialReportIndex": "A String", # The initial index to use when reporting the status of the WorkItem.
+        "mapTask": { # MapTask consists of an ordered set of instructions, each of which describes one particular low-level operation for the worker to perform in order to accomplish the MapTask's WorkItem. Each instruction must appear in the list before any instructions which depends on its output. # Additional information for MapTask WorkItems.
+          "systemName": "A String", # System-defined name of this MapTask. Unique across the workflow.
+          "stageName": "A String", # System-defined name of the stage containing this MapTask. Unique across the workflow.
+          "instructions": [ # The instructions in the MapTask.
+            { # Describes a particular operation comprising a MapTask.
+              "name": "A String", # User-provided name of this operation.
+              "read": { # An instruction that reads records. Takes no inputs, produces one output. # Additional information for Read instructions.
+                "source": { # A source that records can be read and decoded from. # The source to read from.
+                  "codec": { # The codec to use to decode data read from the source.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                    {
+                      "a_key": "", # Properties of the object.
+                    },
+                  ],
+                  "spec": { # The source to read from, plus its parameters.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                  "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                    "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                    "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                    "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                  },
+                },
+              },
+              "outputs": [ # Describes the outputs of the instruction.
+                { # An output of an instruction.
+                  "name": "A String", # The user-provided name of this output.
+                  "onlyCountKeyBytes": True or False, # For system-generated byte and mean byte metrics, certain instructions should only report the key size.
+                  "codec": { # The codec to use to encode data being written via this output.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "systemName": "A String", # System-defined name of this output. Unique across the workflow.
+                  "originalName": "A String", # System-defined name for this output in the original workflow graph. Outputs that do not contribute to an original instruction do not set this.
+                  "onlyCountValueBytes": True or False, # For system-generated byte and mean byte metrics, certain instructions should only report the value size.
+                },
+              ],
+              "partialGroupByKey": { # An instruction that does a partial group-by-key. One input and one output. # Additional information for PartialGroupByKey instructions.
+                "sideInputs": [ # Zero or more side inputs.
+                  { # Information about a side input of a DoFn or an input of a SeqDoFn.
+                    "sources": [ # The source(s) to read element(s) from to get the value of this side input. If more than one source, then the elements are taken from the sources, in the specified order if order matters. At least one source is required.
+                      { # A source that records can be read and decoded from.
+                        "codec": { # The codec to use to decode data read from the source.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                          {
+                            "a_key": "", # Properties of the object.
+                          },
+                        ],
+                        "spec": { # The source to read from, plus its parameters.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                        "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                          "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                          "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                          "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                        },
+                      },
+                    ],
+                    "kind": { # How to interpret the source element(s) as a side input value.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "tag": "A String", # The id of the tag the user code will access this side input by; this should correspond to the tag of some MultiOutputInfo.
+                  },
+                ],
+                "originalCombineValuesInputStoreName": "A String", # If this instruction includes a combining function this is the name of the intermediate store between the GBK and the CombineValues.
+                "originalCombineValuesStepName": "A String", # If this instruction includes a combining function, this is the name of the CombineValues instruction lifted into this instruction.
+                "valueCombiningFn": { # The value combining function to invoke.
+                  "a_key": "", # Properties of the object.
+                },
+                "input": { # An input of an instruction, as a reference to an output of a producer instruction. # Describes the input to the partial group-by-key instruction.
+                  "outputNum": 42, # The output index (origin zero) within the producer.
+                  "producerInstructionIndex": 42, # The index (origin zero) of the parallel instruction that produces the output to be consumed by this input. This index is relative to the list of instructions in this input's instruction's containing MapTask.
+                },
+                "inputElementCodec": { # The codec to use for interpreting an element in the input PTable.
+                  "a_key": "", # Properties of the object.
+                },
+              },
+              "write": { # An instruction that writes records. Takes one input, produces no outputs. # Additional information for Write instructions.
+                "input": { # An input of an instruction, as a reference to an output of a producer instruction. # The input.
+                  "outputNum": 42, # The output index (origin zero) within the producer.
+                  "producerInstructionIndex": 42, # The index (origin zero) of the parallel instruction that produces the output to be consumed by this input. This index is relative to the list of instructions in this input's instruction's containing MapTask.
+                },
+                "sink": { # A sink that records can be encoded and written to. # The sink to write to.
+                  "codec": { # The codec to use to encode data written to the sink.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "spec": { # The sink to write to, plus its parameters.
+                    "a_key": "", # Properties of the object.
+                  },
+                },
+              },
+              "systemName": "A String", # System-defined name of this operation. Unique across the workflow.
+              "flatten": { # An instruction that copies its inputs (zero or more) to its (single) output. # Additional information for Flatten instructions.
+                "inputs": [ # Describes the inputs to the flatten instruction.
+                  { # An input of an instruction, as a reference to an output of a producer instruction.
+                    "outputNum": 42, # The output index (origin zero) within the producer.
+                    "producerInstructionIndex": 42, # The index (origin zero) of the parallel instruction that produces the output to be consumed by this input. This index is relative to the list of instructions in this input's instruction's containing MapTask.
+                  },
+                ],
+              },
+              "originalName": "A String", # System-defined name for the operation in the original workflow graph.
+              "parDo": { # An instruction that does a ParDo operation. Takes one main input and zero or more side inputs, and produces zero or more outputs. Runs user code. # Additional information for ParDo instructions.
+                "sideInputs": [ # Zero or more side inputs.
+                  { # Information about a side input of a DoFn or an input of a SeqDoFn.
+                    "sources": [ # The source(s) to read element(s) from to get the value of this side input. If more than one source, then the elements are taken from the sources, in the specified order if order matters. At least one source is required.
+                      { # A source that records can be read and decoded from.
+                        "codec": { # The codec to use to decode data read from the source.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                          {
+                            "a_key": "", # Properties of the object.
+                          },
+                        ],
+                        "spec": { # The source to read from, plus its parameters.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                        "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                          "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                          "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                          "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                        },
+                      },
+                    ],
+                    "kind": { # How to interpret the source element(s) as a side input value.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "tag": "A String", # The id of the tag the user code will access this side input by; this should correspond to the tag of some MultiOutputInfo.
+                  },
+                ],
+                "input": { # An input of an instruction, as a reference to an output of a producer instruction. # The input.
+                  "outputNum": 42, # The output index (origin zero) within the producer.
+                  "producerInstructionIndex": 42, # The index (origin zero) of the parallel instruction that produces the output to be consumed by this input. This index is relative to the list of instructions in this input's instruction's containing MapTask.
+                },
+                "multiOutputInfos": [ # Information about each of the outputs, if user_fn is a MultiDoFn.
+                  { # Information about an output of a multi-output DoFn.
+                    "tag": "A String", # The id of the tag the user code will emit to this output by; this should correspond to the tag of some SideInputInfo.
+                  },
+                ],
+                "numOutputs": 42, # The number of outputs.
+                "userFn": { # The user function to invoke.
+                  "a_key": "", # Properties of the object.
+                },
+              },
+            },
+          ],
+        },
+        "jobId": "A String", # Identifies the workflow job this WorkItem belongs to.
+        "streamingComputationTask": { # A task which describes what action should be performed for the specified streaming computation ranges. # Additional information for StreamingComputationTask WorkItems.
+          "dataDisks": [ # Describes the set of data disks this task should apply to.
+            { # Describes mounted data disk.
+              "dataDisk": "A String", # The name of the data disk. This name is local to the Google Cloud Platform project and uniquely identifies the disk within that project, for example "myproject-1014-104817-4c2-harness-0-disk-1".
+            },
+          ],
+          "computationRanges": [ # Contains ranges of a streaming computation this task should apply to.
+            { # Describes full or partial data disk assignment information of the computation ranges.
+              "rangeAssignments": [ # Data disk assignments for ranges from this computation.
+                { # Data disk assignment information for a specific key-range of a sharded computation. Currently we only support UTF-8 character splits to simplify encoding into JSON.
+                  "start": "A String", # The start (inclusive) of the key range.
+                  "end": "A String", # The end (exclusive) of the key range.
+                  "dataDisk": "A String", # The name of the data disk where data for this range is stored. This name is local to the Google Cloud Platform project and uniquely identifies the disk within that project, for example "myproject-1014-104817-4c2-harness-0-disk-1".
+                },
+              ],
+              "computationId": "A String", # The ID of the computation.
+            },
+          ],
+          "taskType": "A String", # A type of streaming computation task.
+        },
+        "configuration": "A String", # Work item-specific configuration as an opaque blob.
+        "streamingSetupTask": { # A task which initializes part of a streaming Dataflow job. # Additional information for StreamingSetupTask WorkItems.
+          "workerHarnessPort": 42, # The TCP port used by the worker to communicate with the Dataflow worker harness.
+          "drain": True or False, # The user has requested drain.
+          "streamingComputationTopology": { # Global topology of the streaming Dataflow job, including all computations and their sharded locations. # The global topology of the streaming Dataflow job.
+            "computations": [ # The computations associated with a streaming Dataflow job.
+              { # All configuration data for a particular Computation.
+                "inputs": [ # The inputs to the computation.
+                  { # Describes a stream of data, either as input to be processed or as output of a streaming Dataflow job.
+                    "streamingStageLocation": { # Identifies the location of a streaming computation stage, for stage-to-stage communication. # The stream is part of another computation within the current streaming Dataflow job.
+                      "streamId": "A String", # Identifies the particular stream within the streaming Dataflow job.
+                    },
+                    "pubsubLocation": { # Identifies a pubsub location to use for transferring data into or out of a streaming Dataflow job. # The stream is a pubsub stream.
+                      "idLabel": "A String", # If set, contains a pubsub label from which to extract record ids. If left empty, record deduplication will be strictly best effort.
+                      "timestampLabel": "A String", # If set, contains a pubsub label from which to extract record timestamps. If left empty, record timestamps will be generated upon arrival.
+                      "dropLateData": True or False, # Indicates whether the pipeline allows late-arriving data.
+                      "topic": "A String", # A pubsub topic, in the form of "pubsub.googleapis.com/topics/
+                          # /"
+                      "trackingSubscription": "A String", # If set, specifies the pubsub subscription that will be used for tracking custom time timestamps for watermark estimation.
+                      "withAttributes": True or False, # If true, then the client has requested to get pubsub attributes.
+                      "subscription": "A String", # A pubsub subscription, in the form of "pubsub.googleapis.com/subscriptions/
+                          # /"
+                    },
+                    "customSourceLocation": { # Identifies the location of a custom souce. # The stream is a custom source.
+                      "stateful": True or False, # Whether this source is stateful.
+                    },
+                    "sideInputLocation": { # Identifies the location of a streaming side input. # The stream is a streaming side input.
+                      "stateFamily": "A String", # Identifies the state family where this side input is stored.
+                      "tag": "A String", # Identifies the particular side input within the streaming Dataflow job.
+                    },
+                  },
+                ],
+                "systemStageName": "A String", # The system stage name.
+                "keyRanges": [ # The key ranges processed by the computation.
+                  { # Location information for a specific key-range of a sharded computation. Currently we only support UTF-8 character splits to simplify encoding into JSON.
+                    "start": "A String", # The start (inclusive) of the key range.
+                    "deliveryEndpoint": "A String", # The physical location of this range assignment to be used for streaming computation cross-worker message delivery.
+                    "end": "A String", # The end (exclusive) of the key range.
+                    "persistentDirectory": "A String", # The location of the persistent state for this range, as a persistent directory in the worker local filesystem.
+                    "dataDisk": "A String", # The name of the data disk where data for this range is stored. This name is local to the Google Cloud Platform project and uniquely identifies the disk within that project, for example "myproject-1014-104817-4c2-harness-0-disk-1".
+                  },
+                ],
+                "computationId": "A String", # The ID of the computation.
+                "outputs": [ # The outputs from the computation.
+                  { # Describes a stream of data, either as input to be processed or as output of a streaming Dataflow job.
+                    "streamingStageLocation": { # Identifies the location of a streaming computation stage, for stage-to-stage communication. # The stream is part of another computation within the current streaming Dataflow job.
+                      "streamId": "A String", # Identifies the particular stream within the streaming Dataflow job.
+                    },
+                    "pubsubLocation": { # Identifies a pubsub location to use for transferring data into or out of a streaming Dataflow job. # The stream is a pubsub stream.
+                      "idLabel": "A String", # If set, contains a pubsub label from which to extract record ids. If left empty, record deduplication will be strictly best effort.
+                      "timestampLabel": "A String", # If set, contains a pubsub label from which to extract record timestamps. If left empty, record timestamps will be generated upon arrival.
+                      "dropLateData": True or False, # Indicates whether the pipeline allows late-arriving data.
+                      "topic": "A String", # A pubsub topic, in the form of "pubsub.googleapis.com/topics/
+                          # /"
+                      "trackingSubscription": "A String", # If set, specifies the pubsub subscription that will be used for tracking custom time timestamps for watermark estimation.
+                      "withAttributes": True or False, # If true, then the client has requested to get pubsub attributes.
+                      "subscription": "A String", # A pubsub subscription, in the form of "pubsub.googleapis.com/subscriptions/
+                          # /"
+                    },
+                    "customSourceLocation": { # Identifies the location of a custom souce. # The stream is a custom source.
+                      "stateful": True or False, # Whether this source is stateful.
+                    },
+                    "sideInputLocation": { # Identifies the location of a streaming side input. # The stream is a streaming side input.
+                      "stateFamily": "A String", # Identifies the state family where this side input is stored.
+                      "tag": "A String", # Identifies the particular side input within the streaming Dataflow job.
+                    },
+                  },
+                ],
+                "userStageName": "A String", # The user stage name.
+                "stateFamilies": [ # The state family values.
+                  { # State family configuration.
+                    "stateFamily": "A String", # The state family value.
+                    "isRead": True or False, # If true, this family corresponds to a read operation.
+                  },
+                ],
+              },
+            ],
+            "dataDiskAssignments": [ # The disks assigned to a streaming Dataflow job.
+              { # Data disk assignment for a given VM instance.
+                "vmInstance": "A String", # VM instance name the data disks mounted to, for example "myproject-1014-104817-4c2-harness-0".
+                "dataDisks": [ # Mounted data disks. The order is important a data disk's 0-based index in this list defines which persistent directory the disk is mounted to, for example the list of { "myproject-1014-104817-4c2-harness-0-disk-0" }, { "myproject-1014-104817-4c2-harness-0-disk-1" }.
+                  "A String",
+                ],
+              },
+            ],
+            "persistentStateVersion": 42, # Version number for persistent state.
+            "userStageToComputationNameMap": { # Maps user stage names to stable computation names.
+              "a_key": "A String",
+            },
+            "forwardingKeyBits": 42, # The size (in bits) of keys that will be assigned to source messages.
+          },
+          "receiveWorkPort": 42, # The TCP port on which the worker should listen for messages from other streaming computation workers.
+        },
+        "streamingConfigTask": { # A task that carries configuration information for streaming computations. # Additional information for StreamingConfigTask WorkItems.
+          "userStepToStateFamilyNameMap": { # Map from user step names to state families.
+            "a_key": "A String",
+          },
+          "streamingComputationConfigs": [ # Set of computation configuration information.
+            { # Configuration information for a single streaming computation.
+              "computationId": "A String", # Unique identifier for this computation.
+              "systemName": "A String", # System defined name for this computation.
+              "stageName": "A String", # Stage name of this computation.
+              "instructions": [ # Instructions that comprise the computation.
+                { # Describes a particular operation comprising a MapTask.
+                  "name": "A String", # User-provided name of this operation.
+                  "read": { # An instruction that reads records. Takes no inputs, produces one output. # Additional information for Read instructions.
+                    "source": { # A source that records can be read and decoded from. # The source to read from.
+                      "codec": { # The codec to use to decode data read from the source.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                        {
+                          "a_key": "", # Properties of the object.
+                        },
+                      ],
+                      "spec": { # The source to read from, plus its parameters.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                      "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                        "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                        "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                        "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                      },
+                    },
+                  },
+                  "outputs": [ # Describes the outputs of the instruction.
+                    { # An output of an instruction.
+                      "name": "A String", # The user-provided name of this output.
+                      "onlyCountKeyBytes": True or False, # For system-generated byte and mean byte metrics, certain instructions should only report the key size.
+                      "codec": { # The codec to use to encode data being written via this output.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "systemName": "A String", # System-defined name of this output. Unique across the workflow.
+                      "originalName": "A String", # System-defined name for this output in the original workflow graph. Outputs that do not contribute to an original instruction do not set this.
+                      "onlyCountValueBytes": True or False, # For system-generated byte and mean byte metrics, certain instructions should only report the value size.
+                    },
+                  ],
+                  "partialGroupByKey": { # An instruction that does a partial group-by-key. One input and one output. # Additional information for PartialGroupByKey instructions.
+                    "sideInputs": [ # Zero or more side inputs.
+                      { # Information about a side input of a DoFn or an input of a SeqDoFn.
+                        "sources": [ # The source(s) to read element(s) from to get the value of this side input. If more than one source, then the elements are taken from the sources, in the specified order if order matters. At least one source is required.
+                          { # A source that records can be read and decoded from.
+                            "codec": { # The codec to use to decode data read from the source.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                              {
+                                "a_key": "", # Properties of the object.
+                              },
+                            ],
+                            "spec": { # The source to read from, plus its parameters.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                            "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                              "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                              "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                              "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                            },
+                          },
+                        ],
+                        "kind": { # How to interpret the source element(s) as a side input value.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "tag": "A String", # The id of the tag the user code will access this side input by; this should correspond to the tag of some MultiOutputInfo.
+                      },
+                    ],
+                    "originalCombineValuesInputStoreName": "A String", # If this instruction includes a combining function this is the name of the intermediate store between the GBK and the CombineValues.
+                    "originalCombineValuesStepName": "A String", # If this instruction includes a combining function, this is the name of the CombineValues instruction lifted into this instruction.
+                    "valueCombiningFn": { # The value combining function to invoke.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "input": { # An input of an instruction, as a reference to an output of a producer instruction. # Describes the input to the partial group-by-key instruction.
+                      "outputNum": 42, # The output index (origin zero) within the producer.
+                      "producerInstructionIndex": 42, # The index (origin zero) of the parallel instruction that produces the output to be consumed by this input. This index is relative to the list of instructions in this input's instruction's containing MapTask.
+                    },
+                    "inputElementCodec": { # The codec to use for interpreting an element in the input PTable.
+                      "a_key": "", # Properties of the object.
+                    },
+                  },
+                  "write": { # An instruction that writes records. Takes one input, produces no outputs. # Additional information for Write instructions.
+                    "input": { # An input of an instruction, as a reference to an output of a producer instruction. # The input.
+                      "outputNum": 42, # The output index (origin zero) within the producer.
+                      "producerInstructionIndex": 42, # The index (origin zero) of the parallel instruction that produces the output to be consumed by this input. This index is relative to the list of instructions in this input's instruction's containing MapTask.
+                    },
+                    "sink": { # A sink that records can be encoded and written to. # The sink to write to.
+                      "codec": { # The codec to use to encode data written to the sink.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "spec": { # The sink to write to, plus its parameters.
+                        "a_key": "", # Properties of the object.
+                      },
+                    },
+                  },
+                  "systemName": "A String", # System-defined name of this operation. Unique across the workflow.
+                  "flatten": { # An instruction that copies its inputs (zero or more) to its (single) output. # Additional information for Flatten instructions.
+                    "inputs": [ # Describes the inputs to the flatten instruction.
+                      { # An input of an instruction, as a reference to an output of a producer instruction.
+                        "outputNum": 42, # The output index (origin zero) within the producer.
+                        "producerInstructionIndex": 42, # The index (origin zero) of the parallel instruction that produces the output to be consumed by this input. This index is relative to the list of instructions in this input's instruction's containing MapTask.
+                      },
+                    ],
+                  },
+                  "originalName": "A String", # System-defined name for the operation in the original workflow graph.
+                  "parDo": { # An instruction that does a ParDo operation. Takes one main input and zero or more side inputs, and produces zero or more outputs. Runs user code. # Additional information for ParDo instructions.
+                    "sideInputs": [ # Zero or more side inputs.
+                      { # Information about a side input of a DoFn or an input of a SeqDoFn.
+                        "sources": [ # The source(s) to read element(s) from to get the value of this side input. If more than one source, then the elements are taken from the sources, in the specified order if order matters. At least one source is required.
+                          { # A source that records can be read and decoded from.
+                            "codec": { # The codec to use to decode data read from the source.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                              {
+                                "a_key": "", # Properties of the object.
+                              },
+                            ],
+                            "spec": { # The source to read from, plus its parameters.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                            "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                              "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                              "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                              "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                            },
+                          },
+                        ],
+                        "kind": { # How to interpret the source element(s) as a side input value.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "tag": "A String", # The id of the tag the user code will access this side input by; this should correspond to the tag of some MultiOutputInfo.
+                      },
+                    ],
+                    "input": { # An input of an instruction, as a reference to an output of a producer instruction. # The input.
+                      "outputNum": 42, # The output index (origin zero) within the producer.
+                      "producerInstructionIndex": 42, # The index (origin zero) of the parallel instruction that produces the output to be consumed by this input. This index is relative to the list of instructions in this input's instruction's containing MapTask.
+                    },
+                    "multiOutputInfos": [ # Information about each of the outputs, if user_fn is a MultiDoFn.
+                      { # Information about an output of a multi-output DoFn.
+                        "tag": "A String", # The id of the tag the user code will emit to this output by; this should correspond to the tag of some SideInputInfo.
+                      },
+                    ],
+                    "numOutputs": 42, # The number of outputs.
+                    "userFn": { # The user function to invoke.
+                      "a_key": "", # Properties of the object.
+                    },
+                  },
+                },
+              ],
+            },
+          ],
+        },
+        "packages": [ # Any required packages that need to be fetched in order to execute this WorkItem.
+          { # Packages that need to be installed in order for a worker to run the steps of the Dataflow job which will be assigned to its worker pool. This is the mechanism by which the SDK causes code to be loaded onto the workers. For example, the Dataflow Java SDK might use this to install jars containing the user's code and all of the various dependencies (libraries, data files, etc) required in order for that code to run.
+            "name": "A String", # The name of the package.
+            "location": "A String", # The resource to read the package from. The supported resource type is: Google Cloud Storage: storage.googleapis.com/{bucket} bucket.storage.googleapis.com/
+          },
+        ],
+        "shellTask": { # A task which consists of a shell command for the worker to execute. # Additional information for ShellTask WorkItems.
+          "command": "A String", # The shell command to run.
+          "exitCode": 42, # Exit code for the task.
+        },
+        "id": "A String", # Identifies this WorkItem.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="reportStatus">reportStatus(projectId, location, jobId, body, x__xgafv=None)</code>
+  <pre>Reports the status of dataflow WorkItems leased by a worker.
+
+Args:
+  projectId: string, The project which owns the WorkItem's job. (required)
+  location: string, The location which contains the WorkItem's job. (required)
+  jobId: string, The job which the WorkItem is part of. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Request to report the status of WorkItems.
+    "workerId": "A String", # The ID of the worker reporting the WorkItem status. If this does not match the ID of the worker which the Dataflow service believes currently has the lease on the WorkItem, the report will be dropped (with an error response).
+    "currentWorkerTime": "A String", # The current timestamp at the worker.
+    "workItemStatuses": [ # The order is unimportant, except that the order of the WorkItemServiceState messages in the ReportWorkItemStatusResponse corresponds to the order of WorkItemStatus messages here.
+      { # Conveys a worker's progress through the work described by a WorkItem.
+        "reportIndex": "A String", # The report index. When a WorkItem is leased, the lease will contain an initial report index. When a WorkItem's status is reported to the system, the report should be sent with that report index, and the response will contain the index the worker should use for the next report. Reports received with unexpected index values will be rejected by the service. In order to preserve idempotency, the worker should not alter the contents of a report, even if the worker must submit the same report multiple times before getting back a response. The worker should not submit a subsequent report until the response for the previous report had been received from the service.
+        "errors": [ # Specifies errors which occurred during processing. If errors are provided, and completed = true, then the WorkItem is considered to have failed.
+          { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons.
+            "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+            "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+            "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
+              {
+                "a_key": "", # Properties of the object. Contains field @type with type URL.
+              },
+            ],
+          },
+        ],
+        "sourceOperationResponse": { # The result of a SourceOperationRequest, specified in ReportWorkItemStatusRequest.source_operation when the work item is completed. # If the work item represented a SourceOperationRequest, and the work is completed, contains the result of the operation.
+          "getMetadata": { # The result of a SourceGetMetadataOperation. # A response to a request to get metadata about a source.
+            "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # The computed metadata.
+              "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+              "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+              "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+            },
+          },
+          "split": { # The response to a SourceSplitRequest. # A response to a request to split a source.
+            "outcome": "A String", # Indicates whether splitting happened and produced a list of bundles. If this is USE_CURRENT_SOURCE_AS_IS, the current source should be processed "as is" without splitting. "bundles" is ignored in this case. If this is SPLITTING_HAPPENED, then "bundles" contains a list of bundles into which the source was split.
+            "bundles": [ # If outcome is SPLITTING_HAPPENED, then this is a list of bundles into which the source was split. Otherwise this field is ignored. This list can be empty, which means the source represents an empty input.
+              { # Specification of one of the bundles produced as a result of splitting a Source (e.g. when executing a SourceSplitRequest, or when splitting an active task using WorkItemStatus.dynamic_source_split), relative to the source being split.
+                "derivationMode": "A String", # What source to base the produced source on (if any).
+                "source": { # A source that records can be read and decoded from. # Specification of the source.
+                  "codec": { # The codec to use to decode data read from the source.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                    {
+                      "a_key": "", # Properties of the object.
+                    },
+                  ],
+                  "spec": { # The source to read from, plus its parameters.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                  "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                    "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                    "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                    "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                  },
+                },
+              },
+            ],
+            "shards": [ # DEPRECATED in favor of bundles.
+              { # DEPRECATED in favor of DerivedSource.
+                "derivationMode": "A String", # DEPRECATED
+                "source": { # A source that records can be read and decoded from. # DEPRECATED
+                  "codec": { # The codec to use to decode data read from the source.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                    {
+                      "a_key": "", # Properties of the object.
+                    },
+                  ],
+                  "spec": { # The source to read from, plus its parameters.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                  "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                    "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                    "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                    "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+                  },
+                },
+              },
+            ],
+          },
+        },
+        "stopPosition": { # Position defines a position within a collection of data. The value can be either the end position, a key (used with ordered collections), a byte offset, or a record index. # A worker may split an active map task in two parts, "primary" and "residual", continuing to process the primary part and returning the residual part into the pool of available work. This event is called a "dynamic split" and is critical to the dynamic work rebalancing feature. The two obtained sub-tasks are called "parts" of the split. The parts, if concatenated, must represent the same input as would be read by the current task if the split did not happen. The exact way in which the original task is decomposed into the two parts is specified either as a position demarcating them (stop_position), or explicitly as two DerivedSources, if this task consumes a user-defined source type (dynamic_source_split). The "current" task is adjusted as a result of the split: after a task with range [A, B) sends a stop_position update at C, its range is considered to be [A, C), e.g.: * Progress should be interpreted relative to the new range, e.g. "75% completed" means "75% of [A, C) completed" * The worker should interpret proposed_stop_position relative to the new range, e.g. "split at 68%" should be interpreted as "split at 68% of [A, C)". * If the worker chooses to split again using stop_position, only stop_positions in [A, C) will be accepted. * Etc. dynamic_source_split has similar semantics: e.g., if a task with source S splits using dynamic_source_split into {P, R} (where P and R must be together equivalent to S), then subsequent progress and proposed_stop_position should be interpreted relative to P, and in a potential subsequent dynamic_source_split into {P', R'}, P' and R' must be together equivalent to P, etc.
+          "end": True or False, # Position is past all other positions. Also useful for the end position of an unbounded range.
+          "recordIndex": "A String", # Position is a record index.
+          "byteOffset": "A String", # Position is a byte offset.
+          "key": "A String", # Position is a string key, ordered lexicographically.
+          "concatPosition": { # A position that encapsulates an inner position and an index for the inner position. A ConcatPosition can be used by a reader of a source that encapsulates a set of other sources. # CloudPosition is a concat position.
+            "index": 42, # Index of the inner source.
+            "position": # Object with schema name: Position # Position within the inner source.
+          },
+          "shufflePosition": "A String", # CloudPosition is a base64 encoded BatchShufflePosition (with FIXED sharding).
+        },
+        "sourceFork": { # DEPRECATED in favor of DynamicSourceSplit. # DEPRECATED in favor of dynamic_source_split.
+          "residualSource": { # Specification of one of the bundles produced as a result of splitting a Source (e.g. when executing a SourceSplitRequest, or when splitting an active task using WorkItemStatus.dynamic_source_split), relative to the source being split. # DEPRECATED
+            "derivationMode": "A String", # What source to base the produced source on (if any).
+            "source": { # A source that records can be read and decoded from. # Specification of the source.
+              "codec": { # The codec to use to decode data read from the source.
+                "a_key": "", # Properties of the object.
+              },
+              "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                {
+                  "a_key": "", # Properties of the object.
+                },
+              ],
+              "spec": { # The source to read from, plus its parameters.
+                "a_key": "", # Properties of the object.
+              },
+              "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+              "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+              },
+            },
+          },
+          "primarySource": { # Specification of one of the bundles produced as a result of splitting a Source (e.g. when executing a SourceSplitRequest, or when splitting an active task using WorkItemStatus.dynamic_source_split), relative to the source being split. # DEPRECATED
+            "derivationMode": "A String", # What source to base the produced source on (if any).
+            "source": { # A source that records can be read and decoded from. # Specification of the source.
+              "codec": { # The codec to use to decode data read from the source.
+                "a_key": "", # Properties of the object.
+              },
+              "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                {
+                  "a_key": "", # Properties of the object.
+                },
+              ],
+              "spec": { # The source to read from, plus its parameters.
+                "a_key": "", # Properties of the object.
+              },
+              "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+              "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+              },
+            },
+          },
+          "primary": { # DEPRECATED in favor of DerivedSource. # DEPRECATED
+            "derivationMode": "A String", # DEPRECATED
+            "source": { # A source that records can be read and decoded from. # DEPRECATED
+              "codec": { # The codec to use to decode data read from the source.
+                "a_key": "", # Properties of the object.
+              },
+              "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                {
+                  "a_key": "", # Properties of the object.
+                },
+              ],
+              "spec": { # The source to read from, plus its parameters.
+                "a_key": "", # Properties of the object.
+              },
+              "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+              "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+              },
+            },
+          },
+          "residual": { # DEPRECATED in favor of DerivedSource. # DEPRECATED
+            "derivationMode": "A String", # DEPRECATED
+            "source": { # A source that records can be read and decoded from. # DEPRECATED
+              "codec": { # The codec to use to decode data read from the source.
+                "a_key": "", # Properties of the object.
+              },
+              "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                {
+                  "a_key": "", # Properties of the object.
+                },
+              ],
+              "spec": { # The source to read from, plus its parameters.
+                "a_key": "", # Properties of the object.
+              },
+              "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+              "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+              },
+            },
+          },
+        },
+        "requestedLeaseDuration": "A String", # Amount of time the worker requests for its lease.
+        "completed": True or False, # True if the WorkItem was completed (successfully or unsuccessfully).
+        "workItemId": "A String", # Identifies the WorkItem.
+        "dynamicSourceSplit": { # When a task splits using WorkItemStatus.dynamic_source_split, this message describes the two parts of the split relative to the description of the current task's input. # See documentation of stop_position.
+          "primary": { # Specification of one of the bundles produced as a result of splitting a Source (e.g. when executing a SourceSplitRequest, or when splitting an active task using WorkItemStatus.dynamic_source_split), relative to the source being split. # Primary part (continued to be processed by worker). Specified relative to the previously-current source. Becomes current.
+            "derivationMode": "A String", # What source to base the produced source on (if any).
+            "source": { # A source that records can be read and decoded from. # Specification of the source.
+              "codec": { # The codec to use to decode data read from the source.
+                "a_key": "", # Properties of the object.
+              },
+              "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                {
+                  "a_key": "", # Properties of the object.
+                },
+              ],
+              "spec": { # The source to read from, plus its parameters.
+                "a_key": "", # Properties of the object.
+              },
+              "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+              "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+              },
+            },
+          },
+          "residual": { # Specification of one of the bundles produced as a result of splitting a Source (e.g. when executing a SourceSplitRequest, or when splitting an active task using WorkItemStatus.dynamic_source_split), relative to the source being split. # Residual part (returned to the pool of work). Specified relative to the previously-current source.
+            "derivationMode": "A String", # What source to base the produced source on (if any).
+            "source": { # A source that records can be read and decoded from. # Specification of the source.
+              "codec": { # The codec to use to decode data read from the source.
+                "a_key": "", # Properties of the object.
+              },
+              "baseSpecs": [ # While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs).
+                {
+                  "a_key": "", # Properties of the object.
+                },
+              ],
+              "spec": { # The source to read from, plus its parameters.
+                "a_key": "", # Properties of the object.
+              },
+              "doesNotNeedSplitting": True or False, # Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+              "metadata": { # Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. # Optionally, metadata for this source can be supplied right away, avoiding a SourceGetMetadataOperation roundtrip (see SourceOperationRequest). This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated.
+                "infinite": True or False, # Specifies that the size of this source is known to be infinite (this is a streaming source).
+                "estimatedSizeBytes": "A String", # An estimate of the total size (in bytes) of the data that would be read from this source. This estimate is in terms of external storage size, before any decompression or other processing done by the reader.
+                "producesSortedKeys": True or False, # Whether this source is known to produce key/value pairs with the (encoded) keys in lexicographically sorted order.
+              },
+            },
+          },
+        },
+        "counterUpdates": [ # Worker output counters for this WorkItem.
+          { # An update to a Counter sent from a worker.
+            "floatingPointList": { # A metric value representing a list of floating point numbers. # List of floating point numbers, for Set.
+              "elements": [ # Elements of the list.
+                3.14,
+              ],
+            },
+            "floatingPoint": 3.14, # Floating point value for Sum, Max, Min.
+            "integerMean": { # A representation of an integer mean metric contribution. # Integer mean aggregation value for Mean.
+              "count": { # A representation of an int64, n, that is immune to precision loss when encoded in JSON. # The number of values being aggregated.
+                "lowBits": 42, # The low order bits: n & 0xffffffff.
+                "highBits": 42, # The high order bits, including the sign: n >> 32.
+              },
+              "sum": { # A representation of an int64, n, that is immune to precision loss when encoded in JSON. # The sum of all values being aggregated.
+                "lowBits": 42, # The low order bits: n & 0xffffffff.
+                "highBits": 42, # The high order bits, including the sign: n >> 32.
+              },
+            },
+            "integerList": { # A metric value representing a list of integers. # List of integers, for Set.
+              "elements": [ # Elements of the list.
+                { # A representation of an int64, n, that is immune to precision loss when encoded in JSON.
+                  "lowBits": 42, # The low order bits: n & 0xffffffff.
+                  "highBits": 42, # The high order bits, including the sign: n >> 32.
+                },
+              ],
+            },
+            "cumulative": True or False, # True if this counter is reported as the total cumulative aggregate value accumulated since the worker started working on this WorkItem. By default this is false, indicating that this counter is reported as a delta.
+            "floatingPointMean": { # A representation of a floating point mean metric contribution. # Floating point mean aggregation value for Mean.
+              "count": { # A representation of an int64, n, that is immune to precision loss when encoded in JSON. # The number of values being aggregated.
+                "lowBits": 42, # The low order bits: n & 0xffffffff.
+                "highBits": 42, # The high order bits, including the sign: n >> 32.
+              },
+              "sum": 3.14, # The sum of all values being aggregated.
+            },
+            "shortId": "A String", # The service-generated short identifier for this counter. The short_id -> (name, metadata) mapping is constant for the lifetime of a job.
+            "boolean": True or False, # Boolean value for And, Or.
+            "structuredNameAndMetadata": { # A single message which encapsulates structured name and metadata for a given counter. # Counter structured name and metadata.
+              "name": { # Identifies a counter within a per-job namespace. Counters whose structured names are the same get merged into a single value for the job. # Structured name of the counter.
+                "executionStepName": "A String", # Name of the stage. An execution step contains multiple component steps.
+                "name": "A String", # Counter name. Not necessarily globally-unique, but unique within the context of the other fields. Required.
+                "workerId": "A String", # ID of a particular worker.
+                "originalStepName": "A String", # System generated name of the original step in the user's graph, before optimization.
+                "standardOrigin": "A String", # One of the standard Origins defined above.
+                "portion": "A String", # Portion of this counter, either key or value.
+                "otherOrigin": "A String", # A string containing the origin of the counter.
+                "componentStepName": "A String", # Name of the optimized step being executed by the workers.
+              },
+              "metadata": { # CounterMetadata includes all static non-name non-value counter attributes. # Metadata associated with a counter
+                "standardUnits": "A String", # System defined Units, see above enum.
+                "kind": "A String", # Counter aggregation kind.
+                "description": "A String", # Human-readable description of the counter semantics.
+                "otherUnits": "A String", # A string referring to the unit type.
+              },
+            },
+            "internal": "", # Value for internally-defined counters used by the Dataflow service.
+            "integer": { # A representation of an int64, n, that is immune to precision loss when encoded in JSON. # Integer value for Sum, Max, Min.
+              "lowBits": 42, # The low order bits: n & 0xffffffff.
+              "highBits": 42, # The high order bits, including the sign: n >> 32.
+            },
+            "nameAndKind": { # Basic metadata about a counter. # Counter name and aggregation type.
+              "kind": "A String", # Counter aggregation kind.
+              "name": "A String", # Name of the counter.
+            },
+            "stringList": { # A metric value representing a list of strings. # List of strings, for Set.
+              "elements": [ # Elements of the list.
+                "A String",
+              ],
+            },
+          },
+        ],
+        "progress": { # Obsolete in favor of ApproximateReportedProgress and ApproximateSplitRequest. # DEPRECATED in favor of reported_progress.
+          "position": { # Position defines a position within a collection of data. The value can be either the end position, a key (used with ordered collections), a byte offset, or a record index. # Obsolete.
+            "end": True or False, # Position is past all other positions. Also useful for the end position of an unbounded range.
+            "recordIndex": "A String", # Position is a record index.
+            "byteOffset": "A String", # Position is a byte offset.
+            "key": "A String", # Position is a string key, ordered lexicographically.
+            "concatPosition": { # A position that encapsulates an inner position and an index for the inner position. A ConcatPosition can be used by a reader of a source that encapsulates a set of other sources. # CloudPosition is a concat position.
+              "index": 42, # Index of the inner source.
+              "position": # Object with schema name: Position # Position within the inner source.
+            },
+            "shufflePosition": "A String", # CloudPosition is a base64 encoded BatchShufflePosition (with FIXED sharding).
+          },
+          "remainingTime": "A String", # Obsolete.
+          "percentComplete": 3.14, # Obsolete.
+        },
+        "metricUpdates": [ # DEPRECATED in favor of counter_updates.
+          { # Describes the state of a metric.
+            "meanCount": "", # Worker-computed aggregate value for the "Mean" aggregation kind. This holds the count of the aggregated values and is used in combination with mean_sum above to obtain the actual mean aggregate value. The only possible value type is Long.
+            "kind": "A String", # Metric aggregation kind. The possible metric aggregation kinds are "Sum", "Max", "Min", "Mean", "Set", "And", and "Or". The specified aggregation kind is case-insensitive. If omitted, this is not an aggregated value but instead a single metric sample value.
+            "set": "", # Worker-computed aggregate value for the "Set" aggregation kind. The only possible value type is a list of Values whose type can be Long, Double, or String, according to the metric's type. All Values in the list must be of the same type.
+            "name": { # Identifies a metric, by describing the source which generated the metric. # Name of the metric.
+              "origin": "A String", # Origin (namespace) of metric name. May be blank for user-define metrics; will be "dataflow" for metrics defined by the Dataflow service or SDK.
+              "name": "A String", # Worker-defined metric name.
+              "context": { # Zero or more labeled fields which identify the part of the job this metric is associated with, such as the name of a step or collection. For example, built-in counters associated with steps will have context['step'] = . Counters associated with PCollections in the SDK will have context['pcollection'] =
+                  # .
+                "a_key": "A String",
+              },
+            },
+            "cumulative": True or False, # True if this metric is reported as the total cumulative aggregate value accumulated since the worker started working on this WorkItem. By default this is false, indicating that this metric is reported as a delta that is not associated with any WorkItem.
+            "updateTime": "A String", # Timestamp associated with the metric value. Optional when workers are reporting work progress; it will be filled in responses from the metrics API.
+            "scalar": "", # Worker-computed aggregate value for aggregation kinds "Sum", "Max", "Min", "And", and "Or". The possible value types are Long, Double, and Boolean.
+            "meanSum": "", # Worker-computed aggregate value for the "Mean" aggregation kind. This holds the sum of the aggregated values and is used in combination with mean_count below to obtain the actual mean aggregate value. The only possible value types are Long and Double.
+            "internal": "", # Worker-computed aggregate value for internal use by the Dataflow service.
+          },
+        ],
+        "reportedProgress": { # A progress measurement of a WorkItem by a worker. # The worker's progress through this WorkItem.
+          "fractionConsumed": 3.14, # Completion as fraction of the input consumed, from 0.0 (beginning, nothing consumed), to 1.0 (end of the input, entire input consumed).
+          "position": { # Position defines a position within a collection of data. The value can be either the end position, a key (used with ordered collections), a byte offset, or a record index. # A Position within the work to represent a progress.
+            "end": True or False, # Position is past all other positions. Also useful for the end position of an unbounded range.
+            "recordIndex": "A String", # Position is a record index.
+            "byteOffset": "A String", # Position is a byte offset.
+            "key": "A String", # Position is a string key, ordered lexicographically.
+            "concatPosition": { # A position that encapsulates an inner position and an index for the inner position. A ConcatPosition can be used by a reader of a source that encapsulates a set of other sources. # CloudPosition is a concat position.
+              "index": 42, # Index of the inner source.
+              "position": # Object with schema name: Position # Position within the inner source.
+            },
+            "shufflePosition": "A String", # CloudPosition is a base64 encoded BatchShufflePosition (with FIXED sharding).
+          },
+          "remainingParallelism": { # Represents the level of parallelism in a WorkItem's input, reported by the worker. # Total amount of parallelism in the input of this task that remains, (i.e. can be delegated to this task and any new tasks via dynamic splitting). Always at least 1 for non-finished work items and 0 for finished. "Amount of parallelism" refers to how many non-empty parts of the input can be read in parallel. This does not necessarily equal number of records. An input that can be read in parallel down to the individual records is called "perfectly splittable". An example of non-perfectly parallelizable input is a block-compressed file format where a block of records has to be read as a whole, but different blocks can be read in parallel. Examples: * If we are processing record #30 (starting at 1) out of 50 in a perfectly splittable 50-record input, this value should be 21 (20 remaining + 1 current). * If we are reading through block 3 in a block-compressed file consisting of 5 blocks, this value should be 3 (since blocks 4 and 5 can be processed in parallel by new tasks via dynamic splitting and the current task remains processing block 3). * If we are reading through the last block in a block-compressed file, or reading or processing the last record in a perfectly splittable input, this value should be 1, because apart from the current task, no additional remainder can be split off.
+            "isInfinite": True or False, # Specifies whether the parallelism is infinite. If true, "value" is ignored. Infinite parallelism means the service will assume that the work item can always be split into more non-empty work items by dynamic splitting. This is a work-around for lack of support for infinity by the current JSON-based Java RPC stack.
+            "value": 3.14, # Specifies the level of parallelism in case it is finite.
+          },
+          "consumedParallelism": { # Represents the level of parallelism in a WorkItem's input, reported by the worker. # Total amount of parallelism in the portion of input of this task that has already been consumed and is no longer active. In the first two examples above (see remaining_parallelism), the value should be 29 or 2 respectively. The sum of remaining_parallelism and consumed_parallelism should equal the total amount of parallelism in this work item. If specified, must be finite.
+            "isInfinite": True or False, # Specifies whether the parallelism is infinite. If true, "value" is ignored. Infinite parallelism means the service will assume that the work item can always be split into more non-empty work items by dynamic splitting. This is a work-around for lack of support for infinity by the current JSON-based Java RPC stack.
+            "value": 3.14, # Specifies the level of parallelism in case it is finite.
+          },
+        },
+      },
+    ],
+    "location": "A String", # The location which contains the WorkItem's job.
+  }
+
+  x__xgafv: string, V1 error format.
+
+Returns:
+  An object of the form:
+
+    { # Response from a request to report the status of WorkItems.
+    "workItemServiceStates": [ # A set of messages indicating the service-side state for each WorkItem whose status was reported, in the same order as the WorkItemStatus messages in the ReportWorkItemStatusRequest which resulting in this response.
+      { # The Dataflow service's idea of the current state of a WorkItem being processed by a worker.
+        "reportStatusInterval": "A String", # New recommended reporting interval.
+        "suggestedStopPosition": { # Position defines a position within a collection of data. The value can be either the end position, a key (used with ordered collections), a byte offset, or a record index. # Obsolete, always empty.
+          "end": True or False, # Position is past all other positions. Also useful for the end position of an unbounded range.
+          "recordIndex": "A String", # Position is a record index.
+          "byteOffset": "A String", # Position is a byte offset.
+          "key": "A String", # Position is a string key, ordered lexicographically.
+          "concatPosition": { # A position that encapsulates an inner position and an index for the inner position. A ConcatPosition can be used by a reader of a source that encapsulates a set of other sources. # CloudPosition is a concat position.
+            "index": 42, # Index of the inner source.
+            "position": # Object with schema name: Position # Position within the inner source.
+          },
+          "shufflePosition": "A String", # CloudPosition is a base64 encoded BatchShufflePosition (with FIXED sharding).
+        },
+        "harnessData": { # Other data returned by the service, specific to the particular worker harness.
+          "a_key": "", # Properties of the object.
+        },
+        "nextReportIndex": "A String", # The index value to use for the next report sent by the worker. Note: If the report call fails for whatever reason, the worker should reuse this index for subsequent report attempts.
+        "leaseExpireTime": "A String", # Time at which the current lease will expire.
+        "metricShortId": [ # The short ids that workers should use in subsequent metric updates. Workers should strive to use short ids whenever possible, but it is ok to request the short_id again if a worker lost track of it (e.g. if the worker is recovering from a crash). NOTE: it is possible that the response may have short ids for a subset of the metrics.
+          { # The metric short id is returned to the user alongside an offset into ReportWorkItemStatusRequest
+            "shortId": "A String", # The service-generated short identifier for the metric.
+            "metricIndex": 42, # The index of the corresponding metric in the ReportWorkItemStatusRequest. Required.
+          },
+        ],
+        "splitRequest": { # A suggestion by the service to the worker to dynamically split the WorkItem. # The progress point in the WorkItem where the Dataflow service suggests that the worker truncate the task.
+          "fractionConsumed": 3.14, # A fraction at which to split the work item, from 0.0 (beginning of the input) to 1.0 (end of the input).
+          "position": { # Position defines a position within a collection of data. The value can be either the end position, a key (used with ordered collections), a byte offset, or a record index. # A Position at which to split the work item.
+            "end": True or False, # Position is past all other positions. Also useful for the end position of an unbounded range.
+            "recordIndex": "A String", # Position is a record index.
+            "byteOffset": "A String", # Position is a byte offset.
+            "key": "A String", # Position is a string key, ordered lexicographically.
+            "concatPosition": { # A position that encapsulates an inner position and an index for the inner position. A ConcatPosition can be used by a reader of a source that encapsulates a set of other sources. # CloudPosition is a concat position.
+              "index": 42, # Index of the inner source.
+              "position": # Object with schema name: Position # Position within the inner source.
+            },
+            "shufflePosition": "A String", # CloudPosition is a base64 encoded BatchShufflePosition (with FIXED sharding).
+          },
+        },
+        "suggestedStopPoint": { # Obsolete in favor of ApproximateReportedProgress and ApproximateSplitRequest. # DEPRECATED in favor of split_request.
+          "position": { # Position defines a position within a collection of data. The value can be either the end position, a key (used with ordered collections), a byte offset, or a record index. # Obsolete.
+            "end": True or False, # Position is past all other positions. Also useful for the end position of an unbounded range.
+            "recordIndex": "A String", # Position is a record index.
+            "byteOffset": "A String", # Position is a byte offset.
+            "key": "A String", # Position is a string key, ordered lexicographically.
+            "concatPosition": { # A position that encapsulates an inner position and an index for the inner position. A ConcatPosition can be used by a reader of a source that encapsulates a set of other sources. # CloudPosition is a concat position.
+              "index": 42, # Index of the inner source.
+              "position": # Object with schema name: Position # Position within the inner source.
+            },
+            "shufflePosition": "A String", # CloudPosition is a base64 encoded BatchShufflePosition (with FIXED sharding).
+          },
+          "remainingTime": "A String", # Obsolete.
+          "percentComplete": 3.14, # Obsolete.
+        },
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dataflow_v1b3.projects.templates.html b/docs/dyn/dataflow_v1b3.projects.templates.html
index 27e47836539..351451a5357 100644
--- a/docs/dyn/dataflow_v1b3.projects.templates.html
+++ b/docs/dyn/dataflow_v1b3.projects.templates.html
@@ -88,10 +88,18 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Request to create a Dataflow job.
+    "environment": { # Environment values to set at runtime. # Runtime environment for the job.
+      "maxWorkers": 42, # The maximum number of workers to start for the job.
+      "tempLocation": "A String", # The temp location to use for the job.
+      "serviceAccountEmail": "A String", # The service account to run the job as.
+      "zone": "A String", # The zone to start the workers in.
+      "bypassTempDirValidation": True or False, # Bypass the safety checks for the job's temp directory. Use with caution.
+    },
     "gcsPath": "A String", # A path to the serialized JSON representation of the job.
     "parameters": { # Dynamic parameterization of the job's runtime environment.
       "a_key": "A String",
     },
+    "jobName": "A String", # The job name to use for the created job..
   }
 
   x__xgafv: string, V1 error format.
@@ -103,6 +111,7 @@ <h3>Method Details</h3>
       "clientRequestId": "A String", # Client's unique identifier of the job, re-used by SDK across retried attempts. If this field is set, the service will ensure its uniqueness. That is, the request to create a job will fail if the service has knowledge of a previously submitted job with the same client's id and job name. The caller may, for example, use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.
       "requestedState": "A String", # The job's requested state. UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.
       "name": "A String", # The user-specified Dataflow job name. Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt will return the existing Job. The name must match the regular expression [a-z]([-a-z0-9]{0,38}[a-z0-9])?
+      "location": "A String", # The location which contains this job.
       "replacedByJobId": "A String", # If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field will contain the ID of that job.
       "projectId": "A String", # The project which owns the job.
       "labels": { # User-defined labels for this job. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: * Keys must conform to regexp: \p{Ll}\p{Lo}{0,62} * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * Both keys and values are additionally constrained to be <= 128 bytes in size.
diff --git a/docs/dyn/dataproc_v1.projects.regions.clusters.html b/docs/dyn/dataproc_v1.projects.regions.clusters.html
index 0ae70a47475..c8fcdcd7c0f 100644
--- a/docs/dyn/dataproc_v1.projects.regions.clusters.html
+++ b/docs/dyn/dataproc_v1.projects.regions.clusters.html
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(projectId, region, clusterName, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the resource representation for a cluster in a project.</p>
 <p class="toc_element">
-  <code><a href="#list">list(projectId, region, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(projectId, region, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists all regions/{region}/clusters in a project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -108,18 +108,29 @@ <h3>Method Details</h3>
 
 { # Describes the identifying information, config, and status of a cluster of Google Compute Engine instances.
   "status": { # The status of a cluster and its instances. # [Output-only] Cluster status.
-    "state": "A String", # The cluster's state.
-    "stateStartTime": "A String", # Time when this state was entered.
-    "detail": "A String", # Optional details of cluster's state.
+    "state": "A String", # [Output-only] The cluster's state.
+    "stateStartTime": "A String", # [Output-only] Time when this state was entered.
+    "detail": "A String", # [Output-only] Optional details of cluster's state.
   },
   "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
   "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names of deleted clusters can be reused.
   "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+  "labels": { # [Optional] The labels to associate with this cluster. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.
+    "a_key": "A String",
+  },
+  "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release. # Contains cluster daemon metrics such as HDFS and YARN stats. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+    "yarnMetrics": { # The YARN metrics.
+      "a_key": "A String",
+    },
+    "hdfsMetrics": { # The HDFS metrics.
+      "a_key": "A String",
+    },
+  },
   "statusHistory": [ # [Output-only] The previous cluster status.
     { # The status of a cluster and its instances.
-      "state": "A String", # The cluster's state.
-      "stateStartTime": "A String", # Time when this state was entered.
-      "detail": "A String", # Optional details of cluster's state.
+      "state": "A String", # [Output-only] The cluster's state.
+      "stateStartTime": "A String", # [Output-only] Time when this state was entered.
+      "detail": "A String", # [Output-only] Optional details of cluster's state.
     },
   ],
   "config": { # The cluster config. # [Required] The cluster config. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
@@ -131,74 +142,75 @@ <h3>Method Details</h3>
     },
     "configBucket": "A String", # [Optional] A Google Cloud Storage staging bucket used for sharing generated SSH keys and config. If you do not specify a staging bucket, Cloud Dataproc will determine an appropriate Cloud Storage location (US, ASIA, or EU) for your cluster's staging bucket according to the Google Compute Engine zone where your cluster is deployed, and then it will create and manage this project-level, per-location bucket for you.
     "gceClusterConfig": { # Common config settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Required] The shared Google Compute Engine config settings for all instances in a cluster.
-      "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
-      "tags": [ # The Google Compute Engine tags to add to all instances.
+      "internalIpOnly": True or False, # [Optional] If true, all instances in the cluster will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This `internal_ip_only` restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
+      "networkUri": "A String", # [Optional] The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither `network_uri` nor `subnetwork_uri` is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see [Using Subnetworks](/compute/docs/subnetworks) for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
+      "tags": [ # The Google Compute Engine tags to add to all instances (see [Tagging instances](/compute/docs/label-or-tag-resources#tags)).
         "A String",
       ],
       "zoneUri": "A String", # [Required] The zone where the Google Compute Engine cluster will be located. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]`.
-      "subnetworkUri": "A String", # The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.
-      "serviceAccountScopes": [ # The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: * https://www.googleapis.com/auth/cloud.useraccounts.readonly * https://www.googleapis.com/auth/devstorage.read_write * https://www.googleapis.com/auth/logging.write If no scopes are specfied, the following defaults are also provided: * https://www.googleapis.com/auth/bigquery * https://www.googleapis.com/auth/bigtable.admin.table * https://www.googleapis.com/auth/bigtable.data * https://www.googleapis.com/auth/devstorage.full_control
+      "subnetworkUri": "A String", # [Optional] The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.
+      "serviceAccountScopes": [ # [Optional] The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: * https://www.googleapis.com/auth/cloud.useraccounts.readonly * https://www.googleapis.com/auth/devstorage.read_write * https://www.googleapis.com/auth/logging.write If no scopes are specified, the following defaults are also provided: * https://www.googleapis.com/auth/bigquery * https://www.googleapis.com/auth/bigtable.admin.table * https://www.googleapis.com/auth/bigtable.data * https://www.googleapis.com/auth/devstorage.full_control
         "A String",
       ],
-      "metadata": { # The Google Compute Engine metadata entries to add to all instances.
+      "metadata": { # The Google Compute Engine metadata entries to add to all instances (see [Project and instance metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
         "a_key": "A String",
       },
     },
-    "workerConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for worker instances in a cluster.
-      "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-      "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-      "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+    "workerConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for worker instances in a cluster.
+      "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+      "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+      "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
         "A String",
       ],
-      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
         "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
       },
       "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
         "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
         "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
       },
-      "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+      "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
       "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
     },
-    "initializationActions": [ # [Optional] Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below: ROLE=$(/usr/share/google/get_metadata_value attributes/role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi
+    "initializationActions": [ # [Optional] Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below using `curl` (you can also use `wget`): ROLE=$(curl -H Metadata-Flavor:Google http://metadata/computeMetadata/v1/instance/attributes/dataproc-role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi
       { # Specifies an executable to run on a fully configured node and a timeout period for executable completion.
         "executionTimeout": "A String", # [Optional] Amount of time executable has to complete. Default is 10 minutes. Cluster creation fails with an explanatory error message (the name of the executable that caused the error and the exceeded timeout period) if the executable is not completed at end of the timeout period.
         "executableFile": "A String", # [Required] Google Cloud Storage URI of executable file.
       },
     ],
-    "secondaryWorkerConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for additional worker instances in a cluster.
-      "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-      "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-      "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+    "secondaryWorkerConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for additional worker instances in a cluster.
+      "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+      "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+      "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
         "A String",
       ],
-      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
         "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
       },
       "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
         "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
         "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
       },
-      "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+      "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
       "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
     },
-    "masterConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for the master instance in a cluster.
-      "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-      "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-      "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+    "masterConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for the master instance in a cluster.
+      "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+      "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+      "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
         "A String",
       ],
-      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
         "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
       },
       "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
         "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
         "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
       },
-      "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+      "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
       "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
     },
   },
@@ -211,21 +223,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -245,21 +257,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -285,21 +297,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -319,18 +331,29 @@ <h3>Method Details</h3>
 
     { # Describes the identifying information, config, and status of a cluster of Google Compute Engine instances.
     "status": { # The status of a cluster and its instances. # [Output-only] Cluster status.
-      "state": "A String", # The cluster's state.
-      "stateStartTime": "A String", # Time when this state was entered.
-      "detail": "A String", # Optional details of cluster's state.
+      "state": "A String", # [Output-only] The cluster's state.
+      "stateStartTime": "A String", # [Output-only] Time when this state was entered.
+      "detail": "A String", # [Output-only] Optional details of cluster's state.
     },
     "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
     "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names of deleted clusters can be reused.
     "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+    "labels": { # [Optional] The labels to associate with this cluster. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.
+      "a_key": "A String",
+    },
+    "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release. # Contains cluster daemon metrics such as HDFS and YARN stats. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+      "yarnMetrics": { # The YARN metrics.
+        "a_key": "A String",
+      },
+      "hdfsMetrics": { # The HDFS metrics.
+        "a_key": "A String",
+      },
+    },
     "statusHistory": [ # [Output-only] The previous cluster status.
       { # The status of a cluster and its instances.
-        "state": "A String", # The cluster's state.
-        "stateStartTime": "A String", # Time when this state was entered.
-        "detail": "A String", # Optional details of cluster's state.
+        "state": "A String", # [Output-only] The cluster's state.
+        "stateStartTime": "A String", # [Output-only] Time when this state was entered.
+        "detail": "A String", # [Output-only] Optional details of cluster's state.
       },
     ],
     "config": { # The cluster config. # [Required] The cluster config. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
@@ -342,74 +365,75 @@ <h3>Method Details</h3>
       },
       "configBucket": "A String", # [Optional] A Google Cloud Storage staging bucket used for sharing generated SSH keys and config. If you do not specify a staging bucket, Cloud Dataproc will determine an appropriate Cloud Storage location (US, ASIA, or EU) for your cluster's staging bucket according to the Google Compute Engine zone where your cluster is deployed, and then it will create and manage this project-level, per-location bucket for you.
       "gceClusterConfig": { # Common config settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Required] The shared Google Compute Engine config settings for all instances in a cluster.
-        "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
-        "tags": [ # The Google Compute Engine tags to add to all instances.
+        "internalIpOnly": True or False, # [Optional] If true, all instances in the cluster will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This `internal_ip_only` restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
+        "networkUri": "A String", # [Optional] The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither `network_uri` nor `subnetwork_uri` is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see [Using Subnetworks](/compute/docs/subnetworks) for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
+        "tags": [ # The Google Compute Engine tags to add to all instances (see [Tagging instances](/compute/docs/label-or-tag-resources#tags)).
           "A String",
         ],
         "zoneUri": "A String", # [Required] The zone where the Google Compute Engine cluster will be located. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]`.
-        "subnetworkUri": "A String", # The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.
-        "serviceAccountScopes": [ # The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: * https://www.googleapis.com/auth/cloud.useraccounts.readonly * https://www.googleapis.com/auth/devstorage.read_write * https://www.googleapis.com/auth/logging.write If no scopes are specfied, the following defaults are also provided: * https://www.googleapis.com/auth/bigquery * https://www.googleapis.com/auth/bigtable.admin.table * https://www.googleapis.com/auth/bigtable.data * https://www.googleapis.com/auth/devstorage.full_control
+        "subnetworkUri": "A String", # [Optional] The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.
+        "serviceAccountScopes": [ # [Optional] The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: * https://www.googleapis.com/auth/cloud.useraccounts.readonly * https://www.googleapis.com/auth/devstorage.read_write * https://www.googleapis.com/auth/logging.write If no scopes are specified, the following defaults are also provided: * https://www.googleapis.com/auth/bigquery * https://www.googleapis.com/auth/bigtable.admin.table * https://www.googleapis.com/auth/bigtable.data * https://www.googleapis.com/auth/devstorage.full_control
           "A String",
         ],
-        "metadata": { # The Google Compute Engine metadata entries to add to all instances.
+        "metadata": { # The Google Compute Engine metadata entries to add to all instances (see [Project and instance metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
           "a_key": "A String",
         },
       },
-      "workerConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for worker instances in a cluster.
-        "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-        "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-        "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+      "workerConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for worker instances in a cluster.
+        "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+        "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+        "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
           "A String",
         ],
-        "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-          "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+        "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+          "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
           "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
         },
         "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
           "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
           "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
         },
-        "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+        "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
         "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
       },
-      "initializationActions": [ # [Optional] Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below: ROLE=$(/usr/share/google/get_metadata_value attributes/role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi
+      "initializationActions": [ # [Optional] Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below using `curl` (you can also use `wget`): ROLE=$(curl -H Metadata-Flavor:Google http://metadata/computeMetadata/v1/instance/attributes/dataproc-role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi
         { # Specifies an executable to run on a fully configured node and a timeout period for executable completion.
           "executionTimeout": "A String", # [Optional] Amount of time executable has to complete. Default is 10 minutes. Cluster creation fails with an explanatory error message (the name of the executable that caused the error and the exceeded timeout period) if the executable is not completed at end of the timeout period.
           "executableFile": "A String", # [Required] Google Cloud Storage URI of executable file.
         },
       ],
-      "secondaryWorkerConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for additional worker instances in a cluster.
-        "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-        "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-        "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+      "secondaryWorkerConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for additional worker instances in a cluster.
+        "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+        "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+        "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
           "A String",
         ],
-        "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-          "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+        "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+          "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
           "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
         },
         "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
           "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
           "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
         },
-        "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+        "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
         "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
       },
-      "masterConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for the master instance in a cluster.
-        "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-        "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-        "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+      "masterConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for the master instance in a cluster.
+        "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+        "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+        "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
           "A String",
         ],
-        "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-          "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+        "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+          "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
           "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
         },
         "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
           "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
           "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
         },
-        "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+        "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
         "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
       },
     },
@@ -417,36 +441,48 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(projectId, region, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(projectId, region, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
   <pre>Lists all regions/{region}/clusters in a project.
 
 Args:
   projectId: string, [Required] The ID of the Google Cloud Platform project that the cluster belongs to. (required)
   region: string, [Required] The Cloud Dataproc region in which to handle the request. (required)
-  pageSize: integer, The standard List page size.
-  pageToken: string, The standard List page token.
+  pageSize: integer, [Optional] The standard List page size.
+  filter: string, [Optional] A filter constraining the clusters to list. Filters are case-sensitive and have the following syntax: field:value [field:value] ... or field = value [AND [field = value]] ... where **field** is one of `status.state`, `clusterName`, or `labels.[KEY]`, and `[KEY]` is a label key. **value** can be `*` to match all values. `status.state` can be one of the following: `ACTIVE`, `INACTIVE`, `CREATING`, `RUNNING`, `ERROR`, `DELETING`, or `UPDATING`. `ACTIVE` contains the `CREATING`, `UPDATING`, and `RUNNING` states. `INACTIVE` contains the `DELETING` and `ERROR` states. `clusterName` is the name of the cluster provided at creation time. Only the logical `AND` operator is supported; space-separated items are treated as having an implicit `AND` operator. Example valid filters are: status.state:ACTIVE clusterName:mycluster labels.env:staging \ labels.starred:* and status.state = ACTIVE AND clusterName = mycluster \ AND labels.env = staging AND labels.starred = *
+  pageToken: string, [Optional] The standard List page token.
   x__xgafv: string, V1 error format.
 
 Returns:
   An object of the form:
 
     { # The list of all clusters in a project.
-    "nextPageToken": "A String", # [Optional] This token is included in the response if there are more results to fetch. To fetch additional results, provide this value as the `page_token` in a subsequent ListClustersRequest.
+    "nextPageToken": "A String", # [Output-only] This token is included in the response if there are more results to fetch. To fetch additional results, provide this value as the `page_token` in a subsequent ListClustersRequest.
     "clusters": [ # [Output-only] The clusters in the project.
       { # Describes the identifying information, config, and status of a cluster of Google Compute Engine instances.
         "status": { # The status of a cluster and its instances. # [Output-only] Cluster status.
-          "state": "A String", # The cluster's state.
-          "stateStartTime": "A String", # Time when this state was entered.
-          "detail": "A String", # Optional details of cluster's state.
+          "state": "A String", # [Output-only] The cluster's state.
+          "stateStartTime": "A String", # [Output-only] Time when this state was entered.
+          "detail": "A String", # [Output-only] Optional details of cluster's state.
         },
         "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
         "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names of deleted clusters can be reused.
         "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+        "labels": { # [Optional] The labels to associate with this cluster. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.
+          "a_key": "A String",
+        },
+        "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release. # Contains cluster daemon metrics such as HDFS and YARN stats. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+          "yarnMetrics": { # The YARN metrics.
+            "a_key": "A String",
+          },
+          "hdfsMetrics": { # The HDFS metrics.
+            "a_key": "A String",
+          },
+        },
         "statusHistory": [ # [Output-only] The previous cluster status.
           { # The status of a cluster and its instances.
-            "state": "A String", # The cluster's state.
-            "stateStartTime": "A String", # Time when this state was entered.
-            "detail": "A String", # Optional details of cluster's state.
+            "state": "A String", # [Output-only] The cluster's state.
+            "stateStartTime": "A String", # [Output-only] Time when this state was entered.
+            "detail": "A String", # [Output-only] Optional details of cluster's state.
           },
         ],
         "config": { # The cluster config. # [Required] The cluster config. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
@@ -458,74 +494,75 @@ <h3>Method Details</h3>
           },
           "configBucket": "A String", # [Optional] A Google Cloud Storage staging bucket used for sharing generated SSH keys and config. If you do not specify a staging bucket, Cloud Dataproc will determine an appropriate Cloud Storage location (US, ASIA, or EU) for your cluster's staging bucket according to the Google Compute Engine zone where your cluster is deployed, and then it will create and manage this project-level, per-location bucket for you.
           "gceClusterConfig": { # Common config settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Required] The shared Google Compute Engine config settings for all instances in a cluster.
-            "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
-            "tags": [ # The Google Compute Engine tags to add to all instances.
+            "internalIpOnly": True or False, # [Optional] If true, all instances in the cluster will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This `internal_ip_only` restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
+            "networkUri": "A String", # [Optional] The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither `network_uri` nor `subnetwork_uri` is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see [Using Subnetworks](/compute/docs/subnetworks) for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
+            "tags": [ # The Google Compute Engine tags to add to all instances (see [Tagging instances](/compute/docs/label-or-tag-resources#tags)).
               "A String",
             ],
             "zoneUri": "A String", # [Required] The zone where the Google Compute Engine cluster will be located. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]`.
-            "subnetworkUri": "A String", # The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.
-            "serviceAccountScopes": [ # The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: * https://www.googleapis.com/auth/cloud.useraccounts.readonly * https://www.googleapis.com/auth/devstorage.read_write * https://www.googleapis.com/auth/logging.write If no scopes are specfied, the following defaults are also provided: * https://www.googleapis.com/auth/bigquery * https://www.googleapis.com/auth/bigtable.admin.table * https://www.googleapis.com/auth/bigtable.data * https://www.googleapis.com/auth/devstorage.full_control
+            "subnetworkUri": "A String", # [Optional] The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.
+            "serviceAccountScopes": [ # [Optional] The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: * https://www.googleapis.com/auth/cloud.useraccounts.readonly * https://www.googleapis.com/auth/devstorage.read_write * https://www.googleapis.com/auth/logging.write If no scopes are specified, the following defaults are also provided: * https://www.googleapis.com/auth/bigquery * https://www.googleapis.com/auth/bigtable.admin.table * https://www.googleapis.com/auth/bigtable.data * https://www.googleapis.com/auth/devstorage.full_control
               "A String",
             ],
-            "metadata": { # The Google Compute Engine metadata entries to add to all instances.
+            "metadata": { # The Google Compute Engine metadata entries to add to all instances (see [Project and instance metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
               "a_key": "A String",
             },
           },
-          "workerConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for worker instances in a cluster.
-            "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-            "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-            "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+          "workerConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for worker instances in a cluster.
+            "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+            "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+            "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
               "A String",
             ],
-            "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-              "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+            "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+              "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
               "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
             },
             "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
               "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
               "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
             },
-            "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+            "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
             "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
           },
-          "initializationActions": [ # [Optional] Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below: ROLE=$(/usr/share/google/get_metadata_value attributes/role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi
+          "initializationActions": [ # [Optional] Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below using `curl` (you can also use `wget`): ROLE=$(curl -H Metadata-Flavor:Google http://metadata/computeMetadata/v1/instance/attributes/dataproc-role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi
             { # Specifies an executable to run on a fully configured node and a timeout period for executable completion.
               "executionTimeout": "A String", # [Optional] Amount of time executable has to complete. Default is 10 minutes. Cluster creation fails with an explanatory error message (the name of the executable that caused the error and the exceeded timeout period) if the executable is not completed at end of the timeout period.
               "executableFile": "A String", # [Required] Google Cloud Storage URI of executable file.
             },
           ],
-          "secondaryWorkerConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for additional worker instances in a cluster.
-            "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-            "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-            "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+          "secondaryWorkerConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for additional worker instances in a cluster.
+            "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+            "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+            "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
               "A String",
             ],
-            "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-              "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+            "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+              "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
               "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
             },
             "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
               "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
               "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
             },
-            "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+            "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
             "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
           },
-          "masterConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for the master instance in a cluster.
-            "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-            "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-            "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+          "masterConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for the master instance in a cluster.
+            "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+            "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+            "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
               "A String",
             ],
-            "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-              "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+            "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+              "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
               "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
             },
             "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
               "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
               "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
             },
-            "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+            "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
             "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
           },
         },
@@ -561,18 +598,29 @@ <h3>Method Details</h3>
 
 { # Describes the identifying information, config, and status of a cluster of Google Compute Engine instances.
   "status": { # The status of a cluster and its instances. # [Output-only] Cluster status.
-    "state": "A String", # The cluster's state.
-    "stateStartTime": "A String", # Time when this state was entered.
-    "detail": "A String", # Optional details of cluster's state.
+    "state": "A String", # [Output-only] The cluster's state.
+    "stateStartTime": "A String", # [Output-only] Time when this state was entered.
+    "detail": "A String", # [Output-only] Optional details of cluster's state.
   },
   "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
   "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names of deleted clusters can be reused.
   "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+  "labels": { # [Optional] The labels to associate with this cluster. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.
+    "a_key": "A String",
+  },
+  "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release. # Contains cluster daemon metrics such as HDFS and YARN stats. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+    "yarnMetrics": { # The YARN metrics.
+      "a_key": "A String",
+    },
+    "hdfsMetrics": { # The HDFS metrics.
+      "a_key": "A String",
+    },
+  },
   "statusHistory": [ # [Output-only] The previous cluster status.
     { # The status of a cluster and its instances.
-      "state": "A String", # The cluster's state.
-      "stateStartTime": "A String", # Time when this state was entered.
-      "detail": "A String", # Optional details of cluster's state.
+      "state": "A String", # [Output-only] The cluster's state.
+      "stateStartTime": "A String", # [Output-only] Time when this state was entered.
+      "detail": "A String", # [Output-only] Optional details of cluster's state.
     },
   ],
   "config": { # The cluster config. # [Required] The cluster config. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
@@ -584,74 +632,75 @@ <h3>Method Details</h3>
     },
     "configBucket": "A String", # [Optional] A Google Cloud Storage staging bucket used for sharing generated SSH keys and config. If you do not specify a staging bucket, Cloud Dataproc will determine an appropriate Cloud Storage location (US, ASIA, or EU) for your cluster's staging bucket according to the Google Compute Engine zone where your cluster is deployed, and then it will create and manage this project-level, per-location bucket for you.
     "gceClusterConfig": { # Common config settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Required] The shared Google Compute Engine config settings for all instances in a cluster.
-      "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
-      "tags": [ # The Google Compute Engine tags to add to all instances.
+      "internalIpOnly": True or False, # [Optional] If true, all instances in the cluster will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This `internal_ip_only` restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
+      "networkUri": "A String", # [Optional] The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither `network_uri` nor `subnetwork_uri` is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see [Using Subnetworks](/compute/docs/subnetworks) for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
+      "tags": [ # The Google Compute Engine tags to add to all instances (see [Tagging instances](/compute/docs/label-or-tag-resources#tags)).
         "A String",
       ],
       "zoneUri": "A String", # [Required] The zone where the Google Compute Engine cluster will be located. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]`.
-      "subnetworkUri": "A String", # The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.
-      "serviceAccountScopes": [ # The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: * https://www.googleapis.com/auth/cloud.useraccounts.readonly * https://www.googleapis.com/auth/devstorage.read_write * https://www.googleapis.com/auth/logging.write If no scopes are specfied, the following defaults are also provided: * https://www.googleapis.com/auth/bigquery * https://www.googleapis.com/auth/bigtable.admin.table * https://www.googleapis.com/auth/bigtable.data * https://www.googleapis.com/auth/devstorage.full_control
+      "subnetworkUri": "A String", # [Optional] The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.
+      "serviceAccountScopes": [ # [Optional] The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: * https://www.googleapis.com/auth/cloud.useraccounts.readonly * https://www.googleapis.com/auth/devstorage.read_write * https://www.googleapis.com/auth/logging.write If no scopes are specified, the following defaults are also provided: * https://www.googleapis.com/auth/bigquery * https://www.googleapis.com/auth/bigtable.admin.table * https://www.googleapis.com/auth/bigtable.data * https://www.googleapis.com/auth/devstorage.full_control
         "A String",
       ],
-      "metadata": { # The Google Compute Engine metadata entries to add to all instances.
+      "metadata": { # The Google Compute Engine metadata entries to add to all instances (see [Project and instance metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
         "a_key": "A String",
       },
     },
-    "workerConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for worker instances in a cluster.
-      "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-      "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-      "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+    "workerConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for worker instances in a cluster.
+      "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+      "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+      "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
         "A String",
       ],
-      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
         "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
       },
       "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
         "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
         "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
       },
-      "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+      "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
       "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
     },
-    "initializationActions": [ # [Optional] Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below: ROLE=$(/usr/share/google/get_metadata_value attributes/role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi
+    "initializationActions": [ # [Optional] Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below using `curl` (you can also use `wget`): ROLE=$(curl -H Metadata-Flavor:Google http://metadata/computeMetadata/v1/instance/attributes/dataproc-role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi
       { # Specifies an executable to run on a fully configured node and a timeout period for executable completion.
         "executionTimeout": "A String", # [Optional] Amount of time executable has to complete. Default is 10 minutes. Cluster creation fails with an explanatory error message (the name of the executable that caused the error and the exceeded timeout period) if the executable is not completed at end of the timeout period.
         "executableFile": "A String", # [Required] Google Cloud Storage URI of executable file.
       },
     ],
-    "secondaryWorkerConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for additional worker instances in a cluster.
-      "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-      "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-      "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+    "secondaryWorkerConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for additional worker instances in a cluster.
+      "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+      "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+      "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
         "A String",
       ],
-      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
         "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
       },
       "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
         "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
         "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
       },
-      "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+      "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
       "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
     },
-    "masterConfig": { # The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for the master instance in a cluster.
-      "isPreemptible": True or False, # Specifies that this instance group contains Preemptible Instances.
-      "machineTypeUri": "A String", # The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
-      "instanceNames": [ # The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
+    "masterConfig": { # [Optional] The config settings for Google Compute Engine resources in an instance group, such as a master or worker group. # [Optional] The Google Compute Engine config settings for the master instance in a cluster.
+      "isPreemptible": True or False, # [Optional] Specifies that this instance group contains preemptible instances.
+      "machineTypeUri": "A String", # [Required] The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.
+      "instanceNames": [ # [Optional] The list of instance names. Cloud Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Cloud Dataproc derive the name).
         "A String",
       ],
-      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # Disk option config settings.
-        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and HDFS data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
+      "diskConfig": { # Specifies the config of disk options for a group of VM instances. # [Optional] Disk option config settings.
+        "numLocalSsds": 42, # [Optional] Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not attached, the boot disk is used to store runtime logs and [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are attached, this runtime bulk data is spread across them, and the boot disk contains only basic config and installed binaries.
         "bootDiskSizeGb": 42, # [Optional] Size in GB of the boot disk (default is 500GB).
       },
       "managedGroupConfig": { # Specifies the resources used to actively manage an instance group. # [Output-only] The config for Google Compute Engine Instance Group Manager that manages this group. This is only used for preemptible instance groups.
         "instanceTemplateName": "A String", # [Output-only] The name of the Instance Template used for the Managed Instance Group.
         "instanceGroupManagerName": "A String", # [Output-only] The name of the Instance Group Manager for this group.
       },
-      "numInstances": 42, # The number of VM instances in the instance group. For master instance groups, must be set to 1.
+      "numInstances": 42, # [Required] The number of VM instances in the instance group. For master instance groups, must be set to 1.
       "imageUri": "A String", # [Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfig.image_version`.
     },
   },
@@ -665,21 +714,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
diff --git a/docs/dyn/dataproc_v1.projects.regions.jobs.html b/docs/dyn/dataproc_v1.projects.regions.jobs.html
index e3f6df989a5..ab6e84e13dd 100644
--- a/docs/dyn/dataproc_v1.projects.regions.jobs.html
+++ b/docs/dyn/dataproc_v1.projects.regions.jobs.html
@@ -84,7 +84,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(projectId, region, jobId, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the resource representation for a job in a project.</p>
 <p class="toc_element">
-  <code><a href="#list">list(projectId, region, pageSize=None, x__xgafv=None, jobStateMatcher=None, pageToken=None, clusterName=None)</a></code></p>
+  <code><a href="#list">list(projectId, region, pageSize=None, x__xgafv=None, pageToken=None, clusterName=None, jobStateMatcher=None, filter=None)</a></code></p>
 <p class="firstline">Lists regions/{region}/jobs in a project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -114,11 +114,11 @@ <h3>Method Details</h3>
 
     { # A Cloud Dataproc job resource.
     "status": { # Cloud Dataproc job status. # [Output-only] The job status. Additional application-specific status information may be contained in the type_job and yarn_applications fields.
-      "state": "A String", # [Required] A state message specifying the overall job state.
+      "state": "A String", # [Output-only] A state message specifying the overall job state.
       "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-      "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+      "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
     },
-    "hadoopJob": { # A Cloud Dataproc job for running Hadoop MapReduce jobs on YARN. # Job is a Hadoop job.
+    "hadoopJob": { # A Cloud Dataproc job for running [Apache Hadoop MapReduce](https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) jobs on [Apache Hadoop YARN](https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html). # Job is a Hadoop job.
       "jarFileUris": [ # [Optional] Jar file URIs to add to the CLASSPATHs of the Hadoop driver and tasks.
         "A String",
       ],
@@ -144,9 +144,9 @@ <h3>Method Details</h3>
     },
     "statusHistory": [ # [Output-only] The previous job status.
       { # Cloud Dataproc job status.
-        "state": "A String", # [Required] A state message specifying the overall job state.
+        "state": "A String", # [Output-only] A state message specifying the overall job state.
         "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-        "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+        "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
       },
     ],
     "placement": { # Cloud Dataproc job config. # [Required] Job information, including how, when, and where to run the job.
@@ -155,9 +155,9 @@ <h3>Method Details</h3>
     },
     "reference": { # Encapsulates the full scoping used to reference a job. # [Optional] The fully qualified reference to the job, which can be used to obtain the equivalent REST path of the job resource. If this property is not specified when a job is created, the server generates a job_id.
       "projectId": "A String", # [Required] The ID of the Google Cloud Platform project that the job belongs to.
-      "jobId": "A String", # [Required] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
+      "jobId": "A String", # [Optional] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
     },
-    "sparkSqlJob": { # A Cloud Dataproc job for running Spark SQL queries. # Job is a SparkSql job.
+    "sparkSqlJob": { # A Cloud Dataproc job for running [Apache Spark SQL](http://spark.apache.org/sql/) queries. # Job is a SparkSql job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains SQL queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Spark SQL command: SET `name="value";`).
         "a_key": "A String",
@@ -179,7 +179,7 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "pigJob": { # A Cloud Dataproc job for running Pig queries on YARN. # Job is a Pig job.
+    "pigJob": { # A Cloud Dataproc job for running [Apache Pig](https://pig.apache.org/) queries on YARN. # Job is a Pig job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains the Pig queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Pig command: `name=[value]`).
         "a_key": "A String",
@@ -203,8 +203,11 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a job.
+      "a_key": "A String",
+    },
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
-    "sparkJob": { # A Cloud Dataproc job for running Spark applications on YARN. # Job is a Spark job.
+    "sparkJob": { # A Cloud Dataproc job for running [Apache Spark](http://spark.apache.org/) applications on YARN. # Job is a Spark job.
       "jarFileUris": [ # [Optional] HCFS URIs of jar files to add to the CLASSPATHs of the Spark driver and tasks.
         "A String",
       ],
@@ -228,7 +231,15 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "pysparkJob": { # A Cloud Dataproc job for running PySpark applications on YARN. # Job is a Pyspark job.
+    "yarnApplications": [ # [Output-only] The collection of YARN applications spun up by this job. **Beta** Feature: This report is available for testing purposes only. It may be changed before final release.
+      { # A YARN application created by a job. Application information is a subset of org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+        "progress": 3.14, # [Required] The numerical progress of the application, from 1 to 100.
+        "state": "A String", # [Required] The application state.
+        "name": "A String", # [Required] The application name.
+        "trackingUrl": "A String", # [Optional] The HTTP URL of the ApplicationMaster, HistoryServer, or TimelineServer that provides application-specific information. The URL uses the internal hostname, and requires a proxy server for resolution and, possibly, access.
+      },
+    ],
+    "pysparkJob": { # A Cloud Dataproc job for running [Apache PySpark](https://spark.apache.org/docs/0.9.0/python-programming-guide.html) applications on YARN. # Job is a Pyspark job.
       "mainPythonFileUri": "A String", # [Required] The HCFS URI of the main Python file to use as the driver. Must be a .py file.
       "args": [ # [Optional] The arguments to pass to the driver. Do not include arguments, such as `--conf`, that can be set as job properties, since a collision may occur that causes an incorrect job submission.
         "A String",
@@ -254,7 +265,7 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "hiveJob": { # A Cloud Dataproc job for running Hive queries on YARN. # Job is a Hive job.
+    "hiveJob": { # A Cloud Dataproc job for running [Apache Hive](https://hive.apache.org/) queries on YARN. # Job is a Hive job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains Hive queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Hive command: `SET name="value";`).
         "a_key": "A String",
@@ -307,11 +318,11 @@ <h3>Method Details</h3>
 
     { # A Cloud Dataproc job resource.
     "status": { # Cloud Dataproc job status. # [Output-only] The job status. Additional application-specific status information may be contained in the type_job and yarn_applications fields.
-      "state": "A String", # [Required] A state message specifying the overall job state.
+      "state": "A String", # [Output-only] A state message specifying the overall job state.
       "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-      "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+      "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
     },
-    "hadoopJob": { # A Cloud Dataproc job for running Hadoop MapReduce jobs on YARN. # Job is a Hadoop job.
+    "hadoopJob": { # A Cloud Dataproc job for running [Apache Hadoop MapReduce](https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) jobs on [Apache Hadoop YARN](https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html). # Job is a Hadoop job.
       "jarFileUris": [ # [Optional] Jar file URIs to add to the CLASSPATHs of the Hadoop driver and tasks.
         "A String",
       ],
@@ -337,9 +348,9 @@ <h3>Method Details</h3>
     },
     "statusHistory": [ # [Output-only] The previous job status.
       { # Cloud Dataproc job status.
-        "state": "A String", # [Required] A state message specifying the overall job state.
+        "state": "A String", # [Output-only] A state message specifying the overall job state.
         "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-        "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+        "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
       },
     ],
     "placement": { # Cloud Dataproc job config. # [Required] Job information, including how, when, and where to run the job.
@@ -348,9 +359,9 @@ <h3>Method Details</h3>
     },
     "reference": { # Encapsulates the full scoping used to reference a job. # [Optional] The fully qualified reference to the job, which can be used to obtain the equivalent REST path of the job resource. If this property is not specified when a job is created, the server generates a job_id.
       "projectId": "A String", # [Required] The ID of the Google Cloud Platform project that the job belongs to.
-      "jobId": "A String", # [Required] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
+      "jobId": "A String", # [Optional] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
     },
-    "sparkSqlJob": { # A Cloud Dataproc job for running Spark SQL queries. # Job is a SparkSql job.
+    "sparkSqlJob": { # A Cloud Dataproc job for running [Apache Spark SQL](http://spark.apache.org/sql/) queries. # Job is a SparkSql job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains SQL queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Spark SQL command: SET `name="value";`).
         "a_key": "A String",
@@ -372,7 +383,7 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "pigJob": { # A Cloud Dataproc job for running Pig queries on YARN. # Job is a Pig job.
+    "pigJob": { # A Cloud Dataproc job for running [Apache Pig](https://pig.apache.org/) queries on YARN. # Job is a Pig job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains the Pig queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Pig command: `name=[value]`).
         "a_key": "A String",
@@ -396,8 +407,11 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a job.
+      "a_key": "A String",
+    },
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
-    "sparkJob": { # A Cloud Dataproc job for running Spark applications on YARN. # Job is a Spark job.
+    "sparkJob": { # A Cloud Dataproc job for running [Apache Spark](http://spark.apache.org/) applications on YARN. # Job is a Spark job.
       "jarFileUris": [ # [Optional] HCFS URIs of jar files to add to the CLASSPATHs of the Spark driver and tasks.
         "A String",
       ],
@@ -421,7 +435,15 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "pysparkJob": { # A Cloud Dataproc job for running PySpark applications on YARN. # Job is a Pyspark job.
+    "yarnApplications": [ # [Output-only] The collection of YARN applications spun up by this job. **Beta** Feature: This report is available for testing purposes only. It may be changed before final release.
+      { # A YARN application created by a job. Application information is a subset of org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+        "progress": 3.14, # [Required] The numerical progress of the application, from 1 to 100.
+        "state": "A String", # [Required] The application state.
+        "name": "A String", # [Required] The application name.
+        "trackingUrl": "A String", # [Optional] The HTTP URL of the ApplicationMaster, HistoryServer, or TimelineServer that provides application-specific information. The URL uses the internal hostname, and requires a proxy server for resolution and, possibly, access.
+      },
+    ],
+    "pysparkJob": { # A Cloud Dataproc job for running [Apache PySpark](https://spark.apache.org/docs/0.9.0/python-programming-guide.html) applications on YARN. # Job is a Pyspark job.
       "mainPythonFileUri": "A String", # [Required] The HCFS URI of the main Python file to use as the driver. Must be a .py file.
       "args": [ # [Optional] The arguments to pass to the driver. Do not include arguments, such as `--conf`, that can be set as job properties, since a collision may occur that causes an incorrect job submission.
         "A String",
@@ -447,7 +469,7 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "hiveJob": { # A Cloud Dataproc job for running Hive queries on YARN. # Job is a Hive job.
+    "hiveJob": { # A Cloud Dataproc job for running [Apache Hive](https://hive.apache.org/) queries on YARN. # Job is a Hive job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains Hive queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Hive command: `SET name="value";`).
         "a_key": "A String",
@@ -469,7 +491,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(projectId, region, pageSize=None, x__xgafv=None, jobStateMatcher=None, pageToken=None, clusterName=None)</code>
+    <code class="details" id="list">list(projectId, region, pageSize=None, x__xgafv=None, pageToken=None, clusterName=None, jobStateMatcher=None, filter=None)</code>
   <pre>Lists regions/{region}/jobs in a project.
 
 Args:
@@ -477,9 +499,10 @@ <h3>Method Details</h3>
   region: string, [Required] The Cloud Dataproc region in which to handle the request. (required)
   pageSize: integer, [Optional] The number of results to return in each response.
   x__xgafv: string, V1 error format.
-  jobStateMatcher: string, [Optional] Specifies enumerated categories of jobs to list.
   pageToken: string, [Optional] The page token, returned by a previous call, to request the next page of results.
   clusterName: string, [Optional] If set, the returned jobs list includes only jobs that were submitted to the named cluster.
+  jobStateMatcher: string, [Optional] Specifies enumerated categories of jobs to list (default = match ALL jobs).
+  filter: string, [Optional] A filter constraining the jobs to list. Filters are case-sensitive and have the following syntax: field:value] ... or [field = value] AND [field [= value]] ... where **field** is `status.state` or `labels.[KEY]`, and `[KEY]` is a label key. **value** can be `*` to match all values. `status.state` can be either `ACTIVE` or `INACTIVE`. Only the logical `AND` operator is supported; space-separated items are treated as having an implicit `AND` operator. Example valid filters are: status.state:ACTIVE labels.env:staging labels.starred:* and status.state = ACTIVE AND labels.env = staging AND labels.starred = *
 
 Returns:
   An object of the form:
@@ -489,11 +512,11 @@ <h3>Method Details</h3>
     "jobs": [ # [Output-only] Jobs list.
       { # A Cloud Dataproc job resource.
         "status": { # Cloud Dataproc job status. # [Output-only] The job status. Additional application-specific status information may be contained in the type_job and yarn_applications fields.
-          "state": "A String", # [Required] A state message specifying the overall job state.
+          "state": "A String", # [Output-only] A state message specifying the overall job state.
           "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-          "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+          "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
         },
-        "hadoopJob": { # A Cloud Dataproc job for running Hadoop MapReduce jobs on YARN. # Job is a Hadoop job.
+        "hadoopJob": { # A Cloud Dataproc job for running [Apache Hadoop MapReduce](https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) jobs on [Apache Hadoop YARN](https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html). # Job is a Hadoop job.
           "jarFileUris": [ # [Optional] Jar file URIs to add to the CLASSPATHs of the Hadoop driver and tasks.
             "A String",
           ],
@@ -519,9 +542,9 @@ <h3>Method Details</h3>
         },
         "statusHistory": [ # [Output-only] The previous job status.
           { # Cloud Dataproc job status.
-            "state": "A String", # [Required] A state message specifying the overall job state.
+            "state": "A String", # [Output-only] A state message specifying the overall job state.
             "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-            "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+            "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
           },
         ],
         "placement": { # Cloud Dataproc job config. # [Required] Job information, including how, when, and where to run the job.
@@ -530,9 +553,9 @@ <h3>Method Details</h3>
         },
         "reference": { # Encapsulates the full scoping used to reference a job. # [Optional] The fully qualified reference to the job, which can be used to obtain the equivalent REST path of the job resource. If this property is not specified when a job is created, the server generates a job_id.
           "projectId": "A String", # [Required] The ID of the Google Cloud Platform project that the job belongs to.
-          "jobId": "A String", # [Required] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
+          "jobId": "A String", # [Optional] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
         },
-        "sparkSqlJob": { # A Cloud Dataproc job for running Spark SQL queries. # Job is a SparkSql job.
+        "sparkSqlJob": { # A Cloud Dataproc job for running [Apache Spark SQL](http://spark.apache.org/sql/) queries. # Job is a SparkSql job.
           "queryFileUri": "A String", # The HCFS URI of the script that contains SQL queries.
           "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Spark SQL command: SET `name="value";`).
             "a_key": "A String",
@@ -554,7 +577,7 @@ <h3>Method Details</h3>
             "a_key": "A String",
           },
         },
-        "pigJob": { # A Cloud Dataproc job for running Pig queries on YARN. # Job is a Pig job.
+        "pigJob": { # A Cloud Dataproc job for running [Apache Pig](https://pig.apache.org/) queries on YARN. # Job is a Pig job.
           "queryFileUri": "A String", # The HCFS URI of the script that contains the Pig queries.
           "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Pig command: `name=[value]`).
             "a_key": "A String",
@@ -578,8 +601,11 @@ <h3>Method Details</h3>
           },
         },
         "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+        "labels": { # [Optional] The labels to associate with this job. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a job.
+          "a_key": "A String",
+        },
         "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
-        "sparkJob": { # A Cloud Dataproc job for running Spark applications on YARN. # Job is a Spark job.
+        "sparkJob": { # A Cloud Dataproc job for running [Apache Spark](http://spark.apache.org/) applications on YARN. # Job is a Spark job.
           "jarFileUris": [ # [Optional] HCFS URIs of jar files to add to the CLASSPATHs of the Spark driver and tasks.
             "A String",
           ],
@@ -603,7 +629,15 @@ <h3>Method Details</h3>
             "a_key": "A String",
           },
         },
-        "pysparkJob": { # A Cloud Dataproc job for running PySpark applications on YARN. # Job is a Pyspark job.
+        "yarnApplications": [ # [Output-only] The collection of YARN applications spun up by this job. **Beta** Feature: This report is available for testing purposes only. It may be changed before final release.
+          { # A YARN application created by a job. Application information is a subset of org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+            "progress": 3.14, # [Required] The numerical progress of the application, from 1 to 100.
+            "state": "A String", # [Required] The application state.
+            "name": "A String", # [Required] The application name.
+            "trackingUrl": "A String", # [Optional] The HTTP URL of the ApplicationMaster, HistoryServer, or TimelineServer that provides application-specific information. The URL uses the internal hostname, and requires a proxy server for resolution and, possibly, access.
+          },
+        ],
+        "pysparkJob": { # A Cloud Dataproc job for running [Apache PySpark](https://spark.apache.org/docs/0.9.0/python-programming-guide.html) applications on YARN. # Job is a Pyspark job.
           "mainPythonFileUri": "A String", # [Required] The HCFS URI of the main Python file to use as the driver. Must be a .py file.
           "args": [ # [Optional] The arguments to pass to the driver. Do not include arguments, such as `--conf`, that can be set as job properties, since a collision may occur that causes an incorrect job submission.
             "A String",
@@ -629,7 +663,7 @@ <h3>Method Details</h3>
             "a_key": "A String",
           },
         },
-        "hiveJob": { # A Cloud Dataproc job for running Hive queries on YARN. # Job is a Hive job.
+        "hiveJob": { # A Cloud Dataproc job for running [Apache Hive](https://hive.apache.org/) queries on YARN. # Job is a Hive job.
           "queryFileUri": "A String", # The HCFS URI of the script that contains Hive queries.
           "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Hive command: `SET name="value";`).
             "a_key": "A String",
@@ -679,11 +713,11 @@ <h3>Method Details</h3>
 { # A request to submit a job.
     "job": { # A Cloud Dataproc job resource. # [Required] The job resource.
       "status": { # Cloud Dataproc job status. # [Output-only] The job status. Additional application-specific status information may be contained in the type_job and yarn_applications fields.
-        "state": "A String", # [Required] A state message specifying the overall job state.
+        "state": "A String", # [Output-only] A state message specifying the overall job state.
         "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-        "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+        "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
       },
-      "hadoopJob": { # A Cloud Dataproc job for running Hadoop MapReduce jobs on YARN. # Job is a Hadoop job.
+      "hadoopJob": { # A Cloud Dataproc job for running [Apache Hadoop MapReduce](https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) jobs on [Apache Hadoop YARN](https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html). # Job is a Hadoop job.
         "jarFileUris": [ # [Optional] Jar file URIs to add to the CLASSPATHs of the Hadoop driver and tasks.
           "A String",
         ],
@@ -709,9 +743,9 @@ <h3>Method Details</h3>
       },
       "statusHistory": [ # [Output-only] The previous job status.
         { # Cloud Dataproc job status.
-          "state": "A String", # [Required] A state message specifying the overall job state.
+          "state": "A String", # [Output-only] A state message specifying the overall job state.
           "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-          "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+          "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
         },
       ],
       "placement": { # Cloud Dataproc job config. # [Required] Job information, including how, when, and where to run the job.
@@ -720,9 +754,9 @@ <h3>Method Details</h3>
       },
       "reference": { # Encapsulates the full scoping used to reference a job. # [Optional] The fully qualified reference to the job, which can be used to obtain the equivalent REST path of the job resource. If this property is not specified when a job is created, the server generates a job_id.
         "projectId": "A String", # [Required] The ID of the Google Cloud Platform project that the job belongs to.
-        "jobId": "A String", # [Required] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
+        "jobId": "A String", # [Optional] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
       },
-      "sparkSqlJob": { # A Cloud Dataproc job for running Spark SQL queries. # Job is a SparkSql job.
+      "sparkSqlJob": { # A Cloud Dataproc job for running [Apache Spark SQL](http://spark.apache.org/sql/) queries. # Job is a SparkSql job.
         "queryFileUri": "A String", # The HCFS URI of the script that contains SQL queries.
         "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Spark SQL command: SET `name="value";`).
           "a_key": "A String",
@@ -744,7 +778,7 @@ <h3>Method Details</h3>
           "a_key": "A String",
         },
       },
-      "pigJob": { # A Cloud Dataproc job for running Pig queries on YARN. # Job is a Pig job.
+      "pigJob": { # A Cloud Dataproc job for running [Apache Pig](https://pig.apache.org/) queries on YARN. # Job is a Pig job.
         "queryFileUri": "A String", # The HCFS URI of the script that contains the Pig queries.
         "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Pig command: `name=[value]`).
           "a_key": "A String",
@@ -768,8 +802,11 @@ <h3>Method Details</h3>
         },
       },
       "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+      "labels": { # [Optional] The labels to associate with this job. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a job.
+        "a_key": "A String",
+      },
       "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
-      "sparkJob": { # A Cloud Dataproc job for running Spark applications on YARN. # Job is a Spark job.
+      "sparkJob": { # A Cloud Dataproc job for running [Apache Spark](http://spark.apache.org/) applications on YARN. # Job is a Spark job.
         "jarFileUris": [ # [Optional] HCFS URIs of jar files to add to the CLASSPATHs of the Spark driver and tasks.
           "A String",
         ],
@@ -793,7 +830,15 @@ <h3>Method Details</h3>
           "a_key": "A String",
         },
       },
-      "pysparkJob": { # A Cloud Dataproc job for running PySpark applications on YARN. # Job is a Pyspark job.
+      "yarnApplications": [ # [Output-only] The collection of YARN applications spun up by this job. **Beta** Feature: This report is available for testing purposes only. It may be changed before final release.
+        { # A YARN application created by a job. Application information is a subset of org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+          "progress": 3.14, # [Required] The numerical progress of the application, from 1 to 100.
+          "state": "A String", # [Required] The application state.
+          "name": "A String", # [Required] The application name.
+          "trackingUrl": "A String", # [Optional] The HTTP URL of the ApplicationMaster, HistoryServer, or TimelineServer that provides application-specific information. The URL uses the internal hostname, and requires a proxy server for resolution and, possibly, access.
+        },
+      ],
+      "pysparkJob": { # A Cloud Dataproc job for running [Apache PySpark](https://spark.apache.org/docs/0.9.0/python-programming-guide.html) applications on YARN. # Job is a Pyspark job.
         "mainPythonFileUri": "A String", # [Required] The HCFS URI of the main Python file to use as the driver. Must be a .py file.
         "args": [ # [Optional] The arguments to pass to the driver. Do not include arguments, such as `--conf`, that can be set as job properties, since a collision may occur that causes an incorrect job submission.
           "A String",
@@ -819,7 +864,7 @@ <h3>Method Details</h3>
           "a_key": "A String",
         },
       },
-      "hiveJob": { # A Cloud Dataproc job for running Hive queries on YARN. # Job is a Hive job.
+      "hiveJob": { # A Cloud Dataproc job for running [Apache Hive](https://hive.apache.org/) queries on YARN. # Job is a Hive job.
         "queryFileUri": "A String", # The HCFS URI of the script that contains Hive queries.
         "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Hive command: `SET name="value";`).
           "a_key": "A String",
@@ -847,11 +892,11 @@ <h3>Method Details</h3>
 
     { # A Cloud Dataproc job resource.
     "status": { # Cloud Dataproc job status. # [Output-only] The job status. Additional application-specific status information may be contained in the type_job and yarn_applications fields.
-      "state": "A String", # [Required] A state message specifying the overall job state.
+      "state": "A String", # [Output-only] A state message specifying the overall job state.
       "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-      "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+      "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
     },
-    "hadoopJob": { # A Cloud Dataproc job for running Hadoop MapReduce jobs on YARN. # Job is a Hadoop job.
+    "hadoopJob": { # A Cloud Dataproc job for running [Apache Hadoop MapReduce](https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) jobs on [Apache Hadoop YARN](https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html). # Job is a Hadoop job.
       "jarFileUris": [ # [Optional] Jar file URIs to add to the CLASSPATHs of the Hadoop driver and tasks.
         "A String",
       ],
@@ -877,9 +922,9 @@ <h3>Method Details</h3>
     },
     "statusHistory": [ # [Output-only] The previous job status.
       { # Cloud Dataproc job status.
-        "state": "A String", # [Required] A state message specifying the overall job state.
+        "state": "A String", # [Output-only] A state message specifying the overall job state.
         "stateStartTime": "A String", # [Output-only] The time when this state was entered.
-        "details": "A String", # [Optional] Job state details, such as an error description if the state is ERROR.
+        "details": "A String", # [Output-only] Optional job state details, such as an error description if the state is ERROR.
       },
     ],
     "placement": { # Cloud Dataproc job config. # [Required] Job information, including how, when, and where to run the job.
@@ -888,9 +933,9 @@ <h3>Method Details</h3>
     },
     "reference": { # Encapsulates the full scoping used to reference a job. # [Optional] The fully qualified reference to the job, which can be used to obtain the equivalent REST path of the job resource. If this property is not specified when a job is created, the server generates a job_id.
       "projectId": "A String", # [Required] The ID of the Google Cloud Platform project that the job belongs to.
-      "jobId": "A String", # [Required] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
+      "jobId": "A String", # [Optional] The job ID, which must be unique within the project. The job ID is generated by the server upon job submission or provided by the user as a means to perform retries without creating duplicate jobs. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-). The maximum length is 512 characters.
     },
-    "sparkSqlJob": { # A Cloud Dataproc job for running Spark SQL queries. # Job is a SparkSql job.
+    "sparkSqlJob": { # A Cloud Dataproc job for running [Apache Spark SQL](http://spark.apache.org/sql/) queries. # Job is a SparkSql job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains SQL queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Spark SQL command: SET `name="value";`).
         "a_key": "A String",
@@ -912,7 +957,7 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "pigJob": { # A Cloud Dataproc job for running Pig queries on YARN. # Job is a Pig job.
+    "pigJob": { # A Cloud Dataproc job for running [Apache Pig](https://pig.apache.org/) queries on YARN. # Job is a Pig job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains the Pig queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Pig command: `name=[value]`).
         "a_key": "A String",
@@ -936,8 +981,11 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a job.
+      "a_key": "A String",
+    },
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
-    "sparkJob": { # A Cloud Dataproc job for running Spark applications on YARN. # Job is a Spark job.
+    "sparkJob": { # A Cloud Dataproc job for running [Apache Spark](http://spark.apache.org/) applications on YARN. # Job is a Spark job.
       "jarFileUris": [ # [Optional] HCFS URIs of jar files to add to the CLASSPATHs of the Spark driver and tasks.
         "A String",
       ],
@@ -961,7 +1009,15 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "pysparkJob": { # A Cloud Dataproc job for running PySpark applications on YARN. # Job is a Pyspark job.
+    "yarnApplications": [ # [Output-only] The collection of YARN applications spun up by this job. **Beta** Feature: This report is available for testing purposes only. It may be changed before final release.
+      { # A YARN application created by a job. Application information is a subset of org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto. **Beta Feature**: This report is available for testing purposes only. It may be changed before final release.
+        "progress": 3.14, # [Required] The numerical progress of the application, from 1 to 100.
+        "state": "A String", # [Required] The application state.
+        "name": "A String", # [Required] The application name.
+        "trackingUrl": "A String", # [Optional] The HTTP URL of the ApplicationMaster, HistoryServer, or TimelineServer that provides application-specific information. The URL uses the internal hostname, and requires a proxy server for resolution and, possibly, access.
+      },
+    ],
+    "pysparkJob": { # A Cloud Dataproc job for running [Apache PySpark](https://spark.apache.org/docs/0.9.0/python-programming-guide.html) applications on YARN. # Job is a Pyspark job.
       "mainPythonFileUri": "A String", # [Required] The HCFS URI of the main Python file to use as the driver. Must be a .py file.
       "args": [ # [Optional] The arguments to pass to the driver. Do not include arguments, such as `--conf`, that can be set as job properties, since a collision may occur that causes an incorrect job submission.
         "A String",
@@ -987,7 +1043,7 @@ <h3>Method Details</h3>
         "a_key": "A String",
       },
     },
-    "hiveJob": { # A Cloud Dataproc job for running Hive queries on YARN. # Job is a Hive job.
+    "hiveJob": { # A Cloud Dataproc job for running [Apache Hive](https://hive.apache.org/) queries on YARN. # Job is a Hive job.
       "queryFileUri": "A String", # The HCFS URI of the script that contains Hive queries.
       "scriptVariables": { # [Optional] Mapping of query variable names to values (equivalent to the Hive command: `SET name="value";`).
         "a_key": "A String",
diff --git a/docs/dyn/dataproc_v1.projects.regions.operations.html b/docs/dyn/dataproc_v1.projects.regions.operations.html
index bc2c4617c8d..80af9578003 100644
--- a/docs/dyn/dataproc_v1.projects.regions.operations.html
+++ b/docs/dyn/dataproc_v1.projects.regions.operations.html
@@ -76,7 +76,7 @@ <h1><a href="dataproc_v1.html">Google Cloud Dataproc API</a> . <a href="dataproc
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#cancel">cancel(name, x__xgafv=None)</a></code></p>
-<p class="firstline">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.</p>
+<p class="firstline">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`.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.</p>
@@ -92,7 +92,7 @@ <h2>Instance Methods</h2>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="cancel">cancel(name, x__xgafv=None)</code>
-  <pre>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.
+  <pre>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`.
 
 Args:
   name: string, The name of the operation resource to be cancelled. (required)
@@ -133,21 +133,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -170,21 +170,21 @@ <h3>Method Details</h3>
     "operations": [ # A list of operations that matches the specified filter in the request.
       { # This resource represents a long-running operation that is the result of a network API call.
         "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
           "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
           "code": 42, # The status code, which should be an enum value of google.rpc.Code.
           "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
             {
-              "a_key": "", # Properties of the object. Contains field @ype with type URL.
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           ],
         },
         "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
         "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
         "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       },
     ],
diff --git a/docs/dyn/dataproc_v1alpha1.operations.html b/docs/dyn/dataproc_v1alpha1.operations.html
index 186ad08d3cc..fd4e2031dce 100644
--- a/docs/dyn/dataproc_v1alpha1.operations.html
+++ b/docs/dyn/dataproc_v1alpha1.operations.html
@@ -139,21 +139,21 @@ <h3>Method Details</h3>
 
     { # An asynchronous operation in a project that runs over a given cluster. Used to track the progress of a user request that is running asynchronously. Examples include creating a cluster, updating a cluster, and deleting a cluster.
     "response": { # The operation response. If the called method returns no data on success, the response is `google.protobuf.Empty`. If the called method is `Get`,`Create` or `Update`, the response is the resource. For all other methods, the response type is a concatenation of the method name and "Response". For example, if the called method is `TakeSnapshot()`, the response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
     "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # Indicates if the operation is done. If true, the operation is complete and the `result` is available. If false, the operation is still in progress.
     "name": "A String", # The name of the operation resource, in the format projects/[project_id]/operations/[operation_id]
     "metadata": { # Service-specific metadata associated with the operation.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -176,21 +176,21 @@ <h3>Method Details</h3>
     "operations": [ # A list of operations that match the specified filter in the request.
       { # An asynchronous operation in a project that runs over a given cluster. Used to track the progress of a user request that is running asynchronously. Examples include creating a cluster, updating a cluster, and deleting a cluster.
         "response": { # The operation response. If the called method returns no data on success, the response is `google.protobuf.Empty`. If the called method is `Get`,`Create` or `Update`, the response is the resource. For all other methods, the response type is a concatenation of the method name and "Response". For example, if the called method is `TakeSnapshot()`, the response type is `TakeSnapshotResponse`.
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
         "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
           "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
           "code": 42, # The status code, which should be an enum value of google.rpc.Code.
           "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
             {
-              "a_key": "", # Properties of the object. Contains field @ype with type URL.
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           ],
         },
         "done": True or False, # Indicates if the operation is done. If true, the operation is complete and the `result` is available. If false, the operation is still in progress.
         "name": "A String", # The name of the operation resource, in the format projects/[project_id]/operations/[operation_id]
         "metadata": { # Service-specific metadata associated with the operation.
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       },
     ],
diff --git a/docs/dyn/dataproc_v1alpha1.projects.regions.clusters.html b/docs/dyn/dataproc_v1alpha1.projects.regions.clusters.html
index 3ac60d2935f..615cf0afefe 100644
--- a/docs/dyn/dataproc_v1alpha1.projects.regions.clusters.html
+++ b/docs/dyn/dataproc_v1alpha1.projects.regions.clusters.html
@@ -84,7 +84,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(projectId, region, clusterName, x__xgafv=None)</a></code></p>
 <p class="firstline">Request to get the resource representation for a cluster in a project.</p>
 <p class="toc_element">
-  <code><a href="#list">list(projectId, region, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(projectId, region, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Request a list of all regions/{region}/clusters in a project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -119,6 +119,17 @@ <h3>Method Details</h3>
     "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
     "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
     "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+    "labels": { # [Optional] The labels to associate with this cluster. Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given cluster.
+      "a_key": "A String",
+    },
+    "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+      "yarnMetrics": { # The YARN metrics.
+        "a_key": "A String",
+      },
+      "hdfsMetrics": { # The HDFS metrics.
+        "a_key": "A String",
+      },
+    },
     "configuration": { # The cluster configuration. # [Required] The cluster configuration. It may differ from a user's initial configuration due to Cloud Dataproc setting of default values and updating clusters.
       "softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # [Optional] The configuration settings for software inside the cluster.
         "imageVersion": "A String", # [Optional] The version of software inside the cluster. It must match the regular expression [0-9]+\.[0-9]+. If unspecified it will default to latest version.
@@ -151,6 +162,7 @@ <h3>Method Details</h3>
         },
       },
       "gceClusterConfiguration": { # Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Optional] The shared Google Compute Engine configuration settings for all instances in a cluster.
+        "internalIpOnly": True or False, # If true, all instances in the cluser will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
         "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `compute.googleapis.com/projects/[project_id]/regions/global/default`.
         "tags": [ # The Google Compute Engine tags to add to all instances.
           "A String",
@@ -231,21 +243,21 @@ <h3>Method Details</h3>
 
     { # An asynchronous operation in a project that runs over a given cluster. Used to track the progress of a user request that is running asynchronously. Examples include creating a cluster, updating a cluster, and deleting a cluster.
     "response": { # The operation response. If the called method returns no data on success, the response is `google.protobuf.Empty`. If the called method is `Get`,`Create` or `Update`, the response is the resource. For all other methods, the response type is a concatenation of the method name and "Response". For example, if the called method is `TakeSnapshot()`, the response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
     "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # Indicates if the operation is done. If true, the operation is complete and the `result` is available. If false, the operation is still in progress.
     "name": "A String", # The name of the operation resource, in the format projects/[project_id]/operations/[operation_id]
     "metadata": { # Service-specific metadata associated with the operation.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -265,21 +277,21 @@ <h3>Method Details</h3>
 
     { # An asynchronous operation in a project that runs over a given cluster. Used to track the progress of a user request that is running asynchronously. Examples include creating a cluster, updating a cluster, and deleting a cluster.
     "response": { # The operation response. If the called method returns no data on success, the response is `google.protobuf.Empty`. If the called method is `Get`,`Create` or `Update`, the response is the resource. For all other methods, the response type is a concatenation of the method name and "Response". For example, if the called method is `TakeSnapshot()`, the response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
     "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # Indicates if the operation is done. If true, the operation is complete and the `result` is available. If false, the operation is still in progress.
     "name": "A String", # The name of the operation resource, in the format projects/[project_id]/operations/[operation_id]
     "metadata": { # Service-specific metadata associated with the operation.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -313,6 +325,17 @@ <h3>Method Details</h3>
       "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
       "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
       "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+      "labels": { # [Optional] The labels to associate with this cluster. Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given cluster.
+        "a_key": "A String",
+      },
+      "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+        "yarnMetrics": { # The YARN metrics.
+          "a_key": "A String",
+        },
+        "hdfsMetrics": { # The HDFS metrics.
+          "a_key": "A String",
+        },
+      },
       "configuration": { # The cluster configuration. # [Required] The cluster configuration. It may differ from a user's initial configuration due to Cloud Dataproc setting of default values and updating clusters.
         "softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # [Optional] The configuration settings for software inside the cluster.
           "imageVersion": "A String", # [Optional] The version of software inside the cluster. It must match the regular expression [0-9]+\.[0-9]+. If unspecified it will default to latest version.
@@ -345,6 +368,7 @@ <h3>Method Details</h3>
           },
         },
         "gceClusterConfiguration": { # Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Optional] The shared Google Compute Engine configuration settings for all instances in a cluster.
+          "internalIpOnly": True or False, # If true, all instances in the cluser will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
           "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `compute.googleapis.com/projects/[project_id]/regions/global/default`.
           "tags": [ # The Google Compute Engine tags to add to all instances.
             "A String",
@@ -420,13 +444,14 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(projectId, region, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(projectId, region, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
   <pre>Request a list of all regions/{region}/clusters in a project.
 
 Args:
   projectId: string, [Required] The ID of the Google Cloud Platform project that the cluster belongs to. (required)
   region: string, [Required] The Dataproc region in which to handle the request. (required)
   pageSize: integer, The standard List page size.
+  filter: string, [Optional] A filter constraining which clusters to list. Valid filters contain label terms such as: labels.key1 = val1 AND (-labels.k2 = val2 OR labels.k3 = val3)
   pageToken: string, The standard List page token.
   x__xgafv: string, V1 error format.
 
@@ -452,6 +477,17 @@ <h3>Method Details</h3>
           "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
           "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
           "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+          "labels": { # [Optional] The labels to associate with this cluster. Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given cluster.
+            "a_key": "A String",
+          },
+          "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+            "yarnMetrics": { # The YARN metrics.
+              "a_key": "A String",
+            },
+            "hdfsMetrics": { # The HDFS metrics.
+              "a_key": "A String",
+            },
+          },
           "configuration": { # The cluster configuration. # [Required] The cluster configuration. It may differ from a user's initial configuration due to Cloud Dataproc setting of default values and updating clusters.
             "softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # [Optional] The configuration settings for software inside the cluster.
               "imageVersion": "A String", # [Optional] The version of software inside the cluster. It must match the regular expression [0-9]+\.[0-9]+. If unspecified it will default to latest version.
@@ -484,6 +520,7 @@ <h3>Method Details</h3>
               },
             },
             "gceClusterConfiguration": { # Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Optional] The shared Google Compute Engine configuration settings for all instances in a cluster.
+              "internalIpOnly": True or False, # If true, all instances in the cluser will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
               "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `compute.googleapis.com/projects/[project_id]/regions/global/default`.
               "tags": [ # The Google Compute Engine tags to add to all instances.
                 "A String",
@@ -601,6 +638,17 @@ <h3>Method Details</h3>
     "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
     "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
     "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+    "labels": { # [Optional] The labels to associate with this cluster. Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given cluster.
+      "a_key": "A String",
+    },
+    "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+      "yarnMetrics": { # The YARN metrics.
+        "a_key": "A String",
+      },
+      "hdfsMetrics": { # The HDFS metrics.
+        "a_key": "A String",
+      },
+    },
     "configuration": { # The cluster configuration. # [Required] The cluster configuration. It may differ from a user's initial configuration due to Cloud Dataproc setting of default values and updating clusters.
       "softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # [Optional] The configuration settings for software inside the cluster.
         "imageVersion": "A String", # [Optional] The version of software inside the cluster. It must match the regular expression [0-9]+\.[0-9]+. If unspecified it will default to latest version.
@@ -633,6 +681,7 @@ <h3>Method Details</h3>
         },
       },
       "gceClusterConfiguration": { # Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Optional] The shared Google Compute Engine configuration settings for all instances in a cluster.
+        "internalIpOnly": True or False, # If true, all instances in the cluser will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
         "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `compute.googleapis.com/projects/[project_id]/regions/global/default`.
         "tags": [ # The Google Compute Engine tags to add to all instances.
           "A String",
@@ -714,21 +763,21 @@ <h3>Method Details</h3>
 
     { # An asynchronous operation in a project that runs over a given cluster. Used to track the progress of a user request that is running asynchronously. Examples include creating a cluster, updating a cluster, and deleting a cluster.
     "response": { # The operation response. If the called method returns no data on success, the response is `google.protobuf.Empty`. If the called method is `Get`,`Create` or `Update`, the response is the resource. For all other methods, the response type is a concatenation of the method name and "Response". For example, if the called method is `TakeSnapshot()`, the response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
     "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # Indicates if the operation is done. If true, the operation is complete and the `result` is available. If false, the operation is still in progress.
     "name": "A String", # The name of the operation resource, in the format projects/[project_id]/operations/[operation_id]
     "metadata": { # Service-specific metadata associated with the operation.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
diff --git a/docs/dyn/dataproc_v1alpha1.projects.regions.jobs.html b/docs/dyn/dataproc_v1alpha1.projects.regions.jobs.html
index 0983099751a..fd8ebb24d3b 100644
--- a/docs/dyn/dataproc_v1alpha1.projects.regions.jobs.html
+++ b/docs/dyn/dataproc_v1alpha1.projects.regions.jobs.html
@@ -204,6 +204,9 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+      "a_key": "A String",
+    },
     "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
     "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as driver_output_uri.
@@ -398,6 +401,9 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+      "a_key": "A String",
+    },
     "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
     "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as driver_output_uri.
@@ -592,6 +598,9 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+      "a_key": "A String",
+    },
     "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
     "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as driver_output_uri.
@@ -784,6 +793,9 @@ <h3>Method Details</h3>
         },
       },
       "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+      "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+        "a_key": "A String",
+      },
       "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
       "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
       "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as driver_output_uri.
@@ -970,6 +982,9 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+      "a_key": "A String",
+    },
     "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
     "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as driver_output_uri.
diff --git a/docs/dyn/dataproc_v1beta1.operations.html b/docs/dyn/dataproc_v1beta1.operations.html
index edf2fa37e60..66a1b7defa8 100644
--- a/docs/dyn/dataproc_v1beta1.operations.html
+++ b/docs/dyn/dataproc_v1beta1.operations.html
@@ -139,21 +139,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -176,21 +176,21 @@ <h3>Method Details</h3>
     "operations": [ # A list of operations that matches the specified filter in the request.
       { # This resource represents a long-running operation that is the result of a network API call.
         "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
           "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
           "code": 42, # The status code, which should be an enum value of google.rpc.Code.
           "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
             {
-              "a_key": "", # Properties of the object. Contains field @ype with type URL.
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           ],
         },
         "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
         "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
         "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       },
     ],
diff --git a/docs/dyn/dataproc_v1beta1.projects.clusters.html b/docs/dyn/dataproc_v1beta1.projects.clusters.html
index b4783003476..7aca002d8d5 100644
--- a/docs/dyn/dataproc_v1beta1.projects.clusters.html
+++ b/docs/dyn/dataproc_v1beta1.projects.clusters.html
@@ -87,7 +87,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(projectId, clusterName, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the resource representation for a cluster in a project.</p>
 <p class="toc_element">
-  <code><a href="#list">list(projectId, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(projectId, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists all clusters in a project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -121,6 +121,17 @@ <h3>Method Details</h3>
   "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
   "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
   "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+  "labels": { # [Optional] The labels to associate with this cluster. Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given cluster.
+    "a_key": "A String",
+  },
+  "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+    "yarnMetrics": { # The YARN metrics.
+      "a_key": "A String",
+    },
+    "hdfsMetrics": { # The HDFS metrics.
+      "a_key": "A String",
+    },
+  },
   "configuration": { # The cluster configuration. # [Required] The cluster configuration. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
     "softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # [Optional] The configuration settings for software inside the cluster.
       "imageVersion": "A String", # [Optional] The version of software inside the cluster. It must match the regular expression `[0-9]+\.[0-9]+`. If unspecified, it defaults to the latest version (see [Cloud Dataproc Versioning](/dataproc/versioning)).
@@ -129,6 +140,7 @@ <h3>Method Details</h3>
       },
     },
     "gceClusterConfiguration": { # Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Required] The shared Google Compute Engine configuration settings for all instances in a cluster.
+      "internalIpOnly": True or False, # If true, all instances in the cluser will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
       "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
       "tags": [ # The Google Compute Engine tags to add to all instances.
         "A String",
@@ -210,21 +222,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -243,21 +255,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -282,21 +294,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
@@ -329,6 +341,17 @@ <h3>Method Details</h3>
     "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
     "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
     "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+    "labels": { # [Optional] The labels to associate with this cluster. Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given cluster.
+      "a_key": "A String",
+    },
+    "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+      "yarnMetrics": { # The YARN metrics.
+        "a_key": "A String",
+      },
+      "hdfsMetrics": { # The HDFS metrics.
+        "a_key": "A String",
+      },
+    },
     "configuration": { # The cluster configuration. # [Required] The cluster configuration. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
       "softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # [Optional] The configuration settings for software inside the cluster.
         "imageVersion": "A String", # [Optional] The version of software inside the cluster. It must match the regular expression `[0-9]+\.[0-9]+`. If unspecified, it defaults to the latest version (see [Cloud Dataproc Versioning](/dataproc/versioning)).
@@ -337,6 +360,7 @@ <h3>Method Details</h3>
         },
       },
       "gceClusterConfiguration": { # Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Required] The shared Google Compute Engine configuration settings for all instances in a cluster.
+        "internalIpOnly": True or False, # If true, all instances in the cluser will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
         "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
         "tags": [ # The Google Compute Engine tags to add to all instances.
           "A String",
@@ -413,12 +437,13 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(projectId, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(projectId, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
   <pre>Lists all clusters in a project.
 
 Args:
   projectId: string, [Required] The ID of the Google Cloud Platform project that the cluster belongs to. (required)
   pageSize: integer, The standard List page size.
+  filter: string, [Optional] A filter constraining which clusters to list. Valid filters contain label terms such as: labels.key1 = val1 AND (-labels.k2 = val2 OR labels.k3 = val3)
   pageToken: string, The standard List page token.
   x__xgafv: string, V1 error format.
 
@@ -444,6 +469,17 @@ <h3>Method Details</h3>
         "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
         "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
         "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+        "labels": { # [Optional] The labels to associate with this cluster. Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given cluster.
+          "a_key": "A String",
+        },
+        "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+          "yarnMetrics": { # The YARN metrics.
+            "a_key": "A String",
+          },
+          "hdfsMetrics": { # The HDFS metrics.
+            "a_key": "A String",
+          },
+        },
         "configuration": { # The cluster configuration. # [Required] The cluster configuration. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
           "softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # [Optional] The configuration settings for software inside the cluster.
             "imageVersion": "A String", # [Optional] The version of software inside the cluster. It must match the regular expression `[0-9]+\.[0-9]+`. If unspecified, it defaults to the latest version (see [Cloud Dataproc Versioning](/dataproc/versioning)).
@@ -452,6 +488,7 @@ <h3>Method Details</h3>
             },
           },
           "gceClusterConfiguration": { # Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Required] The shared Google Compute Engine configuration settings for all instances in a cluster.
+            "internalIpOnly": True or False, # If true, all instances in the cluser will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
             "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
             "tags": [ # The Google Compute Engine tags to add to all instances.
               "A String",
@@ -569,6 +606,17 @@ <h3>Method Details</h3>
   "clusterUuid": "A String", # [Output-only] A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
   "clusterName": "A String", # [Required] The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
   "projectId": "A String", # [Required] The Google Cloud Platform project ID that the cluster belongs to.
+  "labels": { # [Optional] The labels to associate with this cluster. Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given cluster.
+    "a_key": "A String",
+  },
+  "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+    "yarnMetrics": { # The YARN metrics.
+      "a_key": "A String",
+    },
+    "hdfsMetrics": { # The HDFS metrics.
+      "a_key": "A String",
+    },
+  },
   "configuration": { # The cluster configuration. # [Required] The cluster configuration. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
     "softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # [Optional] The configuration settings for software inside the cluster.
       "imageVersion": "A String", # [Optional] The version of software inside the cluster. It must match the regular expression `[0-9]+\.[0-9]+`. If unspecified, it defaults to the latest version (see [Cloud Dataproc Versioning](/dataproc/versioning)).
@@ -577,6 +625,7 @@ <h3>Method Details</h3>
       },
     },
     "gceClusterConfiguration": { # Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster. # [Required] The shared Google Compute Engine configuration settings for all instances in a cluster.
+      "internalIpOnly": True or False, # If true, all instances in the cluser will only have internal IP addresses. By default, clusters are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each instance. This restriction can only be enabled for subnetwork enabled networks, and all off-cluster dependencies must be configured to be accessible without external IP addresses.
       "networkUri": "A String", # The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the "default" network of the project is used, if it exists. Cannot be a "Custom Subnet Network" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.
       "tags": [ # The Google Compute Engine tags to add to all instances.
         "A String",
@@ -659,21 +708,21 @@ <h3>Method Details</h3>
 
     { # This resource represents a long-running operation that is the result of a network API call.
     "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons. # The error result of the operation in case of failure or cancellation.
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There will be a common set of message types for APIs to use.
         {
-          "a_key": "", # Properties of the object. Contains field @ype with type URL.
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
       ],
     },
     "done": True or False, # If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.
     "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.
     "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @ype with type URL.
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
     },
   }</pre>
 </div>
diff --git a/docs/dyn/dataproc_v1beta1.projects.jobs.html b/docs/dyn/dataproc_v1beta1.projects.jobs.html
index 6dfcc9c4d37..5c4494da5fc 100644
--- a/docs/dyn/dataproc_v1beta1.projects.jobs.html
+++ b/docs/dyn/dataproc_v1beta1.projects.jobs.html
@@ -84,7 +84,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(projectId, jobId, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the resource representation for a job in a project.</p>
 <p class="toc_element">
-  <code><a href="#list">list(projectId, jobStateMatcher=None, pageSize=None, clusterName=None, x__xgafv=None, pageToken=None)</a></code></p>
+  <code><a href="#list">list(projectId, pageSize=None, x__xgafv=None, jobStateMatcher=None, pageToken=None, clusterName=None, filter=None)</a></code></p>
 <p class="firstline">Lists jobs in a project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -202,6 +202,9 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+      "a_key": "A String",
+    },
     "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
     "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
@@ -404,6 +407,9 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+      "a_key": "A String",
+    },
     "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
     "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
@@ -488,16 +494,17 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(projectId, jobStateMatcher=None, pageSize=None, clusterName=None, x__xgafv=None, pageToken=None)</code>
+    <code class="details" id="list">list(projectId, pageSize=None, x__xgafv=None, jobStateMatcher=None, pageToken=None, clusterName=None, filter=None)</code>
   <pre>Lists jobs in a project.
 
 Args:
   projectId: string, [Required] The ID of the Google Cloud Platform project that the job belongs to. (required)
-  jobStateMatcher: string, [Optional] Specifies enumerated categories of jobs to list.
   pageSize: integer, [Optional] The number of results to return in each response.
-  clusterName: string, [Optional] If set, the returned jobs list includes only jobs that were submitted to the named cluster.
   x__xgafv: string, V1 error format.
+  jobStateMatcher: string, [Optional] Specifies enumerated categories of jobs to list.
   pageToken: string, [Optional] The page token, returned by a previous call, to request the next page of results.
+  clusterName: string, [Optional] If set, the returned jobs list includes only jobs that were submitted to the named cluster.
+  filter: string, [Optional] A filter constraining which jobs to list. Valid filters contain job state and label terms such as: labels.key1 = val1 AND (labels.k2 = val2 OR labels.k3 = val3)
 
 Returns:
   An object of the form:
@@ -596,6 +603,9 @@ <h3>Method Details</h3>
           },
         },
         "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+        "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+          "a_key": "A String",
+        },
         "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
         "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
         "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
@@ -796,6 +806,9 @@ <h3>Method Details</h3>
         },
       },
       "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+      "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+        "a_key": "A String",
+      },
       "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
       "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
       "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
@@ -975,6 +988,9 @@ <h3>Method Details</h3>
       },
     },
     "driverOutputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdout of the job's driver program.
+    "labels": { # [Optional] The labels to associate with this job. Label keys must be between 1 and 63 characters long, and must conform to the following regular expression: \p{Ll}\p{Lo}{0,62} Label values must be between 1 and 63 characters long, and must conform to the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} No more than 64 labels can be associated with a given job.
+      "a_key": "A String",
+    },
     "submittedBy": "A String", # [Output-only] The email address of the user submitting the job. For jobs submitted on the cluster, the address is username@hostname.
     "driverInputResourceUri": "A String", # [Output-only] A URI pointing to the location of the stdin of the job's driver program, only set if the job is interactive.
     "driverControlFilesUri": "A String", # [Output-only] If present, the location of miscellaneous control files which may be used as part of job setup and handling. If not present, control files may be placed in the same location as `driver_output_uri`.
diff --git a/docs/dyn/datastore_v1.projects.html b/docs/dyn/datastore_v1.projects.html
index e31cc90fb15..54340385498 100644
--- a/docs/dyn/datastore_v1.projects.html
+++ b/docs/dyn/datastore_v1.projects.html
@@ -2549,6 +2549,7 @@ <h3>Method Details</h3>
           # In a single transaction, subsequent query result batches for the same query
           # can have a greater snapshot version number. Each batch's snapshot version
           # is valid for all preceding batches.
+          # The value will be zero for eventually consistent queries.
       "skippedResults": 42, # The number of results skipped, typically because of an offset.
       "entityResults": [ # The results for this batch.
         { # The result of fetching an entity from Datastore.
diff --git a/docs/dyn/datastore_v1beta3.projects.html b/docs/dyn/datastore_v1beta3.projects.html
index 87bf75b0551..9cb4d9c8d08 100644
--- a/docs/dyn/datastore_v1beta3.projects.html
+++ b/docs/dyn/datastore_v1beta3.projects.html
@@ -2549,6 +2549,7 @@ <h3>Method Details</h3>
           # In a single transaction, subsequent query result batches for the same query
           # can have a greater snapshot version number. Each batch's snapshot version
           # is valid for all preceding batches.
+          # The value will be zero for eventually consistent queries.
       "skippedResults": 42, # The number of results skipped, typically because of an offset.
       "entityResults": [ # The results for this batch.
         { # The result of fetching an entity from Datastore.
diff --git a/docs/dyn/deploymentmanager_v2.deployments.html b/docs/dyn/deploymentmanager_v2.deployments.html
index ce846ee8466..265cdc64613 100644
--- a/docs/dyn/deploymentmanager_v2.deployments.html
+++ b/docs/dyn/deploymentmanager_v2.deployments.html
@@ -78,7 +78,7 @@ <h2>Instance Methods</h2>
   <code><a href="#cancelPreview">cancelPreview(project, deployment, body)</a></code></p>
 <p class="firstline">Cancels and removes the preview currently associated with the deployment.</p>
 <p class="toc_element">
-  <code><a href="#delete">delete(project, deployment)</a></code></p>
+  <code><a href="#delete">delete(project, deployment, deletePolicy=None)</a></code></p>
 <p class="firstline">Deletes a deployment and all of the resources in the deployment.</p>
 <p class="toc_element">
   <code><a href="#get">get(project, deployment)</a></code></p>
@@ -90,7 +90,7 @@ <h2>Instance Methods</h2>
   <code><a href="#insert">insert(project, body, preview=None)</a></code></p>
 <p class="firstline">Creates a deployment and all of the resources described by the deployment manifest.</p>
 <p class="toc_element">
-  <code><a href="#list">list(project, maxResults=None, pageToken=None, filter=None)</a></code></p>
+  <code><a href="#list">list(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists all deployments for a given project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -174,17 +174,21 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="delete">delete(project, deployment)</code>
+    <code class="details" id="delete">delete(project, deployment, deletePolicy=None)</code>
   <pre>Deletes a deployment and all of the resources in the deployment.
 
 Args:
   project: string, The project ID for this request. (required)
   deployment: string, The name of the deployment for this request. (required)
+  deletePolicy: string, Sets the policy to use for deleting resources.
+    Allowed values
+      ABANDON - 
+      DELETE - 
 
 Returns:
   An object of the form:
@@ -232,7 +236,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -312,7 +316,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
       "target": { # [Input Only] The parameters that define your deployment, including the deployment configuration and relevant templates.
         "imports": [ # Specifies any files to import for this configuration. This can be used to import templates or other files. For example, you might import a text file in order to use the file in a template.
@@ -356,11 +360,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -413,6 +425,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -500,7 +514,7 @@ <h3>Method Details</h3>
       },
       "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-      "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+      "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
     },
     "target": { # [Input Only] The parameters that define your deployment, including the deployment configuration and relevant templates.
       "imports": [ # Specifies any files to import for this configuration. This can be used to import templates or other files. For example, you might import a text file in order to use the file in a template.
@@ -566,16 +580,21 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(project, maxResults=None, pageToken=None, filter=None)</code>
+    <code class="details" id="list">list(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists all deployments for a given project.
 
 Args:
   project: string, The project ID for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
   maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
   pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
   filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
@@ -659,7 +678,7 @@ <h3>Method Details</h3>
             },
             "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
             "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-            "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+            "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
           },
           "target": { # [Input Only] The parameters that define your deployment, including the deployment configuration and relevant templates.
             "imports": [ # Specifies any files to import for this configuration. This can be used to import templates or other files. For example, you might import a text file in order to use the file in a template.
@@ -769,7 +788,7 @@ <h3>Method Details</h3>
       },
       "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-      "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+      "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
     },
     "target": { # [Input Only] The parameters that define your deployment, including the deployment configuration and relevant templates.
       "imports": [ # Specifies any files to import for this configuration. This can be used to import templates or other files. For example, you might import a text file in order to use the file in a template.
@@ -843,7 +862,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -871,11 +890,19 @@ <h3>Method Details</h3>
   "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
       # 
       # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-    { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+    { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
       "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
         "A String",
       ],
-      "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+      "auditLogConfigs": [ # The configuration for each type of logging
+        { # Provides the configuration for a sub-type of logging.
+          "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
     },
   ],
   "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -928,6 +955,8 @@ <h3>Method Details</h3>
           #
           # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
           #
+          #
+          #
           # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
           #
           # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -958,11 +987,19 @@ <h3>Method Details</h3>
     "auditConfigs": [ # Specifies audit logging configs for "data access". "data access": generally refers to data reads/writes and admin reads. "admin activity": generally refers to admin writes.
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit logging for the `service` specified above. Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
+        "auditLogConfigs": [ # The configuration for each type of logging
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.
       },
     ],
     "rules": [ # If more than one rule is specified, the rules are applied in the following manner: - All matching LOG rules are always applied. - If any DENY/DENY_WITH_LOG rule matches, permission is denied. Logging will be applied if one or more matching rule requires logging. - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is granted. Logging will be applied if one or more matching rule requires logging. - Otherwise, if no rule applies, permission is denied.
@@ -1015,6 +1052,8 @@ <h3>Method Details</h3>
             #
             # * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`.
             #
+            #
+            #
             # * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`.
             #
             # * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`.
@@ -1091,7 +1130,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
@@ -1197,7 +1236,7 @@ <h3>Method Details</h3>
       },
       "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-      "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+      "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
     },
     "target": { # [Input Only] The parameters that define your deployment, including the deployment configuration and relevant templates.
       "imports": [ # Specifies any files to import for this configuration. This can be used to import templates or other files. For example, you might import a text file in order to use the file in a template.
@@ -1271,7 +1310,7 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
diff --git a/docs/dyn/deploymentmanager_v2.manifests.html b/docs/dyn/deploymentmanager_v2.manifests.html
index 7a45d5a0591..fc827811d55 100644
--- a/docs/dyn/deploymentmanager_v2.manifests.html
+++ b/docs/dyn/deploymentmanager_v2.manifests.html
@@ -78,7 +78,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(project, deployment, manifest)</a></code></p>
 <p class="firstline">Gets information about a specific manifest.</p>
 <p class="toc_element">
-  <code><a href="#list">list(project, deployment, maxResults=None, pageToken=None, filter=None)</a></code></p>
+  <code><a href="#list">list(project, deployment, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists all manifests for a given deployment.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -116,12 +116,17 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(project, deployment, maxResults=None, pageToken=None, filter=None)</code>
+    <code class="details" id="list">list(project, deployment, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists all manifests for a given deployment.
 
 Args:
   project: string, The project ID for this request. (required)
   deployment: string, The name of the deployment for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
   maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
   pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
   filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
diff --git a/docs/dyn/deploymentmanager_v2.operations.html b/docs/dyn/deploymentmanager_v2.operations.html
index 06bf839dd3a..45db8e0d5d0 100644
--- a/docs/dyn/deploymentmanager_v2.operations.html
+++ b/docs/dyn/deploymentmanager_v2.operations.html
@@ -78,7 +78,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(project, operation)</a></code></p>
 <p class="firstline">Gets information about a specific operation.</p>
 <p class="toc_element">
-  <code><a href="#list">list(project, maxResults=None, pageToken=None, filter=None)</a></code></p>
+  <code><a href="#list">list(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists all operations for a project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -138,16 +138,21 @@ <h3>Method Details</h3>
     },
     "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
     "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+    "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(project, maxResults=None, pageToken=None, filter=None)</code>
+    <code class="details" id="list">list(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists all operations for a project.
 
 Args:
   project: string, The project ID for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
   maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
   pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
   filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
@@ -209,7 +214,7 @@ <h3>Method Details</h3>
         },
         "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
         "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+        "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
       },
     ],
   }</pre>
diff --git a/docs/dyn/deploymentmanager_v2.resources.html b/docs/dyn/deploymentmanager_v2.resources.html
index ad8b9113533..6eb200fcef2 100644
--- a/docs/dyn/deploymentmanager_v2.resources.html
+++ b/docs/dyn/deploymentmanager_v2.resources.html
@@ -78,7 +78,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(project, deployment, resource)</a></code></p>
 <p class="firstline">Gets information about a single resource.</p>
 <p class="toc_element">
-  <code><a href="#list">list(project, deployment, maxResults=None, pageToken=None, filter=None)</a></code></p>
+  <code><a href="#list">list(project, deployment, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists all resources in a given deployment.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -158,12 +158,17 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(project, deployment, maxResults=None, pageToken=None, filter=None)</code>
+    <code class="details" id="list">list(project, deployment, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists all resources in a given deployment.
 
 Args:
   project: string, The project ID for this request. (required)
   deployment: string, The name of the deployment for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
   maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
   pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
   filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
diff --git a/docs/dyn/deploymentmanager_v2.types.html b/docs/dyn/deploymentmanager_v2.types.html
index 5673b7b0e4d..f58ad6cc982 100644
--- a/docs/dyn/deploymentmanager_v2.types.html
+++ b/docs/dyn/deploymentmanager_v2.types.html
@@ -75,18 +75,23 @@
 <h1><a href="deploymentmanager_v2.html">Google Cloud Deployment Manager API</a> . <a href="deploymentmanager_v2.types.html">types</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#list">list(project, maxResults=None, pageToken=None, filter=None)</a></code></p>
+  <code><a href="#list">list(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</a></code></p>
 <p class="firstline">Lists all resource types for Deployment Manager.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="list">list(project, maxResults=None, pageToken=None, filter=None)</code>
+    <code class="details" id="list">list(project, orderBy=None, maxResults=None, pageToken=None, filter=None)</code>
   <pre>Lists all resource types for Deployment Manager.
 
 Args:
   project: string, The project ID for this request. (required)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation timestamp using orderBy="creationTimestamp desc". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by name or creationTimestamp desc is supported.
   maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.
   pageToken: string, Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.
   filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.
@@ -150,7 +155,7 @@ <h3>Method Details</h3>
           },
           "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
           "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-          "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. If creating a persistent disk snapshot, this points to the persistent disk that the snapshot was created from.
+          "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.
         },
         "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
         "insertTime": "A String", # [Output Only] Timestamp when the type was created, in RFC3339 text format.
diff --git a/docs/dyn/dfareporting_v2_5.accountUserProfiles.html b/docs/dyn/dfareporting_v2_5.accountUserProfiles.html
index 4826ccc501c..73e285ed9fa 100644
--- a/docs/dyn/dfareporting_v2_5.accountUserProfiles.html
+++ b/docs/dyn/dfareporting_v2_5.accountUserProfiles.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new account user profile.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, subaccountId=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, userRoleId=None, active=None)</a></code></p>
-<p class="firstline">Retrieves a list of account user profiles, possibly filtered.</p>
+<p class="firstline">Retrieves a list of account user profiles, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -301,7 +301,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, subaccountId=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, userRoleId=None, active=None)</code>
-  <pre>Retrieves a list of account user profiles, possibly filtered.
+  <pre>Retrieves a list of account user profiles, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.accounts.html b/docs/dyn/dfareporting_v2_5.accounts.html
index e0f0d927f8e..6ff646eacf6 100644
--- a/docs/dyn/dfareporting_v2_5.accounts.html
+++ b/docs/dyn/dfareporting_v2_5.accounts.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one account by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, active=None)</a></code></p>
-<p class="firstline">Retrieves the list of accounts, possibly filtered.</p>
+<p class="firstline">Retrieves the list of accounts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -217,7 +217,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, active=None)</code>
-  <pre>Retrieves the list of accounts, possibly filtered.
+  <pre>Retrieves the list of accounts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.ads.html b/docs/dyn/dfareporting_v2_5.ads.html
index f9600f60d54..11dccee3af9 100644
--- a/docs/dyn/dfareporting_v2_5.ads.html
+++ b/docs/dyn/dfareporting_v2_5.ads.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new ad.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, landingPageIds=None, overriddenEventTagId=None, campaignIds=None, sizeIds=None, archived=None, creativeOptimizationConfigurationIds=None, sslCompliant=None, pageToken=None, sortOrder=None, type=None, sslRequired=None, creativeIds=None, remarketingListIds=None, maxResults=None, creativeType=None, placementIds=None, active=None, compatibility=None, advertiserId=None, searchString=None, audienceSegmentIds=None, ids=None, sortField=None, dynamicClickTracker=None)</a></code></p>
-<p class="firstline">Retrieves a list of ads, possibly filtered.</p>
+<p class="firstline">Retrieves a list of ads, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -197,7 +197,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
           { # Contains information about a platform type that can be targeted by ads.
@@ -381,7 +381,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -530,7 +530,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
         { # Contains information about a platform type that can be targeted by ads.
@@ -714,7 +714,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -857,7 +857,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
           { # Contains information about a platform type that can be targeted by ads.
@@ -1041,7 +1041,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -1090,7 +1090,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, landingPageIds=None, overriddenEventTagId=None, campaignIds=None, sizeIds=None, archived=None, creativeOptimizationConfigurationIds=None, sslCompliant=None, pageToken=None, sortOrder=None, type=None, sslRequired=None, creativeIds=None, remarketingListIds=None, maxResults=None, creativeType=None, placementIds=None, active=None, compatibility=None, advertiserId=None, searchString=None, audienceSegmentIds=None, ids=None, sortField=None, dynamicClickTracker=None)</code>
-  <pre>Retrieves a list of ads, possibly filtered.
+  <pre>Retrieves a list of ads, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
@@ -1261,7 +1261,7 @@ <h3>Method Details</h3>
           ],
           "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
           "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-          "archived": True or False, # Whether this ad is archived.
+          "archived": True or False, # Whether this ad is archived. When true, active must be false.
           "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
             "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
               { # Contains information about a platform type that can be targeted by ads.
@@ -1445,7 +1445,7 @@ <h3>Method Details</h3>
             "time": "A String", # Timestamp of the last change in milliseconds since epoch.
           },
           "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-          "active": True or False, # Whether this ad is active.
+          "active": True or False, # Whether this ad is active. When true, archived must be false.
           "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
           "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
           "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -1611,7 +1611,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
         { # Contains information about a platform type that can be targeted by ads.
@@ -1795,7 +1795,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -1938,7 +1938,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
           { # Contains information about a platform type that can be targeted by ads.
@@ -2122,7 +2122,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -2271,7 +2271,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
         { # Contains information about a platform type that can be targeted by ads.
@@ -2455,7 +2455,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -2598,7 +2598,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
           { # Contains information about a platform type that can be targeted by ads.
@@ -2782,7 +2782,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
diff --git a/docs/dyn/dfareporting_v2_5.advertiserGroups.html b/docs/dyn/dfareporting_v2_5.advertiserGroups.html
index 9fc9363933a..b9b11cddef3 100644
--- a/docs/dyn/dfareporting_v2_5.advertiserGroups.html
+++ b/docs/dyn/dfareporting_v2_5.advertiserGroups.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new advertiser group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of advertiser groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of advertiser groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of advertiser groups, possibly filtered.
+  <pre>Retrieves a list of advertiser groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.advertisers.html b/docs/dyn/dfareporting_v2_5.advertisers.html
index 6c569f6bf4b..e7c5af60e81 100644
--- a/docs/dyn/dfareporting_v2_5.advertisers.html
+++ b/docs/dyn/dfareporting_v2_5.advertisers.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new advertiser.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, includeAdvertisersWithoutGroupsOnly=None, onlyParent=None, pageToken=None, sortOrder=None, status=None, maxResults=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, floodlightConfigurationIds=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of advertisers, possibly filtered.</p>
+<p class="firstline">Retrieves a list of advertisers, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -223,7 +223,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, includeAdvertisersWithoutGroupsOnly=None, onlyParent=None, pageToken=None, sortOrder=None, status=None, maxResults=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, floodlightConfigurationIds=None, sortField=None)</code>
-  <pre>Retrieves a list of advertisers, possibly filtered.
+  <pre>Retrieves a list of advertisers, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.campaignCreativeAssociations.html b/docs/dyn/dfareporting_v2_5.campaignCreativeAssociations.html
index f2b20e20372..6489e262e6e 100644
--- a/docs/dyn/dfareporting_v2_5.campaignCreativeAssociations.html
+++ b/docs/dyn/dfareporting_v2_5.campaignCreativeAssociations.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Associates a creative with the specified campaign. This method creates a default ad with dimensions matching the creative in the campaign if such a default ad does not exist already.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves the list of creative IDs associated with the specified campaign.</p>
+<p class="firstline">Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -111,7 +111,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None)</code>
-  <pre>Retrieves the list of creative IDs associated with the specified campaign.
+  <pre>Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.campaigns.html b/docs/dyn/dfareporting_v2_5.campaigns.html
index 84fa83d3983..f9af52ebe36 100644
--- a/docs/dyn/dfareporting_v2_5.campaigns.html
+++ b/docs/dyn/dfareporting_v2_5.campaigns.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new campaign.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, overriddenEventTagId=None, archived=None, advertiserIds=None, pageToken=None, sortOrder=None, maxResults=None, excludedIds=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, sortField=None, atLeastOneOptimizationActivity=None)</a></code></p>
-<p class="firstline">Retrieves a list of campaigns, possibly filtered.</p>
+<p class="firstline">Retrieves a list of campaigns, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -474,7 +474,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, overriddenEventTagId=None, archived=None, advertiserIds=None, pageToken=None, sortOrder=None, maxResults=None, excludedIds=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, sortField=None, atLeastOneOptimizationActivity=None)</code>
-  <pre>Retrieves a list of campaigns, possibly filtered.
+  <pre>Retrieves a list of campaigns, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.changeLogs.html b/docs/dyn/dfareporting_v2_5.changeLogs.html
index 9b231afb4c6..109e0436cae 100644
--- a/docs/dyn/dfareporting_v2_5.changeLogs.html
+++ b/docs/dyn/dfareporting_v2_5.changeLogs.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one change log by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of change logs.</p>
+<p class="firstline">Retrieves a list of change logs. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -115,7 +115,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</code>
-  <pre>Retrieves a list of change logs.
+  <pre>Retrieves a list of change logs. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
@@ -153,6 +153,7 @@ <h3>Method Details</h3>
       OBJECT_REMARKETING_LIST - 
       OBJECT_RICHMEDIA_CREATIVE - 
       OBJECT_SD_SITE - 
+      OBJECT_SEARCH_LIFT_STUDY - 
       OBJECT_SIZE - 
       OBJECT_SUBACCOUNT - 
       OBJECT_TARGETING_TEMPLATE - 
diff --git a/docs/dyn/dfareporting_v2_5.contentCategories.html b/docs/dyn/dfareporting_v2_5.contentCategories.html
index 8ac7be18043..6c6b0022cd1 100644
--- a/docs/dyn/dfareporting_v2_5.contentCategories.html
+++ b/docs/dyn/dfareporting_v2_5.contentCategories.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new content category.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of content categories, possibly filtered.</p>
+<p class="firstline">Retrieves a list of content categories, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of content categories, possibly filtered.
+  <pre>Retrieves a list of content categories, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.conversions.html b/docs/dyn/dfareporting_v2_5.conversions.html
index 0fbc3e52ac9..a5164b32a83 100644
--- a/docs/dyn/dfareporting_v2_5.conversions.html
+++ b/docs/dyn/dfareporting_v2_5.conversions.html
@@ -104,7 +104,7 @@ <h3>Method Details</h3>
         ],
         "floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
         "value": 3.14, # The value of the conversion.
-        "limitAdTracking": True or False, # Whether the user has Limit Ad Tracking set.
+        "limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
         "quantity": "A String", # The quantity of the conversion.
         "floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
         "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId and encryptedUserIdCandidates[]. This or encryptedUserId or encryptedUserIdCandidates[] is a required field.
@@ -141,7 +141,7 @@ <h3>Method Details</h3>
           ],
           "floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
           "value": 3.14, # The value of the conversion.
-          "limitAdTracking": True or False, # Whether the user has Limit Ad Tracking set.
+          "limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
           "quantity": "A String", # The quantity of the conversion.
           "floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
           "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId and encryptedUserIdCandidates[]. This or encryptedUserId or encryptedUserIdCandidates[] is a required field.
diff --git a/docs/dyn/dfareporting_v2_5.creativeAssets.html b/docs/dyn/dfareporting_v2_5.creativeAssets.html
index fbc2e7f688a..46d375fca20 100644
--- a/docs/dyn/dfareporting_v2_5.creativeAssets.html
+++ b/docs/dyn/dfareporting_v2_5.creativeAssets.html
@@ -75,11 +75,11 @@
 <h1><a href="dfareporting_v2_5.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_5.creativeAssets.html">creativeAssets</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#insert">insert(profileId, advertiserId, body=None, media_body=None)</a></code></p>
+  <code><a href="#insert">insert(profileId, advertiserId, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Inserts a new creative asset.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="insert">insert(profileId, advertiserId, body=None, media_body=None)</code>
+    <code class="details" id="insert">insert(profileId, advertiserId, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Inserts a new creative asset.
 
 Args:
@@ -136,6 +136,7 @@ <h3>Method Details</h3>
   }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/dfareporting_v2_5.creativeFieldValues.html b/docs/dyn/dfareporting_v2_5.creativeFieldValues.html
index aca8895e04f..e4f28ac8193 100644
--- a/docs/dyn/dfareporting_v2_5.creativeFieldValues.html
+++ b/docs/dyn/dfareporting_v2_5.creativeFieldValues.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative field value.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, creativeFieldId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative field values, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative field values, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, creativeFieldId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative field values, possibly filtered.
+  <pre>Retrieves a list of creative field values, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.creativeFields.html b/docs/dyn/dfareporting_v2_5.creativeFields.html
index f52d3d7fbed..1fbd88c146d 100644
--- a/docs/dyn/dfareporting_v2_5.creativeFields.html
+++ b/docs/dyn/dfareporting_v2_5.creativeFields.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative field.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative fields, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative fields, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -185,7 +185,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative fields, possibly filtered.
+  <pre>Retrieves a list of creative fields, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.creativeGroups.html b/docs/dyn/dfareporting_v2_5.creativeGroups.html
index 36fa2d28f32..d8586cf0f37 100644
--- a/docs/dyn/dfareporting_v2_5.creativeGroups.html
+++ b/docs/dyn/dfareporting_v2_5.creativeGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, groupNumber=None, maxResults=None, ids=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -184,7 +184,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, groupNumber=None, maxResults=None, ids=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative groups, possibly filtered.
+  <pre>Retrieves a list of creative groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.creatives.html b/docs/dyn/dfareporting_v2_5.creatives.html
index 86a9d508fdf..8cf9d93fd9e 100644
--- a/docs/dyn/dfareporting_v2_5.creatives.html
+++ b/docs/dyn/dfareporting_v2_5.creatives.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of creatives, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creatives, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -1120,7 +1120,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</code>
-  <pre>Retrieves a list of creatives, possibly filtered.
+  <pre>Retrieves a list of creatives, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.directorySiteContacts.html b/docs/dyn/dfareporting_v2_5.directorySiteContacts.html
index bea47277620..9c3b906f74a 100644
--- a/docs/dyn/dfareporting_v2_5.directorySiteContacts.html
+++ b/docs/dyn/dfareporting_v2_5.directorySiteContacts.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one directory site contact by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, directorySiteIds=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of directory site contacts, possibly filtered.</p>
+<p class="firstline">Retrieves a list of directory site contacts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -111,7 +111,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, directorySiteIds=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of directory site contacts, possibly filtered.
+  <pre>Retrieves a list of directory site contacts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.directorySites.html b/docs/dyn/dfareporting_v2_5.directorySites.html
index 22605a053f8..8af3f75a429 100644
--- a/docs/dyn/dfareporting_v2_5.directorySites.html
+++ b/docs/dyn/dfareporting_v2_5.directorySites.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new directory site.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, countryId=None, acceptsInStreamVideoPlacements=None, pageToken=None, sortOrder=None, parentId=None, acceptsPublisherPaidPlacements=None, acceptsInterstitialPlacements=None, maxResults=None, active=None, searchString=None, sortField=None, ids=None, dfp_network_code=None)</a></code></p>
-<p class="firstline">Retrieves a list of directory sites, possibly filtered.</p>
+<p class="firstline">Retrieves a list of directory sites, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -433,7 +433,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, countryId=None, acceptsInStreamVideoPlacements=None, pageToken=None, sortOrder=None, parentId=None, acceptsPublisherPaidPlacements=None, acceptsInterstitialPlacements=None, maxResults=None, active=None, searchString=None, sortField=None, ids=None, dfp_network_code=None)</code>
-  <pre>Retrieves a list of directory sites, possibly filtered.
+  <pre>Retrieves a list of directory sites, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.floodlightActivities.html b/docs/dyn/dfareporting_v2_5.floodlightActivities.html
index c300f81ea58..9ec116afbb4 100644
--- a/docs/dyn/dfareporting_v2_5.floodlightActivities.html
+++ b/docs/dyn/dfareporting_v2_5.floodlightActivities.html
@@ -88,7 +88,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new floodlight activity.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, floodlightActivityGroupName=None, advertiserId=None, tagString=None, floodlightActivityGroupTagString=None, floodlightActivityGroupIds=None, pageToken=None, sortOrder=None, maxResults=None, searchString=None, sortField=None, floodlightConfigurationId=None, ids=None, floodlightActivityGroupType=None)</a></code></p>
-<p class="firstline">Retrieves a list of floodlight activities, possibly filtered.</p>
+<p class="firstline">Retrieves a list of floodlight activities, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -457,7 +457,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, floodlightActivityGroupName=None, advertiserId=None, tagString=None, floodlightActivityGroupTagString=None, floodlightActivityGroupIds=None, pageToken=None, sortOrder=None, maxResults=None, searchString=None, sortField=None, floodlightConfigurationId=None, ids=None, floodlightActivityGroupType=None)</code>
-  <pre>Retrieves a list of floodlight activities, possibly filtered.
+  <pre>Retrieves a list of floodlight activities, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.floodlightActivityGroups.html b/docs/dyn/dfareporting_v2_5.floodlightActivityGroups.html
index 0249afdd187..e8cd8fcfc14 100644
--- a/docs/dyn/dfareporting_v2_5.floodlightActivityGroups.html
+++ b/docs/dyn/dfareporting_v2_5.floodlightActivityGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new floodlight activity group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, floodlightConfigurationId=None, ids=None, maxResults=None, sortOrder=None, type=None)</a></code></p>
-<p class="firstline">Retrieves a list of floodlight activity groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -229,7 +229,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, floodlightConfigurationId=None, ids=None, maxResults=None, sortOrder=None, type=None)</code>
-  <pre>Retrieves a list of floodlight activity groups, possibly filtered.
+  <pre>Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.inventoryItems.html b/docs/dyn/dfareporting_v2_5.inventoryItems.html
index f4aa0d61b6d..d06975220b3 100644
--- a/docs/dyn/dfareporting_v2_5.inventoryItems.html
+++ b/docs/dyn/dfareporting_v2_5.inventoryItems.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one inventory item by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, pageToken=None, inPlan=None, sortOrder=None, type=None, orderId=None, maxResults=None, siteId=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of inventory items, possibly filtered.</p>
+<p class="firstline">Retrieves a list of inventory items, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, pageToken=None, inPlan=None, sortOrder=None, type=None, orderId=None, maxResults=None, siteId=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of inventory items, possibly filtered.
+  <pre>Retrieves a list of inventory items, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.orderDocuments.html b/docs/dyn/dfareporting_v2_5.orderDocuments.html
index dbea3184487..98246e2808f 100644
--- a/docs/dyn/dfareporting_v2_5.orderDocuments.html
+++ b/docs/dyn/dfareporting_v2_5.orderDocuments.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one order document by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of order documents, possibly filtered.</p>
+<p class="firstline">Retrieves a list of order documents, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -125,7 +125,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of order documents, possibly filtered.
+  <pre>Retrieves a list of order documents, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.orders.html b/docs/dyn/dfareporting_v2_5.orders.html
index efcedd7fd35..9a9eacd9abc 100644
--- a/docs/dyn/dfareporting_v2_5.orders.html
+++ b/docs/dyn/dfareporting_v2_5.orders.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one order by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None, siteId=None)</a></code></p>
-<p class="firstline">Retrieves a list of orders, possibly filtered.</p>
+<p class="firstline">Retrieves a list of orders, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -138,7 +138,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None, siteId=None)</code>
-  <pre>Retrieves a list of orders, possibly filtered.
+  <pre>Retrieves a list of orders, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.placementGroups.html b/docs/dyn/dfareporting_v2_5.placementGroups.html
index 779a59d3f1c..a019c9409eb 100644
--- a/docs/dyn/dfareporting_v2_5.placementGroups.html
+++ b/docs/dyn/dfareporting_v2_5.placementGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, siteIds=None, placementGroupType=None, pricingTypes=None, campaignIds=None, advertiserIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, searchString=None, minEndDate=None, directorySiteIds=None, ids=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of placement groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placement groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -406,7 +406,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, siteIds=None, placementGroupType=None, pricingTypes=None, campaignIds=None, advertiserIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, searchString=None, minEndDate=None, directorySiteIds=None, ids=None, sortField=None)</code>
-  <pre>Retrieves a list of placement groups, possibly filtered.
+  <pre>Retrieves a list of placement groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.placementStrategies.html b/docs/dyn/dfareporting_v2_5.placementStrategies.html
index 81a6d542973..247cf735470 100644
--- a/docs/dyn/dfareporting_v2_5.placementStrategies.html
+++ b/docs/dyn/dfareporting_v2_5.placementStrategies.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement strategy.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of placement strategies, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placement strategies, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of placement strategies, possibly filtered.
+  <pre>Retrieves a list of placement strategies, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.placements.html b/docs/dyn/dfareporting_v2_5.placements.html
index c9ca3f0fca4..fe4ce8341aa 100644
--- a/docs/dyn/dfareporting_v2_5.placements.html
+++ b/docs/dyn/dfareporting_v2_5.placements.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, siteIds=None, paymentSource=None, pricingTypes=None, campaignIds=None, advertiserIds=None, sizeIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, compatibilities=None, searchString=None, minEndDate=None, directorySiteIds=None, sortField=None, ids=None, groupIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of placements, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placements, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -580,7 +580,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, siteIds=None, paymentSource=None, pricingTypes=None, campaignIds=None, advertiserIds=None, sizeIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, compatibilities=None, searchString=None, minEndDate=None, directorySiteIds=None, sortField=None, ids=None, groupIds=None)</code>
-  <pre>Retrieves a list of placements, possibly filtered.
+  <pre>Retrieves a list of placements, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.projects.html b/docs/dyn/dfareporting_v2_5.projects.html
index 46b90e72d31..9501d398965 100644
--- a/docs/dyn/dfareporting_v2_5.projects.html
+++ b/docs/dyn/dfareporting_v2_5.projects.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one project by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of projects, possibly filtered.</p>
+<p class="firstline">Retrieves a list of projects, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -124,7 +124,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of projects, possibly filtered.
+  <pre>Retrieves a list of projects, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.remarketingLists.html b/docs/dyn/dfareporting_v2_5.remarketingLists.html
index e305cfe9e2b..0b9df240950 100644
--- a/docs/dyn/dfareporting_v2_5.remarketingLists.html
+++ b/docs/dyn/dfareporting_v2_5.remarketingLists.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new remarketing list.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, floodlightActivityId=None, maxResults=None, active=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of remarketing lists, possibly filtered.</p>
+<p class="firstline">Retrieves a list of remarketing lists, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -247,7 +247,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, floodlightActivityId=None, maxResults=None, active=None, sortOrder=None)</code>
-  <pre>Retrieves a list of remarketing lists, possibly filtered.
+  <pre>Retrieves a list of remarketing lists, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.sites.html b/docs/dyn/dfareporting_v2_5.sites.html
index 25f15ed537b..38c6174a6e0 100644
--- a/docs/dyn/dfareporting_v2_5.sites.html
+++ b/docs/dyn/dfareporting_v2_5.sites.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new site.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, unmappedSite=None, campaignIds=None, acceptsInStreamVideoPlacements=None, pageToken=None, acceptsPublisherPaidPlacements=None, sortOrder=None, acceptsInterstitialPlacements=None, maxResults=None, adWordsSite=None, approved=None, searchString=None, subaccountId=None, directorySiteIds=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of sites, possibly filtered.</p>
+<p class="firstline">Retrieves a list of sites, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -298,7 +298,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, unmappedSite=None, campaignIds=None, acceptsInStreamVideoPlacements=None, pageToken=None, acceptsPublisherPaidPlacements=None, sortOrder=None, acceptsInterstitialPlacements=None, maxResults=None, adWordsSite=None, approved=None, searchString=None, subaccountId=None, directorySiteIds=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of sites, possibly filtered.
+  <pre>Retrieves a list of sites, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.subaccounts.html b/docs/dyn/dfareporting_v2_5.subaccounts.html
index 89ca36ddada..4ffe4891894 100644
--- a/docs/dyn/dfareporting_v2_5.subaccounts.html
+++ b/docs/dyn/dfareporting_v2_5.subaccounts.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new subaccount.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Gets a list of subaccounts, possibly filtered.</p>
+<p class="firstline">Gets a list of subaccounts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -151,7 +151,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Gets a list of subaccounts, possibly filtered.
+  <pre>Gets a list of subaccounts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.targetableRemarketingLists.html b/docs/dyn/dfareporting_v2_5.targetableRemarketingLists.html
index d1a6824897c..5b863767347 100644
--- a/docs/dyn/dfareporting_v2_5.targetableRemarketingLists.html
+++ b/docs/dyn/dfareporting_v2_5.targetableRemarketingLists.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one remarketing list by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, maxResults=None, active=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of targetable remarketing lists, possibly filtered.</p>
+<p class="firstline">Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -120,7 +120,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, maxResults=None, active=None, sortOrder=None)</code>
-  <pre>Retrieves a list of targetable remarketing lists, possibly filtered.
+  <pre>Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5.userRoles.html b/docs/dyn/dfareporting_v2_5.userRoles.html
index 21fd5111644..70f20eab781 100644
--- a/docs/dyn/dfareporting_v2_5.userRoles.html
+++ b/docs/dyn/dfareporting_v2_5.userRoles.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new user role.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, subaccountId=None, pageToken=None, ids=None, maxResults=None, accountUserRoleOnly=None, sortOrder=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of user roles, possibly filtered.</p>
+<p class="firstline">Retrieves a list of user roles, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -191,7 +191,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, subaccountId=None, pageToken=None, ids=None, maxResults=None, accountUserRoleOnly=None, sortOrder=None, sortField=None)</code>
-  <pre>Retrieves a list of user roles, possibly filtered.
+  <pre>Retrieves a list of user roles, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.accountUserProfiles.html b/docs/dyn/dfareporting_v2_5beta1.accountUserProfiles.html
index 61f339f787b..6ad07cd05a0 100644
--- a/docs/dyn/dfareporting_v2_5beta1.accountUserProfiles.html
+++ b/docs/dyn/dfareporting_v2_5beta1.accountUserProfiles.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new account user profile.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, subaccountId=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, userRoleId=None, active=None)</a></code></p>
-<p class="firstline">Retrieves a list of account user profiles, possibly filtered.</p>
+<p class="firstline">Retrieves a list of account user profiles, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -301,7 +301,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, subaccountId=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, userRoleId=None, active=None)</code>
-  <pre>Retrieves a list of account user profiles, possibly filtered.
+  <pre>Retrieves a list of account user profiles, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.accounts.html b/docs/dyn/dfareporting_v2_5beta1.accounts.html
index 0425606ad42..67e00011d8c 100644
--- a/docs/dyn/dfareporting_v2_5beta1.accounts.html
+++ b/docs/dyn/dfareporting_v2_5beta1.accounts.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one account by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, active=None)</a></code></p>
-<p class="firstline">Retrieves the list of accounts, possibly filtered.</p>
+<p class="firstline">Retrieves the list of accounts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -217,7 +217,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, active=None)</code>
-  <pre>Retrieves the list of accounts, possibly filtered.
+  <pre>Retrieves the list of accounts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.ads.html b/docs/dyn/dfareporting_v2_5beta1.ads.html
index 6cb5310b2c8..84e57854b99 100644
--- a/docs/dyn/dfareporting_v2_5beta1.ads.html
+++ b/docs/dyn/dfareporting_v2_5beta1.ads.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new ad.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, landingPageIds=None, overriddenEventTagId=None, campaignIds=None, sizeIds=None, archived=None, creativeOptimizationConfigurationIds=None, sslCompliant=None, pageToken=None, sortOrder=None, type=None, sslRequired=None, creativeIds=None, remarketingListIds=None, maxResults=None, creativeType=None, placementIds=None, active=None, compatibility=None, advertiserId=None, searchString=None, audienceSegmentIds=None, ids=None, sortField=None, dynamicClickTracker=None)</a></code></p>
-<p class="firstline">Retrieves a list of ads, possibly filtered.</p>
+<p class="firstline">Retrieves a list of ads, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -197,7 +197,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
           { # Contains information about a platform type that can be targeted by ads.
@@ -381,7 +381,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -530,7 +530,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
         { # Contains information about a platform type that can be targeted by ads.
@@ -714,7 +714,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -857,7 +857,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
           { # Contains information about a platform type that can be targeted by ads.
@@ -1041,7 +1041,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -1090,7 +1090,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, landingPageIds=None, overriddenEventTagId=None, campaignIds=None, sizeIds=None, archived=None, creativeOptimizationConfigurationIds=None, sslCompliant=None, pageToken=None, sortOrder=None, type=None, sslRequired=None, creativeIds=None, remarketingListIds=None, maxResults=None, creativeType=None, placementIds=None, active=None, compatibility=None, advertiserId=None, searchString=None, audienceSegmentIds=None, ids=None, sortField=None, dynamicClickTracker=None)</code>
-  <pre>Retrieves a list of ads, possibly filtered.
+  <pre>Retrieves a list of ads, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
@@ -1261,7 +1261,7 @@ <h3>Method Details</h3>
           ],
           "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
           "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-          "archived": True or False, # Whether this ad is archived.
+          "archived": True or False, # Whether this ad is archived. When true, active must be false.
           "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
             "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
               { # Contains information about a platform type that can be targeted by ads.
@@ -1445,7 +1445,7 @@ <h3>Method Details</h3>
             "time": "A String", # Timestamp of the last change in milliseconds since epoch.
           },
           "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-          "active": True or False, # Whether this ad is active.
+          "active": True or False, # Whether this ad is active. When true, archived must be false.
           "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
           "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
           "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -1611,7 +1611,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
         { # Contains information about a platform type that can be targeted by ads.
@@ -1795,7 +1795,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -1938,7 +1938,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
           { # Contains information about a platform type that can be targeted by ads.
@@ -2122,7 +2122,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -2271,7 +2271,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
         { # Contains information about a platform type that can be targeted by ads.
@@ -2455,7 +2455,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -2598,7 +2598,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
           { # Contains information about a platform type that can be targeted by ads.
@@ -2782,7 +2782,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
diff --git a/docs/dyn/dfareporting_v2_5beta1.advertiserGroups.html b/docs/dyn/dfareporting_v2_5beta1.advertiserGroups.html
index 6e166c273df..0a5d97bd9a9 100644
--- a/docs/dyn/dfareporting_v2_5beta1.advertiserGroups.html
+++ b/docs/dyn/dfareporting_v2_5beta1.advertiserGroups.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new advertiser group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of advertiser groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of advertiser groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of advertiser groups, possibly filtered.
+  <pre>Retrieves a list of advertiser groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.advertisers.html b/docs/dyn/dfareporting_v2_5beta1.advertisers.html
index f457eaf0e70..1eb4728b893 100644
--- a/docs/dyn/dfareporting_v2_5beta1.advertisers.html
+++ b/docs/dyn/dfareporting_v2_5beta1.advertisers.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new advertiser.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, includeAdvertisersWithoutGroupsOnly=None, onlyParent=None, pageToken=None, sortOrder=None, status=None, maxResults=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, floodlightConfigurationIds=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of advertisers, possibly filtered.</p>
+<p class="firstline">Retrieves a list of advertisers, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -223,7 +223,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, includeAdvertisersWithoutGroupsOnly=None, onlyParent=None, pageToken=None, sortOrder=None, status=None, maxResults=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, floodlightConfigurationIds=None, sortField=None)</code>
-  <pre>Retrieves a list of advertisers, possibly filtered.
+  <pre>Retrieves a list of advertisers, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.campaignCreativeAssociations.html b/docs/dyn/dfareporting_v2_5beta1.campaignCreativeAssociations.html
index 471cd2d6de8..d39c9a91bbd 100644
--- a/docs/dyn/dfareporting_v2_5beta1.campaignCreativeAssociations.html
+++ b/docs/dyn/dfareporting_v2_5beta1.campaignCreativeAssociations.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Associates a creative with the specified campaign. This method creates a default ad with dimensions matching the creative in the campaign if such a default ad does not exist already.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves the list of creative IDs associated with the specified campaign.</p>
+<p class="firstline">Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -111,7 +111,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None)</code>
-  <pre>Retrieves the list of creative IDs associated with the specified campaign.
+  <pre>Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.campaigns.html b/docs/dyn/dfareporting_v2_5beta1.campaigns.html
index d73ed769b1e..eb974fa54ad 100644
--- a/docs/dyn/dfareporting_v2_5beta1.campaigns.html
+++ b/docs/dyn/dfareporting_v2_5beta1.campaigns.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new campaign.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, overriddenEventTagId=None, archived=None, advertiserIds=None, pageToken=None, sortOrder=None, maxResults=None, excludedIds=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, sortField=None, atLeastOneOptimizationActivity=None)</a></code></p>
-<p class="firstline">Retrieves a list of campaigns, possibly filtered.</p>
+<p class="firstline">Retrieves a list of campaigns, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -474,7 +474,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, overriddenEventTagId=None, archived=None, advertiserIds=None, pageToken=None, sortOrder=None, maxResults=None, excludedIds=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, sortField=None, atLeastOneOptimizationActivity=None)</code>
-  <pre>Retrieves a list of campaigns, possibly filtered.
+  <pre>Retrieves a list of campaigns, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.changeLogs.html b/docs/dyn/dfareporting_v2_5beta1.changeLogs.html
index 6e41f9680a6..aeff6b663b5 100644
--- a/docs/dyn/dfareporting_v2_5beta1.changeLogs.html
+++ b/docs/dyn/dfareporting_v2_5beta1.changeLogs.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one change log by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of change logs.</p>
+<p class="firstline">Retrieves a list of change logs. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -115,7 +115,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</code>
-  <pre>Retrieves a list of change logs.
+  <pre>Retrieves a list of change logs. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
@@ -153,6 +153,7 @@ <h3>Method Details</h3>
       OBJECT_REMARKETING_LIST - 
       OBJECT_RICHMEDIA_CREATIVE - 
       OBJECT_SD_SITE - 
+      OBJECT_SEARCH_LIFT_STUDY - 
       OBJECT_SIZE - 
       OBJECT_SUBACCOUNT - 
       OBJECT_TARGETING_TEMPLATE - 
diff --git a/docs/dyn/dfareporting_v2_5beta1.contentCategories.html b/docs/dyn/dfareporting_v2_5beta1.contentCategories.html
index b6a9889e554..0c8632a1a43 100644
--- a/docs/dyn/dfareporting_v2_5beta1.contentCategories.html
+++ b/docs/dyn/dfareporting_v2_5beta1.contentCategories.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new content category.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of content categories, possibly filtered.</p>
+<p class="firstline">Retrieves a list of content categories, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of content categories, possibly filtered.
+  <pre>Retrieves a list of content categories, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.conversions.html b/docs/dyn/dfareporting_v2_5beta1.conversions.html
index 10fabe073cc..4b224d80fed 100644
--- a/docs/dyn/dfareporting_v2_5beta1.conversions.html
+++ b/docs/dyn/dfareporting_v2_5beta1.conversions.html
@@ -104,7 +104,7 @@ <h3>Method Details</h3>
         ],
         "floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
         "value": 3.14, # The value of the conversion.
-        "limitAdTracking": True or False, # Whether the user has Limit Ad Tracking set.
+        "limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
         "quantity": "A String", # The quantity of the conversion.
         "floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
         "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId and encryptedUserIdCandidates[]. This or encryptedUserId or encryptedUserIdCandidates[] is a required field.
@@ -141,7 +141,7 @@ <h3>Method Details</h3>
           ],
           "floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
           "value": 3.14, # The value of the conversion.
-          "limitAdTracking": True or False, # Whether the user has Limit Ad Tracking set.
+          "limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
           "quantity": "A String", # The quantity of the conversion.
           "floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
           "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId and encryptedUserIdCandidates[]. This or encryptedUserId or encryptedUserIdCandidates[] is a required field.
diff --git a/docs/dyn/dfareporting_v2_5beta1.creativeAssets.html b/docs/dyn/dfareporting_v2_5beta1.creativeAssets.html
index 5f7bfd1c8ec..37c71c6a472 100644
--- a/docs/dyn/dfareporting_v2_5beta1.creativeAssets.html
+++ b/docs/dyn/dfareporting_v2_5beta1.creativeAssets.html
@@ -75,11 +75,11 @@
 <h1><a href="dfareporting_v2_5beta1.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_5beta1.creativeAssets.html">creativeAssets</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#insert">insert(profileId, advertiserId, body=None, media_body=None)</a></code></p>
+  <code><a href="#insert">insert(profileId, advertiserId, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Inserts a new creative asset.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="insert">insert(profileId, advertiserId, body=None, media_body=None)</code>
+    <code class="details" id="insert">insert(profileId, advertiserId, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Inserts a new creative asset.
 
 Args:
@@ -136,6 +136,7 @@ <h3>Method Details</h3>
   }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/dfareporting_v2_5beta1.creativeFieldValues.html b/docs/dyn/dfareporting_v2_5beta1.creativeFieldValues.html
index 62bff66d26d..f3ca225f14f 100644
--- a/docs/dyn/dfareporting_v2_5beta1.creativeFieldValues.html
+++ b/docs/dyn/dfareporting_v2_5beta1.creativeFieldValues.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative field value.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, creativeFieldId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative field values, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative field values, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, creativeFieldId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative field values, possibly filtered.
+  <pre>Retrieves a list of creative field values, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.creativeFields.html b/docs/dyn/dfareporting_v2_5beta1.creativeFields.html
index 2d3506a1600..63054f6db19 100644
--- a/docs/dyn/dfareporting_v2_5beta1.creativeFields.html
+++ b/docs/dyn/dfareporting_v2_5beta1.creativeFields.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative field.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative fields, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative fields, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -185,7 +185,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative fields, possibly filtered.
+  <pre>Retrieves a list of creative fields, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.creativeGroups.html b/docs/dyn/dfareporting_v2_5beta1.creativeGroups.html
index e902f819d4c..11e27047c6f 100644
--- a/docs/dyn/dfareporting_v2_5beta1.creativeGroups.html
+++ b/docs/dyn/dfareporting_v2_5beta1.creativeGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, groupNumber=None, maxResults=None, ids=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -184,7 +184,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, groupNumber=None, maxResults=None, ids=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative groups, possibly filtered.
+  <pre>Retrieves a list of creative groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.creatives.html b/docs/dyn/dfareporting_v2_5beta1.creatives.html
index 3786294ea9b..f14f35245ba 100644
--- a/docs/dyn/dfareporting_v2_5beta1.creatives.html
+++ b/docs/dyn/dfareporting_v2_5beta1.creatives.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of creatives, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creatives, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -1120,7 +1120,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</code>
-  <pre>Retrieves a list of creatives, possibly filtered.
+  <pre>Retrieves a list of creatives, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.directorySiteContacts.html b/docs/dyn/dfareporting_v2_5beta1.directorySiteContacts.html
index 3b538b5031e..09c311f659f 100644
--- a/docs/dyn/dfareporting_v2_5beta1.directorySiteContacts.html
+++ b/docs/dyn/dfareporting_v2_5beta1.directorySiteContacts.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one directory site contact by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, directorySiteIds=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of directory site contacts, possibly filtered.</p>
+<p class="firstline">Retrieves a list of directory site contacts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -111,7 +111,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, directorySiteIds=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of directory site contacts, possibly filtered.
+  <pre>Retrieves a list of directory site contacts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.directorySites.html b/docs/dyn/dfareporting_v2_5beta1.directorySites.html
index cade187e037..9d686de95d0 100644
--- a/docs/dyn/dfareporting_v2_5beta1.directorySites.html
+++ b/docs/dyn/dfareporting_v2_5beta1.directorySites.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new directory site.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, countryId=None, acceptsInStreamVideoPlacements=None, pageToken=None, sortOrder=None, parentId=None, acceptsPublisherPaidPlacements=None, acceptsInterstitialPlacements=None, maxResults=None, active=None, searchString=None, sortField=None, ids=None, dfp_network_code=None)</a></code></p>
-<p class="firstline">Retrieves a list of directory sites, possibly filtered.</p>
+<p class="firstline">Retrieves a list of directory sites, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -433,7 +433,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, countryId=None, acceptsInStreamVideoPlacements=None, pageToken=None, sortOrder=None, parentId=None, acceptsPublisherPaidPlacements=None, acceptsInterstitialPlacements=None, maxResults=None, active=None, searchString=None, sortField=None, ids=None, dfp_network_code=None)</code>
-  <pre>Retrieves a list of directory sites, possibly filtered.
+  <pre>Retrieves a list of directory sites, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.floodlightActivities.html b/docs/dyn/dfareporting_v2_5beta1.floodlightActivities.html
index b402799289d..bacb54000ae 100644
--- a/docs/dyn/dfareporting_v2_5beta1.floodlightActivities.html
+++ b/docs/dyn/dfareporting_v2_5beta1.floodlightActivities.html
@@ -88,7 +88,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new floodlight activity.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, floodlightActivityGroupName=None, advertiserId=None, tagString=None, floodlightActivityGroupTagString=None, floodlightActivityGroupIds=None, pageToken=None, sortOrder=None, maxResults=None, searchString=None, sortField=None, floodlightConfigurationId=None, ids=None, floodlightActivityGroupType=None)</a></code></p>
-<p class="firstline">Retrieves a list of floodlight activities, possibly filtered.</p>
+<p class="firstline">Retrieves a list of floodlight activities, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -457,7 +457,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, floodlightActivityGroupName=None, advertiserId=None, tagString=None, floodlightActivityGroupTagString=None, floodlightActivityGroupIds=None, pageToken=None, sortOrder=None, maxResults=None, searchString=None, sortField=None, floodlightConfigurationId=None, ids=None, floodlightActivityGroupType=None)</code>
-  <pre>Retrieves a list of floodlight activities, possibly filtered.
+  <pre>Retrieves a list of floodlight activities, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.floodlightActivityGroups.html b/docs/dyn/dfareporting_v2_5beta1.floodlightActivityGroups.html
index 0513a9ffb4c..9ceef2ffbff 100644
--- a/docs/dyn/dfareporting_v2_5beta1.floodlightActivityGroups.html
+++ b/docs/dyn/dfareporting_v2_5beta1.floodlightActivityGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new floodlight activity group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, floodlightConfigurationId=None, ids=None, maxResults=None, sortOrder=None, type=None)</a></code></p>
-<p class="firstline">Retrieves a list of floodlight activity groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -229,7 +229,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, floodlightConfigurationId=None, ids=None, maxResults=None, sortOrder=None, type=None)</code>
-  <pre>Retrieves a list of floodlight activity groups, possibly filtered.
+  <pre>Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.inventoryItems.html b/docs/dyn/dfareporting_v2_5beta1.inventoryItems.html
index c16a1942e4c..8546b1e5e07 100644
--- a/docs/dyn/dfareporting_v2_5beta1.inventoryItems.html
+++ b/docs/dyn/dfareporting_v2_5beta1.inventoryItems.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one inventory item by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, pageToken=None, inPlan=None, sortOrder=None, type=None, orderId=None, maxResults=None, siteId=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of inventory items, possibly filtered.</p>
+<p class="firstline">Retrieves a list of inventory items, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, pageToken=None, inPlan=None, sortOrder=None, type=None, orderId=None, maxResults=None, siteId=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of inventory items, possibly filtered.
+  <pre>Retrieves a list of inventory items, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.orderDocuments.html b/docs/dyn/dfareporting_v2_5beta1.orderDocuments.html
index 9813a907ac8..8765efeaa45 100644
--- a/docs/dyn/dfareporting_v2_5beta1.orderDocuments.html
+++ b/docs/dyn/dfareporting_v2_5beta1.orderDocuments.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one order document by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of order documents, possibly filtered.</p>
+<p class="firstline">Retrieves a list of order documents, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -125,7 +125,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of order documents, possibly filtered.
+  <pre>Retrieves a list of order documents, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.orders.html b/docs/dyn/dfareporting_v2_5beta1.orders.html
index 7a3e8700390..4009c19cebd 100644
--- a/docs/dyn/dfareporting_v2_5beta1.orders.html
+++ b/docs/dyn/dfareporting_v2_5beta1.orders.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one order by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None, siteId=None)</a></code></p>
-<p class="firstline">Retrieves a list of orders, possibly filtered.</p>
+<p class="firstline">Retrieves a list of orders, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -138,7 +138,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None, siteId=None)</code>
-  <pre>Retrieves a list of orders, possibly filtered.
+  <pre>Retrieves a list of orders, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.placementGroups.html b/docs/dyn/dfareporting_v2_5beta1.placementGroups.html
index 5ed079d13ce..e0ffaa7ca43 100644
--- a/docs/dyn/dfareporting_v2_5beta1.placementGroups.html
+++ b/docs/dyn/dfareporting_v2_5beta1.placementGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, siteIds=None, placementGroupType=None, pricingTypes=None, campaignIds=None, advertiserIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, searchString=None, minEndDate=None, directorySiteIds=None, ids=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of placement groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placement groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -406,7 +406,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, siteIds=None, placementGroupType=None, pricingTypes=None, campaignIds=None, advertiserIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, searchString=None, minEndDate=None, directorySiteIds=None, ids=None, sortField=None)</code>
-  <pre>Retrieves a list of placement groups, possibly filtered.
+  <pre>Retrieves a list of placement groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.placementStrategies.html b/docs/dyn/dfareporting_v2_5beta1.placementStrategies.html
index 6ca59c821f2..7f0a0081a1f 100644
--- a/docs/dyn/dfareporting_v2_5beta1.placementStrategies.html
+++ b/docs/dyn/dfareporting_v2_5beta1.placementStrategies.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement strategy.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of placement strategies, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placement strategies, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of placement strategies, possibly filtered.
+  <pre>Retrieves a list of placement strategies, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.placements.html b/docs/dyn/dfareporting_v2_5beta1.placements.html
index 69e7257cd00..9ee027381e2 100644
--- a/docs/dyn/dfareporting_v2_5beta1.placements.html
+++ b/docs/dyn/dfareporting_v2_5beta1.placements.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, siteIds=None, paymentSource=None, pricingTypes=None, campaignIds=None, advertiserIds=None, sizeIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, compatibilities=None, searchString=None, minEndDate=None, directorySiteIds=None, sortField=None, ids=None, groupIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of placements, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placements, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -580,7 +580,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, siteIds=None, paymentSource=None, pricingTypes=None, campaignIds=None, advertiserIds=None, sizeIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, compatibilities=None, searchString=None, minEndDate=None, directorySiteIds=None, sortField=None, ids=None, groupIds=None)</code>
-  <pre>Retrieves a list of placements, possibly filtered.
+  <pre>Retrieves a list of placements, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.projects.html b/docs/dyn/dfareporting_v2_5beta1.projects.html
index 889443d0067..c3ae016039c 100644
--- a/docs/dyn/dfareporting_v2_5beta1.projects.html
+++ b/docs/dyn/dfareporting_v2_5beta1.projects.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one project by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of projects, possibly filtered.</p>
+<p class="firstline">Retrieves a list of projects, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -124,7 +124,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of projects, possibly filtered.
+  <pre>Retrieves a list of projects, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.remarketingLists.html b/docs/dyn/dfareporting_v2_5beta1.remarketingLists.html
index d30d0df572a..842361bf157 100644
--- a/docs/dyn/dfareporting_v2_5beta1.remarketingLists.html
+++ b/docs/dyn/dfareporting_v2_5beta1.remarketingLists.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new remarketing list.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, floodlightActivityId=None, maxResults=None, active=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of remarketing lists, possibly filtered.</p>
+<p class="firstline">Retrieves a list of remarketing lists, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -247,7 +247,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, floodlightActivityId=None, maxResults=None, active=None, sortOrder=None)</code>
-  <pre>Retrieves a list of remarketing lists, possibly filtered.
+  <pre>Retrieves a list of remarketing lists, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.sites.html b/docs/dyn/dfareporting_v2_5beta1.sites.html
index 319df31f704..8a244ab0c41 100644
--- a/docs/dyn/dfareporting_v2_5beta1.sites.html
+++ b/docs/dyn/dfareporting_v2_5beta1.sites.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new site.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, unmappedSite=None, campaignIds=None, acceptsInStreamVideoPlacements=None, pageToken=None, acceptsPublisherPaidPlacements=None, sortOrder=None, acceptsInterstitialPlacements=None, maxResults=None, adWordsSite=None, approved=None, searchString=None, subaccountId=None, directorySiteIds=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of sites, possibly filtered.</p>
+<p class="firstline">Retrieves a list of sites, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -298,7 +298,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, unmappedSite=None, campaignIds=None, acceptsInStreamVideoPlacements=None, pageToken=None, acceptsPublisherPaidPlacements=None, sortOrder=None, acceptsInterstitialPlacements=None, maxResults=None, adWordsSite=None, approved=None, searchString=None, subaccountId=None, directorySiteIds=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of sites, possibly filtered.
+  <pre>Retrieves a list of sites, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.subaccounts.html b/docs/dyn/dfareporting_v2_5beta1.subaccounts.html
index ce888d77e3b..e1420522712 100644
--- a/docs/dyn/dfareporting_v2_5beta1.subaccounts.html
+++ b/docs/dyn/dfareporting_v2_5beta1.subaccounts.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new subaccount.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Gets a list of subaccounts, possibly filtered.</p>
+<p class="firstline">Gets a list of subaccounts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -151,7 +151,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Gets a list of subaccounts, possibly filtered.
+  <pre>Gets a list of subaccounts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.targetableRemarketingLists.html b/docs/dyn/dfareporting_v2_5beta1.targetableRemarketingLists.html
index 7a082f692a3..5112c7f4e21 100644
--- a/docs/dyn/dfareporting_v2_5beta1.targetableRemarketingLists.html
+++ b/docs/dyn/dfareporting_v2_5beta1.targetableRemarketingLists.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one remarketing list by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, maxResults=None, active=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of targetable remarketing lists, possibly filtered.</p>
+<p class="firstline">Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -120,7 +120,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, maxResults=None, active=None, sortOrder=None)</code>
-  <pre>Retrieves a list of targetable remarketing lists, possibly filtered.
+  <pre>Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_5beta1.userRoles.html b/docs/dyn/dfareporting_v2_5beta1.userRoles.html
index 7efb5869b75..74c91111afd 100644
--- a/docs/dyn/dfareporting_v2_5beta1.userRoles.html
+++ b/docs/dyn/dfareporting_v2_5beta1.userRoles.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new user role.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, subaccountId=None, pageToken=None, ids=None, maxResults=None, accountUserRoleOnly=None, sortOrder=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of user roles, possibly filtered.</p>
+<p class="firstline">Retrieves a list of user roles, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -191,7 +191,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, subaccountId=None, pageToken=None, ids=None, maxResults=None, accountUserRoleOnly=None, sortOrder=None, sortField=None)</code>
-  <pre>Retrieves a list of user roles, possibly filtered.
+  <pre>Retrieves a list of user roles, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.accountUserProfiles.html b/docs/dyn/dfareporting_v2_6.accountUserProfiles.html
index 462e2602dba..258ebf1e79a 100644
--- a/docs/dyn/dfareporting_v2_6.accountUserProfiles.html
+++ b/docs/dyn/dfareporting_v2_6.accountUserProfiles.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new account user profile.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, subaccountId=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, userRoleId=None, active=None)</a></code></p>
-<p class="firstline">Retrieves a list of account user profiles, possibly filtered.</p>
+<p class="firstline">Retrieves a list of account user profiles, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -301,7 +301,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, subaccountId=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, userRoleId=None, active=None)</code>
-  <pre>Retrieves a list of account user profiles, possibly filtered.
+  <pre>Retrieves a list of account user profiles, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.accounts.html b/docs/dyn/dfareporting_v2_6.accounts.html
index 32909703ae9..53509475042 100644
--- a/docs/dyn/dfareporting_v2_6.accounts.html
+++ b/docs/dyn/dfareporting_v2_6.accounts.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one account by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, active=None)</a></code></p>
-<p class="firstline">Retrieves the list of accounts, possibly filtered.</p>
+<p class="firstline">Retrieves the list of accounts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -217,7 +217,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, active=None)</code>
-  <pre>Retrieves the list of accounts, possibly filtered.
+  <pre>Retrieves the list of accounts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.ads.html b/docs/dyn/dfareporting_v2_6.ads.html
index 6b0f2c89182..d10df49cae8 100644
--- a/docs/dyn/dfareporting_v2_6.ads.html
+++ b/docs/dyn/dfareporting_v2_6.ads.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new ad.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, landingPageIds=None, overriddenEventTagId=None, campaignIds=None, sizeIds=None, archived=None, creativeOptimizationConfigurationIds=None, sslCompliant=None, pageToken=None, sortOrder=None, type=None, sslRequired=None, creativeIds=None, remarketingListIds=None, maxResults=None, creativeType=None, placementIds=None, active=None, compatibility=None, advertiserId=None, searchString=None, audienceSegmentIds=None, ids=None, sortField=None, dynamicClickTracker=None)</a></code></p>
-<p class="firstline">Retrieves a list of ads, possibly filtered.</p>
+<p class="firstline">Retrieves a list of ads, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -207,7 +207,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
@@ -400,7 +400,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -559,7 +559,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
@@ -752,7 +752,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -905,7 +905,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
@@ -1098,7 +1098,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -1147,7 +1147,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, landingPageIds=None, overriddenEventTagId=None, campaignIds=None, sizeIds=None, archived=None, creativeOptimizationConfigurationIds=None, sslCompliant=None, pageToken=None, sortOrder=None, type=None, sslRequired=None, creativeIds=None, remarketingListIds=None, maxResults=None, creativeType=None, placementIds=None, active=None, compatibility=None, advertiserId=None, searchString=None, audienceSegmentIds=None, ids=None, sortField=None, dynamicClickTracker=None)</code>
-  <pre>Retrieves a list of ads, possibly filtered.
+  <pre>Retrieves a list of ads, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
@@ -1328,7 +1328,7 @@ <h3>Method Details</h3>
           ],
           "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
           "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-          "archived": True or False, # Whether this ad is archived.
+          "archived": True or False, # Whether this ad is archived. When true, active must be false.
           "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
           "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
             "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
@@ -1521,7 +1521,7 @@ <h3>Method Details</h3>
             "time": "A String", # Timestamp of the last change in milliseconds since epoch.
           },
           "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-          "active": True or False, # Whether this ad is active.
+          "active": True or False, # Whether this ad is active. When true, archived must be false.
           "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
           "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
           "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -1697,7 +1697,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
@@ -1890,7 +1890,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -2043,7 +2043,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
@@ -2236,7 +2236,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -2395,7 +2395,7 @@ <h3>Method Details</h3>
     ],
     "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
     "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-    "archived": True or False, # Whether this ad is archived.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
     "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
     "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
       "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
@@ -2588,7 +2588,7 @@ <h3>Method Details</h3>
       "time": "A String", # Timestamp of the last change in milliseconds since epoch.
     },
     "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-    "active": True or False, # Whether this ad is active.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
     "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
     "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
     "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
@@ -2741,7 +2741,7 @@ <h3>Method Details</h3>
       ],
       "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
       "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
-      "archived": True or False, # Whether this ad is archived.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
       "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
       "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
         "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
@@ -2934,7 +2934,7 @@ <h3>Method Details</h3>
         "time": "A String", # Timestamp of the last change in milliseconds since epoch.
       },
       "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
-      "active": True or False, # Whether this ad is active.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
       "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
       "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
       "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
diff --git a/docs/dyn/dfareporting_v2_6.advertiserGroups.html b/docs/dyn/dfareporting_v2_6.advertiserGroups.html
index 785695c9a4b..1af0b9d95ff 100644
--- a/docs/dyn/dfareporting_v2_6.advertiserGroups.html
+++ b/docs/dyn/dfareporting_v2_6.advertiserGroups.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new advertiser group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of advertiser groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of advertiser groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of advertiser groups, possibly filtered.
+  <pre>Retrieves a list of advertiser groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.advertisers.html b/docs/dyn/dfareporting_v2_6.advertisers.html
index ba72d54a4e4..fb0c2f7adc8 100644
--- a/docs/dyn/dfareporting_v2_6.advertisers.html
+++ b/docs/dyn/dfareporting_v2_6.advertisers.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new advertiser.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, includeAdvertisersWithoutGroupsOnly=None, onlyParent=None, pageToken=None, sortOrder=None, status=None, maxResults=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, floodlightConfigurationIds=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of advertisers, possibly filtered.</p>
+<p class="firstline">Retrieves a list of advertisers, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -223,7 +223,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, includeAdvertisersWithoutGroupsOnly=None, onlyParent=None, pageToken=None, sortOrder=None, status=None, maxResults=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, floodlightConfigurationIds=None, sortField=None)</code>
-  <pre>Retrieves a list of advertisers, possibly filtered.
+  <pre>Retrieves a list of advertisers, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.campaignCreativeAssociations.html b/docs/dyn/dfareporting_v2_6.campaignCreativeAssociations.html
index 6e32146603b..a514d29b8ac 100644
--- a/docs/dyn/dfareporting_v2_6.campaignCreativeAssociations.html
+++ b/docs/dyn/dfareporting_v2_6.campaignCreativeAssociations.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Associates a creative with the specified campaign. This method creates a default ad with dimensions matching the creative in the campaign if such a default ad does not exist already.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves the list of creative IDs associated with the specified campaign.</p>
+<p class="firstline">Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -111,7 +111,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None)</code>
-  <pre>Retrieves the list of creative IDs associated with the specified campaign.
+  <pre>Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.campaigns.html b/docs/dyn/dfareporting_v2_6.campaigns.html
index 8849609878d..1410c21453d 100644
--- a/docs/dyn/dfareporting_v2_6.campaigns.html
+++ b/docs/dyn/dfareporting_v2_6.campaigns.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new campaign.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, overriddenEventTagId=None, archived=None, advertiserIds=None, pageToken=None, sortOrder=None, maxResults=None, excludedIds=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, sortField=None, atLeastOneOptimizationActivity=None)</a></code></p>
-<p class="firstline">Retrieves a list of campaigns, possibly filtered.</p>
+<p class="firstline">Retrieves a list of campaigns, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -471,7 +471,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, overriddenEventTagId=None, archived=None, advertiserIds=None, pageToken=None, sortOrder=None, maxResults=None, excludedIds=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, sortField=None, atLeastOneOptimizationActivity=None)</code>
-  <pre>Retrieves a list of campaigns, possibly filtered.
+  <pre>Retrieves a list of campaigns, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.changeLogs.html b/docs/dyn/dfareporting_v2_6.changeLogs.html
index 3aaff9258e3..9439c17a0c1 100644
--- a/docs/dyn/dfareporting_v2_6.changeLogs.html
+++ b/docs/dyn/dfareporting_v2_6.changeLogs.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one change log by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of change logs.</p>
+<p class="firstline">Retrieves a list of change logs. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -115,7 +115,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</code>
-  <pre>Retrieves a list of change logs.
+  <pre>Retrieves a list of change logs. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
@@ -153,6 +153,7 @@ <h3>Method Details</h3>
       OBJECT_REMARKETING_LIST - 
       OBJECT_RICHMEDIA_CREATIVE - 
       OBJECT_SD_SITE - 
+      OBJECT_SEARCH_LIFT_STUDY - 
       OBJECT_SIZE - 
       OBJECT_SUBACCOUNT - 
       OBJECT_TARGETING_TEMPLATE - 
diff --git a/docs/dyn/dfareporting_v2_6.contentCategories.html b/docs/dyn/dfareporting_v2_6.contentCategories.html
index 0865fb88d47..a91f62f388e 100644
--- a/docs/dyn/dfareporting_v2_6.contentCategories.html
+++ b/docs/dyn/dfareporting_v2_6.contentCategories.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new content category.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of content categories, possibly filtered.</p>
+<p class="firstline">Retrieves a list of content categories, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of content categories, possibly filtered.
+  <pre>Retrieves a list of content categories, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.conversions.html b/docs/dyn/dfareporting_v2_6.conversions.html
index d520afd694f..a3a6ac1b516 100644
--- a/docs/dyn/dfareporting_v2_6.conversions.html
+++ b/docs/dyn/dfareporting_v2_6.conversions.html
@@ -105,7 +105,7 @@ <h3>Method Details</h3>
         "floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
         "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId and encryptedUserIdCandidates[]. This or encryptedUserId or encryptedUserIdCandidates[] is a required field.
         "value": 3.14, # The value of the conversion.
-        "limitAdTracking": True or False, # Whether the user has Limit Ad Tracking set.
+        "limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
         "quantity": "A String", # The quantity of the conversion.
         "floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
         "encryptedUserIdCandidates": [ # A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with NO_COOKIE_MATCH_FOUND error. When set, encryptionInfo should also be specified. This field should only be used when calling conversions.batchinsert. This field is mutually exclusive with encryptedUserId and mobileDeviceId. This or encryptedUserId or mobileDeviceId is a required field.
@@ -145,7 +145,7 @@ <h3>Method Details</h3>
           "floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
           "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId and encryptedUserIdCandidates[]. This or encryptedUserId or encryptedUserIdCandidates[] is a required field.
           "value": 3.14, # The value of the conversion.
-          "limitAdTracking": True or False, # Whether the user has Limit Ad Tracking set.
+          "limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
           "quantity": "A String", # The quantity of the conversion.
           "floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
           "encryptedUserIdCandidates": [ # A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with NO_COOKIE_MATCH_FOUND error. When set, encryptionInfo should also be specified. This field should only be used when calling conversions.batchinsert. This field is mutually exclusive with encryptedUserId and mobileDeviceId. This or encryptedUserId or mobileDeviceId is a required field.
diff --git a/docs/dyn/dfareporting_v2_6.creativeAssets.html b/docs/dyn/dfareporting_v2_6.creativeAssets.html
index ef981115015..9798c18c8e4 100644
--- a/docs/dyn/dfareporting_v2_6.creativeAssets.html
+++ b/docs/dyn/dfareporting_v2_6.creativeAssets.html
@@ -75,11 +75,11 @@
 <h1><a href="dfareporting_v2_6.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_6.creativeAssets.html">creativeAssets</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#insert">insert(profileId, advertiserId, body=None, media_body=None)</a></code></p>
+  <code><a href="#insert">insert(profileId, advertiserId, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Inserts a new creative asset.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="insert">insert(profileId, advertiserId, body=None, media_body=None)</code>
+    <code class="details" id="insert">insert(profileId, advertiserId, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Inserts a new creative asset.
 
 Args:
@@ -145,6 +145,7 @@ <h3>Method Details</h3>
   }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/dfareporting_v2_6.creativeFieldValues.html b/docs/dyn/dfareporting_v2_6.creativeFieldValues.html
index ec03540fbd3..c076e96f163 100644
--- a/docs/dyn/dfareporting_v2_6.creativeFieldValues.html
+++ b/docs/dyn/dfareporting_v2_6.creativeFieldValues.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative field value.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, creativeFieldId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative field values, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative field values, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, creativeFieldId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative field values, possibly filtered.
+  <pre>Retrieves a list of creative field values, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.creativeFields.html b/docs/dyn/dfareporting_v2_6.creativeFields.html
index 1b055260971..b8a3bf8eee1 100644
--- a/docs/dyn/dfareporting_v2_6.creativeFields.html
+++ b/docs/dyn/dfareporting_v2_6.creativeFields.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative field.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative fields, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative fields, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -185,7 +185,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative fields, possibly filtered.
+  <pre>Retrieves a list of creative fields, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.creativeGroups.html b/docs/dyn/dfareporting_v2_6.creativeGroups.html
index fb5f4914194..624677c4ab4 100644
--- a/docs/dyn/dfareporting_v2_6.creativeGroups.html
+++ b/docs/dyn/dfareporting_v2_6.creativeGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, groupNumber=None, maxResults=None, ids=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of creative groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creative groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -184,7 +184,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, groupNumber=None, maxResults=None, ids=None, sortOrder=None)</code>
-  <pre>Retrieves a list of creative groups, possibly filtered.
+  <pre>Retrieves a list of creative groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.creatives.html b/docs/dyn/dfareporting_v2_6.creatives.html
index eb62289f921..6719b2b9f24 100644
--- a/docs/dyn/dfareporting_v2_6.creatives.html
+++ b/docs/dyn/dfareporting_v2_6.creatives.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new creative.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of creatives, possibly filtered.</p>
+<p class="firstline">Retrieves a list of creatives, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -1192,7 +1192,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</code>
-  <pre>Retrieves a list of creatives, possibly filtered.
+  <pre>Retrieves a list of creatives, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.directorySiteContacts.html b/docs/dyn/dfareporting_v2_6.directorySiteContacts.html
index 8d2d65a913a..1d588703249 100644
--- a/docs/dyn/dfareporting_v2_6.directorySiteContacts.html
+++ b/docs/dyn/dfareporting_v2_6.directorySiteContacts.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one directory site contact by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, directorySiteIds=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of directory site contacts, possibly filtered.</p>
+<p class="firstline">Retrieves a list of directory site contacts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -111,7 +111,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, directorySiteIds=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of directory site contacts, possibly filtered.
+  <pre>Retrieves a list of directory site contacts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.directorySites.html b/docs/dyn/dfareporting_v2_6.directorySites.html
index cb852a02f65..bdcf5d45c8c 100644
--- a/docs/dyn/dfareporting_v2_6.directorySites.html
+++ b/docs/dyn/dfareporting_v2_6.directorySites.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new directory site.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, countryId=None, acceptsInStreamVideoPlacements=None, pageToken=None, sortOrder=None, parentId=None, acceptsPublisherPaidPlacements=None, acceptsInterstitialPlacements=None, maxResults=None, active=None, searchString=None, sortField=None, ids=None, dfp_network_code=None)</a></code></p>
-<p class="firstline">Retrieves a list of directory sites, possibly filtered.</p>
+<p class="firstline">Retrieves a list of directory sites, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -433,7 +433,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, countryId=None, acceptsInStreamVideoPlacements=None, pageToken=None, sortOrder=None, parentId=None, acceptsPublisherPaidPlacements=None, acceptsInterstitialPlacements=None, maxResults=None, active=None, searchString=None, sortField=None, ids=None, dfp_network_code=None)</code>
-  <pre>Retrieves a list of directory sites, possibly filtered.
+  <pre>Retrieves a list of directory sites, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.floodlightActivities.html b/docs/dyn/dfareporting_v2_6.floodlightActivities.html
index aaa4b982868..6e498cc05f1 100644
--- a/docs/dyn/dfareporting_v2_6.floodlightActivities.html
+++ b/docs/dyn/dfareporting_v2_6.floodlightActivities.html
@@ -88,7 +88,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new floodlight activity.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, floodlightActivityGroupName=None, advertiserId=None, tagString=None, floodlightActivityGroupTagString=None, floodlightActivityGroupIds=None, pageToken=None, sortOrder=None, maxResults=None, searchString=None, sortField=None, floodlightConfigurationId=None, ids=None, floodlightActivityGroupType=None)</a></code></p>
-<p class="firstline">Retrieves a list of floodlight activities, possibly filtered.</p>
+<p class="firstline">Retrieves a list of floodlight activities, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -457,7 +457,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, floodlightActivityGroupName=None, advertiserId=None, tagString=None, floodlightActivityGroupTagString=None, floodlightActivityGroupIds=None, pageToken=None, sortOrder=None, maxResults=None, searchString=None, sortField=None, floodlightConfigurationId=None, ids=None, floodlightActivityGroupType=None)</code>
-  <pre>Retrieves a list of floodlight activities, possibly filtered.
+  <pre>Retrieves a list of floodlight activities, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.floodlightActivityGroups.html b/docs/dyn/dfareporting_v2_6.floodlightActivityGroups.html
index 8eaac76214d..6f1bf5ba7a1 100644
--- a/docs/dyn/dfareporting_v2_6.floodlightActivityGroups.html
+++ b/docs/dyn/dfareporting_v2_6.floodlightActivityGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new floodlight activity group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, floodlightConfigurationId=None, ids=None, maxResults=None, sortOrder=None, type=None)</a></code></p>
-<p class="firstline">Retrieves a list of floodlight activity groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -229,7 +229,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, floodlightConfigurationId=None, ids=None, maxResults=None, sortOrder=None, type=None)</code>
-  <pre>Retrieves a list of floodlight activity groups, possibly filtered.
+  <pre>Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.inventoryItems.html b/docs/dyn/dfareporting_v2_6.inventoryItems.html
index 8154b322f47..611241b4793 100644
--- a/docs/dyn/dfareporting_v2_6.inventoryItems.html
+++ b/docs/dyn/dfareporting_v2_6.inventoryItems.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one inventory item by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, pageToken=None, inPlan=None, sortOrder=None, type=None, orderId=None, maxResults=None, siteId=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of inventory items, possibly filtered.</p>
+<p class="firstline">Retrieves a list of inventory items, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, pageToken=None, inPlan=None, sortOrder=None, type=None, orderId=None, maxResults=None, siteId=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of inventory items, possibly filtered.
+  <pre>Retrieves a list of inventory items, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.orderDocuments.html b/docs/dyn/dfareporting_v2_6.orderDocuments.html
index 527bb4be446..c1e4b3de226 100644
--- a/docs/dyn/dfareporting_v2_6.orderDocuments.html
+++ b/docs/dyn/dfareporting_v2_6.orderDocuments.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one order document by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of order documents, possibly filtered.</p>
+<p class="firstline">Retrieves a list of order documents, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -125,7 +125,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of order documents, possibly filtered.
+  <pre>Retrieves a list of order documents, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.orders.html b/docs/dyn/dfareporting_v2_6.orders.html
index 1060f328f01..a3aa09d5779 100644
--- a/docs/dyn/dfareporting_v2_6.orders.html
+++ b/docs/dyn/dfareporting_v2_6.orders.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one order by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, projectId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None, siteId=None)</a></code></p>
-<p class="firstline">Retrieves a list of orders, possibly filtered.</p>
+<p class="firstline">Retrieves a list of orders, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -138,7 +138,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, projectId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None, siteId=None)</code>
-  <pre>Retrieves a list of orders, possibly filtered.
+  <pre>Retrieves a list of orders, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.placementGroups.html b/docs/dyn/dfareporting_v2_6.placementGroups.html
index fa14392dca0..2aa4a297165 100644
--- a/docs/dyn/dfareporting_v2_6.placementGroups.html
+++ b/docs/dyn/dfareporting_v2_6.placementGroups.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement group.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, siteIds=None, placementGroupType=None, pricingTypes=None, campaignIds=None, advertiserIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, searchString=None, minEndDate=None, directorySiteIds=None, ids=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of placement groups, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placement groups, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -406,7 +406,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, siteIds=None, placementGroupType=None, pricingTypes=None, campaignIds=None, advertiserIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, searchString=None, minEndDate=None, directorySiteIds=None, ids=None, sortField=None)</code>
-  <pre>Retrieves a list of placement groups, possibly filtered.
+  <pre>Retrieves a list of placement groups, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.placementStrategies.html b/docs/dyn/dfareporting_v2_6.placementStrategies.html
index f70d7d736d4..325f59a9b8a 100644
--- a/docs/dyn/dfareporting_v2_6.placementStrategies.html
+++ b/docs/dyn/dfareporting_v2_6.placementStrategies.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement strategy.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of placement strategies, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placement strategies, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -155,7 +155,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of placement strategies, possibly filtered.
+  <pre>Retrieves a list of placement strategies, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.placements.html b/docs/dyn/dfareporting_v2_6.placements.html
index 95794e2e36e..19b17bc89fe 100644
--- a/docs/dyn/dfareporting_v2_6.placements.html
+++ b/docs/dyn/dfareporting_v2_6.placements.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new placement.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, siteIds=None, paymentSource=None, pricingTypes=None, campaignIds=None, advertiserIds=None, sizeIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, compatibilities=None, searchString=None, minEndDate=None, directorySiteIds=None, sortField=None, ids=None, groupIds=None)</a></code></p>
-<p class="firstline">Retrieves a list of placements, possibly filtered.</p>
+<p class="firstline">Retrieves a list of placements, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -580,7 +580,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, siteIds=None, paymentSource=None, pricingTypes=None, campaignIds=None, advertiserIds=None, sizeIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, compatibilities=None, searchString=None, minEndDate=None, directorySiteIds=None, sortField=None, ids=None, groupIds=None)</code>
-  <pre>Retrieves a list of placements, possibly filtered.
+  <pre>Retrieves a list of placements, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.projects.html b/docs/dyn/dfareporting_v2_6.projects.html
index aec315beb7f..a9ac1daa062 100644
--- a/docs/dyn/dfareporting_v2_6.projects.html
+++ b/docs/dyn/dfareporting_v2_6.projects.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one project by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of projects, possibly filtered.</p>
+<p class="firstline">Retrieves a list of projects, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -125,7 +125,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of projects, possibly filtered.
+  <pre>Retrieves a list of projects, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.remarketingLists.html b/docs/dyn/dfareporting_v2_6.remarketingLists.html
index ef430bedba1..d85f1d85f8e 100644
--- a/docs/dyn/dfareporting_v2_6.remarketingLists.html
+++ b/docs/dyn/dfareporting_v2_6.remarketingLists.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new remarketing list.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, floodlightActivityId=None, maxResults=None, active=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of remarketing lists, possibly filtered.</p>
+<p class="firstline">Retrieves a list of remarketing lists, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -247,7 +247,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, floodlightActivityId=None, maxResults=None, active=None, sortOrder=None)</code>
-  <pre>Retrieves a list of remarketing lists, possibly filtered.
+  <pre>Retrieves a list of remarketing lists, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.sites.html b/docs/dyn/dfareporting_v2_6.sites.html
index db5442c46f9..0b0556bea57 100644
--- a/docs/dyn/dfareporting_v2_6.sites.html
+++ b/docs/dyn/dfareporting_v2_6.sites.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new site.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, unmappedSite=None, campaignIds=None, acceptsInStreamVideoPlacements=None, pageToken=None, acceptsPublisherPaidPlacements=None, sortOrder=None, acceptsInterstitialPlacements=None, maxResults=None, adWordsSite=None, approved=None, searchString=None, subaccountId=None, directorySiteIds=None, sortField=None, ids=None)</a></code></p>
-<p class="firstline">Retrieves a list of sites, possibly filtered.</p>
+<p class="firstline">Retrieves a list of sites, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -298,7 +298,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, unmappedSite=None, campaignIds=None, acceptsInStreamVideoPlacements=None, pageToken=None, acceptsPublisherPaidPlacements=None, sortOrder=None, acceptsInterstitialPlacements=None, maxResults=None, adWordsSite=None, approved=None, searchString=None, subaccountId=None, directorySiteIds=None, sortField=None, ids=None)</code>
-  <pre>Retrieves a list of sites, possibly filtered.
+  <pre>Retrieves a list of sites, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.subaccounts.html b/docs/dyn/dfareporting_v2_6.subaccounts.html
index dc4987ea837..371cc86c305 100644
--- a/docs/dyn/dfareporting_v2_6.subaccounts.html
+++ b/docs/dyn/dfareporting_v2_6.subaccounts.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new subaccount.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Gets a list of subaccounts, possibly filtered.</p>
+<p class="firstline">Gets a list of subaccounts, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -151,7 +151,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Gets a list of subaccounts, possibly filtered.
+  <pre>Gets a list of subaccounts, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.targetableRemarketingLists.html b/docs/dyn/dfareporting_v2_6.targetableRemarketingLists.html
index 4846a135290..89df14b1887 100644
--- a/docs/dyn/dfareporting_v2_6.targetableRemarketingLists.html
+++ b/docs/dyn/dfareporting_v2_6.targetableRemarketingLists.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Gets one remarketing list by ID.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, maxResults=None, active=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of targetable remarketing lists, possibly filtered.</p>
+<p class="firstline">Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -120,7 +120,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, maxResults=None, active=None, sortOrder=None)</code>
-  <pre>Retrieves a list of targetable remarketing lists, possibly filtered.
+  <pre>Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.targetingTemplates.html b/docs/dyn/dfareporting_v2_6.targetingTemplates.html
index 916643dfc79..862e8a04c3c 100644
--- a/docs/dyn/dfareporting_v2_6.targetingTemplates.html
+++ b/docs/dyn/dfareporting_v2_6.targetingTemplates.html
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new targeting template.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
-<p class="firstline">Retrieves a list of targeting templates, optionally filtered.</p>
+<p class="firstline">Retrieves a list of targeting templates, optionally filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -619,7 +619,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
-  <pre>Retrieves a list of targeting templates, optionally filtered.
+  <pre>Retrieves a list of targeting templates, optionally filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_6.userRoles.html b/docs/dyn/dfareporting_v2_6.userRoles.html
index 1ae136739d8..a53ed144125 100644
--- a/docs/dyn/dfareporting_v2_6.userRoles.html
+++ b/docs/dyn/dfareporting_v2_6.userRoles.html
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Inserts a new user role.</p>
 <p class="toc_element">
   <code><a href="#list">list(profileId, searchString=None, subaccountId=None, pageToken=None, ids=None, maxResults=None, accountUserRoleOnly=None, sortOrder=None, sortField=None)</a></code></p>
-<p class="firstline">Retrieves a list of user roles, possibly filtered.</p>
+<p class="firstline">Retrieves a list of user roles, possibly filtered. This method supports paging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -191,7 +191,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="list">list(profileId, searchString=None, subaccountId=None, pageToken=None, ids=None, maxResults=None, accountUserRoleOnly=None, sortOrder=None, sortField=None)</code>
-  <pre>Retrieves a list of user roles, possibly filtered.
+  <pre>Retrieves a list of user roles, possibly filtered. This method supports paging.
 
 Args:
   profileId: string, User profile ID associated with this request. (required)
diff --git a/docs/dyn/dfareporting_v2_7.accountActiveAdSummaries.html b/docs/dyn/dfareporting_v2_7.accountActiveAdSummaries.html
new file mode 100644
index 00000000000..7aab32f062c
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.accountActiveAdSummaries.html
@@ -0,0 +1,101 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.accountActiveAdSummaries.html">accountActiveAdSummaries</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, summaryAccountId)</a></code></p>
+<p class="firstline">Gets the account's active ad summary by account ID.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, summaryAccountId)</code>
+  <pre>Gets the account's active ad summary by account ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  summaryAccountId: string, Account ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Gets a summary of active ads in an account.
+    "availableAds": "A String", # Ads that can be activated for the account.
+    "kind": "dfareporting#accountActiveAdSummary", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountActiveAdSummary".
+    "activeAdsLimitTier": "A String", # Maximum number of active ads allowed for the account.
+    "activeAds": "A String", # Ads that have been activated for the account
+    "accountId": "A String", # ID of the account.
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.accountPermissionGroups.html b/docs/dyn/dfareporting_v2_7.accountPermissionGroups.html
new file mode 100644
index 00000000000..87d501603a0
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.accountPermissionGroups.html
@@ -0,0 +1,124 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.accountPermissionGroups.html">accountPermissionGroups</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one account permission group by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves the list of account permission groups.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one account permission group by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Account permission group ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # AccountPermissionGroups contains a mapping of permission group IDs to names. A permission group is a grouping of account permissions.
+    "kind": "dfareporting#accountPermissionGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountPermissionGroup".
+    "id": "A String", # ID of this account permission group.
+    "name": "A String", # Name of this account permission group.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves the list of account permission groups.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Account Permission Group List Response
+    "kind": "dfareporting#accountPermissionGroupsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountPermissionGroupsListResponse".
+    "accountPermissionGroups": [ # Account permission group collection.
+      { # AccountPermissionGroups contains a mapping of permission group IDs to names. A permission group is a grouping of account permissions.
+        "kind": "dfareporting#accountPermissionGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountPermissionGroup".
+        "id": "A String", # ID of this account permission group.
+        "name": "A String", # Name of this account permission group.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.accountPermissions.html b/docs/dyn/dfareporting_v2_7.accountPermissions.html
new file mode 100644
index 00000000000..868aca8ecfc
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.accountPermissions.html
@@ -0,0 +1,142 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.accountPermissions.html">accountPermissions</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one account permission by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves the list of account permissions.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one account permission by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Account permission ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # AccountPermissions contains information about a particular account permission. Some features of DCM require an account permission to be present in the account.
+    "kind": "dfareporting#accountPermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountPermission".
+    "name": "A String", # Name of this account permission.
+    "level": "A String", # Administrative level required to enable this account permission.
+    "permissionGroupId": "A String", # Permission group of this account permission.
+    "accountProfiles": [ # Account profiles associated with this account permission.
+        #
+        # Possible values are:
+        # - "ACCOUNT_PROFILE_BASIC"
+        # - "ACCOUNT_PROFILE_STANDARD"
+      "A String",
+    ],
+    "id": "A String", # ID of this account permission.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves the list of account permissions.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Account Permission List Response
+    "accountPermissions": [ # Account permission collection.
+      { # AccountPermissions contains information about a particular account permission. Some features of DCM require an account permission to be present in the account.
+        "kind": "dfareporting#accountPermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountPermission".
+        "name": "A String", # Name of this account permission.
+        "level": "A String", # Administrative level required to enable this account permission.
+        "permissionGroupId": "A String", # Permission group of this account permission.
+        "accountProfiles": [ # Account profiles associated with this account permission.
+            #
+            # Possible values are:
+            # - "ACCOUNT_PROFILE_BASIC"
+            # - "ACCOUNT_PROFILE_STANDARD"
+          "A String",
+        ],
+        "id": "A String", # ID of this account permission.
+      },
+    ],
+    "kind": "dfareporting#accountPermissionsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountPermissionsListResponse".
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.accountUserProfiles.html b/docs/dyn/dfareporting_v2_7.accountUserProfiles.html
new file mode 100644
index 00000000000..07e54779ba5
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.accountUserProfiles.html
@@ -0,0 +1,677 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.accountUserProfiles.html">accountUserProfiles</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one account user profile by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new account user profile.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, subaccountId=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, userRoleId=None, active=None)</a></code></p>
+<p class="firstline">Retrieves a list of account user profiles, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing account user profile. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing account user profile.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one account user profile by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, User profile ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # AccountUserProfiles contains properties of a DCM user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.
+      "kind": "dfareporting#accountUserProfile", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfile".
+      "subaccountId": "A String", # Subaccount ID of the user profile. This is a read-only field that can be left blank.
+      "name": "A String", # Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: "&;"#%,".
+      "userRoleFilter": { # Object Filter. # Filter that describes which user roles are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "locale": "A String", # Locale of the user profile. This is a required field.
+          # Acceptable values are:
+          # - "cs" (Czech)
+          # - "de" (German)
+          # - "en" (English)
+          # - "en-GB" (English United Kingdom)
+          # - "es" (Spanish)
+          # - "fr" (French)
+          # - "it" (Italian)
+          # - "ja" (Japanese)
+          # - "ko" (Korean)
+          # - "pl" (Polish)
+          # - "pt-BR" (Portuguese Brazil)
+          # - "ru" (Russian)
+          # - "sv" (Swedish)
+          # - "tr" (Turkish)
+          # - "zh-CN" (Chinese Simplified)
+          # - "zh-TW" (Chinese Traditional)
+      "siteFilter": { # Object Filter. # Filter that describes which sites are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "comments": "A String", # Comments for this user profile.
+      "id": "A String", # ID of the user profile. This is a read-only, auto-generated field.
+      "advertiserFilter": { # Object Filter. # Filter that describes which advertisers are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "campaignFilter": { # Object Filter. # Filter that describes which campaigns are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "userRoleId": "A String", # User role ID of the user profile. This is a required field.
+      "userAccessType": "A String", # User type of the user profile. This is a read-only field that can be left blank.
+      "traffickerType": "A String", # Trafficker type of this user profile.
+      "active": True or False, # Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.
+      "email": "A String", # Email of the user profile. The email addresss must be linked to a Google Account. This field is required on insertion and is read-only after insertion.
+      "accountId": "A String", # Account ID of the user profile. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new account user profile.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # AccountUserProfiles contains properties of a DCM user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.
+    "kind": "dfareporting#accountUserProfile", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfile".
+    "subaccountId": "A String", # Subaccount ID of the user profile. This is a read-only field that can be left blank.
+    "name": "A String", # Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: "&;"#%,".
+    "userRoleFilter": { # Object Filter. # Filter that describes which user roles are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "locale": "A String", # Locale of the user profile. This is a required field.
+        # Acceptable values are:
+        # - "cs" (Czech)
+        # - "de" (German)
+        # - "en" (English)
+        # - "en-GB" (English United Kingdom)
+        # - "es" (Spanish)
+        # - "fr" (French)
+        # - "it" (Italian)
+        # - "ja" (Japanese)
+        # - "ko" (Korean)
+        # - "pl" (Polish)
+        # - "pt-BR" (Portuguese Brazil)
+        # - "ru" (Russian)
+        # - "sv" (Swedish)
+        # - "tr" (Turkish)
+        # - "zh-CN" (Chinese Simplified)
+        # - "zh-TW" (Chinese Traditional)
+    "siteFilter": { # Object Filter. # Filter that describes which sites are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "comments": "A String", # Comments for this user profile.
+    "id": "A String", # ID of the user profile. This is a read-only, auto-generated field.
+    "advertiserFilter": { # Object Filter. # Filter that describes which advertisers are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "campaignFilter": { # Object Filter. # Filter that describes which campaigns are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "userRoleId": "A String", # User role ID of the user profile. This is a required field.
+    "userAccessType": "A String", # User type of the user profile. This is a read-only field that can be left blank.
+    "traffickerType": "A String", # Trafficker type of this user profile.
+    "active": True or False, # Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.
+    "email": "A String", # Email of the user profile. The email addresss must be linked to a Google Account. This field is required on insertion and is read-only after insertion.
+    "accountId": "A String", # Account ID of the user profile. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # AccountUserProfiles contains properties of a DCM user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.
+      "kind": "dfareporting#accountUserProfile", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfile".
+      "subaccountId": "A String", # Subaccount ID of the user profile. This is a read-only field that can be left blank.
+      "name": "A String", # Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: "&;"#%,".
+      "userRoleFilter": { # Object Filter. # Filter that describes which user roles are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "locale": "A String", # Locale of the user profile. This is a required field.
+          # Acceptable values are:
+          # - "cs" (Czech)
+          # - "de" (German)
+          # - "en" (English)
+          # - "en-GB" (English United Kingdom)
+          # - "es" (Spanish)
+          # - "fr" (French)
+          # - "it" (Italian)
+          # - "ja" (Japanese)
+          # - "ko" (Korean)
+          # - "pl" (Polish)
+          # - "pt-BR" (Portuguese Brazil)
+          # - "ru" (Russian)
+          # - "sv" (Swedish)
+          # - "tr" (Turkish)
+          # - "zh-CN" (Chinese Simplified)
+          # - "zh-TW" (Chinese Traditional)
+      "siteFilter": { # Object Filter. # Filter that describes which sites are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "comments": "A String", # Comments for this user profile.
+      "id": "A String", # ID of the user profile. This is a read-only, auto-generated field.
+      "advertiserFilter": { # Object Filter. # Filter that describes which advertisers are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "campaignFilter": { # Object Filter. # Filter that describes which campaigns are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "userRoleId": "A String", # User role ID of the user profile. This is a required field.
+      "userAccessType": "A String", # User type of the user profile. This is a read-only field that can be left blank.
+      "traffickerType": "A String", # Trafficker type of this user profile.
+      "active": True or False, # Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.
+      "email": "A String", # Email of the user profile. The email addresss must be linked to a Google Account. This field is required on insertion and is read-only after insertion.
+      "accountId": "A String", # Account ID of the user profile. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, subaccountId=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, userRoleId=None, active=None)</code>
+  <pre>Retrieves a list of account user profiles, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for objects by name, ID or email. Wildcards (*) are allowed. For example, "user profile*2015" will return objects with names like "user profile June 2015", "user profile April 2015", or simply "user profile 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "user profile" will match objects with name "my user profile", "user profile 2015", or simply "user profile".
+  subaccountId: string, Select only user profiles with the specified subaccount ID.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only user profiles with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  userRoleId: string, Select only user profiles with the specified user role ID.
+  active: boolean, Select only active user profiles.
+
+Returns:
+  An object of the form:
+
+    { # Account User Profile List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "accountUserProfiles": [ # Account user profile collection.
+      { # AccountUserProfiles contains properties of a DCM user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.
+          "kind": "dfareporting#accountUserProfile", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfile".
+          "subaccountId": "A String", # Subaccount ID of the user profile. This is a read-only field that can be left blank.
+          "name": "A String", # Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: "&;"#%,".
+          "userRoleFilter": { # Object Filter. # Filter that describes which user roles are visible to the user profile.
+            "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+              "A String",
+            ],
+            "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+            "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+          },
+          "locale": "A String", # Locale of the user profile. This is a required field.
+              # Acceptable values are:
+              # - "cs" (Czech)
+              # - "de" (German)
+              # - "en" (English)
+              # - "en-GB" (English United Kingdom)
+              # - "es" (Spanish)
+              # - "fr" (French)
+              # - "it" (Italian)
+              # - "ja" (Japanese)
+              # - "ko" (Korean)
+              # - "pl" (Polish)
+              # - "pt-BR" (Portuguese Brazil)
+              # - "ru" (Russian)
+              # - "sv" (Swedish)
+              # - "tr" (Turkish)
+              # - "zh-CN" (Chinese Simplified)
+              # - "zh-TW" (Chinese Traditional)
+          "siteFilter": { # Object Filter. # Filter that describes which sites are visible to the user profile.
+            "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+              "A String",
+            ],
+            "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+            "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+          },
+          "comments": "A String", # Comments for this user profile.
+          "id": "A String", # ID of the user profile. This is a read-only, auto-generated field.
+          "advertiserFilter": { # Object Filter. # Filter that describes which advertisers are visible to the user profile.
+            "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+              "A String",
+            ],
+            "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+            "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+          },
+          "campaignFilter": { # Object Filter. # Filter that describes which campaigns are visible to the user profile.
+            "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+              "A String",
+            ],
+            "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+            "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+          },
+          "userRoleId": "A String", # User role ID of the user profile. This is a required field.
+          "userAccessType": "A String", # User type of the user profile. This is a read-only field that can be left blank.
+          "traffickerType": "A String", # Trafficker type of this user profile.
+          "active": True or False, # Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.
+          "email": "A String", # Email of the user profile. The email addresss must be linked to a Google Account. This field is required on insertion and is read-only after insertion.
+          "accountId": "A String", # Account ID of the user profile. This is a read-only field that can be left blank.
+        },
+    ],
+    "kind": "dfareporting#accountUserProfilesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfilesListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing account user profile. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, User profile ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # AccountUserProfiles contains properties of a DCM user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.
+    "kind": "dfareporting#accountUserProfile", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfile".
+    "subaccountId": "A String", # Subaccount ID of the user profile. This is a read-only field that can be left blank.
+    "name": "A String", # Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: "&;"#%,".
+    "userRoleFilter": { # Object Filter. # Filter that describes which user roles are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "locale": "A String", # Locale of the user profile. This is a required field.
+        # Acceptable values are:
+        # - "cs" (Czech)
+        # - "de" (German)
+        # - "en" (English)
+        # - "en-GB" (English United Kingdom)
+        # - "es" (Spanish)
+        # - "fr" (French)
+        # - "it" (Italian)
+        # - "ja" (Japanese)
+        # - "ko" (Korean)
+        # - "pl" (Polish)
+        # - "pt-BR" (Portuguese Brazil)
+        # - "ru" (Russian)
+        # - "sv" (Swedish)
+        # - "tr" (Turkish)
+        # - "zh-CN" (Chinese Simplified)
+        # - "zh-TW" (Chinese Traditional)
+    "siteFilter": { # Object Filter. # Filter that describes which sites are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "comments": "A String", # Comments for this user profile.
+    "id": "A String", # ID of the user profile. This is a read-only, auto-generated field.
+    "advertiserFilter": { # Object Filter. # Filter that describes which advertisers are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "campaignFilter": { # Object Filter. # Filter that describes which campaigns are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "userRoleId": "A String", # User role ID of the user profile. This is a required field.
+    "userAccessType": "A String", # User type of the user profile. This is a read-only field that can be left blank.
+    "traffickerType": "A String", # Trafficker type of this user profile.
+    "active": True or False, # Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.
+    "email": "A String", # Email of the user profile. The email addresss must be linked to a Google Account. This field is required on insertion and is read-only after insertion.
+    "accountId": "A String", # Account ID of the user profile. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # AccountUserProfiles contains properties of a DCM user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.
+      "kind": "dfareporting#accountUserProfile", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfile".
+      "subaccountId": "A String", # Subaccount ID of the user profile. This is a read-only field that can be left blank.
+      "name": "A String", # Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: "&;"#%,".
+      "userRoleFilter": { # Object Filter. # Filter that describes which user roles are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "locale": "A String", # Locale of the user profile. This is a required field.
+          # Acceptable values are:
+          # - "cs" (Czech)
+          # - "de" (German)
+          # - "en" (English)
+          # - "en-GB" (English United Kingdom)
+          # - "es" (Spanish)
+          # - "fr" (French)
+          # - "it" (Italian)
+          # - "ja" (Japanese)
+          # - "ko" (Korean)
+          # - "pl" (Polish)
+          # - "pt-BR" (Portuguese Brazil)
+          # - "ru" (Russian)
+          # - "sv" (Swedish)
+          # - "tr" (Turkish)
+          # - "zh-CN" (Chinese Simplified)
+          # - "zh-TW" (Chinese Traditional)
+      "siteFilter": { # Object Filter. # Filter that describes which sites are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "comments": "A String", # Comments for this user profile.
+      "id": "A String", # ID of the user profile. This is a read-only, auto-generated field.
+      "advertiserFilter": { # Object Filter. # Filter that describes which advertisers are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "campaignFilter": { # Object Filter. # Filter that describes which campaigns are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "userRoleId": "A String", # User role ID of the user profile. This is a required field.
+      "userAccessType": "A String", # User type of the user profile. This is a read-only field that can be left blank.
+      "traffickerType": "A String", # Trafficker type of this user profile.
+      "active": True or False, # Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.
+      "email": "A String", # Email of the user profile. The email addresss must be linked to a Google Account. This field is required on insertion and is read-only after insertion.
+      "accountId": "A String", # Account ID of the user profile. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing account user profile.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # AccountUserProfiles contains properties of a DCM user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.
+    "kind": "dfareporting#accountUserProfile", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfile".
+    "subaccountId": "A String", # Subaccount ID of the user profile. This is a read-only field that can be left blank.
+    "name": "A String", # Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: "&;"#%,".
+    "userRoleFilter": { # Object Filter. # Filter that describes which user roles are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "locale": "A String", # Locale of the user profile. This is a required field.
+        # Acceptable values are:
+        # - "cs" (Czech)
+        # - "de" (German)
+        # - "en" (English)
+        # - "en-GB" (English United Kingdom)
+        # - "es" (Spanish)
+        # - "fr" (French)
+        # - "it" (Italian)
+        # - "ja" (Japanese)
+        # - "ko" (Korean)
+        # - "pl" (Polish)
+        # - "pt-BR" (Portuguese Brazil)
+        # - "ru" (Russian)
+        # - "sv" (Swedish)
+        # - "tr" (Turkish)
+        # - "zh-CN" (Chinese Simplified)
+        # - "zh-TW" (Chinese Traditional)
+    "siteFilter": { # Object Filter. # Filter that describes which sites are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "comments": "A String", # Comments for this user profile.
+    "id": "A String", # ID of the user profile. This is a read-only, auto-generated field.
+    "advertiserFilter": { # Object Filter. # Filter that describes which advertisers are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "campaignFilter": { # Object Filter. # Filter that describes which campaigns are visible to the user profile.
+      "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+        "A String",
+      ],
+      "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+      "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+    },
+    "userRoleId": "A String", # User role ID of the user profile. This is a required field.
+    "userAccessType": "A String", # User type of the user profile. This is a read-only field that can be left blank.
+    "traffickerType": "A String", # Trafficker type of this user profile.
+    "active": True or False, # Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.
+    "email": "A String", # Email of the user profile. The email addresss must be linked to a Google Account. This field is required on insertion and is read-only after insertion.
+    "accountId": "A String", # Account ID of the user profile. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # AccountUserProfiles contains properties of a DCM user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.
+      "kind": "dfareporting#accountUserProfile", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountUserProfile".
+      "subaccountId": "A String", # Subaccount ID of the user profile. This is a read-only field that can be left blank.
+      "name": "A String", # Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: "&;"#%,".
+      "userRoleFilter": { # Object Filter. # Filter that describes which user roles are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "locale": "A String", # Locale of the user profile. This is a required field.
+          # Acceptable values are:
+          # - "cs" (Czech)
+          # - "de" (German)
+          # - "en" (English)
+          # - "en-GB" (English United Kingdom)
+          # - "es" (Spanish)
+          # - "fr" (French)
+          # - "it" (Italian)
+          # - "ja" (Japanese)
+          # - "ko" (Korean)
+          # - "pl" (Polish)
+          # - "pt-BR" (Portuguese Brazil)
+          # - "ru" (Russian)
+          # - "sv" (Swedish)
+          # - "tr" (Turkish)
+          # - "zh-CN" (Chinese Simplified)
+          # - "zh-TW" (Chinese Traditional)
+      "siteFilter": { # Object Filter. # Filter that describes which sites are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "comments": "A String", # Comments for this user profile.
+      "id": "A String", # ID of the user profile. This is a read-only, auto-generated field.
+      "advertiserFilter": { # Object Filter. # Filter that describes which advertisers are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "campaignFilter": { # Object Filter. # Filter that describes which campaigns are visible to the user profile.
+        "objectIds": [ # Applicable when status is ASSIGNED. The user has access to objects with these object IDs.
+          "A String",
+        ],
+        "status": "A String", # Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.
+        "kind": "dfareporting#objectFilter", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#objectFilter".
+      },
+      "userRoleId": "A String", # User role ID of the user profile. This is a required field.
+      "userAccessType": "A String", # User type of the user profile. This is a read-only field that can be left blank.
+      "traffickerType": "A String", # Trafficker type of this user profile.
+      "active": True or False, # Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.
+      "email": "A String", # Email of the user profile. The email addresss must be linked to a Google Account. This field is required on insertion and is read-only after insertion.
+      "accountId": "A String", # Account ID of the user profile. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.accounts.html b/docs/dyn/dfareporting_v2_7.accounts.html
new file mode 100644
index 00000000000..48a1a23a7a1
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.accounts.html
@@ -0,0 +1,856 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.accounts.html">accounts</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one account by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, active=None)</a></code></p>
+<p class="firstline">Retrieves the list of accounts, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing account. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing account.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one account by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Account ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM account.
+      "kind": "dfareporting#account", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#account".
+      "countryId": "A String", # ID of the country associated with this account.
+      "availablePermissionIds": [ # User role permissions available to the user roles of this account.
+        "A String",
+      ],
+      "description": "A String", # Description of this account.
+      "maximumImageSize": "A String", # Maximum image size allowed for this account.
+      "currencyId": "A String", # ID of currency associated with this account. This is a required field.
+          # Acceptable values are:
+          # - "1" for USD
+          # - "2" for GBP
+          # - "3" for ESP
+          # - "4" for SEK
+          # - "5" for CAD
+          # - "6" for JPY
+          # - "7" for DEM
+          # - "8" for AUD
+          # - "9" for FRF
+          # - "10" for ITL
+          # - "11" for DKK
+          # - "12" for NOK
+          # - "13" for FIM
+          # - "14" for ZAR
+          # - "15" for IEP
+          # - "16" for NLG
+          # - "17" for EUR
+          # - "18" for KRW
+          # - "19" for TWD
+          # - "20" for SGD
+          # - "21" for CNY
+          # - "22" for HKD
+          # - "23" for NZD
+          # - "24" for MYR
+          # - "25" for BRL
+          # - "26" for PTE
+          # - "27" for MXP
+          # - "28" for CLP
+          # - "29" for TRY
+          # - "30" for ARS
+          # - "31" for PEN
+          # - "32" for ILS
+          # - "33" for CHF
+          # - "34" for VEF
+          # - "35" for COP
+          # - "36" for GTQ
+          # - "37" for PLN
+          # - "39" for INR
+          # - "40" for THB
+          # - "41" for IDR
+          # - "42" for CZK
+          # - "43" for RON
+          # - "44" for HUF
+          # - "45" for RUB
+          # - "46" for AED
+          # - "47" for BGN
+          # - "48" for HRK
+      "defaultCreativeSizeId": "A String", # Default placement dimensions for this account.
+      "accountPermissionIds": [ # Account permissions assigned to this account.
+        "A String",
+      ],
+      "nielsenOcrEnabled": True or False, # Whether campaigns created in this account will be enabled for Nielsen OCR reach ratings by default.
+      "accountProfile": "A String", # Profile for this account. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this account. This is a required field, and must be less than 128 characters long and be globally unique.
+      "locale": "A String", # Locale of this account.
+          # Acceptable values are:
+          # - "cs" (Czech)
+          # - "de" (German)
+          # - "en" (English)
+          # - "en-GB" (English United Kingdom)
+          # - "es" (Spanish)
+          # - "fr" (French)
+          # - "it" (Italian)
+          # - "ja" (Japanese)
+          # - "ko" (Korean)
+          # - "pl" (Polish)
+          # - "pt-BR" (Portuguese Brazil)
+          # - "ru" (Russian)
+          # - "sv" (Swedish)
+          # - "tr" (Turkish)
+          # - "zh-CN" (Chinese Simplified)
+          # - "zh-TW" (Chinese Traditional)
+      "teaserSizeLimit": "A String", # File size limit in kilobytes of Rich Media teaser creatives. Must be between 1 and 10240.
+      "reportsConfiguration": { # Reporting Configuration # Reporting configuration of this account.
+        "reportGenerationTimeZoneId": "A String", # Report generation time zone ID of this account. This is a required field that can only be changed by a superuser.
+            # Acceptable values are:
+            #
+            # - "1" for "America/New_York"
+            # - "2" for "Europe/London"
+            # - "3" for "Europe/Paris"
+            # - "4" for "Africa/Johannesburg"
+            # - "5" for "Asia/Jerusalem"
+            # - "6" for "Asia/Shanghai"
+            # - "7" for "Asia/Hong_Kong"
+            # - "8" for "Asia/Tokyo"
+            # - "9" for "Australia/Sydney"
+            # - "10" for "Asia/Dubai"
+            # - "11" for "America/Los_Angeles"
+            # - "12" for "Pacific/Auckland"
+            # - "13" for "America/Sao_Paulo"
+        "exposureToConversionEnabled": True or False, # Whether the exposure to conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+        "lookbackConfiguration": { # Lookback configuration settings. # Default lookback windows for new advertisers in this account.
+          "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        },
+      },
+      "active": True or False, # Whether this account is active.
+      "activeViewOptOut": True or False, # Whether to serve creatives with Active View tags. If disabled, viewability data will not be available for any impressions.
+      "shareReportsWithTwitter": True or False, # Share Path to Conversion reports with Twitter.
+      "id": "A String", # ID of this account. This is a read-only, auto-generated field.
+      "activeAdsLimitTier": "A String", # Maximum number of active ads allowed for this account.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None, active=None)</code>
+  <pre>Retrieves the list of accounts, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "account*2015" will return objects with names like "account June 2015", "account April 2015", or simply "account 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "account" will match objects with name "my account", "account 2015", or simply "account".
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only accounts with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  active: boolean, Select only active accounts. Don't set this field to select both active and non-active accounts.
+
+Returns:
+  An object of the form:
+
+    { # Account List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#accountsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#accountsListResponse".
+    "accounts": [ # Account collection.
+      { # Contains properties of a DCM account.
+          "kind": "dfareporting#account", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#account".
+          "countryId": "A String", # ID of the country associated with this account.
+          "availablePermissionIds": [ # User role permissions available to the user roles of this account.
+            "A String",
+          ],
+          "description": "A String", # Description of this account.
+          "maximumImageSize": "A String", # Maximum image size allowed for this account.
+          "currencyId": "A String", # ID of currency associated with this account. This is a required field.
+              # Acceptable values are:
+              # - "1" for USD
+              # - "2" for GBP
+              # - "3" for ESP
+              # - "4" for SEK
+              # - "5" for CAD
+              # - "6" for JPY
+              # - "7" for DEM
+              # - "8" for AUD
+              # - "9" for FRF
+              # - "10" for ITL
+              # - "11" for DKK
+              # - "12" for NOK
+              # - "13" for FIM
+              # - "14" for ZAR
+              # - "15" for IEP
+              # - "16" for NLG
+              # - "17" for EUR
+              # - "18" for KRW
+              # - "19" for TWD
+              # - "20" for SGD
+              # - "21" for CNY
+              # - "22" for HKD
+              # - "23" for NZD
+              # - "24" for MYR
+              # - "25" for BRL
+              # - "26" for PTE
+              # - "27" for MXP
+              # - "28" for CLP
+              # - "29" for TRY
+              # - "30" for ARS
+              # - "31" for PEN
+              # - "32" for ILS
+              # - "33" for CHF
+              # - "34" for VEF
+              # - "35" for COP
+              # - "36" for GTQ
+              # - "37" for PLN
+              # - "39" for INR
+              # - "40" for THB
+              # - "41" for IDR
+              # - "42" for CZK
+              # - "43" for RON
+              # - "44" for HUF
+              # - "45" for RUB
+              # - "46" for AED
+              # - "47" for BGN
+              # - "48" for HRK
+          "defaultCreativeSizeId": "A String", # Default placement dimensions for this account.
+          "accountPermissionIds": [ # Account permissions assigned to this account.
+            "A String",
+          ],
+          "nielsenOcrEnabled": True or False, # Whether campaigns created in this account will be enabled for Nielsen OCR reach ratings by default.
+          "accountProfile": "A String", # Profile for this account. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this account. This is a required field, and must be less than 128 characters long and be globally unique.
+          "locale": "A String", # Locale of this account.
+              # Acceptable values are:
+              # - "cs" (Czech)
+              # - "de" (German)
+              # - "en" (English)
+              # - "en-GB" (English United Kingdom)
+              # - "es" (Spanish)
+              # - "fr" (French)
+              # - "it" (Italian)
+              # - "ja" (Japanese)
+              # - "ko" (Korean)
+              # - "pl" (Polish)
+              # - "pt-BR" (Portuguese Brazil)
+              # - "ru" (Russian)
+              # - "sv" (Swedish)
+              # - "tr" (Turkish)
+              # - "zh-CN" (Chinese Simplified)
+              # - "zh-TW" (Chinese Traditional)
+          "teaserSizeLimit": "A String", # File size limit in kilobytes of Rich Media teaser creatives. Must be between 1 and 10240.
+          "reportsConfiguration": { # Reporting Configuration # Reporting configuration of this account.
+            "reportGenerationTimeZoneId": "A String", # Report generation time zone ID of this account. This is a required field that can only be changed by a superuser.
+                # Acceptable values are:
+                #
+                # - "1" for "America/New_York"
+                # - "2" for "Europe/London"
+                # - "3" for "Europe/Paris"
+                # - "4" for "Africa/Johannesburg"
+                # - "5" for "Asia/Jerusalem"
+                # - "6" for "Asia/Shanghai"
+                # - "7" for "Asia/Hong_Kong"
+                # - "8" for "Asia/Tokyo"
+                # - "9" for "Australia/Sydney"
+                # - "10" for "Asia/Dubai"
+                # - "11" for "America/Los_Angeles"
+                # - "12" for "Pacific/Auckland"
+                # - "13" for "America/Sao_Paulo"
+            "exposureToConversionEnabled": True or False, # Whether the exposure to conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+            "lookbackConfiguration": { # Lookback configuration settings. # Default lookback windows for new advertisers in this account.
+              "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+              "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+            },
+          },
+          "active": True or False, # Whether this account is active.
+          "activeViewOptOut": True or False, # Whether to serve creatives with Active View tags. If disabled, viewability data will not be available for any impressions.
+          "shareReportsWithTwitter": True or False, # Share Path to Conversion reports with Twitter.
+          "id": "A String", # ID of this account. This is a read-only, auto-generated field.
+          "activeAdsLimitTier": "A String", # Maximum number of active ads allowed for this account.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing account. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Account ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM account.
+    "kind": "dfareporting#account", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#account".
+    "countryId": "A String", # ID of the country associated with this account.
+    "availablePermissionIds": [ # User role permissions available to the user roles of this account.
+      "A String",
+    ],
+    "description": "A String", # Description of this account.
+    "maximumImageSize": "A String", # Maximum image size allowed for this account.
+    "currencyId": "A String", # ID of currency associated with this account. This is a required field.
+        # Acceptable values are:
+        # - "1" for USD
+        # - "2" for GBP
+        # - "3" for ESP
+        # - "4" for SEK
+        # - "5" for CAD
+        # - "6" for JPY
+        # - "7" for DEM
+        # - "8" for AUD
+        # - "9" for FRF
+        # - "10" for ITL
+        # - "11" for DKK
+        # - "12" for NOK
+        # - "13" for FIM
+        # - "14" for ZAR
+        # - "15" for IEP
+        # - "16" for NLG
+        # - "17" for EUR
+        # - "18" for KRW
+        # - "19" for TWD
+        # - "20" for SGD
+        # - "21" for CNY
+        # - "22" for HKD
+        # - "23" for NZD
+        # - "24" for MYR
+        # - "25" for BRL
+        # - "26" for PTE
+        # - "27" for MXP
+        # - "28" for CLP
+        # - "29" for TRY
+        # - "30" for ARS
+        # - "31" for PEN
+        # - "32" for ILS
+        # - "33" for CHF
+        # - "34" for VEF
+        # - "35" for COP
+        # - "36" for GTQ
+        # - "37" for PLN
+        # - "39" for INR
+        # - "40" for THB
+        # - "41" for IDR
+        # - "42" for CZK
+        # - "43" for RON
+        # - "44" for HUF
+        # - "45" for RUB
+        # - "46" for AED
+        # - "47" for BGN
+        # - "48" for HRK
+    "defaultCreativeSizeId": "A String", # Default placement dimensions for this account.
+    "accountPermissionIds": [ # Account permissions assigned to this account.
+      "A String",
+    ],
+    "nielsenOcrEnabled": True or False, # Whether campaigns created in this account will be enabled for Nielsen OCR reach ratings by default.
+    "accountProfile": "A String", # Profile for this account. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this account. This is a required field, and must be less than 128 characters long and be globally unique.
+    "locale": "A String", # Locale of this account.
+        # Acceptable values are:
+        # - "cs" (Czech)
+        # - "de" (German)
+        # - "en" (English)
+        # - "en-GB" (English United Kingdom)
+        # - "es" (Spanish)
+        # - "fr" (French)
+        # - "it" (Italian)
+        # - "ja" (Japanese)
+        # - "ko" (Korean)
+        # - "pl" (Polish)
+        # - "pt-BR" (Portuguese Brazil)
+        # - "ru" (Russian)
+        # - "sv" (Swedish)
+        # - "tr" (Turkish)
+        # - "zh-CN" (Chinese Simplified)
+        # - "zh-TW" (Chinese Traditional)
+    "teaserSizeLimit": "A String", # File size limit in kilobytes of Rich Media teaser creatives. Must be between 1 and 10240.
+    "reportsConfiguration": { # Reporting Configuration # Reporting configuration of this account.
+      "reportGenerationTimeZoneId": "A String", # Report generation time zone ID of this account. This is a required field that can only be changed by a superuser.
+          # Acceptable values are:
+          #
+          # - "1" for "America/New_York"
+          # - "2" for "Europe/London"
+          # - "3" for "Europe/Paris"
+          # - "4" for "Africa/Johannesburg"
+          # - "5" for "Asia/Jerusalem"
+          # - "6" for "Asia/Shanghai"
+          # - "7" for "Asia/Hong_Kong"
+          # - "8" for "Asia/Tokyo"
+          # - "9" for "Australia/Sydney"
+          # - "10" for "Asia/Dubai"
+          # - "11" for "America/Los_Angeles"
+          # - "12" for "Pacific/Auckland"
+          # - "13" for "America/Sao_Paulo"
+      "exposureToConversionEnabled": True or False, # Whether the exposure to conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+      "lookbackConfiguration": { # Lookback configuration settings. # Default lookback windows for new advertisers in this account.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+    },
+    "active": True or False, # Whether this account is active.
+    "activeViewOptOut": True or False, # Whether to serve creatives with Active View tags. If disabled, viewability data will not be available for any impressions.
+    "shareReportsWithTwitter": True or False, # Share Path to Conversion reports with Twitter.
+    "id": "A String", # ID of this account. This is a read-only, auto-generated field.
+    "activeAdsLimitTier": "A String", # Maximum number of active ads allowed for this account.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM account.
+      "kind": "dfareporting#account", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#account".
+      "countryId": "A String", # ID of the country associated with this account.
+      "availablePermissionIds": [ # User role permissions available to the user roles of this account.
+        "A String",
+      ],
+      "description": "A String", # Description of this account.
+      "maximumImageSize": "A String", # Maximum image size allowed for this account.
+      "currencyId": "A String", # ID of currency associated with this account. This is a required field.
+          # Acceptable values are:
+          # - "1" for USD
+          # - "2" for GBP
+          # - "3" for ESP
+          # - "4" for SEK
+          # - "5" for CAD
+          # - "6" for JPY
+          # - "7" for DEM
+          # - "8" for AUD
+          # - "9" for FRF
+          # - "10" for ITL
+          # - "11" for DKK
+          # - "12" for NOK
+          # - "13" for FIM
+          # - "14" for ZAR
+          # - "15" for IEP
+          # - "16" for NLG
+          # - "17" for EUR
+          # - "18" for KRW
+          # - "19" for TWD
+          # - "20" for SGD
+          # - "21" for CNY
+          # - "22" for HKD
+          # - "23" for NZD
+          # - "24" for MYR
+          # - "25" for BRL
+          # - "26" for PTE
+          # - "27" for MXP
+          # - "28" for CLP
+          # - "29" for TRY
+          # - "30" for ARS
+          # - "31" for PEN
+          # - "32" for ILS
+          # - "33" for CHF
+          # - "34" for VEF
+          # - "35" for COP
+          # - "36" for GTQ
+          # - "37" for PLN
+          # - "39" for INR
+          # - "40" for THB
+          # - "41" for IDR
+          # - "42" for CZK
+          # - "43" for RON
+          # - "44" for HUF
+          # - "45" for RUB
+          # - "46" for AED
+          # - "47" for BGN
+          # - "48" for HRK
+      "defaultCreativeSizeId": "A String", # Default placement dimensions for this account.
+      "accountPermissionIds": [ # Account permissions assigned to this account.
+        "A String",
+      ],
+      "nielsenOcrEnabled": True or False, # Whether campaigns created in this account will be enabled for Nielsen OCR reach ratings by default.
+      "accountProfile": "A String", # Profile for this account. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this account. This is a required field, and must be less than 128 characters long and be globally unique.
+      "locale": "A String", # Locale of this account.
+          # Acceptable values are:
+          # - "cs" (Czech)
+          # - "de" (German)
+          # - "en" (English)
+          # - "en-GB" (English United Kingdom)
+          # - "es" (Spanish)
+          # - "fr" (French)
+          # - "it" (Italian)
+          # - "ja" (Japanese)
+          # - "ko" (Korean)
+          # - "pl" (Polish)
+          # - "pt-BR" (Portuguese Brazil)
+          # - "ru" (Russian)
+          # - "sv" (Swedish)
+          # - "tr" (Turkish)
+          # - "zh-CN" (Chinese Simplified)
+          # - "zh-TW" (Chinese Traditional)
+      "teaserSizeLimit": "A String", # File size limit in kilobytes of Rich Media teaser creatives. Must be between 1 and 10240.
+      "reportsConfiguration": { # Reporting Configuration # Reporting configuration of this account.
+        "reportGenerationTimeZoneId": "A String", # Report generation time zone ID of this account. This is a required field that can only be changed by a superuser.
+            # Acceptable values are:
+            #
+            # - "1" for "America/New_York"
+            # - "2" for "Europe/London"
+            # - "3" for "Europe/Paris"
+            # - "4" for "Africa/Johannesburg"
+            # - "5" for "Asia/Jerusalem"
+            # - "6" for "Asia/Shanghai"
+            # - "7" for "Asia/Hong_Kong"
+            # - "8" for "Asia/Tokyo"
+            # - "9" for "Australia/Sydney"
+            # - "10" for "Asia/Dubai"
+            # - "11" for "America/Los_Angeles"
+            # - "12" for "Pacific/Auckland"
+            # - "13" for "America/Sao_Paulo"
+        "exposureToConversionEnabled": True or False, # Whether the exposure to conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+        "lookbackConfiguration": { # Lookback configuration settings. # Default lookback windows for new advertisers in this account.
+          "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        },
+      },
+      "active": True or False, # Whether this account is active.
+      "activeViewOptOut": True or False, # Whether to serve creatives with Active View tags. If disabled, viewability data will not be available for any impressions.
+      "shareReportsWithTwitter": True or False, # Share Path to Conversion reports with Twitter.
+      "id": "A String", # ID of this account. This is a read-only, auto-generated field.
+      "activeAdsLimitTier": "A String", # Maximum number of active ads allowed for this account.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing account.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM account.
+    "kind": "dfareporting#account", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#account".
+    "countryId": "A String", # ID of the country associated with this account.
+    "availablePermissionIds": [ # User role permissions available to the user roles of this account.
+      "A String",
+    ],
+    "description": "A String", # Description of this account.
+    "maximumImageSize": "A String", # Maximum image size allowed for this account.
+    "currencyId": "A String", # ID of currency associated with this account. This is a required field.
+        # Acceptable values are:
+        # - "1" for USD
+        # - "2" for GBP
+        # - "3" for ESP
+        # - "4" for SEK
+        # - "5" for CAD
+        # - "6" for JPY
+        # - "7" for DEM
+        # - "8" for AUD
+        # - "9" for FRF
+        # - "10" for ITL
+        # - "11" for DKK
+        # - "12" for NOK
+        # - "13" for FIM
+        # - "14" for ZAR
+        # - "15" for IEP
+        # - "16" for NLG
+        # - "17" for EUR
+        # - "18" for KRW
+        # - "19" for TWD
+        # - "20" for SGD
+        # - "21" for CNY
+        # - "22" for HKD
+        # - "23" for NZD
+        # - "24" for MYR
+        # - "25" for BRL
+        # - "26" for PTE
+        # - "27" for MXP
+        # - "28" for CLP
+        # - "29" for TRY
+        # - "30" for ARS
+        # - "31" for PEN
+        # - "32" for ILS
+        # - "33" for CHF
+        # - "34" for VEF
+        # - "35" for COP
+        # - "36" for GTQ
+        # - "37" for PLN
+        # - "39" for INR
+        # - "40" for THB
+        # - "41" for IDR
+        # - "42" for CZK
+        # - "43" for RON
+        # - "44" for HUF
+        # - "45" for RUB
+        # - "46" for AED
+        # - "47" for BGN
+        # - "48" for HRK
+    "defaultCreativeSizeId": "A String", # Default placement dimensions for this account.
+    "accountPermissionIds": [ # Account permissions assigned to this account.
+      "A String",
+    ],
+    "nielsenOcrEnabled": True or False, # Whether campaigns created in this account will be enabled for Nielsen OCR reach ratings by default.
+    "accountProfile": "A String", # Profile for this account. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this account. This is a required field, and must be less than 128 characters long and be globally unique.
+    "locale": "A String", # Locale of this account.
+        # Acceptable values are:
+        # - "cs" (Czech)
+        # - "de" (German)
+        # - "en" (English)
+        # - "en-GB" (English United Kingdom)
+        # - "es" (Spanish)
+        # - "fr" (French)
+        # - "it" (Italian)
+        # - "ja" (Japanese)
+        # - "ko" (Korean)
+        # - "pl" (Polish)
+        # - "pt-BR" (Portuguese Brazil)
+        # - "ru" (Russian)
+        # - "sv" (Swedish)
+        # - "tr" (Turkish)
+        # - "zh-CN" (Chinese Simplified)
+        # - "zh-TW" (Chinese Traditional)
+    "teaserSizeLimit": "A String", # File size limit in kilobytes of Rich Media teaser creatives. Must be between 1 and 10240.
+    "reportsConfiguration": { # Reporting Configuration # Reporting configuration of this account.
+      "reportGenerationTimeZoneId": "A String", # Report generation time zone ID of this account. This is a required field that can only be changed by a superuser.
+          # Acceptable values are:
+          #
+          # - "1" for "America/New_York"
+          # - "2" for "Europe/London"
+          # - "3" for "Europe/Paris"
+          # - "4" for "Africa/Johannesburg"
+          # - "5" for "Asia/Jerusalem"
+          # - "6" for "Asia/Shanghai"
+          # - "7" for "Asia/Hong_Kong"
+          # - "8" for "Asia/Tokyo"
+          # - "9" for "Australia/Sydney"
+          # - "10" for "Asia/Dubai"
+          # - "11" for "America/Los_Angeles"
+          # - "12" for "Pacific/Auckland"
+          # - "13" for "America/Sao_Paulo"
+      "exposureToConversionEnabled": True or False, # Whether the exposure to conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+      "lookbackConfiguration": { # Lookback configuration settings. # Default lookback windows for new advertisers in this account.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+    },
+    "active": True or False, # Whether this account is active.
+    "activeViewOptOut": True or False, # Whether to serve creatives with Active View tags. If disabled, viewability data will not be available for any impressions.
+    "shareReportsWithTwitter": True or False, # Share Path to Conversion reports with Twitter.
+    "id": "A String", # ID of this account. This is a read-only, auto-generated field.
+    "activeAdsLimitTier": "A String", # Maximum number of active ads allowed for this account.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM account.
+      "kind": "dfareporting#account", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#account".
+      "countryId": "A String", # ID of the country associated with this account.
+      "availablePermissionIds": [ # User role permissions available to the user roles of this account.
+        "A String",
+      ],
+      "description": "A String", # Description of this account.
+      "maximumImageSize": "A String", # Maximum image size allowed for this account.
+      "currencyId": "A String", # ID of currency associated with this account. This is a required field.
+          # Acceptable values are:
+          # - "1" for USD
+          # - "2" for GBP
+          # - "3" for ESP
+          # - "4" for SEK
+          # - "5" for CAD
+          # - "6" for JPY
+          # - "7" for DEM
+          # - "8" for AUD
+          # - "9" for FRF
+          # - "10" for ITL
+          # - "11" for DKK
+          # - "12" for NOK
+          # - "13" for FIM
+          # - "14" for ZAR
+          # - "15" for IEP
+          # - "16" for NLG
+          # - "17" for EUR
+          # - "18" for KRW
+          # - "19" for TWD
+          # - "20" for SGD
+          # - "21" for CNY
+          # - "22" for HKD
+          # - "23" for NZD
+          # - "24" for MYR
+          # - "25" for BRL
+          # - "26" for PTE
+          # - "27" for MXP
+          # - "28" for CLP
+          # - "29" for TRY
+          # - "30" for ARS
+          # - "31" for PEN
+          # - "32" for ILS
+          # - "33" for CHF
+          # - "34" for VEF
+          # - "35" for COP
+          # - "36" for GTQ
+          # - "37" for PLN
+          # - "39" for INR
+          # - "40" for THB
+          # - "41" for IDR
+          # - "42" for CZK
+          # - "43" for RON
+          # - "44" for HUF
+          # - "45" for RUB
+          # - "46" for AED
+          # - "47" for BGN
+          # - "48" for HRK
+      "defaultCreativeSizeId": "A String", # Default placement dimensions for this account.
+      "accountPermissionIds": [ # Account permissions assigned to this account.
+        "A String",
+      ],
+      "nielsenOcrEnabled": True or False, # Whether campaigns created in this account will be enabled for Nielsen OCR reach ratings by default.
+      "accountProfile": "A String", # Profile for this account. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this account. This is a required field, and must be less than 128 characters long and be globally unique.
+      "locale": "A String", # Locale of this account.
+          # Acceptable values are:
+          # - "cs" (Czech)
+          # - "de" (German)
+          # - "en" (English)
+          # - "en-GB" (English United Kingdom)
+          # - "es" (Spanish)
+          # - "fr" (French)
+          # - "it" (Italian)
+          # - "ja" (Japanese)
+          # - "ko" (Korean)
+          # - "pl" (Polish)
+          # - "pt-BR" (Portuguese Brazil)
+          # - "ru" (Russian)
+          # - "sv" (Swedish)
+          # - "tr" (Turkish)
+          # - "zh-CN" (Chinese Simplified)
+          # - "zh-TW" (Chinese Traditional)
+      "teaserSizeLimit": "A String", # File size limit in kilobytes of Rich Media teaser creatives. Must be between 1 and 10240.
+      "reportsConfiguration": { # Reporting Configuration # Reporting configuration of this account.
+        "reportGenerationTimeZoneId": "A String", # Report generation time zone ID of this account. This is a required field that can only be changed by a superuser.
+            # Acceptable values are:
+            #
+            # - "1" for "America/New_York"
+            # - "2" for "Europe/London"
+            # - "3" for "Europe/Paris"
+            # - "4" for "Africa/Johannesburg"
+            # - "5" for "Asia/Jerusalem"
+            # - "6" for "Asia/Shanghai"
+            # - "7" for "Asia/Hong_Kong"
+            # - "8" for "Asia/Tokyo"
+            # - "9" for "Australia/Sydney"
+            # - "10" for "Asia/Dubai"
+            # - "11" for "America/Los_Angeles"
+            # - "12" for "Pacific/Auckland"
+            # - "13" for "America/Sao_Paulo"
+        "exposureToConversionEnabled": True or False, # Whether the exposure to conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+        "lookbackConfiguration": { # Lookback configuration settings. # Default lookback windows for new advertisers in this account.
+          "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        },
+      },
+      "active": True or False, # Whether this account is active.
+      "activeViewOptOut": True or False, # Whether to serve creatives with Active View tags. If disabled, viewability data will not be available for any impressions.
+      "shareReportsWithTwitter": True or False, # Share Path to Conversion reports with Twitter.
+      "id": "A String", # ID of this account. This is a read-only, auto-generated field.
+      "activeAdsLimitTier": "A String", # Maximum number of active ads allowed for this account.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.ads.html b/docs/dyn/dfareporting_v2_7.ads.html
new file mode 100644
index 00000000000..dcbaa9e00c0
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.ads.html
@@ -0,0 +1,2958 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.ads.html">ads</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one ad by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new ad.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, landingPageIds=None, overriddenEventTagId=None, campaignIds=None, sizeIds=None, archived=None, creativeOptimizationConfigurationIds=None, sslCompliant=None, pageToken=None, sortOrder=None, type=None, sslRequired=None, creativeIds=None, remarketingListIds=None, maxResults=None, placementIds=None, active=None, compatibility=None, advertiserId=None, searchString=None, audienceSegmentIds=None, ids=None, sortField=None, dynamicClickTracker=None)</a></code></p>
+<p class="firstline">Retrieves a list of ads, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing ad. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing ad.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one ad by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Ad ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM ad.
+      "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.
+        "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+        "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+      },
+      "campaignId": "A String", # Campaign ID of this ad. This is a required field on insertion.
+      "languageTargeting": { # Language Targeting. # Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a language that can be targeted by ads.
+            "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+            "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+            "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+            "name": "A String", # Name of this language.
+          },
+        ],
+      },
+      "advertiserId": "A String", # Advertiser ID of this ad. This is a required field on insertion.
+      "geoTargeting": { # Geographical Targeting. # Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+          { # Contains information about a country that can be targeted by ads.
+            "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+            "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+            "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+            "countryCode": "A String", # Country code.
+            "name": "A String", # Name of this country.
+          },
+        ],
+        "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+        "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+          { # Contains information about a postal code that can be targeted by ads.
+            "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+            "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+            "code": "A String", # Postal code. This is equivalent to the id field.
+            "id": "A String", # ID of this postal code.
+            "countryCode": "A String", # Country code of the country to which this postal code belongs.
+          },
+        ],
+        "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+          { # Contains information about a region that can be targeted by ads.
+            "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+            "countryDartId": "A String", # DART ID of the country to which this region belongs.
+            "name": "A String", # Name of this region.
+            "countryCode": "A String", # Country code of the country to which this region belongs.
+            "regionCode": "A String", # Region code.
+            "dartId": "A String", # DART ID of this region.
+          },
+        ],
+        "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+          { # Contains information about a city that can be targeted by ads.
+            "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+            "countryDartId": "A String", # DART ID of the country to which this city belongs.
+            "name": "A String", # Name of this city.
+            "countryCode": "A String", # Country code of the country to which this city belongs.
+            "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+            "regionCode": "A String", # Region code of the region to which this city belongs.
+            "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+            "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+            "regionDartId": "A String", # DART ID of the region to which this city belongs.
+          },
+        ],
+        "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+          { # Contains information about a metro region that can be targeted by ads.
+            "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+            "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+            "name": "A String", # Name of this metro region.
+            "countryCode": "A String", # Country code of the country to which this metro region belongs.
+            "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+            "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+            "dartId": "A String", # DART ID of this metro region.
+          },
+        ],
+      },
+      "creativeGroupAssignments": [ # Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments.
+        { # Creative Group Assignment.
+          "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+          "creativeGroupId": "A String", # ID of the creative group to be assigned.
+        },
+      ],
+      "deliverySchedule": { # Delivery Schedule. # Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.
+        "priority": "A String", # Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.
+        "hardCutoff": True or False, # Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.
+        "frequencyCap": { # Frequency Cap. # Limit on the number of times an individual user can be served the ad within a specified period of time.
+          "duration": "A String", # Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days in seconds, or 7,776,000.
+          "impressions": "A String", # Number of times an individual user can be served the ad within the specified duration. The maximum allowed is 15.
+        },
+        "impressionRatio": "A String", # Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then DCM will serve ad B three times as often as ad A. Must be between 1 and 10.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "eventTagOverrides": [ # Event tag overrides for this ad.
+        { # Event tag override information.
+          "enabled": True or False, # Whether this override is enabled.
+          "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+        },
+      ],
+      "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
+      "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
+      "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a platform type that can be targeted by ads.
+            "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+            "id": "A String", # ID of this platform type.
+            "name": "A String", # Name of this platform type.
+          },
+        ],
+        "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+          { # Contains information about a particular version of an operating system that can be targeted by ads.
+            "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+            "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+            "name": "A String", # Name of this operating system version.
+            "id": "A String", # ID of this operating system version.
+            "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+              "mobile": True or False, # Whether this operating system is for mobile.
+              "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+              "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+              "name": "A String", # Name of this operating system.
+              "desktop": True or False, # Whether this operating system is for desktop.
+            },
+            "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+          },
+        ],
+        "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a browser that can be targeted by ads.
+            "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+            "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+            "name": "A String", # Name of this browser.
+            "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+            "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+            "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          },
+        ],
+        "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+          { # Contains information about an operating system that can be targeted by ads.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+        ],
+        "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+          { # Contains information about a mobile carrier that can be targeted by ads.
+            "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+            "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+            "id": "A String", # ID of this mobile carrier.
+            "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+            "name": "A String", # Name of this mobile carrier.
+          },
+        ],
+        "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+            "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+            "id": "A String", # ID of this connection type.
+            "name": "A String", # Name of this connection type.
+          },
+        ],
+      },
+      "creativeRotation": { # Creative Rotation. # Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment.
+        "creativeAssignments": [ # Creative assignments in this creative rotation.
+          { # Creative Assignment.
+            "weight": 42, # Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM.
+            "sequence": 42, # Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL.
+            "applyEventTags": True or False, # Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.
+            "richMediaExitOverrides": [ # Rich media exit overrides for this creative assignment.
+                # Applicable when the creative type is any of the following:
+                # - RICH_MEDIA_INPAGE
+                # - RICH_MEDIA_INPAGE_FLOATING
+                # - RICH_MEDIA_IM_EXPAND
+                # - RICH_MEDIA_EXPANDING
+                # - RICH_MEDIA_INTERSTITIAL_FLOAT
+                # - RICH_MEDIA_MOBILE_IN_APP
+                # - RICH_MEDIA_MULTI_FLOATING
+                # - RICH_MEDIA_PEEL_DOWN
+                # - ADVANCED_BANNER
+                # - VPAID_LINEAR
+                # - VPAID_NON_LINEAR
+              { # Rich Media Exit Override.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "enabled": True or False, # Whether to use the clickThroughUrl. If false, the creative-level exit will be used.
+                "exitId": "A String", # ID for the override to refer to a specific exit in the creative.
+              },
+            ],
+            "sslCompliant": True or False, # Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+            "creativeGroupAssignments": [ # Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments.
+              { # Creative Group Assignment.
+                "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+                "creativeGroupId": "A String", # ID of the creative group to be assigned.
+              },
+            ],
+            "companionCreativeOverrides": [ # Companion creative overrides for this creative assignment. Applicable to video ads.
+              { # Companion Click-through override.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of this companion click-through override.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "creativeId": "A String", # ID of the creative for this companion click-through override.
+              },
+            ],
+            "startTime": "A String", # Date and time that the assigned creative should start serving.
+            "clickThroughUrl": { # Click-through URL # Click-through URL of the creative assignment.
+              "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                  # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                  # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                  # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+              "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+              "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+              "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+            },
+            "active": True or False, # Whether this creative assignment is active. When true, the creative will be included in the ad's rotation.
+            "creativeId": "A String", # ID of the creative to be assigned. This is a required field.
+            "endTime": "A String", # Date and time that the assigned creative should stop serving. Must be later than the start time.
+            "creativeIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the creative. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          },
+        ],
+        "weightCalculationStrategy": "A String", # Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM.
+        "creativeOptimizationConfigurationId": "A String", # Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.
+        "type": "A String", # Type of creative rotation. Can be used to specify whether to use sequential or random rotation.
+      },
+      "clickThroughUrl": { # Click-through URL # Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.
+        "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+            # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+            # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+            # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+        "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+        "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+        "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+      },
+      "comments": "A String", # Comments for this ad.
+      "remarketingListExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "expression": "A String", # Expression describing which lists are being targeted by the ad.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this ad. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "type": "A String", # Type of ad. This is a required field on insertion. Note that default ads (AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).
+      "sslRequired": True or False, # Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      "audienceSegmentId": "A String", # Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD.
+      "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "expression": "A String", # Keyword expression being targeted by the ad.
+      },
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Default click-through event tag properties for this ad.
+        "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+        "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+      },
+      "createInfo": { # Modification timestamp. # Information about the creation of this ad. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
+      "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
+      "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
+      "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this ad. This is a required field and must be less than 256 characters long.
+      "dayPartTargeting": { # Day Part Targeting. # Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+        "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+          42,
+        ],
+        "daysOfWeek": [ # Days of the week when the ad will serve.
+            #
+            # Acceptable values are:
+            # - "SUNDAY"
+            # - "MONDAY"
+            # - "TUESDAY"
+            # - "WEDNESDAY"
+            # - "THURSDAY"
+            # - "FRIDAY"
+            # - "SATURDAY"
+          "A String",
+        ],
+      },
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this ad. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "sslCompliant": True or False, # Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      "placementAssignments": [ # Placement assignments for this ad.
+        { # Placement Assignment.
+          "active": True or False, # Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.
+          "placementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "placementId": "A String", # ID of the placement to be assigned. This is a required field.
+          "sslRequired": True or False, # Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.
+        },
+      ],
+      "endTime": "A String", # Date and time that this ad should stop serving. Must be later than the start time. This is a required field on insertion.
+      "dynamicClickTracker": True or False, # Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new ad.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM ad.
+    "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.
+      "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+      "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+    },
+    "campaignId": "A String", # Campaign ID of this ad. This is a required field on insertion.
+    "languageTargeting": { # Language Targeting. # Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a language that can be targeted by ads.
+          "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+          "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+          "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+          "name": "A String", # Name of this language.
+        },
+      ],
+    },
+    "advertiserId": "A String", # Advertiser ID of this ad. This is a required field on insertion.
+    "geoTargeting": { # Geographical Targeting. # Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+        { # Contains information about a country that can be targeted by ads.
+          "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+          "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+          "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+          "countryCode": "A String", # Country code.
+          "name": "A String", # Name of this country.
+        },
+      ],
+      "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+      "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+        { # Contains information about a postal code that can be targeted by ads.
+          "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+          "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+          "code": "A String", # Postal code. This is equivalent to the id field.
+          "id": "A String", # ID of this postal code.
+          "countryCode": "A String", # Country code of the country to which this postal code belongs.
+        },
+      ],
+      "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+        { # Contains information about a region that can be targeted by ads.
+          "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+          "countryDartId": "A String", # DART ID of the country to which this region belongs.
+          "name": "A String", # Name of this region.
+          "countryCode": "A String", # Country code of the country to which this region belongs.
+          "regionCode": "A String", # Region code.
+          "dartId": "A String", # DART ID of this region.
+        },
+      ],
+      "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+        { # Contains information about a city that can be targeted by ads.
+          "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+          "countryDartId": "A String", # DART ID of the country to which this city belongs.
+          "name": "A String", # Name of this city.
+          "countryCode": "A String", # Country code of the country to which this city belongs.
+          "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+          "regionCode": "A String", # Region code of the region to which this city belongs.
+          "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+          "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+          "regionDartId": "A String", # DART ID of the region to which this city belongs.
+        },
+      ],
+      "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+        { # Contains information about a metro region that can be targeted by ads.
+          "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+          "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+          "name": "A String", # Name of this metro region.
+          "countryCode": "A String", # Country code of the country to which this metro region belongs.
+          "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+          "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+          "dartId": "A String", # DART ID of this metro region.
+        },
+      ],
+    },
+    "creativeGroupAssignments": [ # Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments.
+      { # Creative Group Assignment.
+        "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+        "creativeGroupId": "A String", # ID of the creative group to be assigned.
+      },
+    ],
+    "deliverySchedule": { # Delivery Schedule. # Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.
+      "priority": "A String", # Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.
+      "hardCutoff": True or False, # Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.
+      "frequencyCap": { # Frequency Cap. # Limit on the number of times an individual user can be served the ad within a specified period of time.
+        "duration": "A String", # Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days in seconds, or 7,776,000.
+        "impressions": "A String", # Number of times an individual user can be served the ad within the specified duration. The maximum allowed is 15.
+      },
+      "impressionRatio": "A String", # Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then DCM will serve ad B three times as often as ad A. Must be between 1 and 10.
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "eventTagOverrides": [ # Event tag overrides for this ad.
+      { # Event tag override information.
+        "enabled": True or False, # Whether this override is enabled.
+        "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+      },
+    ],
+    "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
+    "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
+    "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a platform type that can be targeted by ads.
+          "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+          "id": "A String", # ID of this platform type.
+          "name": "A String", # Name of this platform type.
+        },
+      ],
+      "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+        { # Contains information about a particular version of an operating system that can be targeted by ads.
+          "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+          "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+          "name": "A String", # Name of this operating system version.
+          "id": "A String", # ID of this operating system version.
+          "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+          "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+        },
+      ],
+      "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a browser that can be targeted by ads.
+          "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+          "name": "A String", # Name of this browser.
+          "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+          "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+          "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+        },
+      ],
+      "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+        { # Contains information about an operating system that can be targeted by ads.
+          "mobile": True or False, # Whether this operating system is for mobile.
+          "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+          "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+          "name": "A String", # Name of this operating system.
+          "desktop": True or False, # Whether this operating system is for desktop.
+        },
+      ],
+      "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+        { # Contains information about a mobile carrier that can be targeted by ads.
+          "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+          "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+          "id": "A String", # ID of this mobile carrier.
+          "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+          "name": "A String", # Name of this mobile carrier.
+        },
+      ],
+      "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+          "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+          "id": "A String", # ID of this connection type.
+          "name": "A String", # Name of this connection type.
+        },
+      ],
+    },
+    "creativeRotation": { # Creative Rotation. # Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment.
+      "creativeAssignments": [ # Creative assignments in this creative rotation.
+        { # Creative Assignment.
+          "weight": 42, # Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM.
+          "sequence": 42, # Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL.
+          "applyEventTags": True or False, # Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.
+          "richMediaExitOverrides": [ # Rich media exit overrides for this creative assignment.
+              # Applicable when the creative type is any of the following:
+              # - RICH_MEDIA_INPAGE
+              # - RICH_MEDIA_INPAGE_FLOATING
+              # - RICH_MEDIA_IM_EXPAND
+              # - RICH_MEDIA_EXPANDING
+              # - RICH_MEDIA_INTERSTITIAL_FLOAT
+              # - RICH_MEDIA_MOBILE_IN_APP
+              # - RICH_MEDIA_MULTI_FLOATING
+              # - RICH_MEDIA_PEEL_DOWN
+              # - ADVANCED_BANNER
+              # - VPAID_LINEAR
+              # - VPAID_NON_LINEAR
+            { # Rich Media Exit Override.
+              "clickThroughUrl": { # Click-through URL # Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.
+                "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                    # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                    # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                    # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+              },
+              "enabled": True or False, # Whether to use the clickThroughUrl. If false, the creative-level exit will be used.
+              "exitId": "A String", # ID for the override to refer to a specific exit in the creative.
+            },
+          ],
+          "sslCompliant": True or False, # Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+          "creativeGroupAssignments": [ # Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments.
+            { # Creative Group Assignment.
+              "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+              "creativeGroupId": "A String", # ID of the creative group to be assigned.
+            },
+          ],
+          "companionCreativeOverrides": [ # Companion creative overrides for this creative assignment. Applicable to video ads.
+            { # Companion Click-through override.
+              "clickThroughUrl": { # Click-through URL # Click-through URL of this companion click-through override.
+                "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                    # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                    # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                    # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+              },
+              "creativeId": "A String", # ID of the creative for this companion click-through override.
+            },
+          ],
+          "startTime": "A String", # Date and time that the assigned creative should start serving.
+          "clickThroughUrl": { # Click-through URL # Click-through URL of the creative assignment.
+            "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+            "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+            "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+            "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+          },
+          "active": True or False, # Whether this creative assignment is active. When true, the creative will be included in the ad's rotation.
+          "creativeId": "A String", # ID of the creative to be assigned. This is a required field.
+          "endTime": "A String", # Date and time that the assigned creative should stop serving. Must be later than the start time.
+          "creativeIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the creative. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        },
+      ],
+      "weightCalculationStrategy": "A String", # Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM.
+      "creativeOptimizationConfigurationId": "A String", # Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.
+      "type": "A String", # Type of creative rotation. Can be used to specify whether to use sequential or random rotation.
+    },
+    "clickThroughUrl": { # Click-through URL # Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.
+      "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+          # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+          # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+          # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+      "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+      "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+      "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+    },
+    "comments": "A String", # Comments for this ad.
+    "remarketingListExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "expression": "A String", # Expression describing which lists are being targeted by the ad.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this ad. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "type": "A String", # Type of ad. This is a required field on insertion. Note that default ads (AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).
+    "sslRequired": True or False, # Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated.
+    "audienceSegmentId": "A String", # Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD.
+    "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "expression": "A String", # Keyword expression being targeted by the ad.
+    },
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Default click-through event tag properties for this ad.
+      "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+    },
+    "createInfo": { # Modification timestamp. # Information about the creation of this ad. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
+    "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
+    "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
+    "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this ad. This is a required field and must be less than 256 characters long.
+    "dayPartTargeting": { # Day Part Targeting. # Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+      "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+        42,
+      ],
+      "daysOfWeek": [ # Days of the week when the ad will serve.
+          #
+          # Acceptable values are:
+          # - "SUNDAY"
+          # - "MONDAY"
+          # - "TUESDAY"
+          # - "WEDNESDAY"
+          # - "THURSDAY"
+          # - "FRIDAY"
+          # - "SATURDAY"
+        "A String",
+      ],
+    },
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this ad. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "sslCompliant": True or False, # Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+    "placementAssignments": [ # Placement assignments for this ad.
+      { # Placement Assignment.
+        "active": True or False, # Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.
+        "placementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "placementId": "A String", # ID of the placement to be assigned. This is a required field.
+        "sslRequired": True or False, # Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      },
+    ],
+    "endTime": "A String", # Date and time that this ad should stop serving. Must be later than the start time. This is a required field on insertion.
+    "dynamicClickTracker": True or False, # Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM ad.
+      "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.
+        "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+        "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+      },
+      "campaignId": "A String", # Campaign ID of this ad. This is a required field on insertion.
+      "languageTargeting": { # Language Targeting. # Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a language that can be targeted by ads.
+            "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+            "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+            "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+            "name": "A String", # Name of this language.
+          },
+        ],
+      },
+      "advertiserId": "A String", # Advertiser ID of this ad. This is a required field on insertion.
+      "geoTargeting": { # Geographical Targeting. # Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+          { # Contains information about a country that can be targeted by ads.
+            "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+            "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+            "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+            "countryCode": "A String", # Country code.
+            "name": "A String", # Name of this country.
+          },
+        ],
+        "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+        "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+          { # Contains information about a postal code that can be targeted by ads.
+            "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+            "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+            "code": "A String", # Postal code. This is equivalent to the id field.
+            "id": "A String", # ID of this postal code.
+            "countryCode": "A String", # Country code of the country to which this postal code belongs.
+          },
+        ],
+        "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+          { # Contains information about a region that can be targeted by ads.
+            "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+            "countryDartId": "A String", # DART ID of the country to which this region belongs.
+            "name": "A String", # Name of this region.
+            "countryCode": "A String", # Country code of the country to which this region belongs.
+            "regionCode": "A String", # Region code.
+            "dartId": "A String", # DART ID of this region.
+          },
+        ],
+        "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+          { # Contains information about a city that can be targeted by ads.
+            "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+            "countryDartId": "A String", # DART ID of the country to which this city belongs.
+            "name": "A String", # Name of this city.
+            "countryCode": "A String", # Country code of the country to which this city belongs.
+            "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+            "regionCode": "A String", # Region code of the region to which this city belongs.
+            "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+            "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+            "regionDartId": "A String", # DART ID of the region to which this city belongs.
+          },
+        ],
+        "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+          { # Contains information about a metro region that can be targeted by ads.
+            "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+            "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+            "name": "A String", # Name of this metro region.
+            "countryCode": "A String", # Country code of the country to which this metro region belongs.
+            "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+            "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+            "dartId": "A String", # DART ID of this metro region.
+          },
+        ],
+      },
+      "creativeGroupAssignments": [ # Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments.
+        { # Creative Group Assignment.
+          "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+          "creativeGroupId": "A String", # ID of the creative group to be assigned.
+        },
+      ],
+      "deliverySchedule": { # Delivery Schedule. # Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.
+        "priority": "A String", # Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.
+        "hardCutoff": True or False, # Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.
+        "frequencyCap": { # Frequency Cap. # Limit on the number of times an individual user can be served the ad within a specified period of time.
+          "duration": "A String", # Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days in seconds, or 7,776,000.
+          "impressions": "A String", # Number of times an individual user can be served the ad within the specified duration. The maximum allowed is 15.
+        },
+        "impressionRatio": "A String", # Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then DCM will serve ad B three times as often as ad A. Must be between 1 and 10.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "eventTagOverrides": [ # Event tag overrides for this ad.
+        { # Event tag override information.
+          "enabled": True or False, # Whether this override is enabled.
+          "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+        },
+      ],
+      "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
+      "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
+      "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a platform type that can be targeted by ads.
+            "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+            "id": "A String", # ID of this platform type.
+            "name": "A String", # Name of this platform type.
+          },
+        ],
+        "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+          { # Contains information about a particular version of an operating system that can be targeted by ads.
+            "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+            "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+            "name": "A String", # Name of this operating system version.
+            "id": "A String", # ID of this operating system version.
+            "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+              "mobile": True or False, # Whether this operating system is for mobile.
+              "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+              "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+              "name": "A String", # Name of this operating system.
+              "desktop": True or False, # Whether this operating system is for desktop.
+            },
+            "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+          },
+        ],
+        "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a browser that can be targeted by ads.
+            "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+            "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+            "name": "A String", # Name of this browser.
+            "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+            "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+            "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          },
+        ],
+        "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+          { # Contains information about an operating system that can be targeted by ads.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+        ],
+        "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+          { # Contains information about a mobile carrier that can be targeted by ads.
+            "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+            "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+            "id": "A String", # ID of this mobile carrier.
+            "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+            "name": "A String", # Name of this mobile carrier.
+          },
+        ],
+        "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+            "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+            "id": "A String", # ID of this connection type.
+            "name": "A String", # Name of this connection type.
+          },
+        ],
+      },
+      "creativeRotation": { # Creative Rotation. # Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment.
+        "creativeAssignments": [ # Creative assignments in this creative rotation.
+          { # Creative Assignment.
+            "weight": 42, # Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM.
+            "sequence": 42, # Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL.
+            "applyEventTags": True or False, # Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.
+            "richMediaExitOverrides": [ # Rich media exit overrides for this creative assignment.
+                # Applicable when the creative type is any of the following:
+                # - RICH_MEDIA_INPAGE
+                # - RICH_MEDIA_INPAGE_FLOATING
+                # - RICH_MEDIA_IM_EXPAND
+                # - RICH_MEDIA_EXPANDING
+                # - RICH_MEDIA_INTERSTITIAL_FLOAT
+                # - RICH_MEDIA_MOBILE_IN_APP
+                # - RICH_MEDIA_MULTI_FLOATING
+                # - RICH_MEDIA_PEEL_DOWN
+                # - ADVANCED_BANNER
+                # - VPAID_LINEAR
+                # - VPAID_NON_LINEAR
+              { # Rich Media Exit Override.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "enabled": True or False, # Whether to use the clickThroughUrl. If false, the creative-level exit will be used.
+                "exitId": "A String", # ID for the override to refer to a specific exit in the creative.
+              },
+            ],
+            "sslCompliant": True or False, # Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+            "creativeGroupAssignments": [ # Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments.
+              { # Creative Group Assignment.
+                "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+                "creativeGroupId": "A String", # ID of the creative group to be assigned.
+              },
+            ],
+            "companionCreativeOverrides": [ # Companion creative overrides for this creative assignment. Applicable to video ads.
+              { # Companion Click-through override.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of this companion click-through override.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "creativeId": "A String", # ID of the creative for this companion click-through override.
+              },
+            ],
+            "startTime": "A String", # Date and time that the assigned creative should start serving.
+            "clickThroughUrl": { # Click-through URL # Click-through URL of the creative assignment.
+              "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                  # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                  # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                  # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+              "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+              "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+              "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+            },
+            "active": True or False, # Whether this creative assignment is active. When true, the creative will be included in the ad's rotation.
+            "creativeId": "A String", # ID of the creative to be assigned. This is a required field.
+            "endTime": "A String", # Date and time that the assigned creative should stop serving. Must be later than the start time.
+            "creativeIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the creative. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          },
+        ],
+        "weightCalculationStrategy": "A String", # Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM.
+        "creativeOptimizationConfigurationId": "A String", # Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.
+        "type": "A String", # Type of creative rotation. Can be used to specify whether to use sequential or random rotation.
+      },
+      "clickThroughUrl": { # Click-through URL # Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.
+        "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+            # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+            # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+            # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+        "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+        "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+        "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+      },
+      "comments": "A String", # Comments for this ad.
+      "remarketingListExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "expression": "A String", # Expression describing which lists are being targeted by the ad.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this ad. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "type": "A String", # Type of ad. This is a required field on insertion. Note that default ads (AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).
+      "sslRequired": True or False, # Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      "audienceSegmentId": "A String", # Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD.
+      "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "expression": "A String", # Keyword expression being targeted by the ad.
+      },
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Default click-through event tag properties for this ad.
+        "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+        "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+      },
+      "createInfo": { # Modification timestamp. # Information about the creation of this ad. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
+      "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
+      "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
+      "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this ad. This is a required field and must be less than 256 characters long.
+      "dayPartTargeting": { # Day Part Targeting. # Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+        "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+          42,
+        ],
+        "daysOfWeek": [ # Days of the week when the ad will serve.
+            #
+            # Acceptable values are:
+            # - "SUNDAY"
+            # - "MONDAY"
+            # - "TUESDAY"
+            # - "WEDNESDAY"
+            # - "THURSDAY"
+            # - "FRIDAY"
+            # - "SATURDAY"
+          "A String",
+        ],
+      },
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this ad. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "sslCompliant": True or False, # Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      "placementAssignments": [ # Placement assignments for this ad.
+        { # Placement Assignment.
+          "active": True or False, # Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.
+          "placementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "placementId": "A String", # ID of the placement to be assigned. This is a required field.
+          "sslRequired": True or False, # Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.
+        },
+      ],
+      "endTime": "A String", # Date and time that this ad should stop serving. Must be later than the start time. This is a required field on insertion.
+      "dynamicClickTracker": True or False, # Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, landingPageIds=None, overriddenEventTagId=None, campaignIds=None, sizeIds=None, archived=None, creativeOptimizationConfigurationIds=None, sslCompliant=None, pageToken=None, sortOrder=None, type=None, sslRequired=None, creativeIds=None, remarketingListIds=None, maxResults=None, placementIds=None, active=None, compatibility=None, advertiserId=None, searchString=None, audienceSegmentIds=None, ids=None, sortField=None, dynamicClickTracker=None)</code>
+  <pre>Retrieves a list of ads, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  landingPageIds: string, Select only ads with these landing page IDs. (repeated)
+  overriddenEventTagId: string, Select only ads with this event tag override ID.
+  campaignIds: string, Select only ads with these campaign IDs. (repeated)
+  sizeIds: string, Select only ads with these size IDs. (repeated)
+  archived: boolean, Select only archived ads.
+  creativeOptimizationConfigurationIds: string, Select only ads with these creative optimization configuration IDs. (repeated)
+  sslCompliant: boolean, Select only ads that are SSL-compliant.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  type: string, Select only ads with these types. (repeated)
+    Allowed values
+      AD_SERVING_CLICK_TRACKER - 
+      AD_SERVING_DEFAULT_AD - 
+      AD_SERVING_STANDARD_AD - 
+      AD_SERVING_TRACKING - 
+  sslRequired: boolean, Select only ads that require SSL.
+  creativeIds: string, Select only ads with these creative IDs assigned. (repeated)
+  remarketingListIds: string, Select only ads whose list targeting expression use these remarketing list IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  placementIds: string, Select only ads with these placement IDs assigned. (repeated)
+  active: boolean, Select only active ads.
+  compatibility: string, Select default ads with the specified compatibility. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. IN_STREAM_VIDEO refers to rendering an in-stream video ads developed with the VAST standard.
+    Allowed values
+      APP - 
+      APP_INTERSTITIAL - 
+      DISPLAY - 
+      DISPLAY_INTERSTITIAL - 
+      IN_STREAM_VIDEO - 
+  advertiserId: string, Select only ads with this advertiser ID.
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "ad*2015" will return objects with names like "ad June 2015", "ad April 2015", or simply "ad 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "ad" will match objects with name "my ad", "ad 2015", or simply "ad".
+  audienceSegmentIds: string, Select only ads with these audience segment IDs. (repeated)
+  ids: string, Select only ads with these IDs. (repeated)
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  dynamicClickTracker: boolean, Select only dynamic click trackers. Applicable when type is AD_SERVING_CLICK_TRACKER. If true, select dynamic click trackers. If false, select static click trackers. Leave unset to select both.
+
+Returns:
+  An object of the form:
+
+    { # Ad List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#adsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#adsListResponse".
+    "ads": [ # Ad collection.
+      { # Contains properties of a DCM ad.
+          "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.
+            "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+            "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+          },
+          "campaignId": "A String", # Campaign ID of this ad. This is a required field on insertion.
+          "languageTargeting": { # Language Targeting. # Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+            "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+              { # Contains information about a language that can be targeted by ads.
+                "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+                "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+                "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+                "name": "A String", # Name of this language.
+              },
+            ],
+          },
+          "advertiserId": "A String", # Advertiser ID of this ad. This is a required field on insertion.
+          "geoTargeting": { # Geographical Targeting. # Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+            "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+              { # Contains information about a country that can be targeted by ads.
+                "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+                "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+                "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+                "countryCode": "A String", # Country code.
+                "name": "A String", # Name of this country.
+              },
+            ],
+            "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+            "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+              { # Contains information about a postal code that can be targeted by ads.
+                "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+                "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+                "code": "A String", # Postal code. This is equivalent to the id field.
+                "id": "A String", # ID of this postal code.
+                "countryCode": "A String", # Country code of the country to which this postal code belongs.
+              },
+            ],
+            "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+              { # Contains information about a region that can be targeted by ads.
+                "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+                "countryDartId": "A String", # DART ID of the country to which this region belongs.
+                "name": "A String", # Name of this region.
+                "countryCode": "A String", # Country code of the country to which this region belongs.
+                "regionCode": "A String", # Region code.
+                "dartId": "A String", # DART ID of this region.
+              },
+            ],
+            "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+              { # Contains information about a city that can be targeted by ads.
+                "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+                "countryDartId": "A String", # DART ID of the country to which this city belongs.
+                "name": "A String", # Name of this city.
+                "countryCode": "A String", # Country code of the country to which this city belongs.
+                "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+                "regionCode": "A String", # Region code of the region to which this city belongs.
+                "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+                "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+                "regionDartId": "A String", # DART ID of the region to which this city belongs.
+              },
+            ],
+            "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+              { # Contains information about a metro region that can be targeted by ads.
+                "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+                "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+                "name": "A String", # Name of this metro region.
+                "countryCode": "A String", # Country code of the country to which this metro region belongs.
+                "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+                "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+                "dartId": "A String", # DART ID of this metro region.
+              },
+            ],
+          },
+          "creativeGroupAssignments": [ # Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments.
+            { # Creative Group Assignment.
+              "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+              "creativeGroupId": "A String", # ID of the creative group to be assigned.
+            },
+          ],
+          "deliverySchedule": { # Delivery Schedule. # Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.
+            "priority": "A String", # Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.
+            "hardCutoff": True or False, # Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.
+            "frequencyCap": { # Frequency Cap. # Limit on the number of times an individual user can be served the ad within a specified period of time.
+              "duration": "A String", # Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days in seconds, or 7,776,000.
+              "impressions": "A String", # Number of times an individual user can be served the ad within the specified duration. The maximum allowed is 15.
+            },
+            "impressionRatio": "A String", # Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then DCM will serve ad B three times as often as ad A. Must be between 1 and 10.
+          },
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "eventTagOverrides": [ # Event tag overrides for this ad.
+            { # Event tag override information.
+              "enabled": True or False, # Whether this override is enabled.
+              "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+            },
+          ],
+          "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
+          "archived": True or False, # Whether this ad is archived. When true, active must be false.
+          "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
+          "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+            "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+              { # Contains information about a platform type that can be targeted by ads.
+                "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+                "id": "A String", # ID of this platform type.
+                "name": "A String", # Name of this platform type.
+              },
+            ],
+            "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+              { # Contains information about a particular version of an operating system that can be targeted by ads.
+                "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+                "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+                "name": "A String", # Name of this operating system version.
+                "id": "A String", # ID of this operating system version.
+                "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+                  "mobile": True or False, # Whether this operating system is for mobile.
+                  "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+                  "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+                  "name": "A String", # Name of this operating system.
+                  "desktop": True or False, # Whether this operating system is for desktop.
+                },
+                "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+              },
+            ],
+            "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+              { # Contains information about a browser that can be targeted by ads.
+                "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+                "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+                "name": "A String", # Name of this browser.
+                "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+                "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+                "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+              },
+            ],
+            "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+              { # Contains information about an operating system that can be targeted by ads.
+                "mobile": True or False, # Whether this operating system is for mobile.
+                "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+                "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+                "name": "A String", # Name of this operating system.
+                "desktop": True or False, # Whether this operating system is for desktop.
+              },
+            ],
+            "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+              { # Contains information about a mobile carrier that can be targeted by ads.
+                "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+                "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+                "id": "A String", # ID of this mobile carrier.
+                "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+                "name": "A String", # Name of this mobile carrier.
+              },
+            ],
+            "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+              { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+                "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+                "id": "A String", # ID of this connection type.
+                "name": "A String", # Name of this connection type.
+              },
+            ],
+          },
+          "creativeRotation": { # Creative Rotation. # Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment.
+            "creativeAssignments": [ # Creative assignments in this creative rotation.
+              { # Creative Assignment.
+                "weight": 42, # Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM.
+                "sequence": 42, # Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL.
+                "applyEventTags": True or False, # Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.
+                "richMediaExitOverrides": [ # Rich media exit overrides for this creative assignment.
+                    # Applicable when the creative type is any of the following:
+                    # - RICH_MEDIA_INPAGE
+                    # - RICH_MEDIA_INPAGE_FLOATING
+                    # - RICH_MEDIA_IM_EXPAND
+                    # - RICH_MEDIA_EXPANDING
+                    # - RICH_MEDIA_INTERSTITIAL_FLOAT
+                    # - RICH_MEDIA_MOBILE_IN_APP
+                    # - RICH_MEDIA_MULTI_FLOATING
+                    # - RICH_MEDIA_PEEL_DOWN
+                    # - ADVANCED_BANNER
+                    # - VPAID_LINEAR
+                    # - VPAID_NON_LINEAR
+                  { # Rich Media Exit Override.
+                    "clickThroughUrl": { # Click-through URL # Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.
+                      "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                          # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                          # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                          # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                      "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                      "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                      "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                    },
+                    "enabled": True or False, # Whether to use the clickThroughUrl. If false, the creative-level exit will be used.
+                    "exitId": "A String", # ID for the override to refer to a specific exit in the creative.
+                  },
+                ],
+                "sslCompliant": True or False, # Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+                "creativeGroupAssignments": [ # Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments.
+                  { # Creative Group Assignment.
+                    "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+                    "creativeGroupId": "A String", # ID of the creative group to be assigned.
+                  },
+                ],
+                "companionCreativeOverrides": [ # Companion creative overrides for this creative assignment. Applicable to video ads.
+                  { # Companion Click-through override.
+                    "clickThroughUrl": { # Click-through URL # Click-through URL of this companion click-through override.
+                      "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                          # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                          # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                          # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                      "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                      "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                      "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                    },
+                    "creativeId": "A String", # ID of the creative for this companion click-through override.
+                  },
+                ],
+                "startTime": "A String", # Date and time that the assigned creative should start serving.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of the creative assignment.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "active": True or False, # Whether this creative assignment is active. When true, the creative will be included in the ad's rotation.
+                "creativeId": "A String", # ID of the creative to be assigned. This is a required field.
+                "endTime": "A String", # Date and time that the assigned creative should stop serving. Must be later than the start time.
+                "creativeIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the creative. This is a read-only, auto-generated field.
+                  "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                  "value": "A String", # The value of the dimension.
+                  "dimensionName": "A String", # The name of the dimension.
+                  "etag": "A String", # The eTag of this response for caching purposes.
+                  "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                  "id": "A String", # The ID associated with the value if available.
+                },
+              },
+            ],
+            "weightCalculationStrategy": "A String", # Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM.
+            "creativeOptimizationConfigurationId": "A String", # Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.
+            "type": "A String", # Type of creative rotation. Can be used to specify whether to use sequential or random rotation.
+          },
+          "clickThroughUrl": { # Click-through URL # Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.
+            "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+            "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+            "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+            "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+          },
+          "comments": "A String", # Comments for this ad.
+          "remarketingListExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+            "expression": "A String", # Expression describing which lists are being targeted by the ad.
+          },
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this ad. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "type": "A String", # Type of ad. This is a required field on insertion. Note that default ads (AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).
+          "sslRequired": True or False, # Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated.
+          "audienceSegmentId": "A String", # Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD.
+          "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+            "expression": "A String", # Keyword expression being targeted by the ad.
+          },
+          "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Default click-through event tag properties for this ad.
+            "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+            "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+          },
+          "createInfo": { # Modification timestamp. # Information about the creation of this ad. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
+          "active": True or False, # Whether this ad is active. When true, archived must be false.
+          "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
+          "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
+          "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this ad. This is a required field and must be less than 256 characters long.
+          "dayPartTargeting": { # Day Part Targeting. # Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+            "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+            "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+              42,
+            ],
+            "daysOfWeek": [ # Days of the week when the ad will serve.
+                #
+                # Acceptable values are:
+                # - "SUNDAY"
+                # - "MONDAY"
+                # - "TUESDAY"
+                # - "WEDNESDAY"
+                # - "THURSDAY"
+                # - "FRIDAY"
+                # - "SATURDAY"
+              "A String",
+            ],
+          },
+          "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this ad. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "sslCompliant": True or False, # Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+          "placementAssignments": [ # Placement assignments for this ad.
+            { # Placement Assignment.
+              "active": True or False, # Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.
+              "placementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement. This is a read-only, auto-generated field.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+              "placementId": "A String", # ID of the placement to be assigned. This is a required field.
+              "sslRequired": True or False, # Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.
+            },
+          ],
+          "endTime": "A String", # Date and time that this ad should stop serving. Must be later than the start time. This is a required field on insertion.
+          "dynamicClickTracker": True or False, # Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing ad. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Ad ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM ad.
+    "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.
+      "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+      "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+    },
+    "campaignId": "A String", # Campaign ID of this ad. This is a required field on insertion.
+    "languageTargeting": { # Language Targeting. # Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a language that can be targeted by ads.
+          "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+          "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+          "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+          "name": "A String", # Name of this language.
+        },
+      ],
+    },
+    "advertiserId": "A String", # Advertiser ID of this ad. This is a required field on insertion.
+    "geoTargeting": { # Geographical Targeting. # Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+        { # Contains information about a country that can be targeted by ads.
+          "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+          "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+          "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+          "countryCode": "A String", # Country code.
+          "name": "A String", # Name of this country.
+        },
+      ],
+      "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+      "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+        { # Contains information about a postal code that can be targeted by ads.
+          "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+          "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+          "code": "A String", # Postal code. This is equivalent to the id field.
+          "id": "A String", # ID of this postal code.
+          "countryCode": "A String", # Country code of the country to which this postal code belongs.
+        },
+      ],
+      "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+        { # Contains information about a region that can be targeted by ads.
+          "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+          "countryDartId": "A String", # DART ID of the country to which this region belongs.
+          "name": "A String", # Name of this region.
+          "countryCode": "A String", # Country code of the country to which this region belongs.
+          "regionCode": "A String", # Region code.
+          "dartId": "A String", # DART ID of this region.
+        },
+      ],
+      "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+        { # Contains information about a city that can be targeted by ads.
+          "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+          "countryDartId": "A String", # DART ID of the country to which this city belongs.
+          "name": "A String", # Name of this city.
+          "countryCode": "A String", # Country code of the country to which this city belongs.
+          "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+          "regionCode": "A String", # Region code of the region to which this city belongs.
+          "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+          "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+          "regionDartId": "A String", # DART ID of the region to which this city belongs.
+        },
+      ],
+      "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+        { # Contains information about a metro region that can be targeted by ads.
+          "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+          "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+          "name": "A String", # Name of this metro region.
+          "countryCode": "A String", # Country code of the country to which this metro region belongs.
+          "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+          "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+          "dartId": "A String", # DART ID of this metro region.
+        },
+      ],
+    },
+    "creativeGroupAssignments": [ # Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments.
+      { # Creative Group Assignment.
+        "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+        "creativeGroupId": "A String", # ID of the creative group to be assigned.
+      },
+    ],
+    "deliverySchedule": { # Delivery Schedule. # Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.
+      "priority": "A String", # Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.
+      "hardCutoff": True or False, # Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.
+      "frequencyCap": { # Frequency Cap. # Limit on the number of times an individual user can be served the ad within a specified period of time.
+        "duration": "A String", # Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days in seconds, or 7,776,000.
+        "impressions": "A String", # Number of times an individual user can be served the ad within the specified duration. The maximum allowed is 15.
+      },
+      "impressionRatio": "A String", # Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then DCM will serve ad B three times as often as ad A. Must be between 1 and 10.
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "eventTagOverrides": [ # Event tag overrides for this ad.
+      { # Event tag override information.
+        "enabled": True or False, # Whether this override is enabled.
+        "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+      },
+    ],
+    "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
+    "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
+    "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a platform type that can be targeted by ads.
+          "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+          "id": "A String", # ID of this platform type.
+          "name": "A String", # Name of this platform type.
+        },
+      ],
+      "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+        { # Contains information about a particular version of an operating system that can be targeted by ads.
+          "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+          "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+          "name": "A String", # Name of this operating system version.
+          "id": "A String", # ID of this operating system version.
+          "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+          "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+        },
+      ],
+      "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a browser that can be targeted by ads.
+          "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+          "name": "A String", # Name of this browser.
+          "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+          "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+          "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+        },
+      ],
+      "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+        { # Contains information about an operating system that can be targeted by ads.
+          "mobile": True or False, # Whether this operating system is for mobile.
+          "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+          "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+          "name": "A String", # Name of this operating system.
+          "desktop": True or False, # Whether this operating system is for desktop.
+        },
+      ],
+      "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+        { # Contains information about a mobile carrier that can be targeted by ads.
+          "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+          "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+          "id": "A String", # ID of this mobile carrier.
+          "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+          "name": "A String", # Name of this mobile carrier.
+        },
+      ],
+      "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+          "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+          "id": "A String", # ID of this connection type.
+          "name": "A String", # Name of this connection type.
+        },
+      ],
+    },
+    "creativeRotation": { # Creative Rotation. # Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment.
+      "creativeAssignments": [ # Creative assignments in this creative rotation.
+        { # Creative Assignment.
+          "weight": 42, # Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM.
+          "sequence": 42, # Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL.
+          "applyEventTags": True or False, # Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.
+          "richMediaExitOverrides": [ # Rich media exit overrides for this creative assignment.
+              # Applicable when the creative type is any of the following:
+              # - RICH_MEDIA_INPAGE
+              # - RICH_MEDIA_INPAGE_FLOATING
+              # - RICH_MEDIA_IM_EXPAND
+              # - RICH_MEDIA_EXPANDING
+              # - RICH_MEDIA_INTERSTITIAL_FLOAT
+              # - RICH_MEDIA_MOBILE_IN_APP
+              # - RICH_MEDIA_MULTI_FLOATING
+              # - RICH_MEDIA_PEEL_DOWN
+              # - ADVANCED_BANNER
+              # - VPAID_LINEAR
+              # - VPAID_NON_LINEAR
+            { # Rich Media Exit Override.
+              "clickThroughUrl": { # Click-through URL # Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.
+                "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                    # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                    # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                    # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+              },
+              "enabled": True or False, # Whether to use the clickThroughUrl. If false, the creative-level exit will be used.
+              "exitId": "A String", # ID for the override to refer to a specific exit in the creative.
+            },
+          ],
+          "sslCompliant": True or False, # Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+          "creativeGroupAssignments": [ # Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments.
+            { # Creative Group Assignment.
+              "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+              "creativeGroupId": "A String", # ID of the creative group to be assigned.
+            },
+          ],
+          "companionCreativeOverrides": [ # Companion creative overrides for this creative assignment. Applicable to video ads.
+            { # Companion Click-through override.
+              "clickThroughUrl": { # Click-through URL # Click-through URL of this companion click-through override.
+                "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                    # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                    # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                    # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+              },
+              "creativeId": "A String", # ID of the creative for this companion click-through override.
+            },
+          ],
+          "startTime": "A String", # Date and time that the assigned creative should start serving.
+          "clickThroughUrl": { # Click-through URL # Click-through URL of the creative assignment.
+            "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+            "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+            "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+            "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+          },
+          "active": True or False, # Whether this creative assignment is active. When true, the creative will be included in the ad's rotation.
+          "creativeId": "A String", # ID of the creative to be assigned. This is a required field.
+          "endTime": "A String", # Date and time that the assigned creative should stop serving. Must be later than the start time.
+          "creativeIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the creative. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        },
+      ],
+      "weightCalculationStrategy": "A String", # Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM.
+      "creativeOptimizationConfigurationId": "A String", # Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.
+      "type": "A String", # Type of creative rotation. Can be used to specify whether to use sequential or random rotation.
+    },
+    "clickThroughUrl": { # Click-through URL # Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.
+      "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+          # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+          # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+          # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+      "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+      "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+      "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+    },
+    "comments": "A String", # Comments for this ad.
+    "remarketingListExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "expression": "A String", # Expression describing which lists are being targeted by the ad.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this ad. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "type": "A String", # Type of ad. This is a required field on insertion. Note that default ads (AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).
+    "sslRequired": True or False, # Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated.
+    "audienceSegmentId": "A String", # Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD.
+    "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "expression": "A String", # Keyword expression being targeted by the ad.
+    },
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Default click-through event tag properties for this ad.
+      "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+    },
+    "createInfo": { # Modification timestamp. # Information about the creation of this ad. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
+    "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
+    "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
+    "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this ad. This is a required field and must be less than 256 characters long.
+    "dayPartTargeting": { # Day Part Targeting. # Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+      "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+        42,
+      ],
+      "daysOfWeek": [ # Days of the week when the ad will serve.
+          #
+          # Acceptable values are:
+          # - "SUNDAY"
+          # - "MONDAY"
+          # - "TUESDAY"
+          # - "WEDNESDAY"
+          # - "THURSDAY"
+          # - "FRIDAY"
+          # - "SATURDAY"
+        "A String",
+      ],
+    },
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this ad. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "sslCompliant": True or False, # Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+    "placementAssignments": [ # Placement assignments for this ad.
+      { # Placement Assignment.
+        "active": True or False, # Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.
+        "placementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "placementId": "A String", # ID of the placement to be assigned. This is a required field.
+        "sslRequired": True or False, # Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      },
+    ],
+    "endTime": "A String", # Date and time that this ad should stop serving. Must be later than the start time. This is a required field on insertion.
+    "dynamicClickTracker": True or False, # Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM ad.
+      "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.
+        "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+        "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+      },
+      "campaignId": "A String", # Campaign ID of this ad. This is a required field on insertion.
+      "languageTargeting": { # Language Targeting. # Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a language that can be targeted by ads.
+            "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+            "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+            "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+            "name": "A String", # Name of this language.
+          },
+        ],
+      },
+      "advertiserId": "A String", # Advertiser ID of this ad. This is a required field on insertion.
+      "geoTargeting": { # Geographical Targeting. # Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+          { # Contains information about a country that can be targeted by ads.
+            "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+            "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+            "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+            "countryCode": "A String", # Country code.
+            "name": "A String", # Name of this country.
+          },
+        ],
+        "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+        "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+          { # Contains information about a postal code that can be targeted by ads.
+            "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+            "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+            "code": "A String", # Postal code. This is equivalent to the id field.
+            "id": "A String", # ID of this postal code.
+            "countryCode": "A String", # Country code of the country to which this postal code belongs.
+          },
+        ],
+        "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+          { # Contains information about a region that can be targeted by ads.
+            "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+            "countryDartId": "A String", # DART ID of the country to which this region belongs.
+            "name": "A String", # Name of this region.
+            "countryCode": "A String", # Country code of the country to which this region belongs.
+            "regionCode": "A String", # Region code.
+            "dartId": "A String", # DART ID of this region.
+          },
+        ],
+        "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+          { # Contains information about a city that can be targeted by ads.
+            "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+            "countryDartId": "A String", # DART ID of the country to which this city belongs.
+            "name": "A String", # Name of this city.
+            "countryCode": "A String", # Country code of the country to which this city belongs.
+            "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+            "regionCode": "A String", # Region code of the region to which this city belongs.
+            "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+            "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+            "regionDartId": "A String", # DART ID of the region to which this city belongs.
+          },
+        ],
+        "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+          { # Contains information about a metro region that can be targeted by ads.
+            "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+            "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+            "name": "A String", # Name of this metro region.
+            "countryCode": "A String", # Country code of the country to which this metro region belongs.
+            "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+            "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+            "dartId": "A String", # DART ID of this metro region.
+          },
+        ],
+      },
+      "creativeGroupAssignments": [ # Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments.
+        { # Creative Group Assignment.
+          "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+          "creativeGroupId": "A String", # ID of the creative group to be assigned.
+        },
+      ],
+      "deliverySchedule": { # Delivery Schedule. # Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.
+        "priority": "A String", # Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.
+        "hardCutoff": True or False, # Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.
+        "frequencyCap": { # Frequency Cap. # Limit on the number of times an individual user can be served the ad within a specified period of time.
+          "duration": "A String", # Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days in seconds, or 7,776,000.
+          "impressions": "A String", # Number of times an individual user can be served the ad within the specified duration. The maximum allowed is 15.
+        },
+        "impressionRatio": "A String", # Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then DCM will serve ad B three times as often as ad A. Must be between 1 and 10.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "eventTagOverrides": [ # Event tag overrides for this ad.
+        { # Event tag override information.
+          "enabled": True or False, # Whether this override is enabled.
+          "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+        },
+      ],
+      "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
+      "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
+      "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a platform type that can be targeted by ads.
+            "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+            "id": "A String", # ID of this platform type.
+            "name": "A String", # Name of this platform type.
+          },
+        ],
+        "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+          { # Contains information about a particular version of an operating system that can be targeted by ads.
+            "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+            "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+            "name": "A String", # Name of this operating system version.
+            "id": "A String", # ID of this operating system version.
+            "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+              "mobile": True or False, # Whether this operating system is for mobile.
+              "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+              "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+              "name": "A String", # Name of this operating system.
+              "desktop": True or False, # Whether this operating system is for desktop.
+            },
+            "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+          },
+        ],
+        "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a browser that can be targeted by ads.
+            "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+            "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+            "name": "A String", # Name of this browser.
+            "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+            "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+            "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          },
+        ],
+        "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+          { # Contains information about an operating system that can be targeted by ads.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+        ],
+        "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+          { # Contains information about a mobile carrier that can be targeted by ads.
+            "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+            "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+            "id": "A String", # ID of this mobile carrier.
+            "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+            "name": "A String", # Name of this mobile carrier.
+          },
+        ],
+        "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+            "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+            "id": "A String", # ID of this connection type.
+            "name": "A String", # Name of this connection type.
+          },
+        ],
+      },
+      "creativeRotation": { # Creative Rotation. # Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment.
+        "creativeAssignments": [ # Creative assignments in this creative rotation.
+          { # Creative Assignment.
+            "weight": 42, # Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM.
+            "sequence": 42, # Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL.
+            "applyEventTags": True or False, # Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.
+            "richMediaExitOverrides": [ # Rich media exit overrides for this creative assignment.
+                # Applicable when the creative type is any of the following:
+                # - RICH_MEDIA_INPAGE
+                # - RICH_MEDIA_INPAGE_FLOATING
+                # - RICH_MEDIA_IM_EXPAND
+                # - RICH_MEDIA_EXPANDING
+                # - RICH_MEDIA_INTERSTITIAL_FLOAT
+                # - RICH_MEDIA_MOBILE_IN_APP
+                # - RICH_MEDIA_MULTI_FLOATING
+                # - RICH_MEDIA_PEEL_DOWN
+                # - ADVANCED_BANNER
+                # - VPAID_LINEAR
+                # - VPAID_NON_LINEAR
+              { # Rich Media Exit Override.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "enabled": True or False, # Whether to use the clickThroughUrl. If false, the creative-level exit will be used.
+                "exitId": "A String", # ID for the override to refer to a specific exit in the creative.
+              },
+            ],
+            "sslCompliant": True or False, # Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+            "creativeGroupAssignments": [ # Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments.
+              { # Creative Group Assignment.
+                "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+                "creativeGroupId": "A String", # ID of the creative group to be assigned.
+              },
+            ],
+            "companionCreativeOverrides": [ # Companion creative overrides for this creative assignment. Applicable to video ads.
+              { # Companion Click-through override.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of this companion click-through override.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "creativeId": "A String", # ID of the creative for this companion click-through override.
+              },
+            ],
+            "startTime": "A String", # Date and time that the assigned creative should start serving.
+            "clickThroughUrl": { # Click-through URL # Click-through URL of the creative assignment.
+              "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                  # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                  # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                  # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+              "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+              "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+              "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+            },
+            "active": True or False, # Whether this creative assignment is active. When true, the creative will be included in the ad's rotation.
+            "creativeId": "A String", # ID of the creative to be assigned. This is a required field.
+            "endTime": "A String", # Date and time that the assigned creative should stop serving. Must be later than the start time.
+            "creativeIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the creative. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          },
+        ],
+        "weightCalculationStrategy": "A String", # Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM.
+        "creativeOptimizationConfigurationId": "A String", # Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.
+        "type": "A String", # Type of creative rotation. Can be used to specify whether to use sequential or random rotation.
+      },
+      "clickThroughUrl": { # Click-through URL # Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.
+        "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+            # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+            # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+            # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+        "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+        "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+        "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+      },
+      "comments": "A String", # Comments for this ad.
+      "remarketingListExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "expression": "A String", # Expression describing which lists are being targeted by the ad.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this ad. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "type": "A String", # Type of ad. This is a required field on insertion. Note that default ads (AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).
+      "sslRequired": True or False, # Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      "audienceSegmentId": "A String", # Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD.
+      "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "expression": "A String", # Keyword expression being targeted by the ad.
+      },
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Default click-through event tag properties for this ad.
+        "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+        "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+      },
+      "createInfo": { # Modification timestamp. # Information about the creation of this ad. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
+      "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
+      "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
+      "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this ad. This is a required field and must be less than 256 characters long.
+      "dayPartTargeting": { # Day Part Targeting. # Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+        "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+          42,
+        ],
+        "daysOfWeek": [ # Days of the week when the ad will serve.
+            #
+            # Acceptable values are:
+            # - "SUNDAY"
+            # - "MONDAY"
+            # - "TUESDAY"
+            # - "WEDNESDAY"
+            # - "THURSDAY"
+            # - "FRIDAY"
+            # - "SATURDAY"
+          "A String",
+        ],
+      },
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this ad. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "sslCompliant": True or False, # Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      "placementAssignments": [ # Placement assignments for this ad.
+        { # Placement Assignment.
+          "active": True or False, # Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.
+          "placementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "placementId": "A String", # ID of the placement to be assigned. This is a required field.
+          "sslRequired": True or False, # Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.
+        },
+      ],
+      "endTime": "A String", # Date and time that this ad should stop serving. Must be later than the start time. This is a required field on insertion.
+      "dynamicClickTracker": True or False, # Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing ad.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM ad.
+    "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.
+      "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+      "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+    },
+    "campaignId": "A String", # Campaign ID of this ad. This is a required field on insertion.
+    "languageTargeting": { # Language Targeting. # Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a language that can be targeted by ads.
+          "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+          "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+          "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+          "name": "A String", # Name of this language.
+        },
+      ],
+    },
+    "advertiserId": "A String", # Advertiser ID of this ad. This is a required field on insertion.
+    "geoTargeting": { # Geographical Targeting. # Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+        { # Contains information about a country that can be targeted by ads.
+          "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+          "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+          "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+          "countryCode": "A String", # Country code.
+          "name": "A String", # Name of this country.
+        },
+      ],
+      "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+      "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+        { # Contains information about a postal code that can be targeted by ads.
+          "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+          "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+          "code": "A String", # Postal code. This is equivalent to the id field.
+          "id": "A String", # ID of this postal code.
+          "countryCode": "A String", # Country code of the country to which this postal code belongs.
+        },
+      ],
+      "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+        { # Contains information about a region that can be targeted by ads.
+          "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+          "countryDartId": "A String", # DART ID of the country to which this region belongs.
+          "name": "A String", # Name of this region.
+          "countryCode": "A String", # Country code of the country to which this region belongs.
+          "regionCode": "A String", # Region code.
+          "dartId": "A String", # DART ID of this region.
+        },
+      ],
+      "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+        { # Contains information about a city that can be targeted by ads.
+          "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+          "countryDartId": "A String", # DART ID of the country to which this city belongs.
+          "name": "A String", # Name of this city.
+          "countryCode": "A String", # Country code of the country to which this city belongs.
+          "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+          "regionCode": "A String", # Region code of the region to which this city belongs.
+          "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+          "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+          "regionDartId": "A String", # DART ID of the region to which this city belongs.
+        },
+      ],
+      "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+        { # Contains information about a metro region that can be targeted by ads.
+          "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+          "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+          "name": "A String", # Name of this metro region.
+          "countryCode": "A String", # Country code of the country to which this metro region belongs.
+          "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+          "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+          "dartId": "A String", # DART ID of this metro region.
+        },
+      ],
+    },
+    "creativeGroupAssignments": [ # Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments.
+      { # Creative Group Assignment.
+        "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+        "creativeGroupId": "A String", # ID of the creative group to be assigned.
+      },
+    ],
+    "deliverySchedule": { # Delivery Schedule. # Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.
+      "priority": "A String", # Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.
+      "hardCutoff": True or False, # Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.
+      "frequencyCap": { # Frequency Cap. # Limit on the number of times an individual user can be served the ad within a specified period of time.
+        "duration": "A String", # Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days in seconds, or 7,776,000.
+        "impressions": "A String", # Number of times an individual user can be served the ad within the specified duration. The maximum allowed is 15.
+      },
+      "impressionRatio": "A String", # Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then DCM will serve ad B three times as often as ad A. Must be between 1 and 10.
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "eventTagOverrides": [ # Event tag overrides for this ad.
+      { # Event tag override information.
+        "enabled": True or False, # Whether this override is enabled.
+        "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+      },
+    ],
+    "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
+    "archived": True or False, # Whether this ad is archived. When true, active must be false.
+    "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
+    "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a platform type that can be targeted by ads.
+          "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+          "id": "A String", # ID of this platform type.
+          "name": "A String", # Name of this platform type.
+        },
+      ],
+      "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+        { # Contains information about a particular version of an operating system that can be targeted by ads.
+          "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+          "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+          "name": "A String", # Name of this operating system version.
+          "id": "A String", # ID of this operating system version.
+          "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+          "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+        },
+      ],
+      "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a browser that can be targeted by ads.
+          "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+          "name": "A String", # Name of this browser.
+          "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+          "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+          "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+        },
+      ],
+      "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+        { # Contains information about an operating system that can be targeted by ads.
+          "mobile": True or False, # Whether this operating system is for mobile.
+          "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+          "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+          "name": "A String", # Name of this operating system.
+          "desktop": True or False, # Whether this operating system is for desktop.
+        },
+      ],
+      "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+        { # Contains information about a mobile carrier that can be targeted by ads.
+          "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+          "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+          "id": "A String", # ID of this mobile carrier.
+          "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+          "name": "A String", # Name of this mobile carrier.
+        },
+      ],
+      "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+          "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+          "id": "A String", # ID of this connection type.
+          "name": "A String", # Name of this connection type.
+        },
+      ],
+    },
+    "creativeRotation": { # Creative Rotation. # Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment.
+      "creativeAssignments": [ # Creative assignments in this creative rotation.
+        { # Creative Assignment.
+          "weight": 42, # Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM.
+          "sequence": 42, # Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL.
+          "applyEventTags": True or False, # Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.
+          "richMediaExitOverrides": [ # Rich media exit overrides for this creative assignment.
+              # Applicable when the creative type is any of the following:
+              # - RICH_MEDIA_INPAGE
+              # - RICH_MEDIA_INPAGE_FLOATING
+              # - RICH_MEDIA_IM_EXPAND
+              # - RICH_MEDIA_EXPANDING
+              # - RICH_MEDIA_INTERSTITIAL_FLOAT
+              # - RICH_MEDIA_MOBILE_IN_APP
+              # - RICH_MEDIA_MULTI_FLOATING
+              # - RICH_MEDIA_PEEL_DOWN
+              # - ADVANCED_BANNER
+              # - VPAID_LINEAR
+              # - VPAID_NON_LINEAR
+            { # Rich Media Exit Override.
+              "clickThroughUrl": { # Click-through URL # Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.
+                "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                    # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                    # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                    # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+              },
+              "enabled": True or False, # Whether to use the clickThroughUrl. If false, the creative-level exit will be used.
+              "exitId": "A String", # ID for the override to refer to a specific exit in the creative.
+            },
+          ],
+          "sslCompliant": True or False, # Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+          "creativeGroupAssignments": [ # Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments.
+            { # Creative Group Assignment.
+              "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+              "creativeGroupId": "A String", # ID of the creative group to be assigned.
+            },
+          ],
+          "companionCreativeOverrides": [ # Companion creative overrides for this creative assignment. Applicable to video ads.
+            { # Companion Click-through override.
+              "clickThroughUrl": { # Click-through URL # Click-through URL of this companion click-through override.
+                "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                    # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                    # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                    # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+              },
+              "creativeId": "A String", # ID of the creative for this companion click-through override.
+            },
+          ],
+          "startTime": "A String", # Date and time that the assigned creative should start serving.
+          "clickThroughUrl": { # Click-through URL # Click-through URL of the creative assignment.
+            "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+            "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+            "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+            "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+          },
+          "active": True or False, # Whether this creative assignment is active. When true, the creative will be included in the ad's rotation.
+          "creativeId": "A String", # ID of the creative to be assigned. This is a required field.
+          "endTime": "A String", # Date and time that the assigned creative should stop serving. Must be later than the start time.
+          "creativeIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the creative. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        },
+      ],
+      "weightCalculationStrategy": "A String", # Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM.
+      "creativeOptimizationConfigurationId": "A String", # Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.
+      "type": "A String", # Type of creative rotation. Can be used to specify whether to use sequential or random rotation.
+    },
+    "clickThroughUrl": { # Click-through URL # Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.
+      "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+          # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+          # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+          # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+      "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+      "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+      "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+    },
+    "comments": "A String", # Comments for this ad.
+    "remarketingListExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "expression": "A String", # Expression describing which lists are being targeted by the ad.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this ad. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "type": "A String", # Type of ad. This is a required field on insertion. Note that default ads (AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).
+    "sslRequired": True or False, # Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated.
+    "audienceSegmentId": "A String", # Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD.
+    "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "expression": "A String", # Keyword expression being targeted by the ad.
+    },
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Default click-through event tag properties for this ad.
+      "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+    },
+    "createInfo": { # Modification timestamp. # Information about the creation of this ad. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
+    "active": True or False, # Whether this ad is active. When true, archived must be false.
+    "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
+    "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
+    "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this ad. This is a required field and must be less than 256 characters long.
+    "dayPartTargeting": { # Day Part Targeting. # Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+      "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+      "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+        42,
+      ],
+      "daysOfWeek": [ # Days of the week when the ad will serve.
+          #
+          # Acceptable values are:
+          # - "SUNDAY"
+          # - "MONDAY"
+          # - "TUESDAY"
+          # - "WEDNESDAY"
+          # - "THURSDAY"
+          # - "FRIDAY"
+          # - "SATURDAY"
+        "A String",
+      ],
+    },
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this ad. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "sslCompliant": True or False, # Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+    "placementAssignments": [ # Placement assignments for this ad.
+      { # Placement Assignment.
+        "active": True or False, # Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.
+        "placementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "placementId": "A String", # ID of the placement to be assigned. This is a required field.
+        "sslRequired": True or False, # Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      },
+    ],
+    "endTime": "A String", # Date and time that this ad should stop serving. Must be later than the start time. This is a required field on insertion.
+    "dynamicClickTracker": True or False, # Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM ad.
+      "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.
+        "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+        "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+      },
+      "campaignId": "A String", # Campaign ID of this ad. This is a required field on insertion.
+      "languageTargeting": { # Language Targeting. # Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a language that can be targeted by ads.
+            "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+            "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+            "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+            "name": "A String", # Name of this language.
+          },
+        ],
+      },
+      "advertiserId": "A String", # Advertiser ID of this ad. This is a required field on insertion.
+      "geoTargeting": { # Geographical Targeting. # Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+          { # Contains information about a country that can be targeted by ads.
+            "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+            "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+            "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+            "countryCode": "A String", # Country code.
+            "name": "A String", # Name of this country.
+          },
+        ],
+        "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+        "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+          { # Contains information about a postal code that can be targeted by ads.
+            "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+            "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+            "code": "A String", # Postal code. This is equivalent to the id field.
+            "id": "A String", # ID of this postal code.
+            "countryCode": "A String", # Country code of the country to which this postal code belongs.
+          },
+        ],
+        "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+          { # Contains information about a region that can be targeted by ads.
+            "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+            "countryDartId": "A String", # DART ID of the country to which this region belongs.
+            "name": "A String", # Name of this region.
+            "countryCode": "A String", # Country code of the country to which this region belongs.
+            "regionCode": "A String", # Region code.
+            "dartId": "A String", # DART ID of this region.
+          },
+        ],
+        "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+          { # Contains information about a city that can be targeted by ads.
+            "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+            "countryDartId": "A String", # DART ID of the country to which this city belongs.
+            "name": "A String", # Name of this city.
+            "countryCode": "A String", # Country code of the country to which this city belongs.
+            "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+            "regionCode": "A String", # Region code of the region to which this city belongs.
+            "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+            "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+            "regionDartId": "A String", # DART ID of the region to which this city belongs.
+          },
+        ],
+        "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+          { # Contains information about a metro region that can be targeted by ads.
+            "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+            "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+            "name": "A String", # Name of this metro region.
+            "countryCode": "A String", # Country code of the country to which this metro region belongs.
+            "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+            "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+            "dartId": "A String", # DART ID of this metro region.
+          },
+        ],
+      },
+      "creativeGroupAssignments": [ # Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments.
+        { # Creative Group Assignment.
+          "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+          "creativeGroupId": "A String", # ID of the creative group to be assigned.
+        },
+      ],
+      "deliverySchedule": { # Delivery Schedule. # Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.
+        "priority": "A String", # Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.
+        "hardCutoff": True or False, # Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.
+        "frequencyCap": { # Frequency Cap. # Limit on the number of times an individual user can be served the ad within a specified period of time.
+          "duration": "A String", # Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days in seconds, or 7,776,000.
+          "impressions": "A String", # Number of times an individual user can be served the ad within the specified duration. The maximum allowed is 15.
+        },
+        "impressionRatio": "A String", # Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then DCM will serve ad B three times as often as ad A. Must be between 1 and 10.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "eventTagOverrides": [ # Event tag overrides for this ad.
+        { # Event tag override information.
+          "enabled": True or False, # Whether this override is enabled.
+          "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+        },
+      ],
+      "id": "A String", # ID of this ad. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this ad. This is a read-only field that can be left blank.
+      "archived": True or False, # Whether this ad is archived. When true, active must be false.
+      "targetingTemplateId": "A String", # Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.
+      "technologyTargeting": { # Technology Targeting. # Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a platform type that can be targeted by ads.
+            "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+            "id": "A String", # ID of this platform type.
+            "name": "A String", # Name of this platform type.
+          },
+        ],
+        "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+          { # Contains information about a particular version of an operating system that can be targeted by ads.
+            "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+            "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+            "name": "A String", # Name of this operating system version.
+            "id": "A String", # ID of this operating system version.
+            "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+              "mobile": True or False, # Whether this operating system is for mobile.
+              "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+              "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+              "name": "A String", # Name of this operating system.
+              "desktop": True or False, # Whether this operating system is for desktop.
+            },
+            "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+          },
+        ],
+        "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a browser that can be targeted by ads.
+            "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+            "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+            "name": "A String", # Name of this browser.
+            "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+            "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+            "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          },
+        ],
+        "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+          { # Contains information about an operating system that can be targeted by ads.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+        ],
+        "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+          { # Contains information about a mobile carrier that can be targeted by ads.
+            "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+            "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+            "id": "A String", # ID of this mobile carrier.
+            "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+            "name": "A String", # Name of this mobile carrier.
+          },
+        ],
+        "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+            "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+            "id": "A String", # ID of this connection type.
+            "name": "A String", # Name of this connection type.
+          },
+        ],
+      },
+      "creativeRotation": { # Creative Rotation. # Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment.
+        "creativeAssignments": [ # Creative assignments in this creative rotation.
+          { # Creative Assignment.
+            "weight": 42, # Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM.
+            "sequence": 42, # Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL.
+            "applyEventTags": True or False, # Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.
+            "richMediaExitOverrides": [ # Rich media exit overrides for this creative assignment.
+                # Applicable when the creative type is any of the following:
+                # - RICH_MEDIA_INPAGE
+                # - RICH_MEDIA_INPAGE_FLOATING
+                # - RICH_MEDIA_IM_EXPAND
+                # - RICH_MEDIA_EXPANDING
+                # - RICH_MEDIA_INTERSTITIAL_FLOAT
+                # - RICH_MEDIA_MOBILE_IN_APP
+                # - RICH_MEDIA_MULTI_FLOATING
+                # - RICH_MEDIA_PEEL_DOWN
+                # - ADVANCED_BANNER
+                # - VPAID_LINEAR
+                # - VPAID_NON_LINEAR
+              { # Rich Media Exit Override.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "enabled": True or False, # Whether to use the clickThroughUrl. If false, the creative-level exit will be used.
+                "exitId": "A String", # ID for the override to refer to a specific exit in the creative.
+              },
+            ],
+            "sslCompliant": True or False, # Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+            "creativeGroupAssignments": [ # Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments.
+              { # Creative Group Assignment.
+                "creativeGroupNumber": "A String", # Creative group number of the creative group assignment.
+                "creativeGroupId": "A String", # ID of the creative group to be assigned.
+              },
+            ],
+            "companionCreativeOverrides": [ # Companion creative overrides for this creative assignment. Applicable to video ads.
+              { # Companion Click-through override.
+                "clickThroughUrl": { # Click-through URL # Click-through URL of this companion click-through override.
+                  "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                      # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                      # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                      # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+                  "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+                  "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+                  "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+                },
+                "creativeId": "A String", # ID of the creative for this companion click-through override.
+              },
+            ],
+            "startTime": "A String", # Date and time that the assigned creative should start serving.
+            "clickThroughUrl": { # Click-through URL # Click-through URL of the creative assignment.
+              "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+                  # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+                  # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+                  # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+              "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+              "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+              "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+            },
+            "active": True or False, # Whether this creative assignment is active. When true, the creative will be included in the ad's rotation.
+            "creativeId": "A String", # ID of the creative to be assigned. This is a required field.
+            "endTime": "A String", # Date and time that the assigned creative should stop serving. Must be later than the start time.
+            "creativeIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the creative. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          },
+        ],
+        "weightCalculationStrategy": "A String", # Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM.
+        "creativeOptimizationConfigurationId": "A String", # Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.
+        "type": "A String", # Type of creative rotation. Can be used to specify whether to use sequential or random rotation.
+      },
+      "clickThroughUrl": { # Click-through URL # Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.
+        "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows:
+            # - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field.
+            # - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field.
+            # - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field.
+        "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.
+        "landingPageId": "A String", # ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false.
+        "defaultLandingPage": True or False, # Whether the campaign default landing page is used.
+      },
+      "comments": "A String", # Comments for this ad.
+      "remarketingListExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "expression": "A String", # Expression describing which lists are being targeted by the ad.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this ad. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "type": "A String", # Type of ad. This is a required field on insertion. Note that default ads (AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).
+      "sslRequired": True or False, # Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      "audienceSegmentId": "A String", # Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD.
+      "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "expression": "A String", # Keyword expression being targeted by the ad.
+      },
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Default click-through event tag properties for this ad.
+        "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+        "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+      },
+      "createInfo": { # Modification timestamp. # Information about the creation of this ad. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "startTime": "A String", # Date and time that this ad should start serving. If creating an ad, this field must be a time in the future. This is a required field on insertion.
+      "active": True or False, # Whether this ad is active. When true, archived must be false.
+      "compatibility": "A String", # Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard.
+      "kind": "dfareporting#ad", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ad".
+      "subaccountId": "A String", # Subaccount ID of this ad. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this ad. This is a required field and must be less than 256 characters long.
+      "dayPartTargeting": { # Day Part Targeting. # Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.
+        "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+        "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+          42,
+        ],
+        "daysOfWeek": [ # Days of the week when the ad will serve.
+            #
+            # Acceptable values are:
+            # - "SUNDAY"
+            # - "MONDAY"
+            # - "TUESDAY"
+            # - "WEDNESDAY"
+            # - "THURSDAY"
+            # - "FRIDAY"
+            # - "SATURDAY"
+          "A String",
+        ],
+      },
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this ad. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "sslCompliant": True or False, # Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated.
+      "placementAssignments": [ # Placement assignments for this ad.
+        { # Placement Assignment.
+          "active": True or False, # Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.
+          "placementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "placementId": "A String", # ID of the placement to be assigned. This is a required field.
+          "sslRequired": True or False, # Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.
+        },
+      ],
+      "endTime": "A String", # Date and time that this ad should stop serving. Must be later than the start time. This is a required field on insertion.
+      "dynamicClickTracker": True or False, # Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.advertiserGroups.html b/docs/dyn/dfareporting_v2_7.advertiserGroups.html
new file mode 100644
index 00000000000..a2cdfd5f651
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.advertiserGroups.html
@@ -0,0 +1,263 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.advertiserGroups.html">advertiserGroups</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, id)</a></code></p>
+<p class="firstline">Deletes an existing advertiser group.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one advertiser group by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new advertiser group.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of advertiser groups, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing advertiser group. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing advertiser group.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, id)</code>
+  <pre>Deletes an existing advertiser group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Advertiser group ID. (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one advertiser group by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Advertiser group ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Groups advertisers together so that reports can be generated for the entire group at once.
+      "kind": "dfareporting#advertiserGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroup".
+      "id": "A String", # ID of this advertiser group. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account.
+      "accountId": "A String", # Account ID of this advertiser group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new advertiser group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Groups advertisers together so that reports can be generated for the entire group at once.
+    "kind": "dfareporting#advertiserGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroup".
+    "id": "A String", # ID of this advertiser group. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account.
+    "accountId": "A String", # Account ID of this advertiser group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Groups advertisers together so that reports can be generated for the entire group at once.
+      "kind": "dfareporting#advertiserGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroup".
+      "id": "A String", # ID of this advertiser group. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account.
+      "accountId": "A String", # Account ID of this advertiser group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
+  <pre>Retrieves a list of advertiser groups, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "advertiser*2015" will return objects with names like "advertiser group June 2015", "advertiser group April 2015", or simply "advertiser group 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "advertisergroup" will match objects with name "my advertisergroup", "advertisergroup 2015", or simply "advertisergroup".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only advertiser groups with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Advertiser Group List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#advertiserGroupsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroupsListResponse".
+    "advertiserGroups": [ # Advertiser group collection.
+      { # Groups advertisers together so that reports can be generated for the entire group at once.
+          "kind": "dfareporting#advertiserGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroup".
+          "id": "A String", # ID of this advertiser group. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account.
+          "accountId": "A String", # Account ID of this advertiser group. This is a read-only field that can be left blank.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing advertiser group. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Advertiser group ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Groups advertisers together so that reports can be generated for the entire group at once.
+    "kind": "dfareporting#advertiserGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroup".
+    "id": "A String", # ID of this advertiser group. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account.
+    "accountId": "A String", # Account ID of this advertiser group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Groups advertisers together so that reports can be generated for the entire group at once.
+      "kind": "dfareporting#advertiserGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroup".
+      "id": "A String", # ID of this advertiser group. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account.
+      "accountId": "A String", # Account ID of this advertiser group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing advertiser group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Groups advertisers together so that reports can be generated for the entire group at once.
+    "kind": "dfareporting#advertiserGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroup".
+    "id": "A String", # ID of this advertiser group. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account.
+    "accountId": "A String", # Account ID of this advertiser group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Groups advertisers together so that reports can be generated for the entire group at once.
+      "kind": "dfareporting#advertiserGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroup".
+      "id": "A String", # ID of this advertiser group. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account.
+      "accountId": "A String", # Account ID of this advertiser group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.advertisers.html b/docs/dyn/dfareporting_v2_7.advertisers.html
new file mode 100644
index 00000000000..d2ebd1d5e50
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.advertisers.html
@@ -0,0 +1,475 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.advertisers.html">advertisers</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one advertiser by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new advertiser.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, includeAdvertisersWithoutGroupsOnly=None, onlyParent=None, pageToken=None, sortOrder=None, status=None, maxResults=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, floodlightConfigurationIds=None, sortField=None)</a></code></p>
+<p class="firstline">Retrieves a list of advertisers, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing advertiser. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing advertiser.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one advertiser by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Advertiser ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM advertiser.
+      "status": "A String", # Status of this advertiser.
+      "kind": "dfareporting#advertiser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiser".
+      "subaccountId": "A String", # Subaccount ID of this advertiser.This is a read-only field that can be left blank.
+      "name": "A String", # Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.
+      "originalFloodlightConfigurationId": "A String", # Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.
+      "clickThroughUrlSuffix": "A String", # Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as:
+          # - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups.
+          # - This advertiser's original floodlight configuration is not already shared with another advertiser.
+      "suspended": True or False, # Suspension status of this advertiser.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserGroupId": "A String", # ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "defaultEmail": "A String", # Default email address used in sender field for tag emails.
+      "id": "A String", # ID of this advertiser. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this advertiser.This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new advertiser.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM advertiser.
+    "status": "A String", # Status of this advertiser.
+    "kind": "dfareporting#advertiser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiser".
+    "subaccountId": "A String", # Subaccount ID of this advertiser.This is a read-only field that can be left blank.
+    "name": "A String", # Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.
+    "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.
+    "originalFloodlightConfigurationId": "A String", # Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.
+    "clickThroughUrlSuffix": "A String", # Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as:
+        # - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups.
+        # - This advertiser's original floodlight configuration is not already shared with another advertiser.
+    "suspended": True or False, # Suspension status of this advertiser.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserGroupId": "A String", # ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "defaultEmail": "A String", # Default email address used in sender field for tag emails.
+    "id": "A String", # ID of this advertiser. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this advertiser.This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM advertiser.
+      "status": "A String", # Status of this advertiser.
+      "kind": "dfareporting#advertiser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiser".
+      "subaccountId": "A String", # Subaccount ID of this advertiser.This is a read-only field that can be left blank.
+      "name": "A String", # Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.
+      "originalFloodlightConfigurationId": "A String", # Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.
+      "clickThroughUrlSuffix": "A String", # Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as:
+          # - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups.
+          # - This advertiser's original floodlight configuration is not already shared with another advertiser.
+      "suspended": True or False, # Suspension status of this advertiser.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserGroupId": "A String", # ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "defaultEmail": "A String", # Default email address used in sender field for tag emails.
+      "id": "A String", # ID of this advertiser. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this advertiser.This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, includeAdvertisersWithoutGroupsOnly=None, onlyParent=None, pageToken=None, sortOrder=None, status=None, maxResults=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, floodlightConfigurationIds=None, sortField=None)</code>
+  <pre>Retrieves a list of advertisers, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  includeAdvertisersWithoutGroupsOnly: boolean, Select only advertisers which do not belong to any advertiser group.
+  onlyParent: boolean, Select only advertisers which use another advertiser's floodlight configuration.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  status: string, Select only advertisers with the specified status.
+    Allowed values
+      APPROVED - 
+      ON_HOLD - 
+  maxResults: integer, Maximum number of results to return.
+  advertiserGroupIds: string, Select only advertisers with these advertiser group IDs. (repeated)
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "advertiser*2015" will return objects with names like "advertiser June 2015", "advertiser April 2015", or simply "advertiser 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "advertiser" will match objects with name "my advertiser", "advertiser 2015", or simply "advertiser".
+  subaccountId: string, Select only advertisers with these subaccount IDs.
+  ids: string, Select only advertisers with these IDs. (repeated)
+  floodlightConfigurationIds: string, Select only advertisers with these floodlight configuration IDs. (repeated)
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+
+Returns:
+  An object of the form:
+
+    { # Advertiser List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "advertisers": [ # Advertiser collection.
+      { # Contains properties of a DCM advertiser.
+          "status": "A String", # Status of this advertiser.
+          "kind": "dfareporting#advertiser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiser".
+          "subaccountId": "A String", # Subaccount ID of this advertiser.This is a read-only field that can be left blank.
+          "name": "A String", # Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.
+          "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.
+          "originalFloodlightConfigurationId": "A String", # Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.
+          "clickThroughUrlSuffix": "A String", # Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.
+          "floodlightConfigurationId": "A String", # Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as:
+              # - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups.
+              # - This advertiser's original floodlight configuration is not already shared with another advertiser.
+          "suspended": True or False, # Suspension status of this advertiser.
+          "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "advertiserGroupId": "A String", # ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "defaultEmail": "A String", # Default email address used in sender field for tag emails.
+          "id": "A String", # ID of this advertiser. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this advertiser.This is a read-only field that can be left blank.
+        },
+    ],
+    "kind": "dfareporting#advertisersListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertisersListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing advertiser. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Advertiser ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM advertiser.
+    "status": "A String", # Status of this advertiser.
+    "kind": "dfareporting#advertiser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiser".
+    "subaccountId": "A String", # Subaccount ID of this advertiser.This is a read-only field that can be left blank.
+    "name": "A String", # Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.
+    "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.
+    "originalFloodlightConfigurationId": "A String", # Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.
+    "clickThroughUrlSuffix": "A String", # Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as:
+        # - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups.
+        # - This advertiser's original floodlight configuration is not already shared with another advertiser.
+    "suspended": True or False, # Suspension status of this advertiser.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserGroupId": "A String", # ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "defaultEmail": "A String", # Default email address used in sender field for tag emails.
+    "id": "A String", # ID of this advertiser. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this advertiser.This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM advertiser.
+      "status": "A String", # Status of this advertiser.
+      "kind": "dfareporting#advertiser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiser".
+      "subaccountId": "A String", # Subaccount ID of this advertiser.This is a read-only field that can be left blank.
+      "name": "A String", # Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.
+      "originalFloodlightConfigurationId": "A String", # Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.
+      "clickThroughUrlSuffix": "A String", # Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as:
+          # - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups.
+          # - This advertiser's original floodlight configuration is not already shared with another advertiser.
+      "suspended": True or False, # Suspension status of this advertiser.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserGroupId": "A String", # ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "defaultEmail": "A String", # Default email address used in sender field for tag emails.
+      "id": "A String", # ID of this advertiser. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this advertiser.This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing advertiser.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM advertiser.
+    "status": "A String", # Status of this advertiser.
+    "kind": "dfareporting#advertiser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiser".
+    "subaccountId": "A String", # Subaccount ID of this advertiser.This is a read-only field that can be left blank.
+    "name": "A String", # Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.
+    "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.
+    "originalFloodlightConfigurationId": "A String", # Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.
+    "clickThroughUrlSuffix": "A String", # Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as:
+        # - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups.
+        # - This advertiser's original floodlight configuration is not already shared with another advertiser.
+    "suspended": True or False, # Suspension status of this advertiser.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserGroupId": "A String", # ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "defaultEmail": "A String", # Default email address used in sender field for tag emails.
+    "id": "A String", # ID of this advertiser. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this advertiser.This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM advertiser.
+      "status": "A String", # Status of this advertiser.
+      "kind": "dfareporting#advertiser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiser".
+      "subaccountId": "A String", # Subaccount ID of this advertiser.This is a read-only field that can be left blank.
+      "name": "A String", # Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.
+      "originalFloodlightConfigurationId": "A String", # Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.
+      "clickThroughUrlSuffix": "A String", # Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as:
+          # - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups.
+          # - This advertiser's original floodlight configuration is not already shared with another advertiser.
+      "suspended": True or False, # Suspension status of this advertiser.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserGroupId": "A String", # ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "defaultEmail": "A String", # Default email address used in sender field for tag emails.
+      "id": "A String", # ID of this advertiser. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this advertiser.This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.browsers.html b/docs/dyn/dfareporting_v2_7.browsers.html
new file mode 100644
index 00000000000..9eb3b276410
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.browsers.html
@@ -0,0 +1,106 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.browsers.html">browsers</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of browsers.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of browsers.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Browser List Response
+    "kind": "dfareporting#browsersListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browsersListResponse".
+    "browsers": [ # Browser collection.
+      { # Contains information about a browser that can be targeted by ads.
+        "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+        "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+        "name": "A String", # Name of this browser.
+        "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+        "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+        "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.campaignCreativeAssociations.html b/docs/dyn/dfareporting_v2_7.campaignCreativeAssociations.html
new file mode 100644
index 00000000000..3d500267bea
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.campaignCreativeAssociations.html
@@ -0,0 +1,155 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.campaignCreativeAssociations.html">campaignCreativeAssociations</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, campaignId, body)</a></code></p>
+<p class="firstline">Associates a creative with the specified campaign. This method creates a default ad with dimensions matching the creative in the campaign if such a default ad does not exist already.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="insert">insert(profileId, campaignId, body)</code>
+  <pre>Associates a creative with the specified campaign. This method creates a default ad with dimensions matching the creative in the campaign if such a default ad does not exist already.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Campaign ID in this association. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Identifies a creative which has been associated with a given campaign.
+    "creativeId": "A String", # ID of the creative associated with the campaign. This is a required field.
+    "kind": "dfareporting#campaignCreativeAssociation", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaignCreativeAssociation".
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Identifies a creative which has been associated with a given campaign.
+      "creativeId": "A String", # ID of the creative associated with the campaign. This is a required field.
+      "kind": "dfareporting#campaignCreativeAssociation", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaignCreativeAssociation".
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, campaignId, maxResults=None, pageToken=None, sortOrder=None)</code>
+  <pre>Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Campaign ID in this association. (required)
+  maxResults: integer, Maximum number of results to return.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Campaign Creative Association List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "campaignCreativeAssociations": [ # Campaign creative association collection
+      { # Identifies a creative which has been associated with a given campaign.
+          "creativeId": "A String", # ID of the creative associated with the campaign. This is a required field.
+          "kind": "dfareporting#campaignCreativeAssociation", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaignCreativeAssociation".
+        },
+    ],
+    "kind": "dfareporting#campaignCreativeAssociationsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaignCreativeAssociationsListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.campaigns.html b/docs/dyn/dfareporting_v2_7.campaigns.html
new file mode 100644
index 00000000000..1d1d5a3bcdc
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.campaigns.html
@@ -0,0 +1,1131 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.campaigns.html">campaigns</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one campaign by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, defaultLandingPageName, defaultLandingPageUrl, body)</a></code></p>
+<p class="firstline">Inserts a new campaign.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, overriddenEventTagId=None, archived=None, advertiserIds=None, pageToken=None, sortOrder=None, maxResults=None, excludedIds=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, sortField=None, atLeastOneOptimizationActivity=None)</a></code></p>
+<p class="firstline">Retrieves a list of campaigns, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing campaign. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing campaign.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one campaign by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Campaign ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM campaign.
+      "comment": "A String", # Arbitrary comments about this campaign. Must be less than 256 characters long.
+      "startDate": "A String", # Date on which the campaign starts running. The start date can be any date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This is a required field.
+      "endDate": "A String", # Date on which the campaign will stop running. On insert, the end date must be today or a future date. The end date must be later than or be the same as the start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective campaign run date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This is a required field.
+      "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix override properties for this campaign.
+        "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+        "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+      },
+      "advertiserId": "A String", # Advertiser ID of this campaign. This is a required field.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "eventTagOverrides": [ # Overrides that can be used to activate or deactivate advertiser event tags.
+        { # Event tag override information.
+          "enabled": True or False, # Whether this override is enabled.
+          "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+        },
+      ],
+      "creativeOptimizationConfiguration": { # Creative optimization settings. # Creative optimization configuration for the campaign.
+        "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+          { # Creative optimization activity.
+            "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+            "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+          },
+        ],
+        "optimizationModel": "A String", # Optimization model for this configuration.
+        "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+        "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+      },
+      "id": "A String", # ID of this campaign. This is a read-only auto-generated field.
+      "accountId": "A String", # Account ID of this campaign. This is a read-only field that can be left blank.
+      "traffickerEmails": [ # Campaign trafficker contact emails.
+        "A String",
+      ],
+      "archived": True or False, # Whether this campaign has been archived.
+      "externalId": "A String", # External ID for this campaign.
+      "advertiserGroupId": "A String", # Advertiser group ID of the associated advertiser.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "billingInvoiceCode": "A String", # Billing invoice code included in the DCM client billing invoices associated with the campaign.
+      "creativeGroupIds": [ # List of creative group IDs that are assigned to the campaign.
+        "A String",
+      ],
+      "additionalCreativeOptimizationConfigurations": [ # Additional creative optimization configurations for the campaign.
+        { # Creative optimization settings.
+          "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+            { # Creative optimization activity.
+              "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+              "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+              "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+            },
+          ],
+          "optimizationModel": "A String", # Optimization model for this configuration.
+          "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+          "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+        },
+      ],
+      "createInfo": { # Modification timestamp. # Information about the creation of this campaign. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Click-through event tag ID override properties for this campaign.
+        "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+        "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+      },
+      "kind": "dfareporting#campaign", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
+      "subaccountId": "A String", # Subaccount ID of this campaign. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this campaign. This is a required field and must be less than 256 characters long and unique among campaigns of the same advertiser.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for the campaign.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "nielsenOcrEnabled": True or False, # Whether Nielsen reports are enabled for this campaign.
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this campaign. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "audienceSegmentGroups": [ # Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
+        { # Audience Segment Group.
+          "audienceSegments": [ # Audience segments assigned to this group. The number of segments must be between 2 and 100.
+            { # Audience Segment.
+              "allocation": 42, # Weight allocated to this segment. Must be between 1 and 1000. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group.
+              "id": "A String", # ID of this audience segment. This is a read-only, auto-generated field.
+              "name": "A String", # Name of this audience segment. This is a required field and must be less than 65 characters long.
+            },
+          ],
+          "id": "A String", # ID of this audience segment group. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this audience segment group. This is a required field and must be less than 65 characters long.
+        },
+      ],
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, defaultLandingPageName, defaultLandingPageUrl, body)</code>
+  <pre>Inserts a new campaign.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  defaultLandingPageName: string, Default landing page name for this new campaign. Must be less than 256 characters long. (required)
+  defaultLandingPageUrl: string, Default landing page URL for this new campaign. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM campaign.
+    "comment": "A String", # Arbitrary comments about this campaign. Must be less than 256 characters long.
+    "startDate": "A String", # Date on which the campaign starts running. The start date can be any date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This is a required field.
+    "endDate": "A String", # Date on which the campaign will stop running. On insert, the end date must be today or a future date. The end date must be later than or be the same as the start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective campaign run date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This is a required field.
+    "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix override properties for this campaign.
+      "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+      "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+    },
+    "advertiserId": "A String", # Advertiser ID of this campaign. This is a required field.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "eventTagOverrides": [ # Overrides that can be used to activate or deactivate advertiser event tags.
+      { # Event tag override information.
+        "enabled": True or False, # Whether this override is enabled.
+        "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+      },
+    ],
+    "creativeOptimizationConfiguration": { # Creative optimization settings. # Creative optimization configuration for the campaign.
+      "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+        { # Creative optimization activity.
+          "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+          "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+        },
+      ],
+      "optimizationModel": "A String", # Optimization model for this configuration.
+      "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+      "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+    },
+    "id": "A String", # ID of this campaign. This is a read-only auto-generated field.
+    "accountId": "A String", # Account ID of this campaign. This is a read-only field that can be left blank.
+    "traffickerEmails": [ # Campaign trafficker contact emails.
+      "A String",
+    ],
+    "archived": True or False, # Whether this campaign has been archived.
+    "externalId": "A String", # External ID for this campaign.
+    "advertiserGroupId": "A String", # Advertiser group ID of the associated advertiser.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "billingInvoiceCode": "A String", # Billing invoice code included in the DCM client billing invoices associated with the campaign.
+    "creativeGroupIds": [ # List of creative group IDs that are assigned to the campaign.
+      "A String",
+    ],
+    "additionalCreativeOptimizationConfigurations": [ # Additional creative optimization configurations for the campaign.
+      { # Creative optimization settings.
+        "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+          { # Creative optimization activity.
+            "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+            "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+          },
+        ],
+        "optimizationModel": "A String", # Optimization model for this configuration.
+        "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+        "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+      },
+    ],
+    "createInfo": { # Modification timestamp. # Information about the creation of this campaign. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Click-through event tag ID override properties for this campaign.
+      "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+    },
+    "kind": "dfareporting#campaign", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
+    "subaccountId": "A String", # Subaccount ID of this campaign. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this campaign. This is a required field and must be less than 256 characters long and unique among campaigns of the same advertiser.
+    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for the campaign.
+      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+    },
+    "nielsenOcrEnabled": True or False, # Whether Nielsen reports are enabled for this campaign.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this campaign. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "audienceSegmentGroups": [ # Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
+      { # Audience Segment Group.
+        "audienceSegments": [ # Audience segments assigned to this group. The number of segments must be between 2 and 100.
+          { # Audience Segment.
+            "allocation": 42, # Weight allocated to this segment. Must be between 1 and 1000. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group.
+            "id": "A String", # ID of this audience segment. This is a read-only, auto-generated field.
+            "name": "A String", # Name of this audience segment. This is a required field and must be less than 65 characters long.
+          },
+        ],
+        "id": "A String", # ID of this audience segment group. This is a read-only, auto-generated field.
+        "name": "A String", # Name of this audience segment group. This is a required field and must be less than 65 characters long.
+      },
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM campaign.
+      "comment": "A String", # Arbitrary comments about this campaign. Must be less than 256 characters long.
+      "startDate": "A String", # Date on which the campaign starts running. The start date can be any date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This is a required field.
+      "endDate": "A String", # Date on which the campaign will stop running. On insert, the end date must be today or a future date. The end date must be later than or be the same as the start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective campaign run date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This is a required field.
+      "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix override properties for this campaign.
+        "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+        "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+      },
+      "advertiserId": "A String", # Advertiser ID of this campaign. This is a required field.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "eventTagOverrides": [ # Overrides that can be used to activate or deactivate advertiser event tags.
+        { # Event tag override information.
+          "enabled": True or False, # Whether this override is enabled.
+          "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+        },
+      ],
+      "creativeOptimizationConfiguration": { # Creative optimization settings. # Creative optimization configuration for the campaign.
+        "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+          { # Creative optimization activity.
+            "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+            "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+          },
+        ],
+        "optimizationModel": "A String", # Optimization model for this configuration.
+        "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+        "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+      },
+      "id": "A String", # ID of this campaign. This is a read-only auto-generated field.
+      "accountId": "A String", # Account ID of this campaign. This is a read-only field that can be left blank.
+      "traffickerEmails": [ # Campaign trafficker contact emails.
+        "A String",
+      ],
+      "archived": True or False, # Whether this campaign has been archived.
+      "externalId": "A String", # External ID for this campaign.
+      "advertiserGroupId": "A String", # Advertiser group ID of the associated advertiser.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "billingInvoiceCode": "A String", # Billing invoice code included in the DCM client billing invoices associated with the campaign.
+      "creativeGroupIds": [ # List of creative group IDs that are assigned to the campaign.
+        "A String",
+      ],
+      "additionalCreativeOptimizationConfigurations": [ # Additional creative optimization configurations for the campaign.
+        { # Creative optimization settings.
+          "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+            { # Creative optimization activity.
+              "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+              "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+              "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+            },
+          ],
+          "optimizationModel": "A String", # Optimization model for this configuration.
+          "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+          "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+        },
+      ],
+      "createInfo": { # Modification timestamp. # Information about the creation of this campaign. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Click-through event tag ID override properties for this campaign.
+        "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+        "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+      },
+      "kind": "dfareporting#campaign", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
+      "subaccountId": "A String", # Subaccount ID of this campaign. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this campaign. This is a required field and must be less than 256 characters long and unique among campaigns of the same advertiser.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for the campaign.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "nielsenOcrEnabled": True or False, # Whether Nielsen reports are enabled for this campaign.
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this campaign. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "audienceSegmentGroups": [ # Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
+        { # Audience Segment Group.
+          "audienceSegments": [ # Audience segments assigned to this group. The number of segments must be between 2 and 100.
+            { # Audience Segment.
+              "allocation": 42, # Weight allocated to this segment. Must be between 1 and 1000. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group.
+              "id": "A String", # ID of this audience segment. This is a read-only, auto-generated field.
+              "name": "A String", # Name of this audience segment. This is a required field and must be less than 65 characters long.
+            },
+          ],
+          "id": "A String", # ID of this audience segment group. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this audience segment group. This is a required field and must be less than 65 characters long.
+        },
+      ],
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, overriddenEventTagId=None, archived=None, advertiserIds=None, pageToken=None, sortOrder=None, maxResults=None, excludedIds=None, advertiserGroupIds=None, searchString=None, subaccountId=None, ids=None, sortField=None, atLeastOneOptimizationActivity=None)</code>
+  <pre>Retrieves a list of campaigns, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  overriddenEventTagId: string, Select only campaigns that have overridden this event tag ID.
+  archived: boolean, Select only archived campaigns. Don't set this field to select both archived and non-archived campaigns.
+  advertiserIds: string, Select only campaigns that belong to these advertisers. (repeated)
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  maxResults: integer, Maximum number of results to return.
+  excludedIds: string, Exclude campaigns with these IDs. (repeated)
+  advertiserGroupIds: string, Select only campaigns whose advertisers belong to these advertiser groups. (repeated)
+  searchString: string, Allows searching for campaigns by name or ID. Wildcards (*) are allowed. For example, "campaign*2015" will return campaigns with names like "campaign June 2015", "campaign April 2015", or simply "campaign 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "campaign" will match campaigns with name "my campaign", "campaign 2015", or simply "campaign".
+  subaccountId: string, Select only campaigns that belong to this subaccount.
+  ids: string, Select only campaigns with these IDs. (repeated)
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  atLeastOneOptimizationActivity: boolean, Select only campaigns that have at least one optimization activity.
+
+Returns:
+  An object of the form:
+
+    { # Campaign List Response
+    "campaigns": [ # Campaign collection.
+      { # Contains properties of a DCM campaign.
+          "comment": "A String", # Arbitrary comments about this campaign. Must be less than 256 characters long.
+          "startDate": "A String", # Date on which the campaign starts running. The start date can be any date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This is a required field.
+          "endDate": "A String", # Date on which the campaign will stop running. On insert, the end date must be today or a future date. The end date must be later than or be the same as the start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective campaign run date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This is a required field.
+          "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix override properties for this campaign.
+            "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+            "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+          },
+          "advertiserId": "A String", # Advertiser ID of this campaign. This is a required field.
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "eventTagOverrides": [ # Overrides that can be used to activate or deactivate advertiser event tags.
+            { # Event tag override information.
+              "enabled": True or False, # Whether this override is enabled.
+              "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+            },
+          ],
+          "creativeOptimizationConfiguration": { # Creative optimization settings. # Creative optimization configuration for the campaign.
+            "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+              { # Creative optimization activity.
+                "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+                "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+                  "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                  "value": "A String", # The value of the dimension.
+                  "dimensionName": "A String", # The name of the dimension.
+                  "etag": "A String", # The eTag of this response for caching purposes.
+                  "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                  "id": "A String", # The ID associated with the value if available.
+                },
+                "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+              },
+            ],
+            "optimizationModel": "A String", # Optimization model for this configuration.
+            "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+            "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+          },
+          "id": "A String", # ID of this campaign. This is a read-only auto-generated field.
+          "accountId": "A String", # Account ID of this campaign. This is a read-only field that can be left blank.
+          "traffickerEmails": [ # Campaign trafficker contact emails.
+            "A String",
+          ],
+          "archived": True or False, # Whether this campaign has been archived.
+          "externalId": "A String", # External ID for this campaign.
+          "advertiserGroupId": "A String", # Advertiser group ID of the associated advertiser.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this campaign. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "billingInvoiceCode": "A String", # Billing invoice code included in the DCM client billing invoices associated with the campaign.
+          "creativeGroupIds": [ # List of creative group IDs that are assigned to the campaign.
+            "A String",
+          ],
+          "additionalCreativeOptimizationConfigurations": [ # Additional creative optimization configurations for the campaign.
+            { # Creative optimization settings.
+              "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+                { # Creative optimization activity.
+                  "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+                  "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+                    "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                    "value": "A String", # The value of the dimension.
+                    "dimensionName": "A String", # The name of the dimension.
+                    "etag": "A String", # The eTag of this response for caching purposes.
+                    "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                    "id": "A String", # The ID associated with the value if available.
+                  },
+                  "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+                },
+              ],
+              "optimizationModel": "A String", # Optimization model for this configuration.
+              "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+              "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+            },
+          ],
+          "createInfo": { # Modification timestamp. # Information about the creation of this campaign. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Click-through event tag ID override properties for this campaign.
+            "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+            "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+          },
+          "kind": "dfareporting#campaign", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
+          "subaccountId": "A String", # Subaccount ID of this campaign. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this campaign. This is a required field and must be less than 256 characters long and unique among campaigns of the same advertiser.
+          "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for the campaign.
+            "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+            "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          },
+          "nielsenOcrEnabled": True or False, # Whether Nielsen reports are enabled for this campaign.
+          "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this campaign. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "audienceSegmentGroups": [ # Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
+            { # Audience Segment Group.
+              "audienceSegments": [ # Audience segments assigned to this group. The number of segments must be between 2 and 100.
+                { # Audience Segment.
+                  "allocation": 42, # Weight allocated to this segment. Must be between 1 and 1000. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group.
+                  "id": "A String", # ID of this audience segment. This is a read-only, auto-generated field.
+                  "name": "A String", # Name of this audience segment. This is a required field and must be less than 65 characters long.
+                },
+              ],
+              "id": "A String", # ID of this audience segment group. This is a read-only, auto-generated field.
+              "name": "A String", # Name of this audience segment group. This is a required field and must be less than 65 characters long.
+            },
+          ],
+        },
+    ],
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#campaignsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaignsListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing campaign. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Campaign ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM campaign.
+    "comment": "A String", # Arbitrary comments about this campaign. Must be less than 256 characters long.
+    "startDate": "A String", # Date on which the campaign starts running. The start date can be any date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This is a required field.
+    "endDate": "A String", # Date on which the campaign will stop running. On insert, the end date must be today or a future date. The end date must be later than or be the same as the start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective campaign run date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This is a required field.
+    "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix override properties for this campaign.
+      "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+      "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+    },
+    "advertiserId": "A String", # Advertiser ID of this campaign. This is a required field.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "eventTagOverrides": [ # Overrides that can be used to activate or deactivate advertiser event tags.
+      { # Event tag override information.
+        "enabled": True or False, # Whether this override is enabled.
+        "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+      },
+    ],
+    "creativeOptimizationConfiguration": { # Creative optimization settings. # Creative optimization configuration for the campaign.
+      "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+        { # Creative optimization activity.
+          "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+          "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+        },
+      ],
+      "optimizationModel": "A String", # Optimization model for this configuration.
+      "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+      "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+    },
+    "id": "A String", # ID of this campaign. This is a read-only auto-generated field.
+    "accountId": "A String", # Account ID of this campaign. This is a read-only field that can be left blank.
+    "traffickerEmails": [ # Campaign trafficker contact emails.
+      "A String",
+    ],
+    "archived": True or False, # Whether this campaign has been archived.
+    "externalId": "A String", # External ID for this campaign.
+    "advertiserGroupId": "A String", # Advertiser group ID of the associated advertiser.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "billingInvoiceCode": "A String", # Billing invoice code included in the DCM client billing invoices associated with the campaign.
+    "creativeGroupIds": [ # List of creative group IDs that are assigned to the campaign.
+      "A String",
+    ],
+    "additionalCreativeOptimizationConfigurations": [ # Additional creative optimization configurations for the campaign.
+      { # Creative optimization settings.
+        "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+          { # Creative optimization activity.
+            "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+            "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+          },
+        ],
+        "optimizationModel": "A String", # Optimization model for this configuration.
+        "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+        "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+      },
+    ],
+    "createInfo": { # Modification timestamp. # Information about the creation of this campaign. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Click-through event tag ID override properties for this campaign.
+      "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+    },
+    "kind": "dfareporting#campaign", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
+    "subaccountId": "A String", # Subaccount ID of this campaign. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this campaign. This is a required field and must be less than 256 characters long and unique among campaigns of the same advertiser.
+    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for the campaign.
+      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+    },
+    "nielsenOcrEnabled": True or False, # Whether Nielsen reports are enabled for this campaign.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this campaign. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "audienceSegmentGroups": [ # Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
+      { # Audience Segment Group.
+        "audienceSegments": [ # Audience segments assigned to this group. The number of segments must be between 2 and 100.
+          { # Audience Segment.
+            "allocation": 42, # Weight allocated to this segment. Must be between 1 and 1000. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group.
+            "id": "A String", # ID of this audience segment. This is a read-only, auto-generated field.
+            "name": "A String", # Name of this audience segment. This is a required field and must be less than 65 characters long.
+          },
+        ],
+        "id": "A String", # ID of this audience segment group. This is a read-only, auto-generated field.
+        "name": "A String", # Name of this audience segment group. This is a required field and must be less than 65 characters long.
+      },
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM campaign.
+      "comment": "A String", # Arbitrary comments about this campaign. Must be less than 256 characters long.
+      "startDate": "A String", # Date on which the campaign starts running. The start date can be any date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This is a required field.
+      "endDate": "A String", # Date on which the campaign will stop running. On insert, the end date must be today or a future date. The end date must be later than or be the same as the start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective campaign run date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This is a required field.
+      "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix override properties for this campaign.
+        "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+        "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+      },
+      "advertiserId": "A String", # Advertiser ID of this campaign. This is a required field.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "eventTagOverrides": [ # Overrides that can be used to activate or deactivate advertiser event tags.
+        { # Event tag override information.
+          "enabled": True or False, # Whether this override is enabled.
+          "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+        },
+      ],
+      "creativeOptimizationConfiguration": { # Creative optimization settings. # Creative optimization configuration for the campaign.
+        "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+          { # Creative optimization activity.
+            "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+            "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+          },
+        ],
+        "optimizationModel": "A String", # Optimization model for this configuration.
+        "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+        "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+      },
+      "id": "A String", # ID of this campaign. This is a read-only auto-generated field.
+      "accountId": "A String", # Account ID of this campaign. This is a read-only field that can be left blank.
+      "traffickerEmails": [ # Campaign trafficker contact emails.
+        "A String",
+      ],
+      "archived": True or False, # Whether this campaign has been archived.
+      "externalId": "A String", # External ID for this campaign.
+      "advertiserGroupId": "A String", # Advertiser group ID of the associated advertiser.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "billingInvoiceCode": "A String", # Billing invoice code included in the DCM client billing invoices associated with the campaign.
+      "creativeGroupIds": [ # List of creative group IDs that are assigned to the campaign.
+        "A String",
+      ],
+      "additionalCreativeOptimizationConfigurations": [ # Additional creative optimization configurations for the campaign.
+        { # Creative optimization settings.
+          "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+            { # Creative optimization activity.
+              "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+              "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+              "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+            },
+          ],
+          "optimizationModel": "A String", # Optimization model for this configuration.
+          "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+          "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+        },
+      ],
+      "createInfo": { # Modification timestamp. # Information about the creation of this campaign. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Click-through event tag ID override properties for this campaign.
+        "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+        "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+      },
+      "kind": "dfareporting#campaign", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
+      "subaccountId": "A String", # Subaccount ID of this campaign. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this campaign. This is a required field and must be less than 256 characters long and unique among campaigns of the same advertiser.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for the campaign.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "nielsenOcrEnabled": True or False, # Whether Nielsen reports are enabled for this campaign.
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this campaign. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "audienceSegmentGroups": [ # Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
+        { # Audience Segment Group.
+          "audienceSegments": [ # Audience segments assigned to this group. The number of segments must be between 2 and 100.
+            { # Audience Segment.
+              "allocation": 42, # Weight allocated to this segment. Must be between 1 and 1000. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group.
+              "id": "A String", # ID of this audience segment. This is a read-only, auto-generated field.
+              "name": "A String", # Name of this audience segment. This is a required field and must be less than 65 characters long.
+            },
+          ],
+          "id": "A String", # ID of this audience segment group. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this audience segment group. This is a required field and must be less than 65 characters long.
+        },
+      ],
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing campaign.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM campaign.
+    "comment": "A String", # Arbitrary comments about this campaign. Must be less than 256 characters long.
+    "startDate": "A String", # Date on which the campaign starts running. The start date can be any date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This is a required field.
+    "endDate": "A String", # Date on which the campaign will stop running. On insert, the end date must be today or a future date. The end date must be later than or be the same as the start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective campaign run date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This is a required field.
+    "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix override properties for this campaign.
+      "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+      "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+    },
+    "advertiserId": "A String", # Advertiser ID of this campaign. This is a required field.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "eventTagOverrides": [ # Overrides that can be used to activate or deactivate advertiser event tags.
+      { # Event tag override information.
+        "enabled": True or False, # Whether this override is enabled.
+        "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+      },
+    ],
+    "creativeOptimizationConfiguration": { # Creative optimization settings. # Creative optimization configuration for the campaign.
+      "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+        { # Creative optimization activity.
+          "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+          "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+        },
+      ],
+      "optimizationModel": "A String", # Optimization model for this configuration.
+      "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+      "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+    },
+    "id": "A String", # ID of this campaign. This is a read-only auto-generated field.
+    "accountId": "A String", # Account ID of this campaign. This is a read-only field that can be left blank.
+    "traffickerEmails": [ # Campaign trafficker contact emails.
+      "A String",
+    ],
+    "archived": True or False, # Whether this campaign has been archived.
+    "externalId": "A String", # External ID for this campaign.
+    "advertiserGroupId": "A String", # Advertiser group ID of the associated advertiser.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "billingInvoiceCode": "A String", # Billing invoice code included in the DCM client billing invoices associated with the campaign.
+    "creativeGroupIds": [ # List of creative group IDs that are assigned to the campaign.
+      "A String",
+    ],
+    "additionalCreativeOptimizationConfigurations": [ # Additional creative optimization configurations for the campaign.
+      { # Creative optimization settings.
+        "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+          { # Creative optimization activity.
+            "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+            "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+          },
+        ],
+        "optimizationModel": "A String", # Optimization model for this configuration.
+        "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+        "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+      },
+    ],
+    "createInfo": { # Modification timestamp. # Information about the creation of this campaign. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Click-through event tag ID override properties for this campaign.
+      "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+      "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+    },
+    "kind": "dfareporting#campaign", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
+    "subaccountId": "A String", # Subaccount ID of this campaign. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this campaign. This is a required field and must be less than 256 characters long and unique among campaigns of the same advertiser.
+    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for the campaign.
+      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+    },
+    "nielsenOcrEnabled": True or False, # Whether Nielsen reports are enabled for this campaign.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this campaign. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "audienceSegmentGroups": [ # Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
+      { # Audience Segment Group.
+        "audienceSegments": [ # Audience segments assigned to this group. The number of segments must be between 2 and 100.
+          { # Audience Segment.
+            "allocation": 42, # Weight allocated to this segment. Must be between 1 and 1000. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group.
+            "id": "A String", # ID of this audience segment. This is a read-only, auto-generated field.
+            "name": "A String", # Name of this audience segment. This is a required field and must be less than 65 characters long.
+          },
+        ],
+        "id": "A String", # ID of this audience segment group. This is a read-only, auto-generated field.
+        "name": "A String", # Name of this audience segment group. This is a required field and must be less than 65 characters long.
+      },
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM campaign.
+      "comment": "A String", # Arbitrary comments about this campaign. Must be less than 256 characters long.
+      "startDate": "A String", # Date on which the campaign starts running. The start date can be any date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This is a required field.
+      "endDate": "A String", # Date on which the campaign will stop running. On insert, the end date must be today or a future date. The end date must be later than or be the same as the start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective campaign run date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This is a required field.
+      "clickThroughUrlSuffixProperties": { # Click Through URL Suffix settings. # Click-through URL suffix override properties for this campaign.
+        "clickThroughUrlSuffix": "A String", # Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.
+        "overrideInheritedSuffix": True or False, # Whether this entity should override the inherited click-through URL suffix with its own defined value.
+      },
+      "advertiserId": "A String", # Advertiser ID of this campaign. This is a required field.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "eventTagOverrides": [ # Overrides that can be used to activate or deactivate advertiser event tags.
+        { # Event tag override information.
+          "enabled": True or False, # Whether this override is enabled.
+          "id": "A String", # ID of this event tag override. This is a read-only, auto-generated field.
+        },
+      ],
+      "creativeOptimizationConfiguration": { # Creative optimization settings. # Creative optimization configuration for the campaign.
+        "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+          { # Creative optimization activity.
+            "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+            "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+          },
+        ],
+        "optimizationModel": "A String", # Optimization model for this configuration.
+        "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+        "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+      },
+      "id": "A String", # ID of this campaign. This is a read-only auto-generated field.
+      "accountId": "A String", # Account ID of this campaign. This is a read-only field that can be left blank.
+      "traffickerEmails": [ # Campaign trafficker contact emails.
+        "A String",
+      ],
+      "archived": True or False, # Whether this campaign has been archived.
+      "externalId": "A String", # External ID for this campaign.
+      "advertiserGroupId": "A String", # Advertiser group ID of the associated advertiser.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "billingInvoiceCode": "A String", # Billing invoice code included in the DCM client billing invoices associated with the campaign.
+      "creativeGroupIds": [ # List of creative group IDs that are assigned to the campaign.
+        "A String",
+      ],
+      "additionalCreativeOptimizationConfigurations": [ # Additional creative optimization configurations for the campaign.
+        { # Creative optimization settings.
+          "optimizationActivitys": [ # List of optimization activities associated with this configuration.
+            { # Creative optimization activity.
+              "floodlightActivityId": "A String", # Floodlight activity ID of this optimization activity. This is a required field.
+              "floodlightActivityIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+              "weight": 42, # Weight associated with this optimization. Must be greater than 1. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities.
+            },
+          ],
+          "optimizationModel": "A String", # Optimization model for this configuration.
+          "id": "A String", # ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.
+          "name": "A String", # Name of this creative optimization config. This is a required field and must be less than 129 characters long.
+        },
+      ],
+      "createInfo": { # Modification timestamp. # Information about the creation of this campaign. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "defaultClickThroughEventTagProperties": { # Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further. # Click-through event tag ID override properties for this campaign.
+        "overrideInheritedEventTag": True or False, # Whether this entity should override the inherited default click-through event tag with its own defined value.
+        "defaultClickThroughEventTagId": "A String", # ID of the click-through event tag to apply to all ads in this entity's scope.
+      },
+      "kind": "dfareporting#campaign", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
+      "subaccountId": "A String", # Subaccount ID of this campaign. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this campaign. This is a required field and must be less than 256 characters long and unique among campaigns of the same advertiser.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for the campaign.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "nielsenOcrEnabled": True or False, # Whether Nielsen reports are enabled for this campaign.
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this campaign. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "audienceSegmentGroups": [ # Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
+        { # Audience Segment Group.
+          "audienceSegments": [ # Audience segments assigned to this group. The number of segments must be between 2 and 100.
+            { # Audience Segment.
+              "allocation": 42, # Weight allocated to this segment. Must be between 1 and 1000. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group.
+              "id": "A String", # ID of this audience segment. This is a read-only, auto-generated field.
+              "name": "A String", # Name of this audience segment. This is a required field and must be less than 65 characters long.
+            },
+          ],
+          "id": "A String", # ID of this audience segment group. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this audience segment group. This is a required field and must be less than 65 characters long.
+        },
+      ],
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.changeLogs.html b/docs/dyn/dfareporting_v2_7.changeLogs.html
new file mode 100644
index 00000000000..56ffb380295
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.changeLogs.html
@@ -0,0 +1,232 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.changeLogs.html">changeLogs</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one change log by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</a></code></p>
+<p class="firstline">Retrieves a list of change logs. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one change log by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Change log ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Describes a change that a user has made to a resource.
+    "changeTime": "A String", # Time when the object was modified.
+    "kind": "dfareporting#changeLog", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLog".
+    "subaccountId": "A String", # Subaccount ID of the modified object.
+    "userProfileId": "A String", # ID of the user who modified the object.
+    "objectId": "A String", # ID of the object of this change log. The object could be a campaign, placement, ad, or other type.
+    "newValue": "A String", # New value of the object field.
+    "userProfileName": "A String", # User profile name of the user who modified the object.
+    "fieldName": "A String", # Field name of the object which changed.
+    "oldValue": "A String", # Old value of the object field.
+    "action": "A String", # Action which caused the change.
+    "transactionId": "A String", # Transaction ID of this change log. When a single API call results in many changes, each change will have a separate ID in the change log but will share the same transactionId.
+    "objectType": "A String", # Object type of the change log.
+    "id": "A String", # ID of this change log.
+    "accountId": "A String", # Account ID of the modified object.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</code>
+  <pre>Retrieves a list of change logs. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  objectType: string, Select only change logs with the specified object type.
+    Allowed values
+      OBJECT_ACCOUNT - 
+      OBJECT_ACCOUNT_BILLING_FEATURE - 
+      OBJECT_AD - 
+      OBJECT_ADVERTISER - 
+      OBJECT_ADVERTISER_GROUP - 
+      OBJECT_BILLING_ACCOUNT_GROUP - 
+      OBJECT_BILLING_FEATURE - 
+      OBJECT_BILLING_MINIMUM_FEE - 
+      OBJECT_BILLING_PROFILE - 
+      OBJECT_CAMPAIGN - 
+      OBJECT_CONTENT_CATEGORY - 
+      OBJECT_CREATIVE - 
+      OBJECT_CREATIVE_ASSET - 
+      OBJECT_CREATIVE_BUNDLE - 
+      OBJECT_CREATIVE_FIELD - 
+      OBJECT_CREATIVE_GROUP - 
+      OBJECT_DFA_SITE - 
+      OBJECT_EVENT_TAG - 
+      OBJECT_FLOODLIGHT_ACTIVITY_GROUP - 
+      OBJECT_FLOODLIGHT_ACTVITY - 
+      OBJECT_FLOODLIGHT_CONFIGURATION - 
+      OBJECT_INSTREAM_CREATIVE - 
+      OBJECT_LANDING_PAGE - 
+      OBJECT_MEDIA_ORDER - 
+      OBJECT_PLACEMENT - 
+      OBJECT_PLACEMENT_STRATEGY - 
+      OBJECT_PLAYSTORE_LINK - 
+      OBJECT_PROVIDED_LIST_CLIENT - 
+      OBJECT_RATE_CARD - 
+      OBJECT_REMARKETING_LIST - 
+      OBJECT_RICHMEDIA_CREATIVE - 
+      OBJECT_SD_SITE - 
+      OBJECT_SEARCH_LIFT_STUDY - 
+      OBJECT_SIZE - 
+      OBJECT_SUBACCOUNT - 
+      OBJECT_TARGETING_TEMPLATE - 
+      OBJECT_USER_PROFILE - 
+      OBJECT_USER_PROFILE_FILTER - 
+      OBJECT_USER_ROLE - 
+  maxChangeTime: string, Select only change logs whose change time is before the specified maxChangeTime.The time should be formatted as an RFC3339 date/time string. For example, for 10:54 PM on July 18th, 2015, in the America/New York time zone, the format is "2015-07-18T22:54:00-04:00". In other words, the year, month, day, the letter T, the hour (24-hour clock system), minute, second, and then the time zone offset.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  maxResults: integer, Maximum number of results to return.
+  action: string, Select only change logs with the specified action.
+    Allowed values
+      ACTION_ADD - 
+      ACTION_ASSIGN - 
+      ACTION_ASSOCIATE - 
+      ACTION_CREATE - 
+      ACTION_DELETE - 
+      ACTION_DISABLE - 
+      ACTION_EMAIL_TAGS - 
+      ACTION_ENABLE - 
+      ACTION_LINK - 
+      ACTION_MARK_AS_DEFAULT - 
+      ACTION_PUSH - 
+      ACTION_REMOVE - 
+      ACTION_SEND - 
+      ACTION_SHARE - 
+      ACTION_UNASSIGN - 
+      ACTION_UNLINK - 
+      ACTION_UPDATE - 
+  minChangeTime: string, Select only change logs whose change time is before the specified minChangeTime.The time should be formatted as an RFC3339 date/time string. For example, for 10:54 PM on July 18th, 2015, in the America/New York time zone, the format is "2015-07-18T22:54:00-04:00". In other words, the year, month, day, the letter T, the hour (24-hour clock system), minute, second, and then the time zone offset.
+  searchString: string, Select only change logs whose object ID, user name, old or new values match the search string.
+  userProfileIds: string, Select only change logs with these user profile IDs. (repeated)
+  ids: string, Select only change logs with these IDs. (repeated)
+  objectIds: string, Select only change logs with these object IDs. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Change Log List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#changeLogsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLogsListResponse".
+    "changeLogs": [ # Change log collection.
+      { # Describes a change that a user has made to a resource.
+        "changeTime": "A String", # Time when the object was modified.
+        "kind": "dfareporting#changeLog", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLog".
+        "subaccountId": "A String", # Subaccount ID of the modified object.
+        "userProfileId": "A String", # ID of the user who modified the object.
+        "objectId": "A String", # ID of the object of this change log. The object could be a campaign, placement, ad, or other type.
+        "newValue": "A String", # New value of the object field.
+        "userProfileName": "A String", # User profile name of the user who modified the object.
+        "fieldName": "A String", # Field name of the object which changed.
+        "oldValue": "A String", # Old value of the object field.
+        "action": "A String", # Action which caused the change.
+        "transactionId": "A String", # Transaction ID of this change log. When a single API call results in many changes, each change will have a separate ID in the change log but will share the same transactionId.
+        "objectType": "A String", # Object type of the change log.
+        "id": "A String", # ID of this change log.
+        "accountId": "A String", # Account ID of the modified object.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.cities.html b/docs/dyn/dfareporting_v2_7.cities.html
new file mode 100644
index 00000000000..56882ae8825
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.cities.html
@@ -0,0 +1,113 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.cities.html">cities</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, dartIds=None, namePrefix=None, regionDartIds=None, countryDartIds=None)</a></code></p>
+<p class="firstline">Retrieves a list of cities, possibly filtered.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="list">list(profileId, dartIds=None, namePrefix=None, regionDartIds=None, countryDartIds=None)</code>
+  <pre>Retrieves a list of cities, possibly filtered.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  dartIds: string, Select only cities with these DART IDs. (repeated)
+  namePrefix: string, Select only cities with names starting with this prefix.
+  regionDartIds: string, Select only cities from these regions. (repeated)
+  countryDartIds: string, Select only cities from these countries. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # City List Response
+    "kind": "dfareporting#citiesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#citiesListResponse".
+    "cities": [ # City collection.
+      { # Contains information about a city that can be targeted by ads.
+        "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+        "countryDartId": "A String", # DART ID of the country to which this city belongs.
+        "name": "A String", # Name of this city.
+        "countryCode": "A String", # Country code of the country to which this city belongs.
+        "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+        "regionCode": "A String", # Region code of the region to which this city belongs.
+        "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+        "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+        "regionDartId": "A String", # DART ID of the region to which this city belongs.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.connectionTypes.html b/docs/dyn/dfareporting_v2_7.connectionTypes.html
new file mode 100644
index 00000000000..9f5610fb30e
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.connectionTypes.html
@@ -0,0 +1,124 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.connectionTypes.html">connectionTypes</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one connection type by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of connection types.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one connection type by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Connection type ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+    "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+    "id": "A String", # ID of this connection type.
+    "name": "A String", # Name of this connection type.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of connection types.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Connection Type List Response
+    "kind": "dfareporting#connectionTypesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionTypesListResponse".
+    "connectionTypes": [ # Collection of connection types such as broadband and mobile.
+      { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+        "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+        "id": "A String", # ID of this connection type.
+        "name": "A String", # Name of this connection type.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.contentCategories.html b/docs/dyn/dfareporting_v2_7.contentCategories.html
new file mode 100644
index 00000000000..d1e3117885c
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.contentCategories.html
@@ -0,0 +1,263 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.contentCategories.html">contentCategories</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, id)</a></code></p>
+<p class="firstline">Deletes an existing content category.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one content category by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new content category.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of content categories, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing content category. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing content category.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, id)</code>
+  <pre>Deletes an existing content category.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Content category ID. (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one content category by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Content category ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Organizes placements according to the contents of their associated webpages.
+      "kind": "dfareporting#contentCategory", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategory".
+      "id": "A String", # ID of this content category. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account.
+      "accountId": "A String", # Account ID of this content category. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new content category.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Organizes placements according to the contents of their associated webpages.
+    "kind": "dfareporting#contentCategory", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategory".
+    "id": "A String", # ID of this content category. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account.
+    "accountId": "A String", # Account ID of this content category. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Organizes placements according to the contents of their associated webpages.
+      "kind": "dfareporting#contentCategory", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategory".
+      "id": "A String", # ID of this content category. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account.
+      "accountId": "A String", # Account ID of this content category. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
+  <pre>Retrieves a list of content categories, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "contentcategory*2015" will return objects with names like "contentcategory June 2015", "contentcategory April 2015", or simply "contentcategory 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "contentcategory" will match objects with name "my contentcategory", "contentcategory 2015", or simply "contentcategory".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only content categories with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Content Category List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#contentCategoriesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategoriesListResponse".
+    "contentCategories": [ # Content category collection.
+      { # Organizes placements according to the contents of their associated webpages.
+          "kind": "dfareporting#contentCategory", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategory".
+          "id": "A String", # ID of this content category. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account.
+          "accountId": "A String", # Account ID of this content category. This is a read-only field that can be left blank.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing content category. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Content category ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Organizes placements according to the contents of their associated webpages.
+    "kind": "dfareporting#contentCategory", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategory".
+    "id": "A String", # ID of this content category. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account.
+    "accountId": "A String", # Account ID of this content category. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Organizes placements according to the contents of their associated webpages.
+      "kind": "dfareporting#contentCategory", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategory".
+      "id": "A String", # ID of this content category. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account.
+      "accountId": "A String", # Account ID of this content category. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing content category.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Organizes placements according to the contents of their associated webpages.
+    "kind": "dfareporting#contentCategory", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategory".
+    "id": "A String", # ID of this content category. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account.
+    "accountId": "A String", # Account ID of this content category. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Organizes placements according to the contents of their associated webpages.
+      "kind": "dfareporting#contentCategory", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#contentCategory".
+      "id": "A String", # ID of this content category. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account.
+      "accountId": "A String", # Account ID of this content category. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.conversions.html b/docs/dyn/dfareporting_v2_7.conversions.html
new file mode 100644
index 00000000000..957834369a9
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.conversions.html
@@ -0,0 +1,170 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.conversions.html">conversions</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#batchinsert">batchinsert(profileId, body)</a></code></p>
+<p class="firstline">Inserts conversions.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="batchinsert">batchinsert(profileId, body)</code>
+  <pre>Inserts conversions.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Insert Conversions Request.
+    "conversions": [ # The set of conversions to insert.
+      { # A Conversion represents when a user successfully performs a desired action after seeing an ad.
+        "ordinal": "A String", # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
+        "timestampMicros": "A String", # The timestamp of conversion, in Unix epoch micros. This is a required field.
+        "kind": "dfareporting#conversion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversion".
+        "childDirectedTreatment": True or False, # Whether the conversion was directed toward children.
+        "encryptedUserId": "A String", # The alphanumeric encrypted user ID. When set, encryptionInfo should also be specified. This field is mutually exclusive with encryptedUserIdCandidates[] and mobileDeviceId. This or encryptedUserIdCandidates[] or mobileDeviceId is a required field.
+        "customVariables": [ # Custom floodlight variables.
+          { # A custom floodlight variable.
+            "kind": "dfareporting#customFloodlightVariable", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customFloodlightVariable".
+            "type": "A String", # The type of custom floodlight variable to supply a value for. These map to the "u[1-20]=" in the tags.
+            "value": "A String", # The value of the custom floodlight variable. The length of string must not exceed 50 characters.
+          },
+        ],
+        "floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
+        "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId and encryptedUserIdCandidates[]. This or encryptedUserId or encryptedUserIdCandidates[] is a required field.
+        "value": 3.14, # The value of the conversion.
+        "limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
+        "quantity": "A String", # The quantity of the conversion.
+        "floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
+        "encryptedUserIdCandidates": [ # A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with NO_COOKIE_MATCH_FOUND error. When set, encryptionInfo should also be specified. This field should only be used when calling conversions.batchinsert. This field is mutually exclusive with encryptedUserId and mobileDeviceId. This or encryptedUserId or mobileDeviceId is a required field.
+          "A String",
+        ],
+      },
+    ],
+    "kind": "dfareporting#conversionsBatchInsertRequest", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchInsertRequest".
+    "encryptionInfo": { # A description of how user IDs are encrypted. # Describes how encryptedUserId or encryptedUserIdCandidates[] is encrypted. This is a required field if encryptedUserId or encryptedUserIdCandidates[] is used.
+      "kind": "dfareporting#encryptionInfo", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#encryptionInfo".
+      "encryptionEntityId": "A String", # The encryption entity ID. This should match the encryption configuration for ad serving or Data Transfer.
+      "encryptionSource": "A String", # Describes whether the encrypted cookie was received from ad serving (the %m macro) or from Data Transfer.
+      "encryptionEntityType": "A String", # The encryption entity type. This should match the encryption configuration for ad serving or Data Transfer.
+    },
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Insert Conversions Response.
+    "status": [ # The status of each conversion's insertion status. The status is returned in the same order that conversions are inserted.
+      { # The original conversion that was inserted or updated and whether there were any errors.
+        "conversion": { # A Conversion represents when a user successfully performs a desired action after seeing an ad. # The original conversion that was inserted or updated.
+          "ordinal": "A String", # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
+          "timestampMicros": "A String", # The timestamp of conversion, in Unix epoch micros. This is a required field.
+          "kind": "dfareporting#conversion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversion".
+          "childDirectedTreatment": True or False, # Whether the conversion was directed toward children.
+          "encryptedUserId": "A String", # The alphanumeric encrypted user ID. When set, encryptionInfo should also be specified. This field is mutually exclusive with encryptedUserIdCandidates[] and mobileDeviceId. This or encryptedUserIdCandidates[] or mobileDeviceId is a required field.
+          "customVariables": [ # Custom floodlight variables.
+            { # A custom floodlight variable.
+              "kind": "dfareporting#customFloodlightVariable", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customFloodlightVariable".
+              "type": "A String", # The type of custom floodlight variable to supply a value for. These map to the "u[1-20]=" in the tags.
+              "value": "A String", # The value of the custom floodlight variable. The length of string must not exceed 50 characters.
+            },
+          ],
+          "floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
+          "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId and encryptedUserIdCandidates[]. This or encryptedUserId or encryptedUserIdCandidates[] is a required field.
+          "value": 3.14, # The value of the conversion.
+          "limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
+          "quantity": "A String", # The quantity of the conversion.
+          "floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
+          "encryptedUserIdCandidates": [ # A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with NO_COOKIE_MATCH_FOUND error. When set, encryptionInfo should also be specified. This field should only be used when calling conversions.batchinsert. This field is mutually exclusive with encryptedUserId and mobileDeviceId. This or encryptedUserId or mobileDeviceId is a required field.
+            "A String",
+          ],
+        },
+        "errors": [ # A list of errors related to this conversion.
+          { # The error code and description for a conversion that failed to insert or update.
+            "kind": "dfareporting#conversionError", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionError".
+            "code": "A String", # The error code.
+            "message": "A String", # A description of the error.
+          },
+        ],
+        "kind": "dfareporting#conversionStatus", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionStatus".
+      },
+    ],
+    "hasFailures": True or False, # Indicates that some or all conversions failed to insert.
+    "kind": "dfareporting#conversionsBatchInsertResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchInsertResponse".
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.countries.html b/docs/dyn/dfareporting_v2_7.countries.html
new file mode 100644
index 00000000000..b554b113424
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.countries.html
@@ -0,0 +1,128 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.countries.html">countries</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, dartId)</a></code></p>
+<p class="firstline">Gets one country by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of countries.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, dartId)</code>
+  <pre>Gets one country by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  dartId: string, Country DART ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about a country that can be targeted by ads.
+    "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+    "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+    "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+    "countryCode": "A String", # Country code.
+    "name": "A String", # Name of this country.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of countries.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Country List Response
+    "kind": "dfareporting#countriesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#countriesListResponse".
+    "countries": [ # Country collection.
+      { # Contains information about a country that can be targeted by ads.
+        "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+        "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+        "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+        "countryCode": "A String", # Country code.
+        "name": "A String", # Name of this country.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.creativeAssets.html b/docs/dyn/dfareporting_v2_7.creativeAssets.html
new file mode 100644
index 00000000000..edc0a8e6be0
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.creativeAssets.html
@@ -0,0 +1,210 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.creativeAssets.html">creativeAssets</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, advertiserId, body=None, media_body=None, media_mime_type=None)</a></code></p>
+<p class="firstline">Inserts a new creative asset.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="insert">insert(profileId, advertiserId, body=None, media_body=None, media_mime_type=None)</code>
+  <pre>Inserts a new creative asset.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  advertiserId: string, Advertiser ID of this creative. This is a required field. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # CreativeAssets contains properties of a creative asset file which will be uploaded or has already been uploaded. Refer to the creative sample code for how to upload assets and insert a creative.
+    "kind": "dfareporting#creativeAssetMetadata", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeAssetMetadata".
+    "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field.
+      "A String",
+    ],
+    "warnedValidationRules": [ # Rules validated during code generation that generated a warning. This is a read-only, auto-generated field.
+        # 
+        # Possible values are:
+        # - "ADMOB_REFERENCED"
+        # - "ASSET_FORMAT_UNSUPPORTED_DCM"
+        # - "ASSET_INVALID"
+        # - "CLICK_TAG_HARD_CODED"
+        # - "CLICK_TAG_INVALID"
+        # - "CLICK_TAG_IN_GWD"
+        # - "CLICK_TAG_MISSING"
+        # - "CLICK_TAG_MORE_THAN_ONE"
+        # - "CLICK_TAG_NON_TOP_LEVEL"
+        # - "COMPONENT_UNSUPPORTED_DCM"
+        # - "ENABLER_UNSUPPORTED_METHOD_DCM"
+        # - "EXTERNAL_FILE_REFERENCED"
+        # - "FILE_DETAIL_EMPTY"
+        # - "FILE_TYPE_INVALID"
+        # - "GWD_PROPERTIES_INVALID"
+        # - "HTML5_FEATURE_UNSUPPORTED"
+        # - "LINKED_FILE_NOT_FOUND"
+        # - "MAX_FLASH_VERSION_11"
+        # - "MRAID_REFERENCED"
+        # - "NOT_SSL_COMPLIANT"
+        # - "ORPHANED_ASSET"
+        # - "PRIMARY_HTML_MISSING"
+        # - "SVG_INVALID"
+        # - "ZIP_INVALID"
+      "A String",
+    ],
+    "assetIdentifier": { # Creative Asset ID. # ID of the creative asset. This is a required field.
+      "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+      "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+    },
+    "clickTags": [ # List of detected click tags for assets. This is a read-only auto-generated field.
+      { # Creative Click Tag.
+        "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+        "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+      },
+    ],
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the numeric ID of the asset. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # Numeric ID of the asset. This is a read-only, auto-generated field.
+  }
+
+  media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
+
+Returns:
+  An object of the form:
+
+    { # CreativeAssets contains properties of a creative asset file which will be uploaded or has already been uploaded. Refer to the creative sample code for how to upload assets and insert a creative.
+      "kind": "dfareporting#creativeAssetMetadata", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeAssetMetadata".
+      "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field.
+        "A String",
+      ],
+      "warnedValidationRules": [ # Rules validated during code generation that generated a warning. This is a read-only, auto-generated field.
+          #
+          # Possible values are:
+          # - "ADMOB_REFERENCED"
+          # - "ASSET_FORMAT_UNSUPPORTED_DCM"
+          # - "ASSET_INVALID"
+          # - "CLICK_TAG_HARD_CODED"
+          # - "CLICK_TAG_INVALID"
+          # - "CLICK_TAG_IN_GWD"
+          # - "CLICK_TAG_MISSING"
+          # - "CLICK_TAG_MORE_THAN_ONE"
+          # - "CLICK_TAG_NON_TOP_LEVEL"
+          # - "COMPONENT_UNSUPPORTED_DCM"
+          # - "ENABLER_UNSUPPORTED_METHOD_DCM"
+          # - "EXTERNAL_FILE_REFERENCED"
+          # - "FILE_DETAIL_EMPTY"
+          # - "FILE_TYPE_INVALID"
+          # - "GWD_PROPERTIES_INVALID"
+          # - "HTML5_FEATURE_UNSUPPORTED"
+          # - "LINKED_FILE_NOT_FOUND"
+          # - "MAX_FLASH_VERSION_11"
+          # - "MRAID_REFERENCED"
+          # - "NOT_SSL_COMPLIANT"
+          # - "ORPHANED_ASSET"
+          # - "PRIMARY_HTML_MISSING"
+          # - "SVG_INVALID"
+          # - "ZIP_INVALID"
+        "A String",
+      ],
+      "assetIdentifier": { # Creative Asset ID. # ID of the creative asset. This is a required field.
+        "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+        "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+      },
+      "clickTags": [ # List of detected click tags for assets. This is a read-only auto-generated field.
+        { # Creative Click Tag.
+          "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+          "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+        },
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the numeric ID of the asset. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # Numeric ID of the asset. This is a read-only, auto-generated field.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.creativeFieldValues.html b/docs/dyn/dfareporting_v2_7.creativeFieldValues.html
new file mode 100644
index 00000000000..9b105183400
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.creativeFieldValues.html
@@ -0,0 +1,261 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.creativeFieldValues.html">creativeFieldValues</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, creativeFieldId, id)</a></code></p>
+<p class="firstline">Deletes an existing creative field value.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, creativeFieldId, id)</a></code></p>
+<p class="firstline">Gets one creative field value by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, creativeFieldId, body)</a></code></p>
+<p class="firstline">Inserts a new creative field value.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, creativeFieldId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of creative field values, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, creativeFieldId, id, body)</a></code></p>
+<p class="firstline">Updates an existing creative field value. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, creativeFieldId, body)</a></code></p>
+<p class="firstline">Updates an existing creative field value.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, creativeFieldId, id)</code>
+  <pre>Deletes an existing creative field value.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  creativeFieldId: string, Creative field ID for this creative field value. (required)
+  id: string, Creative Field Value ID (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, creativeFieldId, id)</code>
+  <pre>Gets one creative field value by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  creativeFieldId: string, Creative field ID for this creative field value. (required)
+  id: string, Creative Field Value ID (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative field value.
+      "kind": "dfareporting#creativeFieldValue", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValue".
+      "id": "A String", # ID of this creative field value. This is a read-only, auto-generated field.
+      "value": "A String", # Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, creativeFieldId, body)</code>
+  <pre>Inserts a new creative field value.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  creativeFieldId: string, Creative field ID for this creative field value. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative field value.
+    "kind": "dfareporting#creativeFieldValue", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValue".
+    "id": "A String", # ID of this creative field value. This is a read-only, auto-generated field.
+    "value": "A String", # Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative field value.
+      "kind": "dfareporting#creativeFieldValue", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValue".
+      "id": "A String", # ID of this creative field value. This is a read-only, auto-generated field.
+      "value": "A String", # Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, creativeFieldId, searchString=None, sortField=None, ids=None, maxResults=None, pageToken=None, sortOrder=None)</code>
+  <pre>Retrieves a list of creative field values, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  creativeFieldId: string, Creative field ID for this creative field value. (required)
+  searchString: string, Allows searching for creative field values by their values. Wildcards (e.g. *) are not allowed.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      VALUE - 
+  ids: string, Select only creative field values with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Creative Field Value List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#creativeFieldValuesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValuesListResponse".
+    "creativeFieldValues": [ # Creative field value collection.
+      { # Contains properties of a creative field value.
+          "kind": "dfareporting#creativeFieldValue", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValue".
+          "id": "A String", # ID of this creative field value. This is a read-only, auto-generated field.
+          "value": "A String", # Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, creativeFieldId, id, body)</code>
+  <pre>Updates an existing creative field value. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  creativeFieldId: string, Creative field ID for this creative field value. (required)
+  id: string, Creative Field Value ID (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative field value.
+    "kind": "dfareporting#creativeFieldValue", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValue".
+    "id": "A String", # ID of this creative field value. This is a read-only, auto-generated field.
+    "value": "A String", # Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative field value.
+      "kind": "dfareporting#creativeFieldValue", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValue".
+      "id": "A String", # ID of this creative field value. This is a read-only, auto-generated field.
+      "value": "A String", # Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, creativeFieldId, body)</code>
+  <pre>Updates an existing creative field value.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  creativeFieldId: string, Creative field ID for this creative field value. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative field value.
+    "kind": "dfareporting#creativeFieldValue", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValue".
+    "id": "A String", # ID of this creative field value. This is a read-only, auto-generated field.
+    "value": "A String", # Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative field value.
+      "kind": "dfareporting#creativeFieldValue", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldValue".
+      "id": "A String", # ID of this creative field value. This is a read-only, auto-generated field.
+      "value": "A String", # Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.creativeFields.html b/docs/dyn/dfareporting_v2_7.creativeFields.html
new file mode 100644
index 00000000000..263786b891e
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.creativeFields.html
@@ -0,0 +1,344 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.creativeFields.html">creativeFields</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, id)</a></code></p>
+<p class="firstline">Deletes an existing creative field.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one creative field by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new creative field.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of creative fields, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing creative field. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing creative field.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, id)</code>
+  <pre>Deletes an existing creative field.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Creative Field ID (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one creative field by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Creative Field ID (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative field.
+      "kind": "dfareporting#creativeField", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
+      "subaccountId": "A String", # Subaccount ID of this creative field. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
+      "advertiserId": "A String", # Advertiser ID of this creative field. This is a required field on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this creative field. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this creative field. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new creative field.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative field.
+    "kind": "dfareporting#creativeField", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
+    "subaccountId": "A String", # Subaccount ID of this creative field. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
+    "advertiserId": "A String", # Advertiser ID of this creative field. This is a required field on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this creative field. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this creative field. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative field.
+      "kind": "dfareporting#creativeField", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
+      "subaccountId": "A String", # Subaccount ID of this creative field. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
+      "advertiserId": "A String", # Advertiser ID of this creative field. This is a required field on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this creative field. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this creative field. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</code>
+  <pre>Retrieves a list of creative fields, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for creative fields by name or ID. Wildcards (*) are allowed. For example, "creativefield*2015" will return creative fields with names like "creativefield June 2015", "creativefield April 2015", or simply "creativefield 2015". Most of the searches also add wild-cards implicitly at the start and the end of the search string. For example, a search string of "creativefield" will match creative fields with the name "my creativefield", "creativefield 2015", or simply "creativefield".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  advertiserIds: string, Select only creative fields that belong to these advertisers. (repeated)
+  ids: string, Select only creative fields with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Creative Field List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "creativeFields": [ # Creative field collection.
+      { # Contains properties of a creative field.
+          "kind": "dfareporting#creativeField", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
+          "subaccountId": "A String", # Subaccount ID of this creative field. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
+          "advertiserId": "A String", # Advertiser ID of this creative field. This is a required field on insertion.
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "id": "A String", # ID of this creative field. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this creative field. This is a read-only field that can be left blank.
+        },
+    ],
+    "kind": "dfareporting#creativeFieldsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeFieldsListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing creative field. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Creative Field ID (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative field.
+    "kind": "dfareporting#creativeField", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
+    "subaccountId": "A String", # Subaccount ID of this creative field. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
+    "advertiserId": "A String", # Advertiser ID of this creative field. This is a required field on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this creative field. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this creative field. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative field.
+      "kind": "dfareporting#creativeField", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
+      "subaccountId": "A String", # Subaccount ID of this creative field. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
+      "advertiserId": "A String", # Advertiser ID of this creative field. This is a required field on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this creative field. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this creative field. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing creative field.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative field.
+    "kind": "dfareporting#creativeField", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
+    "subaccountId": "A String", # Subaccount ID of this creative field. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
+    "advertiserId": "A String", # Advertiser ID of this creative field. This is a required field on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this creative field. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this creative field. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative field.
+      "kind": "dfareporting#creativeField", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
+      "subaccountId": "A String", # Subaccount ID of this creative field. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
+      "advertiserId": "A String", # Advertiser ID of this creative field. This is a required field on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this creative field. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this creative field. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.creativeGroups.html b/docs/dyn/dfareporting_v2_7.creativeGroups.html
new file mode 100644
index 00000000000..d508bd228c7
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.creativeGroups.html
@@ -0,0 +1,364 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.creativeGroups.html">creativeGroups</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one creative group by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new creative group.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, groupNumber=None, maxResults=None, ids=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of creative groups, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing creative group. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing creative group.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one creative group by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Creative group ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative group.
+      "kind": "dfareporting#creativeGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroup".
+      "subaccountId": "A String", # Subaccount ID of this creative group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser.
+      "groupNumber": 42, # Subgroup of the creative group. Assign your creative groups to one of the following subgroups in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion.
+          # Acceptable values are:
+          # - 1
+          # - 2
+      "advertiserId": "A String", # Advertiser ID of this creative group. This is a required field on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this creative group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this creative group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new creative group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative group.
+    "kind": "dfareporting#creativeGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroup".
+    "subaccountId": "A String", # Subaccount ID of this creative group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser.
+    "groupNumber": 42, # Subgroup of the creative group. Assign your creative groups to one of the following subgroups in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion.
+        # Acceptable values are:
+        # - 1
+        # - 2
+    "advertiserId": "A String", # Advertiser ID of this creative group. This is a required field on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this creative group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this creative group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative group.
+      "kind": "dfareporting#creativeGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroup".
+      "subaccountId": "A String", # Subaccount ID of this creative group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser.
+      "groupNumber": 42, # Subgroup of the creative group. Assign your creative groups to one of the following subgroups in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion.
+          # Acceptable values are:
+          # - 1
+          # - 2
+      "advertiserId": "A String", # Advertiser ID of this creative group. This is a required field on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this creative group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this creative group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, groupNumber=None, maxResults=None, ids=None, sortOrder=None)</code>
+  <pre>Retrieves a list of creative groups, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for creative groups by name or ID. Wildcards (*) are allowed. For example, "creativegroup*2015" will return creative groups with names like "creativegroup June 2015", "creativegroup April 2015", or simply "creativegroup 2015". Most of the searches also add wild-cards implicitly at the start and the end of the search string. For example, a search string of "creativegroup" will match creative groups with the name "my creativegroup", "creativegroup 2015", or simply "creativegroup".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  advertiserIds: string, Select only creative groups that belong to these advertisers. (repeated)
+  groupNumber: integer, Select only creative groups that belong to this subgroup.
+  maxResults: integer, Maximum number of results to return.
+  ids: string, Select only creative groups with these IDs. (repeated)
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Creative Group List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "creativeGroups": [ # Creative group collection.
+      { # Contains properties of a creative group.
+          "kind": "dfareporting#creativeGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroup".
+          "subaccountId": "A String", # Subaccount ID of this creative group. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser.
+          "groupNumber": 42, # Subgroup of the creative group. Assign your creative groups to one of the following subgroups in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion.
+              # Acceptable values are:
+              # - 1
+              # - 2
+          "advertiserId": "A String", # Advertiser ID of this creative group. This is a required field on insertion.
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "id": "A String", # ID of this creative group. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this creative group. This is a read-only field that can be left blank.
+        },
+    ],
+    "kind": "dfareporting#creativeGroupsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroupsListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing creative group. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Creative group ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative group.
+    "kind": "dfareporting#creativeGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroup".
+    "subaccountId": "A String", # Subaccount ID of this creative group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser.
+    "groupNumber": 42, # Subgroup of the creative group. Assign your creative groups to one of the following subgroups in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion.
+        # Acceptable values are:
+        # - 1
+        # - 2
+    "advertiserId": "A String", # Advertiser ID of this creative group. This is a required field on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this creative group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this creative group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative group.
+      "kind": "dfareporting#creativeGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroup".
+      "subaccountId": "A String", # Subaccount ID of this creative group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser.
+      "groupNumber": 42, # Subgroup of the creative group. Assign your creative groups to one of the following subgroups in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion.
+          # Acceptable values are:
+          # - 1
+          # - 2
+      "advertiserId": "A String", # Advertiser ID of this creative group. This is a required field on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this creative group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this creative group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing creative group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a creative group.
+    "kind": "dfareporting#creativeGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroup".
+    "subaccountId": "A String", # Subaccount ID of this creative group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser.
+    "groupNumber": 42, # Subgroup of the creative group. Assign your creative groups to one of the following subgroups in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion.
+        # Acceptable values are:
+        # - 1
+        # - 2
+    "advertiserId": "A String", # Advertiser ID of this creative group. This is a required field on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this creative group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this creative group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a creative group.
+      "kind": "dfareporting#creativeGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeGroup".
+      "subaccountId": "A String", # Subaccount ID of this creative group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser.
+      "groupNumber": 42, # Subgroup of the creative group. Assign your creative groups to one of the following subgroups in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion.
+          # Acceptable values are:
+          # - 1
+          # - 2
+      "advertiserId": "A String", # Advertiser ID of this creative group. This is a required field on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this creative group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this creative group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.creatives.html b/docs/dyn/dfareporting_v2_7.creatives.html
new file mode 100644
index 00000000000..edc93a4924a
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.creatives.html
@@ -0,0 +1,3149 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.creatives.html">creatives</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one creative by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new creative.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</a></code></p>
+<p class="firstline">Retrieves a list of creatives, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing creative. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing creative.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one creative by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Creative ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Creative.
+      "thirdPartyUrls": [ # Third-party URLs for tracking in-stream video creative events. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+        { # Third-party Tracking URL.
+          "url": "A String", # URL for the specified third-party URL type.
+          "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video creatives.
+        },
+      ],
+      "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "videoDescription": "A String", # Description of the video ad. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types.
+      "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.
+      "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.
+        "windowHeight": 42, # Height of the window.
+        "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+        "windowWidth": 42, # Width of the window.
+        "positionOption": "A String", # Position in the browser where the window will open.
+        "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+      },
+      "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives.
+      "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types.
+      "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.
+        "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+        "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+      },
+      "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+      "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "archived": True or False, # Whether the creative is archived. Applicable to all creative types.
+      "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA.
+      "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.
+      "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by DoubleClick Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types.
+      "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.
+        "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+        "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+      },
+      "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE.
+      "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.
+      "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types.
+        { # Creative Field Assignment.
+          "creativeFieldId": "A String", # ID of the creative field.
+          "creativeFieldValueId": "A String", # ID of the creative field value.
+        },
+      ],
+      "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.
+      "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+        "A String",
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is false. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types.
+          #
+          # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types.
+      "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.
+      "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT
+        { # Creative Asset.
+          "mimeType": "A String", # Detected MIME type for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+          "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "A String",
+          ],
+          "originalBackup": True or False, # Whether the backup asset is original or changed by the user in DCM. Applicable to the following creative types: all RICH_MEDIA.
+          "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_VIDEO and VPAID_LINEAR_VIDEO.
+          "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.
+          "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL.
+          "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+          "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field.
+              # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives.
+              # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+              # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives.
+              # OTHER refers to assets from sources other than DCM, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives.
+              # PARENT_VIDEO refers to videos uploaded by the user in DCM and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+              # TRANSCODED_VIDEO refers to videos transcoded by DCM from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+              # ALTERNATE_VIDEO refers to the DCM representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within DCM.
+              # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative.
+          "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "bitRate": 42, # Detected bit-rate for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.
+          "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.
+          "videoDuration": 3.14, # Detected video duration for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "active": True or False, # Whether the video asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.
+            "A String",
+          ],
+          "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "zIndex": 42, # zIndex value of an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY.
+          "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.
+          "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.
+            "targetType": "A String", # Target type used by the event.
+            "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+            "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+            "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+              "showStatusBar": True or False, # Whether to display the browser status bar.
+              "showScrollBar": True or False, # Whether to display the browser scroll bar.
+              "showAddressBar": True or False, # Whether to display the browser address bar.
+              "showMenuBar": True or False, # Whether to display the browser menu bar.
+              "title": "A String", # Title of popup window.
+              "showToolBar": True or False, # Whether to display the browser tool bar.
+              "positionType": "A String", # Popup window position either centered or at specific coordinate.
+              "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+                "top": 42, # Offset distance from top side of an asset or a window.
+                "left": 42, # Offset distance from left side of an asset or a window.
+              },
+              "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+                "width": 42, # Width of this size.
+                "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                "height": 42, # Height of this size.
+              },
+            },
+            "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+            "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+            "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+            "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+            "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+            "advertiserCustomEventName": "A String", # User-entered name for the event.
+          },
+          "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Must be between 0 and 9.99. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+          "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+            "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+            "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+          },
+          "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets.
+          "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+        },
+      ],
+      "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT
+      "videoDuration": 3.14, # Creative video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, all RICH_MEDIA, and all VPAID.
+      "htmlCodeLocked": True or False, # Whether HTML code is DCM-generated or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.
+      "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        { # Creative Click Tag.
+          "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+          "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+        },
+      ],
+      "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      "active": True or False, # Whether the creative is active. Applicable to all creative types.
+      "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. Applicable to all creative types.
+          #
+          # Acceptable values are:
+          # - "APP"
+          # - "APP_INTERSTITIAL"
+          # - "IN_STREAM_VIDEO"
+          # - "DISPLAY"
+          # - "DISPLAY_INTERSTITIAL"
+        "A String",
+      ],
+      "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.
+      "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+        "A String",
+      ],
+      "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative".
+      "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+      "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types.
+      "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types.
+      "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "backupImageClickThroughUrl": "A String", # Click-through URL for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types.
+      "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+      "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE.
+      "companionCreatives": [ # List of companion creatives assigned to an in-Stream videocreative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID and all INSTREAM_VIDEO with dynamicAssetSelection set to false.
+        "A String",
+      ],
+      "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true.
+        "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives.
+          { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives.
+            "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field.
+            "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field.
+            "name": "A String", # A user-friendly name for this rule. This is a required field.
+          },
+        ],
+        "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field.
+      },
+      "auto_advance_images": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY.
+      "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by DCM for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "A String",
+      ],
+      "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "customHtml": "A String", # User-entered value.
+        "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed.
+      },
+      "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new creative.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Creative.
+    "thirdPartyUrls": [ # Third-party URLs for tracking in-stream video creative events. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      { # Third-party Tracking URL.
+        "url": "A String", # URL for the specified third-party URL type.
+        "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video creatives.
+      },
+    ],
+    "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "videoDescription": "A String", # Description of the video ad. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types.
+    "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.
+    "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.
+      "windowHeight": 42, # Height of the window.
+      "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+      "windowWidth": 42, # Width of the window.
+      "positionOption": "A String", # Position in the browser where the window will open.
+      "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+    },
+    "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives.
+    "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types.
+    "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.
+      "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+      "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+    },
+    "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+    "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "archived": True or False, # Whether the creative is archived. Applicable to all creative types.
+    "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA.
+    "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.
+    "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by DoubleClick Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types.
+    "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.
+      "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+      "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+    },
+    "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE.
+    "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.
+    "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types.
+      { # Creative Field Assignment.
+        "creativeFieldId": "A String", # ID of the creative field.
+        "creativeFieldValueId": "A String", # ID of the creative field value.
+      },
+    ],
+    "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.
+    "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "A String",
+    ],
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is false. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types.
+        # 
+        # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types.
+    "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.
+    "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT
+      { # Creative Asset.
+        "mimeType": "A String", # Detected MIME type for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+        "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+        "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "A String",
+        ],
+        "originalBackup": True or False, # Whether the backup asset is original or changed by the user in DCM. Applicable to the following creative types: all RICH_MEDIA.
+        "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_VIDEO and VPAID_LINEAR_VIDEO.
+        "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.
+        "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL.
+        "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+        "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field.
+            # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives.
+            # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives.
+            # OTHER refers to assets from sources other than DCM, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives.
+            # PARENT_VIDEO refers to videos uploaded by the user in DCM and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+            # TRANSCODED_VIDEO refers to videos transcoded by DCM from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+            # ALTERNATE_VIDEO refers to the DCM representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within DCM.
+            # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative.
+        "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+        "bitRate": 42, # Detected bit-rate for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.
+        "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.
+        "videoDuration": 3.14, # Detected video duration for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+        "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+          "top": 42, # Offset distance from top side of an asset or a window.
+          "left": 42, # Offset distance from left side of an asset or a window.
+        },
+        "active": True or False, # Whether the video asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.
+          "A String",
+        ],
+        "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+        "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "zIndex": 42, # zIndex value of an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY.
+        "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.
+        "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+        "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Must be between 0 and 9.99. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+        "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+          "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+        },
+        "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets.
+        "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "top": 42, # Offset distance from top side of an asset or a window.
+          "left": 42, # Offset distance from left side of an asset or a window.
+        },
+        "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+      },
+    ],
+    "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT
+    "videoDuration": 3.14, # Creative video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, all RICH_MEDIA, and all VPAID.
+    "htmlCodeLocked": True or False, # Whether HTML code is DCM-generated or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.
+    "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      { # Creative Click Tag.
+        "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+        "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+      },
+    ],
+    "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    "active": True or False, # Whether the creative is active. Applicable to all creative types.
+    "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. Applicable to all creative types.
+        # 
+        # Acceptable values are:
+        # - "APP"
+        # - "APP_INTERSTITIAL"
+        # - "IN_STREAM_VIDEO"
+        # - "DISPLAY"
+        # - "DISPLAY_INTERSTITIAL"
+      "A String",
+    ],
+    "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.
+    "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "A String",
+    ],
+    "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative".
+    "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+    "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types.
+    "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types.
+    "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "backupImageClickThroughUrl": "A String", # Click-through URL for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types.
+    "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+    "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE.
+    "companionCreatives": [ # List of companion creatives assigned to an in-Stream videocreative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID and all INSTREAM_VIDEO with dynamicAssetSelection set to false.
+      "A String",
+    ],
+    "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true.
+      "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives.
+        { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives.
+          "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field.
+          "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field.
+          "name": "A String", # A user-friendly name for this rule. This is a required field.
+        },
+      ],
+      "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field.
+    },
+    "auto_advance_images": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY.
+    "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by DCM for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "A String",
+    ],
+    "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "customHtml": "A String", # User-entered value.
+      "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed.
+    },
+    "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Creative.
+      "thirdPartyUrls": [ # Third-party URLs for tracking in-stream video creative events. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+        { # Third-party Tracking URL.
+          "url": "A String", # URL for the specified third-party URL type.
+          "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video creatives.
+        },
+      ],
+      "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "videoDescription": "A String", # Description of the video ad. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types.
+      "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.
+      "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.
+        "windowHeight": 42, # Height of the window.
+        "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+        "windowWidth": 42, # Width of the window.
+        "positionOption": "A String", # Position in the browser where the window will open.
+        "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+      },
+      "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives.
+      "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types.
+      "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.
+        "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+        "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+      },
+      "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+      "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "archived": True or False, # Whether the creative is archived. Applicable to all creative types.
+      "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA.
+      "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.
+      "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by DoubleClick Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types.
+      "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.
+        "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+        "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+      },
+      "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE.
+      "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.
+      "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types.
+        { # Creative Field Assignment.
+          "creativeFieldId": "A String", # ID of the creative field.
+          "creativeFieldValueId": "A String", # ID of the creative field value.
+        },
+      ],
+      "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.
+      "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+        "A String",
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is false. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types.
+          #
+          # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types.
+      "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.
+      "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT
+        { # Creative Asset.
+          "mimeType": "A String", # Detected MIME type for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+          "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "A String",
+          ],
+          "originalBackup": True or False, # Whether the backup asset is original or changed by the user in DCM. Applicable to the following creative types: all RICH_MEDIA.
+          "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_VIDEO and VPAID_LINEAR_VIDEO.
+          "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.
+          "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL.
+          "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+          "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field.
+              # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives.
+              # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+              # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives.
+              # OTHER refers to assets from sources other than DCM, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives.
+              # PARENT_VIDEO refers to videos uploaded by the user in DCM and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+              # TRANSCODED_VIDEO refers to videos transcoded by DCM from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+              # ALTERNATE_VIDEO refers to the DCM representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within DCM.
+              # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative.
+          "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "bitRate": 42, # Detected bit-rate for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.
+          "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.
+          "videoDuration": 3.14, # Detected video duration for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "active": True or False, # Whether the video asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.
+            "A String",
+          ],
+          "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "zIndex": 42, # zIndex value of an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY.
+          "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.
+          "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.
+            "targetType": "A String", # Target type used by the event.
+            "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+            "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+            "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+              "showStatusBar": True or False, # Whether to display the browser status bar.
+              "showScrollBar": True or False, # Whether to display the browser scroll bar.
+              "showAddressBar": True or False, # Whether to display the browser address bar.
+              "showMenuBar": True or False, # Whether to display the browser menu bar.
+              "title": "A String", # Title of popup window.
+              "showToolBar": True or False, # Whether to display the browser tool bar.
+              "positionType": "A String", # Popup window position either centered or at specific coordinate.
+              "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+                "top": 42, # Offset distance from top side of an asset or a window.
+                "left": 42, # Offset distance from left side of an asset or a window.
+              },
+              "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+                "width": 42, # Width of this size.
+                "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                "height": 42, # Height of this size.
+              },
+            },
+            "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+            "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+            "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+            "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+            "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+            "advertiserCustomEventName": "A String", # User-entered name for the event.
+          },
+          "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Must be between 0 and 9.99. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+          "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+            "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+            "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+          },
+          "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets.
+          "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+        },
+      ],
+      "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT
+      "videoDuration": 3.14, # Creative video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, all RICH_MEDIA, and all VPAID.
+      "htmlCodeLocked": True or False, # Whether HTML code is DCM-generated or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.
+      "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        { # Creative Click Tag.
+          "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+          "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+        },
+      ],
+      "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      "active": True or False, # Whether the creative is active. Applicable to all creative types.
+      "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. Applicable to all creative types.
+          #
+          # Acceptable values are:
+          # - "APP"
+          # - "APP_INTERSTITIAL"
+          # - "IN_STREAM_VIDEO"
+          # - "DISPLAY"
+          # - "DISPLAY_INTERSTITIAL"
+        "A String",
+      ],
+      "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.
+      "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+        "A String",
+      ],
+      "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative".
+      "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+      "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types.
+      "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types.
+      "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "backupImageClickThroughUrl": "A String", # Click-through URL for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types.
+      "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+      "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE.
+      "companionCreatives": [ # List of companion creatives assigned to an in-Stream videocreative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID and all INSTREAM_VIDEO with dynamicAssetSelection set to false.
+        "A String",
+      ],
+      "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true.
+        "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives.
+          { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives.
+            "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field.
+            "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field.
+            "name": "A String", # A user-friendly name for this rule. This is a required field.
+          },
+        ],
+        "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field.
+      },
+      "auto_advance_images": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY.
+      "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by DCM for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "A String",
+      ],
+      "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "customHtml": "A String", # User-entered value.
+        "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed.
+      },
+      "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</code>
+  <pre>Retrieves a list of creatives, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Select only creatives with this campaign ID.
+  advertiserId: string, Select only creatives with this advertiser ID.
+  sizeIds: string, Select only creatives with these size IDs. (repeated)
+  archived: boolean, Select only archived creatives. Leave blank to select archived and unarchived creatives.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  renderingIds: string, Select only creatives with these rendering IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  active: boolean, Select only active creatives. Leave blank to select active and inactive creatives.
+  companionCreativeIds: string, Select only in-stream video creatives with these companion IDs. (repeated)
+  types: string, Select only creatives with these creative types. (repeated)
+    Allowed values
+      BRAND_SAFE_DEFAULT_INSTREAM_VIDEO - 
+      CUSTOM_DISPLAY - 
+      CUSTOM_DISPLAY_INTERSTITIAL - 
+      DISPLAY - 
+      DISPLAY_IMAGE_GALLERY - 
+      DISPLAY_REDIRECT - 
+      FLASH_INPAGE - 
+      HTML5_BANNER - 
+      IMAGE - 
+      INSTREAM_VIDEO - 
+      INSTREAM_VIDEO_REDIRECT - 
+      INTERNAL_REDIRECT - 
+      INTERSTITIAL_INTERNAL_REDIRECT - 
+      RICH_MEDIA_DISPLAY_BANNER - 
+      RICH_MEDIA_DISPLAY_EXPANDING - 
+      RICH_MEDIA_DISPLAY_INTERSTITIAL - 
+      RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL - 
+      RICH_MEDIA_IM_EXPAND - 
+      RICH_MEDIA_INPAGE_FLOATING - 
+      RICH_MEDIA_MOBILE_IN_APP - 
+      RICH_MEDIA_PEEL_DOWN - 
+      TRACKING_TEXT - 
+      VPAID_LINEAR_VIDEO - 
+      VPAID_NON_LINEAR_VIDEO - 
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "creative*2015" will return objects with names like "creative June 2015", "creative April 2015", or simply "creative 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "creative" will match objects with name "my creative", "creative 2015", or simply "creative".
+  ids: string, Select only creatives with these IDs. (repeated)
+  studioCreativeId: string, Select only creatives corresponding to this Studio creative ID.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  creativeFieldIds: string, Select only creatives with these creative field IDs. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Creative List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#creativesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativesListResponse".
+    "creatives": [ # Creative collection.
+      { # Contains properties of a Creative.
+          "thirdPartyUrls": [ # Third-party URLs for tracking in-stream video creative events. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+            { # Third-party Tracking URL.
+              "url": "A String", # URL for the specified third-party URL type.
+              "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video creatives.
+            },
+          ],
+          "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+          "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+          "videoDescription": "A String", # Description of the video ad. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+          "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types.
+          "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+          "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.
+          "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.
+            { # Creative Custom Event.
+              "targetType": "A String", # Target type used by the event.
+              "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+              "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+              "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+                "showStatusBar": True or False, # Whether to display the browser status bar.
+                "showScrollBar": True or False, # Whether to display the browser scroll bar.
+                "showAddressBar": True or False, # Whether to display the browser address bar.
+                "showMenuBar": True or False, # Whether to display the browser menu bar.
+                "title": "A String", # Title of popup window.
+                "showToolBar": True or False, # Whether to display the browser tool bar.
+                "positionType": "A String", # Popup window position either centered or at specific coordinate.
+                "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+                  "top": 42, # Offset distance from top side of an asset or a window.
+                  "left": 42, # Offset distance from left side of an asset or a window.
+                },
+                "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+                  "width": 42, # Width of this size.
+                  "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                  "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                  "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                  "height": 42, # Height of this size.
+                },
+              },
+              "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+              "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+              "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+              "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+              "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+              "advertiserCustomEventName": "A String", # User-entered name for the event.
+            },
+          ],
+          "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.
+            "windowHeight": 42, # Height of the window.
+            "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+            "windowWidth": 42, # Width of the window.
+            "positionOption": "A String", # Position in the browser where the window will open.
+            "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+          },
+          "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives.
+          "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types.
+          "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+          "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+          "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+          "archived": True or False, # Whether the creative is archived. Applicable to all creative types.
+          "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA.
+          "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.
+          "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by DoubleClick Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            { # Creative Custom Event.
+              "targetType": "A String", # Target type used by the event.
+              "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+              "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+              "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+                "showStatusBar": True or False, # Whether to display the browser status bar.
+                "showScrollBar": True or False, # Whether to display the browser scroll bar.
+                "showAddressBar": True or False, # Whether to display the browser address bar.
+                "showMenuBar": True or False, # Whether to display the browser menu bar.
+                "title": "A String", # Title of popup window.
+                "showToolBar": True or False, # Whether to display the browser tool bar.
+                "positionType": "A String", # Popup window position either centered or at specific coordinate.
+                "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+                  "top": 42, # Offset distance from top side of an asset or a window.
+                  "left": 42, # Offset distance from left side of an asset or a window.
+                },
+                "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+                  "width": 42, # Width of this size.
+                  "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                  "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                  "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                  "height": 42, # Height of this size.
+                },
+              },
+              "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+              "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+              "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+              "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+              "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+              "advertiserCustomEventName": "A String", # User-entered name for the event.
+            },
+          ],
+          "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types.
+          "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.
+            { # Creative Custom Event.
+              "targetType": "A String", # Target type used by the event.
+              "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+              "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+              "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+                "showStatusBar": True or False, # Whether to display the browser status bar.
+                "showScrollBar": True or False, # Whether to display the browser scroll bar.
+                "showAddressBar": True or False, # Whether to display the browser address bar.
+                "showMenuBar": True or False, # Whether to display the browser menu bar.
+                "title": "A String", # Title of popup window.
+                "showToolBar": True or False, # Whether to display the browser tool bar.
+                "positionType": "A String", # Popup window position either centered or at specific coordinate.
+                "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+                  "top": 42, # Offset distance from top side of an asset or a window.
+                  "left": 42, # Offset distance from left side of an asset or a window.
+                },
+                "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+                  "width": 42, # Width of this size.
+                  "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                  "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                  "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                  "height": 42, # Height of this size.
+                },
+              },
+              "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+              "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+              "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+              "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+              "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+              "advertiserCustomEventName": "A String", # User-entered name for the event.
+            },
+          ],
+          "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+          "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE.
+          "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.
+          "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types.
+            { # Creative Field Assignment.
+              "creativeFieldId": "A String", # ID of the creative field.
+              "creativeFieldValueId": "A String", # ID of the creative field value.
+            },
+          ],
+          "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.
+          "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+            "A String",
+          ],
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is false. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.
+          "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types.
+              #
+              # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types.
+          "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+          "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.
+          "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+          "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT
+            { # Creative Asset.
+              "mimeType": "A String", # Detected MIME type for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+              "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+              "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+              "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+                "width": 42, # Width of this size.
+                "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                "height": 42, # Height of this size.
+              },
+              "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+              "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+              "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+              "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+                "A String",
+              ],
+              "originalBackup": True or False, # Whether the backup asset is original or changed by the user in DCM. Applicable to the following creative types: all RICH_MEDIA.
+              "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_VIDEO and VPAID_LINEAR_VIDEO.
+              "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.
+              "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+              "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL.
+              "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+                "width": 42, # Width of this size.
+                "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                "height": 42, # Height of this size.
+              },
+              "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+              "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+              "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+              "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+                "width": 42, # Width of this size.
+                "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                "height": 42, # Height of this size.
+              },
+              "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+              "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+              "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field.
+                  # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives.
+                  # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+                  # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives.
+                  # OTHER refers to assets from sources other than DCM, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives.
+                  # PARENT_VIDEO refers to videos uploaded by the user in DCM and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+                  # TRANSCODED_VIDEO refers to videos transcoded by DCM from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+                  # ALTERNATE_VIDEO refers to the DCM representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within DCM.
+                  # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative.
+              "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+              "bitRate": 42, # Detected bit-rate for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+              "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.
+              "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+              "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.
+              "videoDuration": 3.14, # Detected video duration for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+              "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+              "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+              "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+                "top": 42, # Offset distance from top side of an asset or a window.
+                "left": 42, # Offset distance from left side of an asset or a window.
+              },
+              "active": True or False, # Whether the video asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+              "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.
+                "A String",
+              ],
+              "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+              "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+              "zIndex": 42, # zIndex value of an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY.
+              "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.
+              "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.
+                "targetType": "A String", # Target type used by the event.
+                "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+                "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+                "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+                  "showStatusBar": True or False, # Whether to display the browser status bar.
+                  "showScrollBar": True or False, # Whether to display the browser scroll bar.
+                  "showAddressBar": True or False, # Whether to display the browser address bar.
+                  "showMenuBar": True or False, # Whether to display the browser menu bar.
+                  "title": "A String", # Title of popup window.
+                  "showToolBar": True or False, # Whether to display the browser tool bar.
+                  "positionType": "A String", # Popup window position either centered or at specific coordinate.
+                  "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+                    "top": 42, # Offset distance from top side of an asset or a window.
+                    "left": 42, # Offset distance from left side of an asset or a window.
+                  },
+                  "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+                    "width": 42, # Width of this size.
+                    "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                    "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                    "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                    "height": 42, # Height of this size.
+                  },
+                },
+                "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+                "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+                "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+                "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+                "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+                "advertiserCustomEventName": "A String", # User-entered name for the event.
+              },
+              "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+              "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Must be between 0 and 9.99. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+              "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+                "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+                "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+              },
+              "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets.
+              "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+              "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.
+                "top": 42, # Offset distance from top side of an asset or a window.
+                "left": 42, # Offset distance from left side of an asset or a window.
+              },
+              "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+            },
+          ],
+          "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT
+          "videoDuration": 3.14, # Creative video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, all RICH_MEDIA, and all VPAID.
+          "htmlCodeLocked": True or False, # Whether HTML code is DCM-generated or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.
+          "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            { # Creative Click Tag.
+              "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+              "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+              "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+            },
+          ],
+          "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+          "active": True or False, # Whether the creative is active. Applicable to all creative types.
+          "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. Applicable to all creative types.
+              #
+              # Acceptable values are:
+              # - "APP"
+              # - "APP_INTERSTITIAL"
+              # - "IN_STREAM_VIDEO"
+              # - "DISPLAY"
+              # - "DISPLAY_INTERSTITIAL"
+            "A String",
+          ],
+          "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.
+          "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+            "A String",
+          ],
+          "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative".
+          "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+          "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types.
+          "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types.
+          "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "backupImageClickThroughUrl": "A String", # Click-through URL for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types.
+          "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+          "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE.
+          "companionCreatives": [ # List of companion creatives assigned to an in-Stream videocreative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID and all INSTREAM_VIDEO with dynamicAssetSelection set to false.
+            "A String",
+          ],
+          "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true.
+            "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives.
+              { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives.
+                "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field.
+                "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field.
+                "name": "A String", # A user-friendly name for this rule. This is a required field.
+              },
+            ],
+            "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field.
+          },
+          "auto_advance_images": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY.
+          "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by DCM for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "A String",
+          ],
+          "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "customHtml": "A String", # User-entered value.
+            "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed.
+          },
+          "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing creative. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Creative ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Creative.
+    "thirdPartyUrls": [ # Third-party URLs for tracking in-stream video creative events. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      { # Third-party Tracking URL.
+        "url": "A String", # URL for the specified third-party URL type.
+        "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video creatives.
+      },
+    ],
+    "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "videoDescription": "A String", # Description of the video ad. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types.
+    "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.
+    "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.
+      "windowHeight": 42, # Height of the window.
+      "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+      "windowWidth": 42, # Width of the window.
+      "positionOption": "A String", # Position in the browser where the window will open.
+      "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+    },
+    "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives.
+    "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types.
+    "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.
+      "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+      "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+    },
+    "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+    "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "archived": True or False, # Whether the creative is archived. Applicable to all creative types.
+    "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA.
+    "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.
+    "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by DoubleClick Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types.
+    "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.
+      "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+      "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+    },
+    "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE.
+    "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.
+    "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types.
+      { # Creative Field Assignment.
+        "creativeFieldId": "A String", # ID of the creative field.
+        "creativeFieldValueId": "A String", # ID of the creative field value.
+      },
+    ],
+    "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.
+    "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "A String",
+    ],
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is false. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types.
+        # 
+        # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types.
+    "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.
+    "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT
+      { # Creative Asset.
+        "mimeType": "A String", # Detected MIME type for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+        "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+        "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "A String",
+        ],
+        "originalBackup": True or False, # Whether the backup asset is original or changed by the user in DCM. Applicable to the following creative types: all RICH_MEDIA.
+        "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_VIDEO and VPAID_LINEAR_VIDEO.
+        "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.
+        "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL.
+        "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+        "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field.
+            # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives.
+            # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives.
+            # OTHER refers to assets from sources other than DCM, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives.
+            # PARENT_VIDEO refers to videos uploaded by the user in DCM and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+            # TRANSCODED_VIDEO refers to videos transcoded by DCM from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+            # ALTERNATE_VIDEO refers to the DCM representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within DCM.
+            # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative.
+        "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+        "bitRate": 42, # Detected bit-rate for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.
+        "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.
+        "videoDuration": 3.14, # Detected video duration for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+        "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+          "top": 42, # Offset distance from top side of an asset or a window.
+          "left": 42, # Offset distance from left side of an asset or a window.
+        },
+        "active": True or False, # Whether the video asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.
+          "A String",
+        ],
+        "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+        "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "zIndex": 42, # zIndex value of an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY.
+        "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.
+        "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+        "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Must be between 0 and 9.99. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+        "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+          "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+        },
+        "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets.
+        "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "top": 42, # Offset distance from top side of an asset or a window.
+          "left": 42, # Offset distance from left side of an asset or a window.
+        },
+        "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+      },
+    ],
+    "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT
+    "videoDuration": 3.14, # Creative video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, all RICH_MEDIA, and all VPAID.
+    "htmlCodeLocked": True or False, # Whether HTML code is DCM-generated or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.
+    "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      { # Creative Click Tag.
+        "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+        "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+      },
+    ],
+    "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    "active": True or False, # Whether the creative is active. Applicable to all creative types.
+    "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. Applicable to all creative types.
+        # 
+        # Acceptable values are:
+        # - "APP"
+        # - "APP_INTERSTITIAL"
+        # - "IN_STREAM_VIDEO"
+        # - "DISPLAY"
+        # - "DISPLAY_INTERSTITIAL"
+      "A String",
+    ],
+    "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.
+    "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "A String",
+    ],
+    "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative".
+    "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+    "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types.
+    "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types.
+    "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "backupImageClickThroughUrl": "A String", # Click-through URL for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types.
+    "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+    "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE.
+    "companionCreatives": [ # List of companion creatives assigned to an in-Stream videocreative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID and all INSTREAM_VIDEO with dynamicAssetSelection set to false.
+      "A String",
+    ],
+    "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true.
+      "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives.
+        { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives.
+          "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field.
+          "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field.
+          "name": "A String", # A user-friendly name for this rule. This is a required field.
+        },
+      ],
+      "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field.
+    },
+    "auto_advance_images": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY.
+    "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by DCM for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "A String",
+    ],
+    "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "customHtml": "A String", # User-entered value.
+      "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed.
+    },
+    "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Creative.
+      "thirdPartyUrls": [ # Third-party URLs for tracking in-stream video creative events. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+        { # Third-party Tracking URL.
+          "url": "A String", # URL for the specified third-party URL type.
+          "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video creatives.
+        },
+      ],
+      "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "videoDescription": "A String", # Description of the video ad. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types.
+      "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.
+      "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.
+        "windowHeight": 42, # Height of the window.
+        "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+        "windowWidth": 42, # Width of the window.
+        "positionOption": "A String", # Position in the browser where the window will open.
+        "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+      },
+      "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives.
+      "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types.
+      "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.
+        "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+        "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+      },
+      "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+      "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "archived": True or False, # Whether the creative is archived. Applicable to all creative types.
+      "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA.
+      "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.
+      "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by DoubleClick Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types.
+      "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.
+        "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+        "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+      },
+      "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE.
+      "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.
+      "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types.
+        { # Creative Field Assignment.
+          "creativeFieldId": "A String", # ID of the creative field.
+          "creativeFieldValueId": "A String", # ID of the creative field value.
+        },
+      ],
+      "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.
+      "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+        "A String",
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is false. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types.
+          #
+          # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types.
+      "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.
+      "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT
+        { # Creative Asset.
+          "mimeType": "A String", # Detected MIME type for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+          "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "A String",
+          ],
+          "originalBackup": True or False, # Whether the backup asset is original or changed by the user in DCM. Applicable to the following creative types: all RICH_MEDIA.
+          "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_VIDEO and VPAID_LINEAR_VIDEO.
+          "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.
+          "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL.
+          "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+          "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field.
+              # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives.
+              # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+              # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives.
+              # OTHER refers to assets from sources other than DCM, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives.
+              # PARENT_VIDEO refers to videos uploaded by the user in DCM and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+              # TRANSCODED_VIDEO refers to videos transcoded by DCM from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+              # ALTERNATE_VIDEO refers to the DCM representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within DCM.
+              # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative.
+          "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "bitRate": 42, # Detected bit-rate for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.
+          "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.
+          "videoDuration": 3.14, # Detected video duration for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "active": True or False, # Whether the video asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.
+            "A String",
+          ],
+          "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "zIndex": 42, # zIndex value of an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY.
+          "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.
+          "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.
+            "targetType": "A String", # Target type used by the event.
+            "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+            "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+            "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+              "showStatusBar": True or False, # Whether to display the browser status bar.
+              "showScrollBar": True or False, # Whether to display the browser scroll bar.
+              "showAddressBar": True or False, # Whether to display the browser address bar.
+              "showMenuBar": True or False, # Whether to display the browser menu bar.
+              "title": "A String", # Title of popup window.
+              "showToolBar": True or False, # Whether to display the browser tool bar.
+              "positionType": "A String", # Popup window position either centered or at specific coordinate.
+              "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+                "top": 42, # Offset distance from top side of an asset or a window.
+                "left": 42, # Offset distance from left side of an asset or a window.
+              },
+              "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+                "width": 42, # Width of this size.
+                "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                "height": 42, # Height of this size.
+              },
+            },
+            "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+            "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+            "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+            "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+            "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+            "advertiserCustomEventName": "A String", # User-entered name for the event.
+          },
+          "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Must be between 0 and 9.99. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+          "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+            "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+            "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+          },
+          "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets.
+          "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+        },
+      ],
+      "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT
+      "videoDuration": 3.14, # Creative video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, all RICH_MEDIA, and all VPAID.
+      "htmlCodeLocked": True or False, # Whether HTML code is DCM-generated or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.
+      "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        { # Creative Click Tag.
+          "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+          "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+        },
+      ],
+      "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      "active": True or False, # Whether the creative is active. Applicable to all creative types.
+      "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. Applicable to all creative types.
+          #
+          # Acceptable values are:
+          # - "APP"
+          # - "APP_INTERSTITIAL"
+          # - "IN_STREAM_VIDEO"
+          # - "DISPLAY"
+          # - "DISPLAY_INTERSTITIAL"
+        "A String",
+      ],
+      "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.
+      "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+        "A String",
+      ],
+      "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative".
+      "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+      "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types.
+      "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types.
+      "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "backupImageClickThroughUrl": "A String", # Click-through URL for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types.
+      "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+      "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE.
+      "companionCreatives": [ # List of companion creatives assigned to an in-Stream videocreative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID and all INSTREAM_VIDEO with dynamicAssetSelection set to false.
+        "A String",
+      ],
+      "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true.
+        "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives.
+          { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives.
+            "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field.
+            "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field.
+            "name": "A String", # A user-friendly name for this rule. This is a required field.
+          },
+        ],
+        "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field.
+      },
+      "auto_advance_images": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY.
+      "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by DCM for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "A String",
+      ],
+      "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "customHtml": "A String", # User-entered value.
+        "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed.
+      },
+      "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing creative.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Creative.
+    "thirdPartyUrls": [ # Third-party URLs for tracking in-stream video creative events. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      { # Third-party Tracking URL.
+        "url": "A String", # URL for the specified third-party URL type.
+        "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video creatives.
+      },
+    ],
+    "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "videoDescription": "A String", # Description of the video ad. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types.
+    "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.
+    "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.
+      "windowHeight": 42, # Height of the window.
+      "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+      "windowWidth": 42, # Width of the window.
+      "positionOption": "A String", # Position in the browser where the window will open.
+      "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+    },
+    "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives.
+    "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types.
+    "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.
+      "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+      "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+    },
+    "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+    "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "archived": True or False, # Whether the creative is archived. Applicable to all creative types.
+    "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA.
+    "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.
+    "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by DoubleClick Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types.
+    "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.
+      { # Creative Custom Event.
+        "targetType": "A String", # Target type used by the event.
+        "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+        "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+        "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+          "showStatusBar": True or False, # Whether to display the browser status bar.
+          "showScrollBar": True or False, # Whether to display the browser scroll bar.
+          "showAddressBar": True or False, # Whether to display the browser address bar.
+          "showMenuBar": True or False, # Whether to display the browser menu bar.
+          "title": "A String", # Title of popup window.
+          "showToolBar": True or False, # Whether to display the browser tool bar.
+          "positionType": "A String", # Popup window position either centered or at specific coordinate.
+          "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        },
+        "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+        "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+        "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+        "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+        "advertiserCustomEventName": "A String", # User-entered name for the event.
+      },
+    ],
+    "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.
+      "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+      "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+    },
+    "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE.
+    "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.
+    "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types.
+      { # Creative Field Assignment.
+        "creativeFieldId": "A String", # ID of the creative field.
+        "creativeFieldValueId": "A String", # ID of the creative field value.
+      },
+    ],
+    "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.
+    "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "A String",
+    ],
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is false. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types.
+        # 
+        # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types.
+    "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.
+    "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT
+      { # Creative Asset.
+        "mimeType": "A String", # Detected MIME type for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+        "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+        "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "A String",
+        ],
+        "originalBackup": True or False, # Whether the backup asset is original or changed by the user in DCM. Applicable to the following creative types: all RICH_MEDIA.
+        "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_VIDEO and VPAID_LINEAR_VIDEO.
+        "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.
+        "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL.
+        "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+        "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+        "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field.
+            # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives.
+            # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives.
+            # OTHER refers to assets from sources other than DCM, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives.
+            # PARENT_VIDEO refers to videos uploaded by the user in DCM and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+            # TRANSCODED_VIDEO refers to videos transcoded by DCM from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+            # ALTERNATE_VIDEO refers to the DCM representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within DCM.
+            # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative.
+        "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+        "bitRate": 42, # Detected bit-rate for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.
+        "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.
+        "videoDuration": 3.14, # Detected video duration for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+        "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+          "top": 42, # Offset distance from top side of an asset or a window.
+          "left": 42, # Offset distance from left side of an asset or a window.
+        },
+        "active": True or False, # Whether the video asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.
+          "A String",
+        ],
+        "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+        "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+        "zIndex": 42, # zIndex value of an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY.
+        "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.
+        "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+        "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Must be between 0 and 9.99. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+        "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+          "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+        },
+        "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets.
+        "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+        "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "top": 42, # Offset distance from top side of an asset or a window.
+          "left": 42, # Offset distance from left side of an asset or a window.
+        },
+        "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+      },
+    ],
+    "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT
+    "videoDuration": 3.14, # Creative video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, all RICH_MEDIA, and all VPAID.
+    "htmlCodeLocked": True or False, # Whether HTML code is DCM-generated or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.
+    "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      { # Creative Click Tag.
+        "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+        "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+      },
+    ],
+    "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    "active": True or False, # Whether the creative is active. Applicable to all creative types.
+    "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. Applicable to all creative types.
+        # 
+        # Acceptable values are:
+        # - "APP"
+        # - "APP_INTERSTITIAL"
+        # - "IN_STREAM_VIDEO"
+        # - "DISPLAY"
+        # - "DISPLAY_INTERSTITIAL"
+      "A String",
+    ],
+    "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.
+    "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "A String",
+    ],
+    "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative".
+    "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+    "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types.
+    "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types.
+    "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "backupImageClickThroughUrl": "A String", # Click-through URL for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+    "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types.
+    "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+    "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+    "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE.
+    "companionCreatives": [ # List of companion creatives assigned to an in-Stream videocreative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID and all INSTREAM_VIDEO with dynamicAssetSelection set to false.
+      "A String",
+    ],
+    "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true.
+      "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives.
+        { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives.
+          "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field.
+          "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field.
+          "name": "A String", # A user-friendly name for this rule. This is a required field.
+        },
+      ],
+      "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field.
+    },
+    "auto_advance_images": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY.
+    "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by DCM for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "A String",
+    ],
+    "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "customHtml": "A String", # User-entered value.
+      "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed.
+    },
+    "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Creative.
+      "thirdPartyUrls": [ # Third-party URLs for tracking in-stream video creative events. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+        { # Third-party Tracking URL.
+          "url": "A String", # URL for the specified third-party URL type.
+          "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video creatives.
+        },
+      ],
+      "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "videoDescription": "A String", # Description of the video ad. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types.
+      "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.
+      "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.
+        "windowHeight": 42, # Height of the window.
+        "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+        "windowWidth": 42, # Width of the window.
+        "positionOption": "A String", # Position in the browser where the window will open.
+        "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.
+      },
+      "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives.
+      "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types.
+      "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.
+        "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+        "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+      },
+      "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+      "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "archived": True or False, # Whether the creative is archived. Applicable to all creative types.
+      "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA.
+      "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.
+      "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by DoubleClick Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types.
+      "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.
+        { # Creative Custom Event.
+          "targetType": "A String", # Target type used by the event.
+          "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+          "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+          "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+            "showStatusBar": True or False, # Whether to display the browser status bar.
+            "showScrollBar": True or False, # Whether to display the browser scroll bar.
+            "showAddressBar": True or False, # Whether to display the browser address bar.
+            "showMenuBar": True or False, # Whether to display the browser menu bar.
+            "title": "A String", # Title of popup window.
+            "showToolBar": True or False, # Whether to display the browser tool bar.
+            "positionType": "A String", # Popup window position either centered or at specific coordinate.
+            "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+              "top": 42, # Offset distance from top side of an asset or a window.
+              "left": 42, # Offset distance from left side of an asset or a window.
+            },
+            "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          },
+          "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+          "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+          "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+          "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+          "advertiserCustomEventName": "A String", # User-entered name for the event.
+        },
+      ],
+      "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.
+        "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+        "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+      },
+      "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE.
+      "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.
+      "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types.
+        { # Creative Field Assignment.
+          "creativeFieldId": "A String", # ID of the creative field.
+          "creativeFieldValueId": "A String", # ID of the creative field value.
+        },
+      ],
+      "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.
+      "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+        "A String",
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is false. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types.
+          #
+          # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types.
+      "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.
+      "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT
+        { # Creative Asset.
+          "mimeType": "A String", # Detected MIME type for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+          "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by DCM. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "A String",
+          ],
+          "originalBackup": True or False, # Whether the backup asset is original or changed by the user in DCM. Applicable to the following creative types: all RICH_MEDIA.
+          "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_VIDEO and VPAID_LINEAR_VIDEO.
+          "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.
+          "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL.
+          "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+          "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field.
+              # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives.
+              # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+              # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives.
+              # OTHER refers to assets from sources other than DCM, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives.
+              # PARENT_VIDEO refers to videos uploaded by the user in DCM and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+              # TRANSCODED_VIDEO refers to videos transcoded by DCM from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives.
+              # ALTERNATE_VIDEO refers to the DCM representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within DCM.
+              # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative.
+          "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "bitRate": 42, # Detected bit-rate for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.
+          "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.
+          "videoDuration": 3.14, # Detected video duration for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+          "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "active": True or False, # Whether the video asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.
+            "A String",
+          ],
+          "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.
+          "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.
+          "zIndex": 42, # zIndex value of an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY.
+          "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.
+          "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.
+            "targetType": "A String", # Target type used by the event.
+            "artworkType": "A String", # Artwork type used by the creative.This is a read-only field.
+            "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.
+            "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events.
+              "showStatusBar": True or False, # Whether to display the browser status bar.
+              "showScrollBar": True or False, # Whether to display the browser scroll bar.
+              "showAddressBar": True or False, # Whether to display the browser address bar.
+              "showMenuBar": True or False, # Whether to display the browser menu bar.
+              "title": "A String", # Title of popup window.
+              "showToolBar": True or False, # Whether to display the browser tool bar.
+              "positionType": "A String", # Popup window position either centered or at specific coordinate.
+              "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.
+                "top": 42, # Offset distance from top side of an asset or a window.
+                "left": 42, # Offset distance from left side of an asset or a window.
+              },
+              "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID
+                "width": 42, # Width of this size.
+                "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                "height": 42, # Height of this size.
+              },
+            },
+            "advertiserCustomEventId": "A String", # Unique ID of this event used by DDM Reporting and Data Transfer. This is a read-only field.
+            "artworkLabel": "A String", # Artwork label column, used to link events in DCM back to events in Studio. This is a required field and should not be modified after insertion.
+            "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field.
+            "exitUrl": "A String", # Exit URL of the event. This field is used only for exit events.
+            "id": "A String", # ID of this event. This is a required field and should not be modified after insertion.
+            "advertiserCustomEventName": "A String", # User-entered name for the event.
+          },
+          "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Must be between 0 and 9.99. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height.
+          "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+            "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.
+            "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed.
+          },
+          "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets.
+          "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.
+          "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.
+            "top": 42, # Offset distance from top side of an asset or a window.
+            "left": 42, # Offset distance from left side of an asset or a window.
+          },
+          "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA.
+        },
+      ],
+      "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT
+      "videoDuration": 3.14, # Creative video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, all RICH_MEDIA, and all VPAID.
+      "htmlCodeLocked": True or False, # Whether HTML code is DCM-generated or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.
+      "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        { # Creative Click Tag.
+          "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+          "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.
+          "value": "A String", # Parameter value for the specified click tag. This field contains a click-through url.
+        },
+      ],
+      "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+      "active": True or False, # Whether the creative is active. Applicable to all creative types.
+      "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. Applicable to all creative types.
+          #
+          # Acceptable values are:
+          # - "APP"
+          # - "APP_INTERSTITIAL"
+          # - "IN_STREAM_VIDEO"
+          # - "DISPLAY"
+          # - "DISPLAY_INTERSTITIAL"
+        "A String",
+      ],
+      "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.
+      "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+        "A String",
+      ],
+      "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative".
+      "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types.
+      "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types.
+      "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types.
+      "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "backupImageClickThroughUrl": "A String", # Click-through URL for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+      "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types.
+      "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.
+      "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.
+      "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE.
+      "companionCreatives": [ # List of companion creatives assigned to an in-Stream videocreative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID and all INSTREAM_VIDEO with dynamicAssetSelection set to false.
+        "A String",
+      ],
+      "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true.
+        "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives.
+          { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives.
+            "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field.
+            "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field.
+            "name": "A String", # A user-friendly name for this rule. This is a required field.
+          },
+        ],
+        "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field.
+      },
+      "auto_advance_images": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY.
+      "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by DCM for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "A String",
+      ],
+      "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.
+        "customHtml": "A String", # User-entered value.
+        "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed.
+      },
+      "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.dimensionValues.html b/docs/dyn/dfareporting_v2_7.dimensionValues.html
new file mode 100644
index 00000000000..58971c139e9
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.dimensionValues.html
@@ -0,0 +1,144 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.dimensionValues.html">dimensionValues</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#query">query(profileId, body, pageToken=None, maxResults=None)</a></code></p>
+<p class="firstline">Retrieves list of report dimension values for a list of filters.</p>
+<p class="toc_element">
+  <code><a href="#query_next">query_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="query">query(profileId, body, pageToken=None, maxResults=None)</code>
+  <pre>Retrieves list of report dimension values for a list of filters.
+
+Args:
+  profileId: string, The DFA user profile ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents a DimensionValuesRequest.
+    "dimensionName": "A String", # The name of the dimension for which values should be requested.
+    "startDate": "A String", # The start date of the date range for which to retrieve dimension values. A string of the format "yyyy-MM-dd".
+    "kind": "dfareporting#dimensionValueRequest", # The kind of request this is, in this case dfareporting#dimensionValueRequest.
+    "endDate": "A String", # The end date of the date range for which to retrieve dimension values. A string of the format "yyyy-MM-dd".
+    "filters": [ # The list of filters by which to filter values. The filters are ANDed.
+      { # Represents a dimension filter.
+        "dimensionName": "A String", # The name of the dimension to filter.
+        "kind": "dfareporting#dimensionFilter", # The kind of resource this is, in this case dfareporting#dimensionFilter.
+        "value": "A String", # The value of the dimension to filter.
+      },
+    ],
+  }
+
+  pageToken: string, The value of the nextToken from the previous result page.
+  maxResults: integer, Maximum number of results to return.
+
+Returns:
+  An object of the form:
+
+    { # Represents the list of DimensionValue resources.
+    "nextPageToken": "A String", # Continuation token used to page through dimension values. To retrieve the next page of results, set the next request's "pageToken" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted.
+    "items": [ # The dimension values returned in this response.
+      { # Represents a DimensionValue resource.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+    ],
+    "kind": "dfareporting#dimensionValueList", # The kind of list this is, in this case dfareporting#dimensionValueList.
+    "etag": "A String", # The eTag of this response for caching purposes.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="query_next">query_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.directorySiteContacts.html b/docs/dyn/dfareporting_v2_7.directorySiteContacts.html
new file mode 100644
index 00000000000..f54a4c23b59
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.directorySiteContacts.html
@@ -0,0 +1,169 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.directorySiteContacts.html">directorySiteContacts</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one directory site contact by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, directorySiteIds=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of directory site contacts, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one directory site contact by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Directory site contact ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Site Directory contact.
+    "kind": "dfareporting#directorySiteContact", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#directorySiteContact".
+    "firstName": "A String", # First name of this directory site contact.
+    "title": "A String", # Title or designation of this directory site contact.
+    "lastName": "A String", # Last name of this directory site contact.
+    "email": "A String", # Email address of this directory site contact.
+    "phone": "A String", # Phone number of this directory site contact.
+    "role": "A String", # Directory site contact role.
+    "address": "A String", # Address of this directory site contact.
+    "type": "A String", # Directory site contact type.
+    "id": "A String", # ID of this directory site contact. This is a read-only, auto-generated field.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, directorySiteIds=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
+  <pre>Retrieves a list of directory site contacts, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for objects by name, ID or email. Wildcards (*) are allowed. For example, "directory site contact*2015" will return objects with names like "directory site contact June 2015", "directory site contact April 2015", or simply "directory site contact 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "directory site contact" will match objects with name "my directory site contact", "directory site contact 2015", or simply "directory site contact".
+  directorySiteIds: string, Select only directory site contacts with these directory site IDs. This is a required field. (repeated)
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only directory site contacts with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Directory Site Contact List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "directorySiteContacts": [ # Directory site contact collection
+      { # Contains properties of a Site Directory contact.
+        "kind": "dfareporting#directorySiteContact", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#directorySiteContact".
+        "firstName": "A String", # First name of this directory site contact.
+        "title": "A String", # Title or designation of this directory site contact.
+        "lastName": "A String", # Last name of this directory site contact.
+        "email": "A String", # Email address of this directory site contact.
+        "phone": "A String", # Phone number of this directory site contact.
+        "role": "A String", # Directory site contact role.
+        "address": "A String", # Address of this directory site contact.
+        "type": "A String", # Directory site contact type.
+        "id": "A String", # ID of this directory site contact. This is a read-only, auto-generated field.
+      },
+    ],
+    "kind": "dfareporting#directorySiteContactsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#directorySiteContactsListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.directorySites.html b/docs/dyn/dfareporting_v2_7.directorySites.html
new file mode 100644
index 00000000000..d8e49697722
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.directorySites.html
@@ -0,0 +1,590 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.directorySites.html">directorySites</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one directory site by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new directory site.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, countryId=None, acceptsInStreamVideoPlacements=None, pageToken=None, sortOrder=None, parentId=None, acceptsPublisherPaidPlacements=None, acceptsInterstitialPlacements=None, maxResults=None, active=None, searchString=None, sortField=None, ids=None, dfp_network_code=None)</a></code></p>
+<p class="firstline">Retrieves a list of directory sites, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one directory site by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Directory site ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # DirectorySites contains properties of a website from the Site Directory. Sites need to be added to an account via the Sites resource before they can be assigned to a placement.
+      "kind": "dfareporting#directorySite", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#directorySite".
+      "countryId": "A String", # Country ID of this directory site.
+      "description": "A String", # Description of this directory site.
+      "settings": { # Directory Site Settings # Directory site settings.
+        "nielsenOcrOptOut": True or False, # Whether this directory site has disabled Nielsen OCR reach ratings.
+        "activeViewOptOut": True or False, # Whether this directory site has disabled active view creatives.
+        "dfp_settings": { # DFP Settings # Directory site DFP settings.
+          "publisherPortalOnly": True or False, # Whether this directory site is available only via DoubleClick Publisher Portal.
+          "dfp_network_name": "A String", # DFP network name for this directory site.
+          "pubPaidPlacementAccepted": True or False, # Whether this directory site accepts publisher-paid tags.
+          "programmaticPlacementAccepted": True or False, # Whether this directory site accepts programmatic placements.
+          "dfp_network_code": "A String", # DFP network code for this directory site.
+        },
+        "verificationTagOptOut": True or False, # Whether this directory site has disabled generation of Verification ins tags.
+        "instream_video_placement_accepted": True or False, # Whether this site accepts in-stream video ads.
+        "interstitialPlacementAccepted": True or False, # Whether this site accepts interstitial ads.
+        "videoActiveViewOptOut": True or False, # Whether this directory site has disabled active view for in-stream video creatives.
+      },
+      "currencyId": "A String", # Currency ID of this directory site.
+          # Possible values are:
+          # - "1" for USD
+          # - "2" for GBP
+          # - "3" for ESP
+          # - "4" for SEK
+          # - "5" for CAD
+          # - "6" for JPY
+          # - "7" for DEM
+          # - "8" for AUD
+          # - "9" for FRF
+          # - "10" for ITL
+          # - "11" for DKK
+          # - "12" for NOK
+          # - "13" for FIM
+          # - "14" for ZAR
+          # - "15" for IEP
+          # - "16" for NLG
+          # - "17" for EUR
+          # - "18" for KRW
+          # - "19" for TWD
+          # - "20" for SGD
+          # - "21" for CNY
+          # - "22" for HKD
+          # - "23" for NZD
+          # - "24" for MYR
+          # - "25" for BRL
+          # - "26" for PTE
+          # - "27" for MXP
+          # - "28" for CLP
+          # - "29" for TRY
+          # - "30" for ARS
+          # - "31" for PEN
+          # - "32" for ILS
+          # - "33" for CHF
+          # - "34" for VEF
+          # - "35" for COP
+          # - "36" for GTQ
+          # - "37" for PLN
+          # - "39" for INR
+          # - "40" for THB
+          # - "41" for IDR
+          # - "42" for CZK
+          # - "43" for RON
+          # - "44" for HUF
+          # - "45" for RUB
+          # - "46" for AED
+          # - "47" for BGN
+          # - "48" for HRK
+      "inpageTagFormats": [ # Tag types for regular placements.
+          #
+          # Acceptable values are:
+          # - "STANDARD"
+          # - "IFRAME_JAVASCRIPT_INPAGE"
+          # - "INTERNAL_REDIRECT_INPAGE"
+          # - "JAVASCRIPT_INPAGE"
+        "A String",
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "interstitialTagFormats": [ # Tag types for interstitial placements.
+          #
+          # Acceptable values are:
+          # - "IFRAME_JAVASCRIPT_INTERSTITIAL"
+          # - "INTERNAL_REDIRECT_INTERSTITIAL"
+          # - "JAVASCRIPT_INTERSTITIAL"
+        "A String",
+      ],
+      "contactAssignments": [ # Directory site contacts.
+        { # Directory Site Contact Assignment
+          "contactId": "A String", # ID of this directory site contact. This is a read-only, auto-generated field.
+          "visibility": "A String", # Visibility of this directory site contact assignment. When set to PUBLIC this contact assignment is visible to all account and agency users; when set to PRIVATE it is visible only to the site.
+        },
+      ],
+      "url": "A String", # URL of this directory site.
+      "parentId": "A String", # Parent directory site ID.
+      "active": True or False, # Whether this directory site is active.
+      "id": "A String", # ID of this directory site. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this directory site.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new directory site.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # DirectorySites contains properties of a website from the Site Directory. Sites need to be added to an account via the Sites resource before they can be assigned to a placement.
+    "kind": "dfareporting#directorySite", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#directorySite".
+    "countryId": "A String", # Country ID of this directory site.
+    "description": "A String", # Description of this directory site.
+    "settings": { # Directory Site Settings # Directory site settings.
+      "nielsenOcrOptOut": True or False, # Whether this directory site has disabled Nielsen OCR reach ratings.
+      "activeViewOptOut": True or False, # Whether this directory site has disabled active view creatives.
+      "dfp_settings": { # DFP Settings # Directory site DFP settings.
+        "publisherPortalOnly": True or False, # Whether this directory site is available only via DoubleClick Publisher Portal.
+        "dfp_network_name": "A String", # DFP network name for this directory site.
+        "pubPaidPlacementAccepted": True or False, # Whether this directory site accepts publisher-paid tags.
+        "programmaticPlacementAccepted": True or False, # Whether this directory site accepts programmatic placements.
+        "dfp_network_code": "A String", # DFP network code for this directory site.
+      },
+      "verificationTagOptOut": True or False, # Whether this directory site has disabled generation of Verification ins tags.
+      "instream_video_placement_accepted": True or False, # Whether this site accepts in-stream video ads.
+      "interstitialPlacementAccepted": True or False, # Whether this site accepts interstitial ads.
+      "videoActiveViewOptOut": True or False, # Whether this directory site has disabled active view for in-stream video creatives.
+    },
+    "currencyId": "A String", # Currency ID of this directory site.
+        # Possible values are:
+        # - "1" for USD
+        # - "2" for GBP
+        # - "3" for ESP
+        # - "4" for SEK
+        # - "5" for CAD
+        # - "6" for JPY
+        # - "7" for DEM
+        # - "8" for AUD
+        # - "9" for FRF
+        # - "10" for ITL
+        # - "11" for DKK
+        # - "12" for NOK
+        # - "13" for FIM
+        # - "14" for ZAR
+        # - "15" for IEP
+        # - "16" for NLG
+        # - "17" for EUR
+        # - "18" for KRW
+        # - "19" for TWD
+        # - "20" for SGD
+        # - "21" for CNY
+        # - "22" for HKD
+        # - "23" for NZD
+        # - "24" for MYR
+        # - "25" for BRL
+        # - "26" for PTE
+        # - "27" for MXP
+        # - "28" for CLP
+        # - "29" for TRY
+        # - "30" for ARS
+        # - "31" for PEN
+        # - "32" for ILS
+        # - "33" for CHF
+        # - "34" for VEF
+        # - "35" for COP
+        # - "36" for GTQ
+        # - "37" for PLN
+        # - "39" for INR
+        # - "40" for THB
+        # - "41" for IDR
+        # - "42" for CZK
+        # - "43" for RON
+        # - "44" for HUF
+        # - "45" for RUB
+        # - "46" for AED
+        # - "47" for BGN
+        # - "48" for HRK
+    "inpageTagFormats": [ # Tag types for regular placements.
+        # 
+        # Acceptable values are:
+        # - "STANDARD"
+        # - "IFRAME_JAVASCRIPT_INPAGE"
+        # - "INTERNAL_REDIRECT_INPAGE"
+        # - "JAVASCRIPT_INPAGE"
+      "A String",
+    ],
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "interstitialTagFormats": [ # Tag types for interstitial placements.
+        # 
+        # Acceptable values are:
+        # - "IFRAME_JAVASCRIPT_INTERSTITIAL"
+        # - "INTERNAL_REDIRECT_INTERSTITIAL"
+        # - "JAVASCRIPT_INTERSTITIAL"
+      "A String",
+    ],
+    "contactAssignments": [ # Directory site contacts.
+      { # Directory Site Contact Assignment
+        "contactId": "A String", # ID of this directory site contact. This is a read-only, auto-generated field.
+        "visibility": "A String", # Visibility of this directory site contact assignment. When set to PUBLIC this contact assignment is visible to all account and agency users; when set to PRIVATE it is visible only to the site.
+      },
+    ],
+    "url": "A String", # URL of this directory site.
+    "parentId": "A String", # Parent directory site ID.
+    "active": True or False, # Whether this directory site is active.
+    "id": "A String", # ID of this directory site. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this directory site.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # DirectorySites contains properties of a website from the Site Directory. Sites need to be added to an account via the Sites resource before they can be assigned to a placement.
+      "kind": "dfareporting#directorySite", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#directorySite".
+      "countryId": "A String", # Country ID of this directory site.
+      "description": "A String", # Description of this directory site.
+      "settings": { # Directory Site Settings # Directory site settings.
+        "nielsenOcrOptOut": True or False, # Whether this directory site has disabled Nielsen OCR reach ratings.
+        "activeViewOptOut": True or False, # Whether this directory site has disabled active view creatives.
+        "dfp_settings": { # DFP Settings # Directory site DFP settings.
+          "publisherPortalOnly": True or False, # Whether this directory site is available only via DoubleClick Publisher Portal.
+          "dfp_network_name": "A String", # DFP network name for this directory site.
+          "pubPaidPlacementAccepted": True or False, # Whether this directory site accepts publisher-paid tags.
+          "programmaticPlacementAccepted": True or False, # Whether this directory site accepts programmatic placements.
+          "dfp_network_code": "A String", # DFP network code for this directory site.
+        },
+        "verificationTagOptOut": True or False, # Whether this directory site has disabled generation of Verification ins tags.
+        "instream_video_placement_accepted": True or False, # Whether this site accepts in-stream video ads.
+        "interstitialPlacementAccepted": True or False, # Whether this site accepts interstitial ads.
+        "videoActiveViewOptOut": True or False, # Whether this directory site has disabled active view for in-stream video creatives.
+      },
+      "currencyId": "A String", # Currency ID of this directory site.
+          # Possible values are:
+          # - "1" for USD
+          # - "2" for GBP
+          # - "3" for ESP
+          # - "4" for SEK
+          # - "5" for CAD
+          # - "6" for JPY
+          # - "7" for DEM
+          # - "8" for AUD
+          # - "9" for FRF
+          # - "10" for ITL
+          # - "11" for DKK
+          # - "12" for NOK
+          # - "13" for FIM
+          # - "14" for ZAR
+          # - "15" for IEP
+          # - "16" for NLG
+          # - "17" for EUR
+          # - "18" for KRW
+          # - "19" for TWD
+          # - "20" for SGD
+          # - "21" for CNY
+          # - "22" for HKD
+          # - "23" for NZD
+          # - "24" for MYR
+          # - "25" for BRL
+          # - "26" for PTE
+          # - "27" for MXP
+          # - "28" for CLP
+          # - "29" for TRY
+          # - "30" for ARS
+          # - "31" for PEN
+          # - "32" for ILS
+          # - "33" for CHF
+          # - "34" for VEF
+          # - "35" for COP
+          # - "36" for GTQ
+          # - "37" for PLN
+          # - "39" for INR
+          # - "40" for THB
+          # - "41" for IDR
+          # - "42" for CZK
+          # - "43" for RON
+          # - "44" for HUF
+          # - "45" for RUB
+          # - "46" for AED
+          # - "47" for BGN
+          # - "48" for HRK
+      "inpageTagFormats": [ # Tag types for regular placements.
+          #
+          # Acceptable values are:
+          # - "STANDARD"
+          # - "IFRAME_JAVASCRIPT_INPAGE"
+          # - "INTERNAL_REDIRECT_INPAGE"
+          # - "JAVASCRIPT_INPAGE"
+        "A String",
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "interstitialTagFormats": [ # Tag types for interstitial placements.
+          #
+          # Acceptable values are:
+          # - "IFRAME_JAVASCRIPT_INTERSTITIAL"
+          # - "INTERNAL_REDIRECT_INTERSTITIAL"
+          # - "JAVASCRIPT_INTERSTITIAL"
+        "A String",
+      ],
+      "contactAssignments": [ # Directory site contacts.
+        { # Directory Site Contact Assignment
+          "contactId": "A String", # ID of this directory site contact. This is a read-only, auto-generated field.
+          "visibility": "A String", # Visibility of this directory site contact assignment. When set to PUBLIC this contact assignment is visible to all account and agency users; when set to PRIVATE it is visible only to the site.
+        },
+      ],
+      "url": "A String", # URL of this directory site.
+      "parentId": "A String", # Parent directory site ID.
+      "active": True or False, # Whether this directory site is active.
+      "id": "A String", # ID of this directory site. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this directory site.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, countryId=None, acceptsInStreamVideoPlacements=None, pageToken=None, sortOrder=None, parentId=None, acceptsPublisherPaidPlacements=None, acceptsInterstitialPlacements=None, maxResults=None, active=None, searchString=None, sortField=None, ids=None, dfp_network_code=None)</code>
+  <pre>Retrieves a list of directory sites, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  countryId: string, Select only directory sites with this country ID.
+  acceptsInStreamVideoPlacements: boolean, This search filter is no longer supported and will have no effect on the results returned.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  parentId: string, Select only directory sites with this parent ID.
+  acceptsPublisherPaidPlacements: boolean, Select only directory sites that accept publisher paid placements. This field can be left blank.
+  acceptsInterstitialPlacements: boolean, This search filter is no longer supported and will have no effect on the results returned.
+  maxResults: integer, Maximum number of results to return.
+  active: boolean, Select only active directory sites. Leave blank to retrieve both active and inactive directory sites.
+  searchString: string, Allows searching for objects by name, ID or URL. Wildcards (*) are allowed. For example, "directory site*2015" will return objects with names like "directory site June 2015", "directory site April 2015", or simply "directory site 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "directory site" will match objects with name "my directory site", "directory site 2015" or simply, "directory site".
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only directory sites with these IDs. (repeated)
+  dfp_network_code: string, Select only directory sites with this DFP network code.
+
+Returns:
+  An object of the form:
+
+    { # Directory Site List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#directorySitesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#directorySitesListResponse".
+    "directorySites": [ # Directory site collection.
+      { # DirectorySites contains properties of a website from the Site Directory. Sites need to be added to an account via the Sites resource before they can be assigned to a placement.
+          "kind": "dfareporting#directorySite", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#directorySite".
+          "countryId": "A String", # Country ID of this directory site.
+          "description": "A String", # Description of this directory site.
+          "settings": { # Directory Site Settings # Directory site settings.
+            "nielsenOcrOptOut": True or False, # Whether this directory site has disabled Nielsen OCR reach ratings.
+            "activeViewOptOut": True or False, # Whether this directory site has disabled active view creatives.
+            "dfp_settings": { # DFP Settings # Directory site DFP settings.
+              "publisherPortalOnly": True or False, # Whether this directory site is available only via DoubleClick Publisher Portal.
+              "dfp_network_name": "A String", # DFP network name for this directory site.
+              "pubPaidPlacementAccepted": True or False, # Whether this directory site accepts publisher-paid tags.
+              "programmaticPlacementAccepted": True or False, # Whether this directory site accepts programmatic placements.
+              "dfp_network_code": "A String", # DFP network code for this directory site.
+            },
+            "verificationTagOptOut": True or False, # Whether this directory site has disabled generation of Verification ins tags.
+            "instream_video_placement_accepted": True or False, # Whether this site accepts in-stream video ads.
+            "interstitialPlacementAccepted": True or False, # Whether this site accepts interstitial ads.
+            "videoActiveViewOptOut": True or False, # Whether this directory site has disabled active view for in-stream video creatives.
+          },
+          "currencyId": "A String", # Currency ID of this directory site.
+              # Possible values are:
+              # - "1" for USD
+              # - "2" for GBP
+              # - "3" for ESP
+              # - "4" for SEK
+              # - "5" for CAD
+              # - "6" for JPY
+              # - "7" for DEM
+              # - "8" for AUD
+              # - "9" for FRF
+              # - "10" for ITL
+              # - "11" for DKK
+              # - "12" for NOK
+              # - "13" for FIM
+              # - "14" for ZAR
+              # - "15" for IEP
+              # - "16" for NLG
+              # - "17" for EUR
+              # - "18" for KRW
+              # - "19" for TWD
+              # - "20" for SGD
+              # - "21" for CNY
+              # - "22" for HKD
+              # - "23" for NZD
+              # - "24" for MYR
+              # - "25" for BRL
+              # - "26" for PTE
+              # - "27" for MXP
+              # - "28" for CLP
+              # - "29" for TRY
+              # - "30" for ARS
+              # - "31" for PEN
+              # - "32" for ILS
+              # - "33" for CHF
+              # - "34" for VEF
+              # - "35" for COP
+              # - "36" for GTQ
+              # - "37" for PLN
+              # - "39" for INR
+              # - "40" for THB
+              # - "41" for IDR
+              # - "42" for CZK
+              # - "43" for RON
+              # - "44" for HUF
+              # - "45" for RUB
+              # - "46" for AED
+              # - "47" for BGN
+              # - "48" for HRK
+          "inpageTagFormats": [ # Tag types for regular placements.
+              #
+              # Acceptable values are:
+              # - "STANDARD"
+              # - "IFRAME_JAVASCRIPT_INPAGE"
+              # - "INTERNAL_REDIRECT_INPAGE"
+              # - "JAVASCRIPT_INPAGE"
+            "A String",
+          ],
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this directory site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "interstitialTagFormats": [ # Tag types for interstitial placements.
+              #
+              # Acceptable values are:
+              # - "IFRAME_JAVASCRIPT_INTERSTITIAL"
+              # - "INTERNAL_REDIRECT_INTERSTITIAL"
+              # - "JAVASCRIPT_INTERSTITIAL"
+            "A String",
+          ],
+          "contactAssignments": [ # Directory site contacts.
+            { # Directory Site Contact Assignment
+              "contactId": "A String", # ID of this directory site contact. This is a read-only, auto-generated field.
+              "visibility": "A String", # Visibility of this directory site contact assignment. When set to PUBLIC this contact assignment is visible to all account and agency users; when set to PRIVATE it is visible only to the site.
+            },
+          ],
+          "url": "A String", # URL of this directory site.
+          "parentId": "A String", # Parent directory site ID.
+          "active": True or False, # Whether this directory site is active.
+          "id": "A String", # ID of this directory site. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this directory site.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.dynamicTargetingKeys.html b/docs/dyn/dfareporting_v2_7.dynamicTargetingKeys.html
new file mode 100644
index 00000000000..0c0ac5fe251
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.dynamicTargetingKeys.html
@@ -0,0 +1,164 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.dynamicTargetingKeys.html">dynamicTargetingKeys</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, objectId, name, objectType)</a></code></p>
+<p class="firstline">Deletes an existing dynamic targeting key.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new dynamic targeting key. Keys must be created at the advertiser level before being assigned to the advertiser's ads, creatives, or placements. There is a maximum of 1000 keys per advertiser, out of which a maximum of 20 keys can be assigned per ad, creative, or placement.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, advertiserId=None, objectId=None, names=None, objectType=None)</a></code></p>
+<p class="firstline">Retrieves a list of dynamic targeting keys.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, objectId, name, objectType)</code>
+  <pre>Deletes an existing dynamic targeting key.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  objectId: string, ID of the object of this dynamic targeting key. This is a required field. (required)
+  name: string, Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase. (required)
+  objectType: string, Type of the object of this dynamic targeting key. This is a required field. (required)
+    Allowed values
+      OBJECT_AD - 
+      OBJECT_ADVERTISER - 
+      OBJECT_CREATIVE - 
+      OBJECT_PLACEMENT - 
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new dynamic targeting key. Keys must be created at the advertiser level before being assigned to the advertiser's ads, creatives, or placements. There is a maximum of 1000 keys per advertiser, out of which a maximum of 20 keys can be assigned per ad, creative, or placement.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a dynamic targeting key. Dynamic targeting keys are unique, user-friendly labels, created at the advertiser level in DCM, that can be assigned to ads, creatives, and placements and used for targeting with DoubleClick Studio dynamic creatives. Use these labels instead of numeric DCM IDs (such as placement IDs) to save time and avoid errors in your dynamic feeds.
+    "kind": "dfareporting#dynamicTargetingKey", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#dynamicTargetingKey".
+    "name": "A String", # Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase.
+    "objectId": "A String", # ID of the object of this dynamic targeting key. This is a required field.
+    "objectType": "A String", # Type of the object of this dynamic targeting key. This is a required field.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a dynamic targeting key. Dynamic targeting keys are unique, user-friendly labels, created at the advertiser level in DCM, that can be assigned to ads, creatives, and placements and used for targeting with DoubleClick Studio dynamic creatives. Use these labels instead of numeric DCM IDs (such as placement IDs) to save time and avoid errors in your dynamic feeds.
+      "kind": "dfareporting#dynamicTargetingKey", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#dynamicTargetingKey".
+      "name": "A String", # Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase.
+      "objectId": "A String", # ID of the object of this dynamic targeting key. This is a required field.
+      "objectType": "A String", # Type of the object of this dynamic targeting key. This is a required field.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, advertiserId=None, objectId=None, names=None, objectType=None)</code>
+  <pre>Retrieves a list of dynamic targeting keys.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  advertiserId: string, Select only dynamic targeting keys whose object has this advertiser ID.
+  objectId: string, Select only dynamic targeting keys with this object ID.
+  names: string, Select only dynamic targeting keys exactly matching these names. (repeated)
+  objectType: string, Select only dynamic targeting keys with this object type.
+    Allowed values
+      OBJECT_AD - 
+      OBJECT_ADVERTISER - 
+      OBJECT_CREATIVE - 
+      OBJECT_PLACEMENT - 
+
+Returns:
+  An object of the form:
+
+    { # Dynamic Targeting Key List Response
+    "kind": "dfareporting#dynamicTargetingKeysListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#dynamicTargetingKeysListResponse".
+    "dynamicTargetingKeys": [ # Dynamic targeting key collection.
+      { # Contains properties of a dynamic targeting key. Dynamic targeting keys are unique, user-friendly labels, created at the advertiser level in DCM, that can be assigned to ads, creatives, and placements and used for targeting with DoubleClick Studio dynamic creatives. Use these labels instead of numeric DCM IDs (such as placement IDs) to save time and avoid errors in your dynamic feeds.
+          "kind": "dfareporting#dynamicTargetingKey", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#dynamicTargetingKey".
+          "name": "A String", # Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase.
+          "objectId": "A String", # ID of the object of this dynamic targeting key. This is a required field.
+          "objectType": "A String", # Type of the object of this dynamic targeting key. This is a required field.
+        },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.eventTags.html b/docs/dyn/dfareporting_v2_7.eventTags.html
new file mode 100644
index 00000000000..b4cebf1120b
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.eventTags.html
@@ -0,0 +1,493 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.eventTags.html">eventTags</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, id)</a></code></p>
+<p class="firstline">Deletes an existing event tag.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one event tag by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new event tag.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, campaignId=None, advertiserId=None, adId=None, sortOrder=None, definitionsOnly=None, eventTagTypes=None, searchString=None, sortField=None, enabled=None, ids=None)</a></code></p>
+<p class="firstline">Retrieves a list of event tags, possibly filtered.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing event tag. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing event tag.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, id)</code>
+  <pre>Deletes an existing event tag.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Event tag ID. (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one event tag by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Event tag ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of an event tag.
+      "status": "A String", # Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "subaccountId": "A String", # Subaccount ID of this event tag. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this event tag. This is a required field and must be less than 256 characters long.
+      "campaignId": "A String", # Campaign ID of this event tag. This field or the advertiserId field is required on insertion.
+      "url": "A String", # Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
+      "sslCompliant": True or False, # Whether this tag is SSL-compliant or not. This is a read-only field.
+      "urlEscapeLevels": 42, # Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
+      "kind": "dfareporting#eventTag", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTag".
+      "enabledByDefault": True or False, # Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.
+      "advertiserId": "A String", # Advertiser ID of this event tag. This field or the campaignId field is required on insertion.
+      "siteFilterType": "A String", # Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteIds": [ # Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a whitelist or blacklist filter.
+        "A String",
+      ],
+      "excludeFromAdxRequests": True or False, # Whether to remove this event tag from ads that are trafficked through DoubleClick Bid Manager to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
+      "type": "A String", # Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.
+      "id": "A String", # ID of this event tag. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this event tag. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new event tag.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of an event tag.
+    "status": "A String", # Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "subaccountId": "A String", # Subaccount ID of this event tag. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this event tag. This is a required field and must be less than 256 characters long.
+    "campaignId": "A String", # Campaign ID of this event tag. This field or the advertiserId field is required on insertion.
+    "url": "A String", # Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
+    "sslCompliant": True or False, # Whether this tag is SSL-compliant or not. This is a read-only field.
+    "urlEscapeLevels": 42, # Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
+    "kind": "dfareporting#eventTag", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTag".
+    "enabledByDefault": True or False, # Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.
+    "advertiserId": "A String", # Advertiser ID of this event tag. This field or the campaignId field is required on insertion.
+    "siteFilterType": "A String", # Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteIds": [ # Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a whitelist or blacklist filter.
+      "A String",
+    ],
+    "excludeFromAdxRequests": True or False, # Whether to remove this event tag from ads that are trafficked through DoubleClick Bid Manager to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
+    "type": "A String", # Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.
+    "id": "A String", # ID of this event tag. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this event tag. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of an event tag.
+      "status": "A String", # Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "subaccountId": "A String", # Subaccount ID of this event tag. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this event tag. This is a required field and must be less than 256 characters long.
+      "campaignId": "A String", # Campaign ID of this event tag. This field or the advertiserId field is required on insertion.
+      "url": "A String", # Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
+      "sslCompliant": True or False, # Whether this tag is SSL-compliant or not. This is a read-only field.
+      "urlEscapeLevels": 42, # Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
+      "kind": "dfareporting#eventTag", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTag".
+      "enabledByDefault": True or False, # Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.
+      "advertiserId": "A String", # Advertiser ID of this event tag. This field or the campaignId field is required on insertion.
+      "siteFilterType": "A String", # Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteIds": [ # Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a whitelist or blacklist filter.
+        "A String",
+      ],
+      "excludeFromAdxRequests": True or False, # Whether to remove this event tag from ads that are trafficked through DoubleClick Bid Manager to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
+      "type": "A String", # Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.
+      "id": "A String", # ID of this event tag. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this event tag. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, campaignId=None, advertiserId=None, adId=None, sortOrder=None, definitionsOnly=None, eventTagTypes=None, searchString=None, sortField=None, enabled=None, ids=None)</code>
+  <pre>Retrieves a list of event tags, possibly filtered.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Select only event tags that belong to this campaign.
+  advertiserId: string, Select only event tags that belong to this advertiser.
+  adId: string, Select only event tags that belong to this ad.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  definitionsOnly: boolean, Examine only the specified campaign or advertiser's event tags for matching selector criteria. When set to false, the parent advertiser and parent campaign of the specified ad or campaign is examined as well. In addition, when set to false, the status field is examined as well, along with the enabledByDefault field. This parameter can not be set to true when adId is specified as ads do not define their own even tags.
+  eventTagTypes: string, Select only event tags with the specified event tag types. Event tag types can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. (repeated)
+    Allowed values
+      CLICK_THROUGH_EVENT_TAG - 
+      IMPRESSION_IMAGE_EVENT_TAG - 
+      IMPRESSION_JAVASCRIPT_EVENT_TAG - 
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "eventtag*2015" will return objects with names like "eventtag June 2015", "eventtag April 2015", or simply "eventtag 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "eventtag" will match objects with name "my eventtag", "eventtag 2015", or simply "eventtag".
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  enabled: boolean, Select only enabled event tags. What is considered enabled or disabled depends on the definitionsOnly parameter. When definitionsOnly is set to true, only the specified advertiser or campaign's event tags' enabledByDefault field is examined. When definitionsOnly is set to false, the specified ad or specified campaign's parent advertiser's or parent campaign's event tags' enabledByDefault and status fields are examined as well.
+  ids: string, Select only event tags with these IDs. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Event Tag List Response
+    "eventTags": [ # Event tag collection.
+      { # Contains properties of an event tag.
+          "status": "A String", # Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.
+          "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "subaccountId": "A String", # Subaccount ID of this event tag. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this event tag. This is a required field and must be less than 256 characters long.
+          "campaignId": "A String", # Campaign ID of this event tag. This field or the advertiserId field is required on insertion.
+          "url": "A String", # Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
+          "sslCompliant": True or False, # Whether this tag is SSL-compliant or not. This is a read-only field.
+          "urlEscapeLevels": 42, # Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
+          "kind": "dfareporting#eventTag", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTag".
+          "enabledByDefault": True or False, # Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.
+          "advertiserId": "A String", # Advertiser ID of this event tag. This field or the campaignId field is required on insertion.
+          "siteFilterType": "A String", # Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "siteIds": [ # Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a whitelist or blacklist filter.
+            "A String",
+          ],
+          "excludeFromAdxRequests": True or False, # Whether to remove this event tag from ads that are trafficked through DoubleClick Bid Manager to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
+          "type": "A String", # Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.
+          "id": "A String", # ID of this event tag. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this event tag. This is a read-only field that can be left blank.
+        },
+    ],
+    "kind": "dfareporting#eventTagsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTagsListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing event tag. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Event tag ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of an event tag.
+    "status": "A String", # Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "subaccountId": "A String", # Subaccount ID of this event tag. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this event tag. This is a required field and must be less than 256 characters long.
+    "campaignId": "A String", # Campaign ID of this event tag. This field or the advertiserId field is required on insertion.
+    "url": "A String", # Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
+    "sslCompliant": True or False, # Whether this tag is SSL-compliant or not. This is a read-only field.
+    "urlEscapeLevels": 42, # Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
+    "kind": "dfareporting#eventTag", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTag".
+    "enabledByDefault": True or False, # Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.
+    "advertiserId": "A String", # Advertiser ID of this event tag. This field or the campaignId field is required on insertion.
+    "siteFilterType": "A String", # Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteIds": [ # Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a whitelist or blacklist filter.
+      "A String",
+    ],
+    "excludeFromAdxRequests": True or False, # Whether to remove this event tag from ads that are trafficked through DoubleClick Bid Manager to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
+    "type": "A String", # Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.
+    "id": "A String", # ID of this event tag. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this event tag. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of an event tag.
+      "status": "A String", # Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "subaccountId": "A String", # Subaccount ID of this event tag. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this event tag. This is a required field and must be less than 256 characters long.
+      "campaignId": "A String", # Campaign ID of this event tag. This field or the advertiserId field is required on insertion.
+      "url": "A String", # Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
+      "sslCompliant": True or False, # Whether this tag is SSL-compliant or not. This is a read-only field.
+      "urlEscapeLevels": 42, # Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
+      "kind": "dfareporting#eventTag", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTag".
+      "enabledByDefault": True or False, # Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.
+      "advertiserId": "A String", # Advertiser ID of this event tag. This field or the campaignId field is required on insertion.
+      "siteFilterType": "A String", # Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteIds": [ # Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a whitelist or blacklist filter.
+        "A String",
+      ],
+      "excludeFromAdxRequests": True or False, # Whether to remove this event tag from ads that are trafficked through DoubleClick Bid Manager to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
+      "type": "A String", # Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.
+      "id": "A String", # ID of this event tag. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this event tag. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing event tag.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of an event tag.
+    "status": "A String", # Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "subaccountId": "A String", # Subaccount ID of this event tag. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this event tag. This is a required field and must be less than 256 characters long.
+    "campaignId": "A String", # Campaign ID of this event tag. This field or the advertiserId field is required on insertion.
+    "url": "A String", # Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
+    "sslCompliant": True or False, # Whether this tag is SSL-compliant or not. This is a read-only field.
+    "urlEscapeLevels": 42, # Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
+    "kind": "dfareporting#eventTag", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTag".
+    "enabledByDefault": True or False, # Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.
+    "advertiserId": "A String", # Advertiser ID of this event tag. This field or the campaignId field is required on insertion.
+    "siteFilterType": "A String", # Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteIds": [ # Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a whitelist or blacklist filter.
+      "A String",
+    ],
+    "excludeFromAdxRequests": True or False, # Whether to remove this event tag from ads that are trafficked through DoubleClick Bid Manager to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
+    "type": "A String", # Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.
+    "id": "A String", # ID of this event tag. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this event tag. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of an event tag.
+      "status": "A String", # Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "subaccountId": "A String", # Subaccount ID of this event tag. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this event tag. This is a required field and must be less than 256 characters long.
+      "campaignId": "A String", # Campaign ID of this event tag. This field or the advertiserId field is required on insertion.
+      "url": "A String", # Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
+      "sslCompliant": True or False, # Whether this tag is SSL-compliant or not. This is a read-only field.
+      "urlEscapeLevels": 42, # Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
+      "kind": "dfareporting#eventTag", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTag".
+      "enabledByDefault": True or False, # Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.
+      "advertiserId": "A String", # Advertiser ID of this event tag. This field or the campaignId field is required on insertion.
+      "siteFilterType": "A String", # Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteIds": [ # Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a whitelist or blacklist filter.
+        "A String",
+      ],
+      "excludeFromAdxRequests": True or False, # Whether to remove this event tag from ads that are trafficked through DoubleClick Bid Manager to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
+      "type": "A String", # Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.
+      "id": "A String", # ID of this event tag. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this event tag. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.files.html b/docs/dyn/dfareporting_v2_7.files.html
new file mode 100644
index 00000000000..5f5851ad8bd
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.files.html
@@ -0,0 +1,205 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.files.html">files</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(reportId, fileId)</a></code></p>
+<p class="firstline">Retrieves a report file by its report ID and file ID.</p>
+<p class="toc_element">
+  <code><a href="#get_media">get_media(reportId, fileId)</a></code></p>
+<p class="firstline">Retrieves a report file by its report ID and file ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, pageToken=None, maxResults=None, sortOrder=None, sortField=None, scope=None)</a></code></p>
+<p class="firstline">Lists files for a user profile.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(reportId, fileId)</code>
+  <pre>Retrieves a report file by its report ID and file ID.
+
+Args:
+  reportId: string, The ID of the report. (required)
+  fileId: string, The ID of the report file. (required)
+
+Returns:
+  An object of the form:
+
+    { # Represents a File resource. A file contains the metadata for a report run. It shows the status of the run and holds the URLs to the generated report data if the run is finished and the status is "REPORT_AVAILABLE".
+    "status": "A String", # The status of the report file.
+    "kind": "dfareporting#file", # The kind of resource this is, in this case dfareporting#file.
+    "format": "A String", # The output format of the report. Only available once the file is available.
+    "dateRange": { # Represents a date range. # The date range for which the file has report data. The date range will always be the absolute date range for which the report is run.
+      "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+      "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+      "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+      "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+    },
+    "fileName": "A String", # The filename of the file.
+    "etag": "A String", # The eTag of this response for caching purposes.
+    "reportId": "A String", # The ID of the report this file was generated from.
+    "urls": { # The URLs where the completed report file can be downloaded.
+      "browserUrl": "A String", # The URL for downloading the report data through a browser.
+      "apiUrl": "A String", # The URL for downloading the report data through the API.
+    },
+    "lastModifiedTime": "A String", # The timestamp in milliseconds since epoch when this file was last modified.
+    "id": "A String", # The unique ID of this report file.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get_media">get_media(reportId, fileId)</code>
+  <pre>Retrieves a report file by its report ID and file ID.
+
+Args:
+  reportId: string, The ID of the report. (required)
+  fileId: string, The ID of the report file. (required)
+
+Returns:
+  The media object as a string.
+
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, pageToken=None, maxResults=None, sortOrder=None, sortField=None, scope=None)</code>
+  <pre>Lists files for a user profile.
+
+Args:
+  profileId: string, The DFA profile ID. (required)
+  pageToken: string, The value of the nextToken from the previous result page.
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is 'DESCENDING'.
+    Allowed values
+      ASCENDING - Ascending order.
+      DESCENDING - Descending order.
+  sortField: string, The field by which to sort the list.
+    Allowed values
+      ID - Sort by file ID.
+      LAST_MODIFIED_TIME - Sort by 'lastmodifiedAt' field.
+  scope: string, The scope that defines which results are returned, default is 'MINE'.
+    Allowed values
+      ALL - All files in account.
+      MINE - My files.
+      SHARED_WITH_ME - Files shared with me.
+
+Returns:
+  An object of the form:
+
+    { # Represents the list of File resources.
+    "nextPageToken": "A String", # Continuation token used to page through files. To retrieve the next page of results, set the next request's "pageToken" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted.
+    "items": [ # The files returned in this response.
+      { # Represents a File resource. A file contains the metadata for a report run. It shows the status of the run and holds the URLs to the generated report data if the run is finished and the status is "REPORT_AVAILABLE".
+        "status": "A String", # The status of the report file.
+        "kind": "dfareporting#file", # The kind of resource this is, in this case dfareporting#file.
+        "format": "A String", # The output format of the report. Only available once the file is available.
+        "dateRange": { # Represents a date range. # The date range for which the file has report data. The date range will always be the absolute date range for which the report is run.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "fileName": "A String", # The filename of the file.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "reportId": "A String", # The ID of the report this file was generated from.
+        "urls": { # The URLs where the completed report file can be downloaded.
+          "browserUrl": "A String", # The URL for downloading the report data through a browser.
+          "apiUrl": "A String", # The URL for downloading the report data through the API.
+        },
+        "lastModifiedTime": "A String", # The timestamp in milliseconds since epoch when this file was last modified.
+        "id": "A String", # The unique ID of this report file.
+      },
+    ],
+    "kind": "dfareporting#fileList", # The kind of list this is, in this case dfareporting#fileList.
+    "etag": "A String", # The eTag of this response for caching purposes.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.floodlightActivities.html b/docs/dyn/dfareporting_v2_7.floodlightActivities.html
new file mode 100644
index 00000000000..8c88286a74a
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.floodlightActivities.html
@@ -0,0 +1,1045 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.floodlightActivities.html">floodlightActivities</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, id)</a></code></p>
+<p class="firstline">Deletes an existing floodlight activity.</p>
+<p class="toc_element">
+  <code><a href="#generatetag">generatetag(profileId, floodlightActivityId=None)</a></code></p>
+<p class="firstline">Generates a tag for a floodlight activity.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one floodlight activity by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new floodlight activity.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, floodlightActivityGroupName=None, advertiserId=None, tagString=None, floodlightActivityGroupTagString=None, floodlightActivityGroupIds=None, pageToken=None, sortOrder=None, maxResults=None, searchString=None, sortField=None, floodlightConfigurationId=None, ids=None, floodlightActivityGroupType=None)</a></code></p>
+<p class="firstline">Retrieves a list of floodlight activities, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing floodlight activity. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing floodlight activity.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, id)</code>
+  <pre>Deletes an existing floodlight activity.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Floodlight activity ID. (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="generatetag">generatetag(profileId, floodlightActivityId=None)</code>
+  <pre>Generates a tag for a floodlight activity.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  floodlightActivityId: string, Floodlight activity ID for which we want to generate a tag.
+
+Returns:
+  An object of the form:
+
+    { # Floodlight Activity GenerateTag Response
+    "kind": "dfareporting#floodlightActivitiesGenerateTagResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivitiesGenerateTagResponse".
+    "floodlightActivityTag": "A String", # Generated tag for this floodlight activity.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one floodlight activity by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Floodlight activity ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight activity.
+      "tagString": "A String", # Value of the cat= paramter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
+      "secure": True or False, # Whether this tag should use SSL.
+      "floodlightActivityGroupName": "A String", # Name of the associated floodlight activity group. This is a read-only field.
+      "imageTagEnabled": True or False, # Whether the image tag is enabled for this activity.
+      "advertiserId": "A String", # Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
+      "tagFormat": "A String", # Tag format type for the floodlight activity. If left blank, the tag format will default to HTML.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "floodlightActivityGroupId": "A String", # Floodlight activity group ID of this floodlight activity. This is a required field.
+      "id": "A String", # ID of this floodlight activity. This is a read-only, auto-generated field.
+      "floodlightActivityGroupTagString": "A String", # Tag string of the associated floodlight activity group. This is a read-only field.
+      "publisherTags": [ # Publisher dynamic floodlight tags.
+        { # Publisher Dynamic Tag
+          "viewThrough": True or False, # Whether this tag is applicable only for view-throughs.
+          "clickThrough": True or False, # Whether this tag is applicable only for click-throughs.
+          "siteId": "A String", # Site ID of this dynamic tag.
+          "dynamicTag": { # Dynamic Tag # Dynamic floodlight tag.
+            "tag": "A String", # Tag code.
+            "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+            "name": "A String", # Name of this tag.
+          },
+          "directorySiteId": "A String", # Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.
+          "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        },
+      ],
+      "sslCompliant": True or False, # Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "hidden": True or False, # Whether this activity is archived.
+      "accountId": "A String", # Account ID of this floodlight activity. This is a read-only field that can be left blank.
+      "sslRequired": True or False, # Whether this floodlight activity must be SSL-compliant.
+      "expectedUrl": "A String", # URL where this tag will be deployed. If specified, must be less than 256 characters long.
+      "cacheBustingType": "A String", # Code type used for cache busting in the generated tag.
+      "kind": "dfareporting#floodlightActivity", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivity".
+      "subaccountId": "A String", # Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
+      "notes": "A String", # General notes or implementation instructions for the tag.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
+      "userDefinedVariableTypes": [ # List of the user-defined variables used by this conversion tag. These map to the "u[1-20]=" in the tags. Each of these can have a user defined type.
+          # Acceptable values are:
+          # - "U1"
+          # - "U2"
+          # - "U3"
+          # - "U4"
+          # - "U5"
+          # - "U6"
+          # - "U7"
+          # - "U8"
+          # - "U9"
+          # - "U10"
+          # - "U11"
+          # - "U12"
+          # - "U13"
+          # - "U14"
+          # - "U15"
+          # - "U16"
+          # - "U17"
+          # - "U18"
+          # - "U19"
+          # - "U20"
+        "A String",
+      ],
+      "defaultTags": [ # Dynamic floodlight tags.
+        { # Dynamic Tag
+          "tag": "A String", # Tag code.
+          "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this tag.
+        },
+      ],
+      "countingMethod": "A String", # Counting method for conversions for this floodlight activity. This is a required field.
+      "floodlightActivityGroupType": "A String", # Type of the associated floodlight activity group. This is a read-only field.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new floodlight activity.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Floodlight activity.
+    "tagString": "A String", # Value of the cat= paramter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
+    "secure": True or False, # Whether this tag should use SSL.
+    "floodlightActivityGroupName": "A String", # Name of the associated floodlight activity group. This is a read-only field.
+    "imageTagEnabled": True or False, # Whether the image tag is enabled for this activity.
+    "advertiserId": "A String", # Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
+    "tagFormat": "A String", # Tag format type for the floodlight activity. If left blank, the tag format will default to HTML.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "floodlightActivityGroupId": "A String", # Floodlight activity group ID of this floodlight activity. This is a required field.
+    "id": "A String", # ID of this floodlight activity. This is a read-only, auto-generated field.
+    "floodlightActivityGroupTagString": "A String", # Tag string of the associated floodlight activity group. This is a read-only field.
+    "publisherTags": [ # Publisher dynamic floodlight tags.
+      { # Publisher Dynamic Tag
+        "viewThrough": True or False, # Whether this tag is applicable only for view-throughs.
+        "clickThrough": True or False, # Whether this tag is applicable only for click-throughs.
+        "siteId": "A String", # Site ID of this dynamic tag.
+        "dynamicTag": { # Dynamic Tag # Dynamic floodlight tag.
+          "tag": "A String", # Tag code.
+          "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this tag.
+        },
+        "directorySiteId": "A String", # Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.
+        "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      },
+    ],
+    "sslCompliant": True or False, # Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "hidden": True or False, # Whether this activity is archived.
+    "accountId": "A String", # Account ID of this floodlight activity. This is a read-only field that can be left blank.
+    "sslRequired": True or False, # Whether this floodlight activity must be SSL-compliant.
+    "expectedUrl": "A String", # URL where this tag will be deployed. If specified, must be less than 256 characters long.
+    "cacheBustingType": "A String", # Code type used for cache busting in the generated tag.
+    "kind": "dfareporting#floodlightActivity", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivity".
+    "subaccountId": "A String", # Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
+    "notes": "A String", # General notes or implementation instructions for the tag.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
+    "userDefinedVariableTypes": [ # List of the user-defined variables used by this conversion tag. These map to the "u[1-20]=" in the tags. Each of these can have a user defined type.
+        # Acceptable values are:
+        # - "U1"
+        # - "U2"
+        # - "U3"
+        # - "U4"
+        # - "U5"
+        # - "U6"
+        # - "U7"
+        # - "U8"
+        # - "U9"
+        # - "U10"
+        # - "U11"
+        # - "U12"
+        # - "U13"
+        # - "U14"
+        # - "U15"
+        # - "U16"
+        # - "U17"
+        # - "U18"
+        # - "U19"
+        # - "U20"
+      "A String",
+    ],
+    "defaultTags": [ # Dynamic floodlight tags.
+      { # Dynamic Tag
+        "tag": "A String", # Tag code.
+        "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+        "name": "A String", # Name of this tag.
+      },
+    ],
+    "countingMethod": "A String", # Counting method for conversions for this floodlight activity. This is a required field.
+    "floodlightActivityGroupType": "A String", # Type of the associated floodlight activity group. This is a read-only field.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight activity.
+      "tagString": "A String", # Value of the cat= paramter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
+      "secure": True or False, # Whether this tag should use SSL.
+      "floodlightActivityGroupName": "A String", # Name of the associated floodlight activity group. This is a read-only field.
+      "imageTagEnabled": True or False, # Whether the image tag is enabled for this activity.
+      "advertiserId": "A String", # Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
+      "tagFormat": "A String", # Tag format type for the floodlight activity. If left blank, the tag format will default to HTML.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "floodlightActivityGroupId": "A String", # Floodlight activity group ID of this floodlight activity. This is a required field.
+      "id": "A String", # ID of this floodlight activity. This is a read-only, auto-generated field.
+      "floodlightActivityGroupTagString": "A String", # Tag string of the associated floodlight activity group. This is a read-only field.
+      "publisherTags": [ # Publisher dynamic floodlight tags.
+        { # Publisher Dynamic Tag
+          "viewThrough": True or False, # Whether this tag is applicable only for view-throughs.
+          "clickThrough": True or False, # Whether this tag is applicable only for click-throughs.
+          "siteId": "A String", # Site ID of this dynamic tag.
+          "dynamicTag": { # Dynamic Tag # Dynamic floodlight tag.
+            "tag": "A String", # Tag code.
+            "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+            "name": "A String", # Name of this tag.
+          },
+          "directorySiteId": "A String", # Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.
+          "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        },
+      ],
+      "sslCompliant": True or False, # Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "hidden": True or False, # Whether this activity is archived.
+      "accountId": "A String", # Account ID of this floodlight activity. This is a read-only field that can be left blank.
+      "sslRequired": True or False, # Whether this floodlight activity must be SSL-compliant.
+      "expectedUrl": "A String", # URL where this tag will be deployed. If specified, must be less than 256 characters long.
+      "cacheBustingType": "A String", # Code type used for cache busting in the generated tag.
+      "kind": "dfareporting#floodlightActivity", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivity".
+      "subaccountId": "A String", # Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
+      "notes": "A String", # General notes or implementation instructions for the tag.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
+      "userDefinedVariableTypes": [ # List of the user-defined variables used by this conversion tag. These map to the "u[1-20]=" in the tags. Each of these can have a user defined type.
+          # Acceptable values are:
+          # - "U1"
+          # - "U2"
+          # - "U3"
+          # - "U4"
+          # - "U5"
+          # - "U6"
+          # - "U7"
+          # - "U8"
+          # - "U9"
+          # - "U10"
+          # - "U11"
+          # - "U12"
+          # - "U13"
+          # - "U14"
+          # - "U15"
+          # - "U16"
+          # - "U17"
+          # - "U18"
+          # - "U19"
+          # - "U20"
+        "A String",
+      ],
+      "defaultTags": [ # Dynamic floodlight tags.
+        { # Dynamic Tag
+          "tag": "A String", # Tag code.
+          "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this tag.
+        },
+      ],
+      "countingMethod": "A String", # Counting method for conversions for this floodlight activity. This is a required field.
+      "floodlightActivityGroupType": "A String", # Type of the associated floodlight activity group. This is a read-only field.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, floodlightActivityGroupName=None, advertiserId=None, tagString=None, floodlightActivityGroupTagString=None, floodlightActivityGroupIds=None, pageToken=None, sortOrder=None, maxResults=None, searchString=None, sortField=None, floodlightConfigurationId=None, ids=None, floodlightActivityGroupType=None)</code>
+  <pre>Retrieves a list of floodlight activities, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  floodlightActivityGroupName: string, Select only floodlight activities with the specified floodlight activity group name.
+  advertiserId: string, Select only floodlight activities for the specified advertiser ID. Must specify either ids, advertiserId, or floodlightConfigurationId for a non-empty result.
+  tagString: string, Select only floodlight activities with the specified tag string.
+  floodlightActivityGroupTagString: string, Select only floodlight activities with the specified floodlight activity group tag string.
+  floodlightActivityGroupIds: string, Select only floodlight activities with the specified floodlight activity group IDs. (repeated)
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  maxResults: integer, Maximum number of results to return.
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "floodlightactivity*2015" will return objects with names like "floodlightactivity June 2015", "floodlightactivity April 2015", or simply "floodlightactivity 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "floodlightactivity" will match objects with name "my floodlightactivity activity", "floodlightactivity 2015", or simply "floodlightactivity".
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  floodlightConfigurationId: string, Select only floodlight activities for the specified floodlight configuration ID. Must specify either ids, advertiserId, or floodlightConfigurationId for a non-empty result.
+  ids: string, Select only floodlight activities with the specified IDs. Must specify either ids, advertiserId, or floodlightConfigurationId for a non-empty result. (repeated)
+  floodlightActivityGroupType: string, Select only floodlight activities with the specified floodlight activity group type.
+    Allowed values
+      COUNTER - 
+      SALE - 
+
+Returns:
+  An object of the form:
+
+    { # Floodlight Activity List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#floodlightActivitiesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivitiesListResponse".
+    "floodlightActivities": [ # Floodlight activity collection.
+      { # Contains properties of a Floodlight activity.
+          "tagString": "A String", # Value of the cat= paramter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
+          "secure": True or False, # Whether this tag should use SSL.
+          "floodlightActivityGroupName": "A String", # Name of the associated floodlight activity group. This is a read-only field.
+          "imageTagEnabled": True or False, # Whether the image tag is enabled for this activity.
+          "advertiserId": "A String", # Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
+          "tagFormat": "A String", # Tag format type for the floodlight activity. If left blank, the tag format will default to HTML.
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "floodlightActivityGroupId": "A String", # Floodlight activity group ID of this floodlight activity. This is a required field.
+          "id": "A String", # ID of this floodlight activity. This is a read-only, auto-generated field.
+          "floodlightActivityGroupTagString": "A String", # Tag string of the associated floodlight activity group. This is a read-only field.
+          "publisherTags": [ # Publisher dynamic floodlight tags.
+            { # Publisher Dynamic Tag
+              "viewThrough": True or False, # Whether this tag is applicable only for view-throughs.
+              "clickThrough": True or False, # Whether this tag is applicable only for click-throughs.
+              "siteId": "A String", # Site ID of this dynamic tag.
+              "dynamicTag": { # Dynamic Tag # Dynamic floodlight tag.
+                "tag": "A String", # Tag code.
+                "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+                "name": "A String", # Name of this tag.
+              },
+              "directorySiteId": "A String", # Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.
+              "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+            },
+          ],
+          "sslCompliant": True or False, # Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
+          "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "hidden": True or False, # Whether this activity is archived.
+          "accountId": "A String", # Account ID of this floodlight activity. This is a read-only field that can be left blank.
+          "sslRequired": True or False, # Whether this floodlight activity must be SSL-compliant.
+          "expectedUrl": "A String", # URL where this tag will be deployed. If specified, must be less than 256 characters long.
+          "cacheBustingType": "A String", # Code type used for cache busting in the generated tag.
+          "kind": "dfareporting#floodlightActivity", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivity".
+          "subaccountId": "A String", # Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
+          "notes": "A String", # General notes or implementation instructions for the tag.
+          "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
+          "userDefinedVariableTypes": [ # List of the user-defined variables used by this conversion tag. These map to the "u[1-20]=" in the tags. Each of these can have a user defined type.
+              # Acceptable values are:
+              # - "U1"
+              # - "U2"
+              # - "U3"
+              # - "U4"
+              # - "U5"
+              # - "U6"
+              # - "U7"
+              # - "U8"
+              # - "U9"
+              # - "U10"
+              # - "U11"
+              # - "U12"
+              # - "U13"
+              # - "U14"
+              # - "U15"
+              # - "U16"
+              # - "U17"
+              # - "U18"
+              # - "U19"
+              # - "U20"
+            "A String",
+          ],
+          "defaultTags": [ # Dynamic floodlight tags.
+            { # Dynamic Tag
+              "tag": "A String", # Tag code.
+              "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+              "name": "A String", # Name of this tag.
+            },
+          ],
+          "countingMethod": "A String", # Counting method for conversions for this floodlight activity. This is a required field.
+          "floodlightActivityGroupType": "A String", # Type of the associated floodlight activity group. This is a read-only field.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing floodlight activity. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Floodlight activity ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Floodlight activity.
+    "tagString": "A String", # Value of the cat= paramter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
+    "secure": True or False, # Whether this tag should use SSL.
+    "floodlightActivityGroupName": "A String", # Name of the associated floodlight activity group. This is a read-only field.
+    "imageTagEnabled": True or False, # Whether the image tag is enabled for this activity.
+    "advertiserId": "A String", # Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
+    "tagFormat": "A String", # Tag format type for the floodlight activity. If left blank, the tag format will default to HTML.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "floodlightActivityGroupId": "A String", # Floodlight activity group ID of this floodlight activity. This is a required field.
+    "id": "A String", # ID of this floodlight activity. This is a read-only, auto-generated field.
+    "floodlightActivityGroupTagString": "A String", # Tag string of the associated floodlight activity group. This is a read-only field.
+    "publisherTags": [ # Publisher dynamic floodlight tags.
+      { # Publisher Dynamic Tag
+        "viewThrough": True or False, # Whether this tag is applicable only for view-throughs.
+        "clickThrough": True or False, # Whether this tag is applicable only for click-throughs.
+        "siteId": "A String", # Site ID of this dynamic tag.
+        "dynamicTag": { # Dynamic Tag # Dynamic floodlight tag.
+          "tag": "A String", # Tag code.
+          "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this tag.
+        },
+        "directorySiteId": "A String", # Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.
+        "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      },
+    ],
+    "sslCompliant": True or False, # Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "hidden": True or False, # Whether this activity is archived.
+    "accountId": "A String", # Account ID of this floodlight activity. This is a read-only field that can be left blank.
+    "sslRequired": True or False, # Whether this floodlight activity must be SSL-compliant.
+    "expectedUrl": "A String", # URL where this tag will be deployed. If specified, must be less than 256 characters long.
+    "cacheBustingType": "A String", # Code type used for cache busting in the generated tag.
+    "kind": "dfareporting#floodlightActivity", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivity".
+    "subaccountId": "A String", # Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
+    "notes": "A String", # General notes or implementation instructions for the tag.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
+    "userDefinedVariableTypes": [ # List of the user-defined variables used by this conversion tag. These map to the "u[1-20]=" in the tags. Each of these can have a user defined type.
+        # Acceptable values are:
+        # - "U1"
+        # - "U2"
+        # - "U3"
+        # - "U4"
+        # - "U5"
+        # - "U6"
+        # - "U7"
+        # - "U8"
+        # - "U9"
+        # - "U10"
+        # - "U11"
+        # - "U12"
+        # - "U13"
+        # - "U14"
+        # - "U15"
+        # - "U16"
+        # - "U17"
+        # - "U18"
+        # - "U19"
+        # - "U20"
+      "A String",
+    ],
+    "defaultTags": [ # Dynamic floodlight tags.
+      { # Dynamic Tag
+        "tag": "A String", # Tag code.
+        "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+        "name": "A String", # Name of this tag.
+      },
+    ],
+    "countingMethod": "A String", # Counting method for conversions for this floodlight activity. This is a required field.
+    "floodlightActivityGroupType": "A String", # Type of the associated floodlight activity group. This is a read-only field.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight activity.
+      "tagString": "A String", # Value of the cat= paramter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
+      "secure": True or False, # Whether this tag should use SSL.
+      "floodlightActivityGroupName": "A String", # Name of the associated floodlight activity group. This is a read-only field.
+      "imageTagEnabled": True or False, # Whether the image tag is enabled for this activity.
+      "advertiserId": "A String", # Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
+      "tagFormat": "A String", # Tag format type for the floodlight activity. If left blank, the tag format will default to HTML.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "floodlightActivityGroupId": "A String", # Floodlight activity group ID of this floodlight activity. This is a required field.
+      "id": "A String", # ID of this floodlight activity. This is a read-only, auto-generated field.
+      "floodlightActivityGroupTagString": "A String", # Tag string of the associated floodlight activity group. This is a read-only field.
+      "publisherTags": [ # Publisher dynamic floodlight tags.
+        { # Publisher Dynamic Tag
+          "viewThrough": True or False, # Whether this tag is applicable only for view-throughs.
+          "clickThrough": True or False, # Whether this tag is applicable only for click-throughs.
+          "siteId": "A String", # Site ID of this dynamic tag.
+          "dynamicTag": { # Dynamic Tag # Dynamic floodlight tag.
+            "tag": "A String", # Tag code.
+            "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+            "name": "A String", # Name of this tag.
+          },
+          "directorySiteId": "A String", # Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.
+          "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        },
+      ],
+      "sslCompliant": True or False, # Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "hidden": True or False, # Whether this activity is archived.
+      "accountId": "A String", # Account ID of this floodlight activity. This is a read-only field that can be left blank.
+      "sslRequired": True or False, # Whether this floodlight activity must be SSL-compliant.
+      "expectedUrl": "A String", # URL where this tag will be deployed. If specified, must be less than 256 characters long.
+      "cacheBustingType": "A String", # Code type used for cache busting in the generated tag.
+      "kind": "dfareporting#floodlightActivity", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivity".
+      "subaccountId": "A String", # Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
+      "notes": "A String", # General notes or implementation instructions for the tag.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
+      "userDefinedVariableTypes": [ # List of the user-defined variables used by this conversion tag. These map to the "u[1-20]=" in the tags. Each of these can have a user defined type.
+          # Acceptable values are:
+          # - "U1"
+          # - "U2"
+          # - "U3"
+          # - "U4"
+          # - "U5"
+          # - "U6"
+          # - "U7"
+          # - "U8"
+          # - "U9"
+          # - "U10"
+          # - "U11"
+          # - "U12"
+          # - "U13"
+          # - "U14"
+          # - "U15"
+          # - "U16"
+          # - "U17"
+          # - "U18"
+          # - "U19"
+          # - "U20"
+        "A String",
+      ],
+      "defaultTags": [ # Dynamic floodlight tags.
+        { # Dynamic Tag
+          "tag": "A String", # Tag code.
+          "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this tag.
+        },
+      ],
+      "countingMethod": "A String", # Counting method for conversions for this floodlight activity. This is a required field.
+      "floodlightActivityGroupType": "A String", # Type of the associated floodlight activity group. This is a read-only field.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing floodlight activity.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Floodlight activity.
+    "tagString": "A String", # Value of the cat= paramter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
+    "secure": True or False, # Whether this tag should use SSL.
+    "floodlightActivityGroupName": "A String", # Name of the associated floodlight activity group. This is a read-only field.
+    "imageTagEnabled": True or False, # Whether the image tag is enabled for this activity.
+    "advertiserId": "A String", # Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
+    "tagFormat": "A String", # Tag format type for the floodlight activity. If left blank, the tag format will default to HTML.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "floodlightActivityGroupId": "A String", # Floodlight activity group ID of this floodlight activity. This is a required field.
+    "id": "A String", # ID of this floodlight activity. This is a read-only, auto-generated field.
+    "floodlightActivityGroupTagString": "A String", # Tag string of the associated floodlight activity group. This is a read-only field.
+    "publisherTags": [ # Publisher dynamic floodlight tags.
+      { # Publisher Dynamic Tag
+        "viewThrough": True or False, # Whether this tag is applicable only for view-throughs.
+        "clickThrough": True or False, # Whether this tag is applicable only for click-throughs.
+        "siteId": "A String", # Site ID of this dynamic tag.
+        "dynamicTag": { # Dynamic Tag # Dynamic floodlight tag.
+          "tag": "A String", # Tag code.
+          "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this tag.
+        },
+        "directorySiteId": "A String", # Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.
+        "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      },
+    ],
+    "sslCompliant": True or False, # Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "hidden": True or False, # Whether this activity is archived.
+    "accountId": "A String", # Account ID of this floodlight activity. This is a read-only field that can be left blank.
+    "sslRequired": True or False, # Whether this floodlight activity must be SSL-compliant.
+    "expectedUrl": "A String", # URL where this tag will be deployed. If specified, must be less than 256 characters long.
+    "cacheBustingType": "A String", # Code type used for cache busting in the generated tag.
+    "kind": "dfareporting#floodlightActivity", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivity".
+    "subaccountId": "A String", # Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
+    "notes": "A String", # General notes or implementation instructions for the tag.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
+    "userDefinedVariableTypes": [ # List of the user-defined variables used by this conversion tag. These map to the "u[1-20]=" in the tags. Each of these can have a user defined type.
+        # Acceptable values are:
+        # - "U1"
+        # - "U2"
+        # - "U3"
+        # - "U4"
+        # - "U5"
+        # - "U6"
+        # - "U7"
+        # - "U8"
+        # - "U9"
+        # - "U10"
+        # - "U11"
+        # - "U12"
+        # - "U13"
+        # - "U14"
+        # - "U15"
+        # - "U16"
+        # - "U17"
+        # - "U18"
+        # - "U19"
+        # - "U20"
+      "A String",
+    ],
+    "defaultTags": [ # Dynamic floodlight tags.
+      { # Dynamic Tag
+        "tag": "A String", # Tag code.
+        "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+        "name": "A String", # Name of this tag.
+      },
+    ],
+    "countingMethod": "A String", # Counting method for conversions for this floodlight activity. This is a required field.
+    "floodlightActivityGroupType": "A String", # Type of the associated floodlight activity group. This is a read-only field.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight activity.
+      "tagString": "A String", # Value of the cat= paramter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
+      "secure": True or False, # Whether this tag should use SSL.
+      "floodlightActivityGroupName": "A String", # Name of the associated floodlight activity group. This is a read-only field.
+      "imageTagEnabled": True or False, # Whether the image tag is enabled for this activity.
+      "advertiserId": "A String", # Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
+      "tagFormat": "A String", # Tag format type for the floodlight activity. If left blank, the tag format will default to HTML.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "floodlightActivityGroupId": "A String", # Floodlight activity group ID of this floodlight activity. This is a required field.
+      "id": "A String", # ID of this floodlight activity. This is a read-only, auto-generated field.
+      "floodlightActivityGroupTagString": "A String", # Tag string of the associated floodlight activity group. This is a read-only field.
+      "publisherTags": [ # Publisher dynamic floodlight tags.
+        { # Publisher Dynamic Tag
+          "viewThrough": True or False, # Whether this tag is applicable only for view-throughs.
+          "clickThrough": True or False, # Whether this tag is applicable only for click-throughs.
+          "siteId": "A String", # Site ID of this dynamic tag.
+          "dynamicTag": { # Dynamic Tag # Dynamic floodlight tag.
+            "tag": "A String", # Tag code.
+            "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+            "name": "A String", # Name of this tag.
+          },
+          "directorySiteId": "A String", # Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.
+          "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        },
+      ],
+      "sslCompliant": True or False, # Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "hidden": True or False, # Whether this activity is archived.
+      "accountId": "A String", # Account ID of this floodlight activity. This is a read-only field that can be left blank.
+      "sslRequired": True or False, # Whether this floodlight activity must be SSL-compliant.
+      "expectedUrl": "A String", # URL where this tag will be deployed. If specified, must be less than 256 characters long.
+      "cacheBustingType": "A String", # Code type used for cache busting in the generated tag.
+      "kind": "dfareporting#floodlightActivity", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivity".
+      "subaccountId": "A String", # Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
+      "notes": "A String", # General notes or implementation instructions for the tag.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
+      "userDefinedVariableTypes": [ # List of the user-defined variables used by this conversion tag. These map to the "u[1-20]=" in the tags. Each of these can have a user defined type.
+          # Acceptable values are:
+          # - "U1"
+          # - "U2"
+          # - "U3"
+          # - "U4"
+          # - "U5"
+          # - "U6"
+          # - "U7"
+          # - "U8"
+          # - "U9"
+          # - "U10"
+          # - "U11"
+          # - "U12"
+          # - "U13"
+          # - "U14"
+          # - "U15"
+          # - "U16"
+          # - "U17"
+          # - "U18"
+          # - "U19"
+          # - "U20"
+        "A String",
+      ],
+      "defaultTags": [ # Dynamic floodlight tags.
+        { # Dynamic Tag
+          "tag": "A String", # Tag code.
+          "id": "A String", # ID of this dynamic tag. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this tag.
+        },
+      ],
+      "countingMethod": "A String", # Counting method for conversions for this floodlight activity. This is a required field.
+      "floodlightActivityGroupType": "A String", # Type of the associated floodlight activity group. This is a read-only field.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.floodlightActivityGroups.html b/docs/dyn/dfareporting_v2_7.floodlightActivityGroups.html
new file mode 100644
index 00000000000..e0d7ddd4efe
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.floodlightActivityGroups.html
@@ -0,0 +1,488 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.floodlightActivityGroups.html">floodlightActivityGroups</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one floodlight activity group by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new floodlight activity group.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, floodlightConfigurationId=None, ids=None, maxResults=None, sortOrder=None, type=None)</a></code></p>
+<p class="firstline">Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing floodlight activity group. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing floodlight activity group.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one floodlight activity group by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Floodlight activity Group ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight activity group.
+      "kind": "dfareporting#floodlightActivityGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroup".
+      "subaccountId": "A String", # Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity group. This is a required field.
+      "advertiserId": "A String", # Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "tagString": "A String", # Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.
+      "type": "A String", # Type of the floodlight activity group. This is a required field that is read-only after insertion.
+      "id": "A String", # ID of this floodlight activity group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this floodlight activity group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new floodlight activity group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Floodlight activity group.
+    "kind": "dfareporting#floodlightActivityGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroup".
+    "subaccountId": "A String", # Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity group. This is a required field.
+    "advertiserId": "A String", # Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "tagString": "A String", # Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.
+    "type": "A String", # Type of the floodlight activity group. This is a required field that is read-only after insertion.
+    "id": "A String", # ID of this floodlight activity group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this floodlight activity group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight activity group.
+      "kind": "dfareporting#floodlightActivityGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroup".
+      "subaccountId": "A String", # Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity group. This is a required field.
+      "advertiserId": "A String", # Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "tagString": "A String", # Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.
+      "type": "A String", # Type of the floodlight activity group. This is a required field that is read-only after insertion.
+      "id": "A String", # ID of this floodlight activity group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this floodlight activity group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, floodlightConfigurationId=None, ids=None, maxResults=None, sortOrder=None, type=None)</code>
+  <pre>Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  advertiserId: string, Select only floodlight activity groups with the specified advertiser ID. Must specify either advertiserId or floodlightConfigurationId for a non-empty result.
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "floodlightactivitygroup*2015" will return objects with names like "floodlightactivitygroup June 2015", "floodlightactivitygroup April 2015", or simply "floodlightactivitygroup 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "floodlightactivitygroup" will match objects with name "my floodlightactivitygroup activity", "floodlightactivitygroup 2015", or simply "floodlightactivitygroup".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  floodlightConfigurationId: string, Select only floodlight activity groups with the specified floodlight configuration ID. Must specify either advertiserId, or floodlightConfigurationId for a non-empty result.
+  ids: string, Select only floodlight activity groups with the specified IDs. Must specify either advertiserId or floodlightConfigurationId for a non-empty result. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  type: string, Select only floodlight activity groups with the specified floodlight activity group type.
+    Allowed values
+      COUNTER - 
+      SALE - 
+
+Returns:
+  An object of the form:
+
+    { # Floodlight Activity Group List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#floodlightActivityGroupsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroupsListResponse".
+    "floodlightActivityGroups": [ # Floodlight activity group collection.
+      { # Contains properties of a Floodlight activity group.
+          "kind": "dfareporting#floodlightActivityGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroup".
+          "subaccountId": "A String", # Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.
+          "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity group. This is a required field.
+          "advertiserId": "A String", # Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.
+          "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "tagString": "A String", # Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.
+          "type": "A String", # Type of the floodlight activity group. This is a required field that is read-only after insertion.
+          "id": "A String", # ID of this floodlight activity group. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this floodlight activity group. This is a read-only field that can be left blank.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing floodlight activity group. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Floodlight activity Group ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Floodlight activity group.
+    "kind": "dfareporting#floodlightActivityGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroup".
+    "subaccountId": "A String", # Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity group. This is a required field.
+    "advertiserId": "A String", # Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "tagString": "A String", # Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.
+    "type": "A String", # Type of the floodlight activity group. This is a required field that is read-only after insertion.
+    "id": "A String", # ID of this floodlight activity group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this floodlight activity group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight activity group.
+      "kind": "dfareporting#floodlightActivityGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroup".
+      "subaccountId": "A String", # Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity group. This is a required field.
+      "advertiserId": "A String", # Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "tagString": "A String", # Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.
+      "type": "A String", # Type of the floodlight activity group. This is a required field that is read-only after insertion.
+      "id": "A String", # ID of this floodlight activity group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this floodlight activity group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing floodlight activity group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Floodlight activity group.
+    "kind": "dfareporting#floodlightActivityGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroup".
+    "subaccountId": "A String", # Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.
+    "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity group. This is a required field.
+    "advertiserId": "A String", # Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.
+    "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "tagString": "A String", # Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.
+    "type": "A String", # Type of the floodlight activity group. This is a required field that is read-only after insertion.
+    "id": "A String", # ID of this floodlight activity group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this floodlight activity group. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight activity group.
+      "kind": "dfareporting#floodlightActivityGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightActivityGroup".
+      "subaccountId": "A String", # Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.
+      "floodlightConfigurationId": "A String", # Floodlight configuration ID of this floodlight activity group. This is a required field.
+      "advertiserId": "A String", # Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.
+      "floodlightConfigurationIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "tagString": "A String", # Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being [a-z][A-Z][0-9][-][ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.
+      "type": "A String", # Type of the floodlight activity group. This is a required field that is read-only after insertion.
+      "id": "A String", # ID of this floodlight activity group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this floodlight activity group. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.floodlightConfigurations.html b/docs/dyn/dfareporting_v2_7.floodlightConfigurations.html
new file mode 100644
index 00000000000..d2c947f0793
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.floodlightConfigurations.html
@@ -0,0 +1,514 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.floodlightConfigurations.html">floodlightConfigurations</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one floodlight configuration by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, ids=None)</a></code></p>
+<p class="firstline">Retrieves a list of floodlight configurations, possibly filtered.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing floodlight configuration. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing floodlight configuration.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one floodlight configuration by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Floodlight configuration ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight configuration.
+      "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
+      "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
+      "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
+        "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
+        "imageTagEnabled": True or False, # Whether image tags are enabled.
+      },
+      "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
+      "standardVariableTypes": [ # List of standard variables enabled for this configuration.
+          #
+          # Acceptable values are:
+          # - "ORD"
+          # - "NUM"
+        "A String",
+      ],
+      "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
+        "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
+        "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
+      },
+      "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
+      "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
+      "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
+      "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
+      "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
+        { # Third Party Authentication Token
+          "name": "A String", # Name of the third-party authentication token.
+          "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
+        },
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
+      "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
+        { # User Defined Variable configuration.
+          "dataType": "A String", # Data type for the variable. This is a required field.
+          "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
+          "variableType": "A String", # Variable name in the tag. This is a required field.
+        },
+      ],
+      "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, ids=None)</code>
+  <pre>Retrieves a list of floodlight configurations, possibly filtered.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  ids: string, Set of IDs of floodlight configurations to retrieve. Required field; otherwise an empty list will be returned. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Floodlight Configuration List Response
+    "floodlightConfigurations": [ # Floodlight configuration collection.
+      { # Contains properties of a Floodlight configuration.
+          "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
+          "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
+          "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+          "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
+            "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+            "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          },
+          "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
+            "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
+            "imageTagEnabled": True or False, # Whether image tags are enabled.
+          },
+          "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
+          "standardVariableTypes": [ # List of standard variables enabled for this configuration.
+              #
+              # Acceptable values are:
+              # - "ORD"
+              # - "NUM"
+            "A String",
+          ],
+          "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
+            "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
+            "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
+          },
+          "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
+          "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
+          "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
+          "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
+          "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
+            { # Third Party Authentication Token
+              "name": "A String", # Name of the third-party authentication token.
+              "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
+            },
+          ],
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
+          "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
+            { # User Defined Variable configuration.
+              "dataType": "A String", # Data type for the variable. This is a required field.
+              "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
+              "variableType": "A String", # Variable name in the tag. This is a required field.
+            },
+          ],
+          "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
+        },
+    ],
+    "kind": "dfareporting#floodlightConfigurationsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfigurationsListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing floodlight configuration. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Floodlight configuration ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Floodlight configuration.
+    "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
+    "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
+    "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
+      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+    },
+    "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
+      "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
+      "imageTagEnabled": True or False, # Whether image tags are enabled.
+    },
+    "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
+    "standardVariableTypes": [ # List of standard variables enabled for this configuration.
+        # 
+        # Acceptable values are:
+        # - "ORD"
+        # - "NUM"
+      "A String",
+    ],
+    "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
+      "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
+      "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
+    },
+    "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
+    "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
+    "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
+    "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
+    "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
+      { # Third Party Authentication Token
+        "name": "A String", # Name of the third-party authentication token.
+        "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
+      },
+    ],
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
+    "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
+      { # User Defined Variable configuration.
+        "dataType": "A String", # Data type for the variable. This is a required field.
+        "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
+        "variableType": "A String", # Variable name in the tag. This is a required field.
+      },
+    ],
+    "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight configuration.
+      "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
+      "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
+      "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
+        "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
+        "imageTagEnabled": True or False, # Whether image tags are enabled.
+      },
+      "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
+      "standardVariableTypes": [ # List of standard variables enabled for this configuration.
+          #
+          # Acceptable values are:
+          # - "ORD"
+          # - "NUM"
+        "A String",
+      ],
+      "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
+        "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
+        "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
+      },
+      "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
+      "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
+      "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
+      "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
+      "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
+        { # Third Party Authentication Token
+          "name": "A String", # Name of the third-party authentication token.
+          "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
+        },
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
+      "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
+        { # User Defined Variable configuration.
+          "dataType": "A String", # Data type for the variable. This is a required field.
+          "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
+          "variableType": "A String", # Variable name in the tag. This is a required field.
+        },
+      ],
+      "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing floodlight configuration.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a Floodlight configuration.
+    "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
+    "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
+    "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
+      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+    },
+    "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
+      "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
+      "imageTagEnabled": True or False, # Whether image tags are enabled.
+    },
+    "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
+    "standardVariableTypes": [ # List of standard variables enabled for this configuration.
+        # 
+        # Acceptable values are:
+        # - "ORD"
+        # - "NUM"
+      "A String",
+    ],
+    "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
+      "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
+      "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
+    },
+    "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
+    "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
+    "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
+    "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
+    "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
+      { # Third Party Authentication Token
+        "name": "A String", # Name of the third-party authentication token.
+        "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
+      },
+    ],
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
+    "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
+      { # User Defined Variable configuration.
+        "dataType": "A String", # Data type for the variable. This is a required field.
+        "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
+        "variableType": "A String", # Variable name in the tag. This is a required field.
+      },
+    ],
+    "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a Floodlight configuration.
+      "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
+      "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
+      "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
+        "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
+        "imageTagEnabled": True or False, # Whether image tags are enabled.
+      },
+      "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
+      "standardVariableTypes": [ # List of standard variables enabled for this configuration.
+          #
+          # Acceptable values are:
+          # - "ORD"
+          # - "NUM"
+        "A String",
+      ],
+      "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
+        "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
+        "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
+      },
+      "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
+      "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
+      "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
+      "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
+      "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
+        { # Third Party Authentication Token
+          "name": "A String", # Name of the third-party authentication token.
+          "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
+        },
+      ],
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
+      "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
+        { # User Defined Variable configuration.
+          "dataType": "A String", # Data type for the variable. This is a required field.
+          "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
+          "variableType": "A String", # Variable name in the tag. This is a required field.
+        },
+      ],
+      "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.html b/docs/dyn/dfareporting_v2_7.html
new file mode 100644
index 00000000000..1a7a6653bc9
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.html
@@ -0,0 +1,398 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.accountActiveAdSummaries.html">accountActiveAdSummaries()</a></code>
+</p>
+<p class="firstline">Returns the accountActiveAdSummaries Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.accountPermissionGroups.html">accountPermissionGroups()</a></code>
+</p>
+<p class="firstline">Returns the accountPermissionGroups Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.accountPermissions.html">accountPermissions()</a></code>
+</p>
+<p class="firstline">Returns the accountPermissions Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.accountUserProfiles.html">accountUserProfiles()</a></code>
+</p>
+<p class="firstline">Returns the accountUserProfiles Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.accounts.html">accounts()</a></code>
+</p>
+<p class="firstline">Returns the accounts Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.ads.html">ads()</a></code>
+</p>
+<p class="firstline">Returns the ads Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.advertiserGroups.html">advertiserGroups()</a></code>
+</p>
+<p class="firstline">Returns the advertiserGroups Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.advertisers.html">advertisers()</a></code>
+</p>
+<p class="firstline">Returns the advertisers Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.browsers.html">browsers()</a></code>
+</p>
+<p class="firstline">Returns the browsers Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.campaignCreativeAssociations.html">campaignCreativeAssociations()</a></code>
+</p>
+<p class="firstline">Returns the campaignCreativeAssociations Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.campaigns.html">campaigns()</a></code>
+</p>
+<p class="firstline">Returns the campaigns Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.changeLogs.html">changeLogs()</a></code>
+</p>
+<p class="firstline">Returns the changeLogs Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.cities.html">cities()</a></code>
+</p>
+<p class="firstline">Returns the cities Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.connectionTypes.html">connectionTypes()</a></code>
+</p>
+<p class="firstline">Returns the connectionTypes Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.contentCategories.html">contentCategories()</a></code>
+</p>
+<p class="firstline">Returns the contentCategories Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.conversions.html">conversions()</a></code>
+</p>
+<p class="firstline">Returns the conversions Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.countries.html">countries()</a></code>
+</p>
+<p class="firstline">Returns the countries Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.creativeAssets.html">creativeAssets()</a></code>
+</p>
+<p class="firstline">Returns the creativeAssets Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.creativeFieldValues.html">creativeFieldValues()</a></code>
+</p>
+<p class="firstline">Returns the creativeFieldValues Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.creativeFields.html">creativeFields()</a></code>
+</p>
+<p class="firstline">Returns the creativeFields Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.creativeGroups.html">creativeGroups()</a></code>
+</p>
+<p class="firstline">Returns the creativeGroups Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.creatives.html">creatives()</a></code>
+</p>
+<p class="firstline">Returns the creatives Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.dimensionValues.html">dimensionValues()</a></code>
+</p>
+<p class="firstline">Returns the dimensionValues Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.directorySiteContacts.html">directorySiteContacts()</a></code>
+</p>
+<p class="firstline">Returns the directorySiteContacts Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.directorySites.html">directorySites()</a></code>
+</p>
+<p class="firstline">Returns the directorySites Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.dynamicTargetingKeys.html">dynamicTargetingKeys()</a></code>
+</p>
+<p class="firstline">Returns the dynamicTargetingKeys Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.eventTags.html">eventTags()</a></code>
+</p>
+<p class="firstline">Returns the eventTags Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.files.html">files()</a></code>
+</p>
+<p class="firstline">Returns the files Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.floodlightActivities.html">floodlightActivities()</a></code>
+</p>
+<p class="firstline">Returns the floodlightActivities Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.floodlightActivityGroups.html">floodlightActivityGroups()</a></code>
+</p>
+<p class="firstline">Returns the floodlightActivityGroups Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.floodlightConfigurations.html">floodlightConfigurations()</a></code>
+</p>
+<p class="firstline">Returns the floodlightConfigurations Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.inventoryItems.html">inventoryItems()</a></code>
+</p>
+<p class="firstline">Returns the inventoryItems Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.landingPages.html">landingPages()</a></code>
+</p>
+<p class="firstline">Returns the landingPages Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.languages.html">languages()</a></code>
+</p>
+<p class="firstline">Returns the languages Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.metros.html">metros()</a></code>
+</p>
+<p class="firstline">Returns the metros Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.mobileCarriers.html">mobileCarriers()</a></code>
+</p>
+<p class="firstline">Returns the mobileCarriers Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.operatingSystemVersions.html">operatingSystemVersions()</a></code>
+</p>
+<p class="firstline">Returns the operatingSystemVersions Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.operatingSystems.html">operatingSystems()</a></code>
+</p>
+<p class="firstline">Returns the operatingSystems Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.orderDocuments.html">orderDocuments()</a></code>
+</p>
+<p class="firstline">Returns the orderDocuments Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.orders.html">orders()</a></code>
+</p>
+<p class="firstline">Returns the orders Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.placementGroups.html">placementGroups()</a></code>
+</p>
+<p class="firstline">Returns the placementGroups Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.placementStrategies.html">placementStrategies()</a></code>
+</p>
+<p class="firstline">Returns the placementStrategies Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.placements.html">placements()</a></code>
+</p>
+<p class="firstline">Returns the placements Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.platformTypes.html">platformTypes()</a></code>
+</p>
+<p class="firstline">Returns the platformTypes Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.postalCodes.html">postalCodes()</a></code>
+</p>
+<p class="firstline">Returns the postalCodes Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.projects.html">projects()</a></code>
+</p>
+<p class="firstline">Returns the projects Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.regions.html">regions()</a></code>
+</p>
+<p class="firstline">Returns the regions Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.remarketingListShares.html">remarketingListShares()</a></code>
+</p>
+<p class="firstline">Returns the remarketingListShares Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.remarketingLists.html">remarketingLists()</a></code>
+</p>
+<p class="firstline">Returns the remarketingLists Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.reports.html">reports()</a></code>
+</p>
+<p class="firstline">Returns the reports Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.sites.html">sites()</a></code>
+</p>
+<p class="firstline">Returns the sites Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.sizes.html">sizes()</a></code>
+</p>
+<p class="firstline">Returns the sizes Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.subaccounts.html">subaccounts()</a></code>
+</p>
+<p class="firstline">Returns the subaccounts Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.targetableRemarketingLists.html">targetableRemarketingLists()</a></code>
+</p>
+<p class="firstline">Returns the targetableRemarketingLists Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.targetingTemplates.html">targetingTemplates()</a></code>
+</p>
+<p class="firstline">Returns the targetingTemplates Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.userProfiles.html">userProfiles()</a></code>
+</p>
+<p class="firstline">Returns the userProfiles Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.userRolePermissionGroups.html">userRolePermissionGroups()</a></code>
+</p>
+<p class="firstline">Returns the userRolePermissionGroups Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.userRolePermissions.html">userRolePermissions()</a></code>
+</p>
+<p class="firstline">Returns the userRolePermissions Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.userRoles.html">userRoles()</a></code>
+</p>
+<p class="firstline">Returns the userRoles Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.videoFormats.html">videoFormats()</a></code>
+</p>
+<p class="firstline">Returns the videoFormats Resource.</p>
+
+<p class="toc_element">
+  <code><a href="#new_batch_http_request">new_batch_http_request()</a></code></p>
+<p class="firstline">Create a BatchHttpRequest object based on the discovery document.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="new_batch_http_request">new_batch_http_request()</code>
+  <pre>Create a BatchHttpRequest object based on the discovery document.
+
+        Args:
+          callback: callable, A callback to be called for each response, of the
+            form callback(id, response, exception). The first parameter is the
+            request id, and the second is the deserialized response object. The
+            third is an apiclient.errors.HttpError exception object if an HTTP
+            error occurred while processing the request, or None if no error
+            occurred.
+
+        Returns:
+          A BatchHttpRequest object based on the discovery document.
+        </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.inventoryItems.html b/docs/dyn/dfareporting_v2_7.inventoryItems.html
new file mode 100644
index 00000000000..2f281f9b015
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.inventoryItems.html
@@ -0,0 +1,250 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.inventoryItems.html">inventoryItems</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, projectId, id)</a></code></p>
+<p class="firstline">Gets one inventory item by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, projectId, pageToken=None, inPlan=None, sortOrder=None, type=None, orderId=None, maxResults=None, siteId=None, sortField=None, ids=None)</a></code></p>
+<p class="firstline">Retrieves a list of inventory items, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, projectId, id)</code>
+  <pre>Gets one inventory item by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  projectId: string, Project ID for order documents. (required)
+  id: string, Inventory item ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Represents a buy from the DoubleClick Planning inventory store.
+    "orderId": "A String", # Order ID of this inventory item.
+    "pricing": { # Pricing Information # Pricing of this inventory item.
+      "groupType": "A String", # Group type of this inventory item if it represents a placement group. Is null otherwise. There are two type of placement groups: PLANNING_PLACEMENT_GROUP_TYPE_PACKAGE is a simple group of inventory items that acts as a single pricing point for a group of tags. PLANNING_PLACEMENT_GROUP_TYPE_ROADBLOCK is a group of inventory items that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned inventory items to be marked as primary.
+      "startDate": "A String", # Start date of this inventory item.
+      "endDate": "A String", # End date of this inventory item.
+      "pricingType": "A String", # Pricing type of this inventory item.
+      "flights": [ # Flights of this inventory item. A flight (a.k.a. pricing period) represents the inventory item pricing information for a specific period of time.
+        { # Flight
+          "rateOrCost": "A String", # Rate or cost of this flight.
+          "startDate": "A String", # Inventory item flight start date.
+          "units": "A String", # Units of this flight.
+          "endDate": "A String", # Inventory item flight end date.
+        },
+      ],
+      "capCostType": "A String", # Cap cost type of this inventory item.
+    },
+    "kind": "dfareporting#inventoryItem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#inventoryItem".
+    "negotiationChannelId": "A String", # Negotiation channel ID of this inventory item.
+    "subaccountId": "A String", # Subaccount ID of this inventory item.
+    "name": "A String", # Name of this inventory item. For standalone inventory items, this is the same name as that of its only ad slot. For group inventory items, this can differ from the name of any of its ad slots.
+    "estimatedClickThroughRate": "A String", # Estimated click-through rate of this inventory item.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this inventory item.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "estimatedConversionRate": "A String", # Estimated conversion rate of this inventory item.
+    "inPlan": True or False, # Whether this inventory item is in plan.
+    "id": "A String", # ID of this inventory item.
+    "advertiserId": "A String", # Advertiser ID of this inventory item.
+    "siteId": "A String", # ID of the site this inventory item is associated with.
+    "adSlots": [ # Ad slots of this inventory item. If this inventory item represents a standalone placement, there will be exactly one ad slot. If this inventory item represents a placement group, there will be more than one ad slot, each representing one child placement in that placement group.
+      { # Ad Slot
+        "comment": "A String", # Comment for this ad slot.
+        "linkedPlacementId": "A String", # ID of the placement from an external platform that is linked to this ad slot.
+        "name": "A String", # Name of this ad slot.
+        "primary": True or False, # Primary ad slot of a roadblock inventory item.
+        "height": "A String", # Height of this ad slot.
+        "width": "A String", # Width of this ad slot.
+        "paymentSourceType": "A String", # Payment source type of this ad slot.
+        "compatibility": "A String", # Ad slot compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop, mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard.
+      },
+    ],
+    "projectId": "A String", # Project ID of this inventory item.
+    "rfpId": "A String", # RFP ID of this inventory item.
+    "type": "A String", # Type of inventory item.
+    "contentCategoryId": "A String", # Content category ID of this inventory item.
+    "placementStrategyId": "A String", # Placement strategy ID of this inventory item.
+    "accountId": "A String", # Account ID of this inventory item.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, projectId, pageToken=None, inPlan=None, sortOrder=None, type=None, orderId=None, maxResults=None, siteId=None, sortField=None, ids=None)</code>
+  <pre>Retrieves a list of inventory items, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  projectId: string, Project ID for order documents. (required)
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  inPlan: boolean, Select only inventory items that are in plan.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  type: string, Select only inventory items with this type.
+    Allowed values
+      PLANNING_PLACEMENT_TYPE_CREDIT - 
+      PLANNING_PLACEMENT_TYPE_REGULAR - 
+  orderId: string, Select only inventory items that belong to specified orders. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  siteId: string, Select only inventory items that are associated with these sites. (repeated)
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only inventory items with these IDs. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Inventory item List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#inventoryItemsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#inventoryItemsListResponse".
+    "inventoryItems": [ # Inventory item collection
+      { # Represents a buy from the DoubleClick Planning inventory store.
+        "orderId": "A String", # Order ID of this inventory item.
+        "pricing": { # Pricing Information # Pricing of this inventory item.
+          "groupType": "A String", # Group type of this inventory item if it represents a placement group. Is null otherwise. There are two type of placement groups: PLANNING_PLACEMENT_GROUP_TYPE_PACKAGE is a simple group of inventory items that acts as a single pricing point for a group of tags. PLANNING_PLACEMENT_GROUP_TYPE_ROADBLOCK is a group of inventory items that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned inventory items to be marked as primary.
+          "startDate": "A String", # Start date of this inventory item.
+          "endDate": "A String", # End date of this inventory item.
+          "pricingType": "A String", # Pricing type of this inventory item.
+          "flights": [ # Flights of this inventory item. A flight (a.k.a. pricing period) represents the inventory item pricing information for a specific period of time.
+            { # Flight
+              "rateOrCost": "A String", # Rate or cost of this flight.
+              "startDate": "A String", # Inventory item flight start date.
+              "units": "A String", # Units of this flight.
+              "endDate": "A String", # Inventory item flight end date.
+            },
+          ],
+          "capCostType": "A String", # Cap cost type of this inventory item.
+        },
+        "kind": "dfareporting#inventoryItem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#inventoryItem".
+        "negotiationChannelId": "A String", # Negotiation channel ID of this inventory item.
+        "subaccountId": "A String", # Subaccount ID of this inventory item.
+        "name": "A String", # Name of this inventory item. For standalone inventory items, this is the same name as that of its only ad slot. For group inventory items, this can differ from the name of any of its ad slots.
+        "estimatedClickThroughRate": "A String", # Estimated click-through rate of this inventory item.
+        "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this inventory item.
+          "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+        },
+        "estimatedConversionRate": "A String", # Estimated conversion rate of this inventory item.
+        "inPlan": True or False, # Whether this inventory item is in plan.
+        "id": "A String", # ID of this inventory item.
+        "advertiserId": "A String", # Advertiser ID of this inventory item.
+        "siteId": "A String", # ID of the site this inventory item is associated with.
+        "adSlots": [ # Ad slots of this inventory item. If this inventory item represents a standalone placement, there will be exactly one ad slot. If this inventory item represents a placement group, there will be more than one ad slot, each representing one child placement in that placement group.
+          { # Ad Slot
+            "comment": "A String", # Comment for this ad slot.
+            "linkedPlacementId": "A String", # ID of the placement from an external platform that is linked to this ad slot.
+            "name": "A String", # Name of this ad slot.
+            "primary": True or False, # Primary ad slot of a roadblock inventory item.
+            "height": "A String", # Height of this ad slot.
+            "width": "A String", # Width of this ad slot.
+            "paymentSourceType": "A String", # Payment source type of this ad slot.
+            "compatibility": "A String", # Ad slot compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop, mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard.
+          },
+        ],
+        "projectId": "A String", # Project ID of this inventory item.
+        "rfpId": "A String", # RFP ID of this inventory item.
+        "type": "A String", # Type of inventory item.
+        "contentCategoryId": "A String", # Content category ID of this inventory item.
+        "placementStrategyId": "A String", # Placement strategy ID of this inventory item.
+        "accountId": "A String", # Account ID of this inventory item.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.landingPages.html b/docs/dyn/dfareporting_v2_7.landingPages.html
new file mode 100644
index 00000000000..0d3e9a8368d
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.landingPages.html
@@ -0,0 +1,247 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.landingPages.html">landingPages</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, campaignId, id)</a></code></p>
+<p class="firstline">Deletes an existing campaign landing page.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, campaignId, id)</a></code></p>
+<p class="firstline">Gets one campaign landing page by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, campaignId, body)</a></code></p>
+<p class="firstline">Inserts a new landing page for the specified campaign.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, campaignId)</a></code></p>
+<p class="firstline">Retrieves the list of landing pages for the specified campaign.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, campaignId, id, body)</a></code></p>
+<p class="firstline">Updates an existing campaign landing page. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, campaignId, body)</a></code></p>
+<p class="firstline">Updates an existing campaign landing page.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, campaignId, id)</code>
+  <pre>Deletes an existing campaign landing page.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Landing page campaign ID. (required)
+  id: string, Landing page ID. (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, campaignId, id)</code>
+  <pre>Gets one campaign landing page by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Landing page campaign ID. (required)
+  id: string, Landing page ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about where a user's browser is taken after the user clicks an ad.
+      "default": True or False, # Whether or not this landing page will be assigned to any ads or creatives that do not have a landing page assigned explicitly. Only one default landing page is allowed per campaign.
+      "url": "A String", # URL of this landing page. This is a required field.
+      "kind": "dfareporting#landingPage", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPage".
+      "id": "A String", # ID of this landing page. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this landing page. This is a required field. It must be less than 256 characters long, and must be unique among landing pages of the same campaign.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, campaignId, body)</code>
+  <pre>Inserts a new landing page for the specified campaign.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Landing page campaign ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains information about where a user's browser is taken after the user clicks an ad.
+    "default": True or False, # Whether or not this landing page will be assigned to any ads or creatives that do not have a landing page assigned explicitly. Only one default landing page is allowed per campaign.
+    "url": "A String", # URL of this landing page. This is a required field.
+    "kind": "dfareporting#landingPage", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPage".
+    "id": "A String", # ID of this landing page. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this landing page. This is a required field. It must be less than 256 characters long, and must be unique among landing pages of the same campaign.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains information about where a user's browser is taken after the user clicks an ad.
+      "default": True or False, # Whether or not this landing page will be assigned to any ads or creatives that do not have a landing page assigned explicitly. Only one default landing page is allowed per campaign.
+      "url": "A String", # URL of this landing page. This is a required field.
+      "kind": "dfareporting#landingPage", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPage".
+      "id": "A String", # ID of this landing page. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this landing page. This is a required field. It must be less than 256 characters long, and must be unique among landing pages of the same campaign.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, campaignId)</code>
+  <pre>Retrieves the list of landing pages for the specified campaign.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Landing page campaign ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Landing Page List Response
+    "kind": "dfareporting#landingPagesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPagesListResponse".
+    "landingPages": [ # Landing page collection
+      { # Contains information about where a user's browser is taken after the user clicks an ad.
+          "default": True or False, # Whether or not this landing page will be assigned to any ads or creatives that do not have a landing page assigned explicitly. Only one default landing page is allowed per campaign.
+          "url": "A String", # URL of this landing page. This is a required field.
+          "kind": "dfareporting#landingPage", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPage".
+          "id": "A String", # ID of this landing page. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this landing page. This is a required field. It must be less than 256 characters long, and must be unique among landing pages of the same campaign.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, campaignId, id, body)</code>
+  <pre>Updates an existing campaign landing page. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Landing page campaign ID. (required)
+  id: string, Landing page ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains information about where a user's browser is taken after the user clicks an ad.
+    "default": True or False, # Whether or not this landing page will be assigned to any ads or creatives that do not have a landing page assigned explicitly. Only one default landing page is allowed per campaign.
+    "url": "A String", # URL of this landing page. This is a required field.
+    "kind": "dfareporting#landingPage", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPage".
+    "id": "A String", # ID of this landing page. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this landing page. This is a required field. It must be less than 256 characters long, and must be unique among landing pages of the same campaign.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains information about where a user's browser is taken after the user clicks an ad.
+      "default": True or False, # Whether or not this landing page will be assigned to any ads or creatives that do not have a landing page assigned explicitly. Only one default landing page is allowed per campaign.
+      "url": "A String", # URL of this landing page. This is a required field.
+      "kind": "dfareporting#landingPage", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPage".
+      "id": "A String", # ID of this landing page. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this landing page. This is a required field. It must be less than 256 characters long, and must be unique among landing pages of the same campaign.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, campaignId, body)</code>
+  <pre>Updates an existing campaign landing page.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Landing page campaign ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains information about where a user's browser is taken after the user clicks an ad.
+    "default": True or False, # Whether or not this landing page will be assigned to any ads or creatives that do not have a landing page assigned explicitly. Only one default landing page is allowed per campaign.
+    "url": "A String", # URL of this landing page. This is a required field.
+    "kind": "dfareporting#landingPage", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPage".
+    "id": "A String", # ID of this landing page. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this landing page. This is a required field. It must be less than 256 characters long, and must be unique among landing pages of the same campaign.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains information about where a user's browser is taken after the user clicks an ad.
+      "default": True or False, # Whether or not this landing page will be assigned to any ads or creatives that do not have a landing page assigned explicitly. Only one default landing page is allowed per campaign.
+      "url": "A String", # URL of this landing page. This is a required field.
+      "kind": "dfareporting#landingPage", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#landingPage".
+      "id": "A String", # ID of this landing page. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this landing page. This is a required field. It must be less than 256 characters long, and must be unique among landing pages of the same campaign.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.languages.html b/docs/dyn/dfareporting_v2_7.languages.html
new file mode 100644
index 00000000000..d0980758e2a
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.languages.html
@@ -0,0 +1,104 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.languages.html">languages</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of languages.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of languages.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Language List Response
+    "languages": [ # Language collection.
+      { # Contains information about a language that can be targeted by ads.
+        "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+        "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+        "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+        "name": "A String", # Name of this language.
+      },
+    ],
+    "kind": "dfareporting#languagesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#languagesListResponse".
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.metros.html b/docs/dyn/dfareporting_v2_7.metros.html
new file mode 100644
index 00000000000..81faa5b8988
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.metros.html
@@ -0,0 +1,107 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.metros.html">metros</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of metros.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of metros.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Metro List Response
+    "kind": "dfareporting#metrosListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metrosListResponse".
+    "metros": [ # Metro collection.
+      { # Contains information about a metro region that can be targeted by ads.
+        "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+        "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+        "name": "A String", # Name of this metro region.
+        "countryCode": "A String", # Country code of the country to which this metro region belongs.
+        "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+        "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+        "dartId": "A String", # DART ID of this metro region.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.mobileCarriers.html b/docs/dyn/dfareporting_v2_7.mobileCarriers.html
new file mode 100644
index 00000000000..48d3e8919c4
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.mobileCarriers.html
@@ -0,0 +1,128 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.mobileCarriers.html">mobileCarriers</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one mobile carrier by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of mobile carriers.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one mobile carrier by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Mobile carrier ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about a mobile carrier that can be targeted by ads.
+    "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+    "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+    "id": "A String", # ID of this mobile carrier.
+    "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+    "name": "A String", # Name of this mobile carrier.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of mobile carriers.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Mobile Carrier List Response
+    "kind": "dfareporting#mobileCarriersListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarriersListResponse".
+    "mobileCarriers": [ # Mobile carrier collection.
+      { # Contains information about a mobile carrier that can be targeted by ads.
+        "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+        "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+        "id": "A String", # ID of this mobile carrier.
+        "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+        "name": "A String", # Name of this mobile carrier.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.operatingSystemVersions.html b/docs/dyn/dfareporting_v2_7.operatingSystemVersions.html
new file mode 100644
index 00000000000..ae706e6febc
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.operatingSystemVersions.html
@@ -0,0 +1,142 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.operatingSystemVersions.html">operatingSystemVersions</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one operating system version by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of operating system versions.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one operating system version by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Operating system version ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about a particular version of an operating system that can be targeted by ads.
+    "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+    "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+    "name": "A String", # Name of this operating system version.
+    "id": "A String", # ID of this operating system version.
+    "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+      "mobile": True or False, # Whether this operating system is for mobile.
+      "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+      "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+      "name": "A String", # Name of this operating system.
+      "desktop": True or False, # Whether this operating system is for desktop.
+    },
+    "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of operating system versions.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Operating System Version List Response
+    "kind": "dfareporting#operatingSystemVersionsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersionsListResponse".
+    "operatingSystemVersions": [ # Operating system version collection.
+      { # Contains information about a particular version of an operating system that can be targeted by ads.
+        "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+        "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+        "name": "A String", # Name of this operating system version.
+        "id": "A String", # ID of this operating system version.
+        "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+          "mobile": True or False, # Whether this operating system is for mobile.
+          "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+          "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+          "name": "A String", # Name of this operating system.
+          "desktop": True or False, # Whether this operating system is for desktop.
+        },
+        "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.operatingSystems.html b/docs/dyn/dfareporting_v2_7.operatingSystems.html
new file mode 100644
index 00000000000..dda4f4918b6
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.operatingSystems.html
@@ -0,0 +1,128 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.operatingSystems.html">operatingSystems</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, dartId)</a></code></p>
+<p class="firstline">Gets one operating system by DART ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of operating systems.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, dartId)</code>
+  <pre>Gets one operating system by DART ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  dartId: string, Operating system DART ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about an operating system that can be targeted by ads.
+    "mobile": True or False, # Whether this operating system is for mobile.
+    "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+    "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+    "name": "A String", # Name of this operating system.
+    "desktop": True or False, # Whether this operating system is for desktop.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of operating systems.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Operating System List Response
+    "kind": "dfareporting#operatingSystemsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemsListResponse".
+    "operatingSystems": [ # Operating system collection.
+      { # Contains information about an operating system that can be targeted by ads.
+        "mobile": True or False, # Whether this operating system is for mobile.
+        "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+        "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+        "name": "A String", # Name of this operating system.
+        "desktop": True or False, # Whether this operating system is for desktop.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.orderDocuments.html b/docs/dyn/dfareporting_v2_7.orderDocuments.html
new file mode 100644
index 00000000000..4d250d17411
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.orderDocuments.html
@@ -0,0 +1,199 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.orderDocuments.html">orderDocuments</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, projectId, id)</a></code></p>
+<p class="firstline">Gets one order document by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</a></code></p>
+<p class="firstline">Retrieves a list of order documents, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, projectId, id)</code>
+  <pre>Gets one order document by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  projectId: string, Project ID for order documents. (required)
+  id: string, Order document ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DoubleClick Planning order document.
+    "orderId": "A String", # ID of the order from which this order document is created.
+    "approvedByUserProfileIds": [ # IDs of users who have approved this order document.
+      "A String",
+    ],
+    "kind": "dfareporting#orderDocument", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#orderDocument".
+    "subaccountId": "A String", # Subaccount ID of this order document.
+    "effectiveDate": "A String", # Effective date of this order document.
+    "lastSentTime": "A String", # Timestamp of the last email sent with this order document.
+    "lastSentRecipients": [ # List of email addresses that received the last sent document.
+      "A String",
+    ],
+    "title": "A String", # Title of this order document.
+    "amendedOrderDocumentId": "A String", # The amended order document ID of this order document. An order document can be created by optionally amending another order document so that the change history can be preserved.
+    "signed": True or False, # Whether this order document has been signed.
+    "createdInfo": { # Modification timestamp. # Information about the creation of this order document.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "advertiserId": "A String", # Advertiser ID of this order document.
+    "projectId": "A String", # Project ID of this order document.
+    "cancelled": True or False, # Whether this order document is cancelled.
+    "type": "A String", # Type of this order document
+    "id": "A String", # ID of this order document.
+    "accountId": "A String", # Account ID of this order document.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</code>
+  <pre>Retrieves a list of order documents, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  projectId: string, Project ID for order documents. (required)
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  orderId: string, Select only order documents for specified orders. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  siteId: string, Select only order documents that are associated with these sites. (repeated)
+  approved: boolean, Select only order documents that have been approved by at least one user.
+  searchString: string, Allows searching for order documents by name or ID. Wildcards (*) are allowed. For example, "orderdocument*2015" will return order documents with names like "orderdocument June 2015", "orderdocument April 2015", or simply "orderdocument 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "orderdocument" will match order documents with name "my orderdocument", "orderdocument 2015", or simply "orderdocument".
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only order documents with these IDs. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Order document List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#orderDocumentsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#orderDocumentsListResponse".
+    "orderDocuments": [ # Order document collection
+      { # Contains properties of a DoubleClick Planning order document.
+        "orderId": "A String", # ID of the order from which this order document is created.
+        "approvedByUserProfileIds": [ # IDs of users who have approved this order document.
+          "A String",
+        ],
+        "kind": "dfareporting#orderDocument", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#orderDocument".
+        "subaccountId": "A String", # Subaccount ID of this order document.
+        "effectiveDate": "A String", # Effective date of this order document.
+        "lastSentTime": "A String", # Timestamp of the last email sent with this order document.
+        "lastSentRecipients": [ # List of email addresses that received the last sent document.
+          "A String",
+        ],
+        "title": "A String", # Title of this order document.
+        "amendedOrderDocumentId": "A String", # The amended order document ID of this order document. An order document can be created by optionally amending another order document so that the change history can be preserved.
+        "signed": True or False, # Whether this order document has been signed.
+        "createdInfo": { # Modification timestamp. # Information about the creation of this order document.
+          "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+        },
+        "advertiserId": "A String", # Advertiser ID of this order document.
+        "projectId": "A String", # Project ID of this order document.
+        "cancelled": True or False, # Whether this order document is cancelled.
+        "type": "A String", # Type of this order document
+        "id": "A String", # ID of this order document.
+        "accountId": "A String", # Account ID of this order document.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.orders.html b/docs/dyn/dfareporting_v2_7.orders.html
new file mode 100644
index 00000000000..d1c05f12344
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.orders.html
@@ -0,0 +1,223 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.orders.html">orders</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, projectId, id)</a></code></p>
+<p class="firstline">Gets one order by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, projectId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None, siteId=None)</a></code></p>
+<p class="firstline">Retrieves a list of orders, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, projectId, id)</code>
+  <pre>Gets one order by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  projectId: string, Project ID for orders. (required)
+  id: string, Order ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Describes properties of a DoubleClick Planning order.
+    "termsAndConditions": "A String", # Terms and conditions of this order.
+    "kind": "dfareporting#order", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#order".
+    "sellerOrganizationName": "A String", # Name of the seller organization.
+    "subaccountId": "A String", # Subaccount ID of this order.
+    "name": "A String", # Name of this order.
+    "buyerInvoiceId": "A String", # Buyer invoice ID associated with this order.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this order.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "notes": "A String", # Notes of this order.
+    "contacts": [ # Contacts for this order.
+      { # Contact of an order.
+        "signatureUserProfileId": "A String", # ID of the user profile containing the signature that will be embedded into order documents.
+        "contactTitle": "A String", # Title of this contact.
+        "contactInfo": "A String", # Free-form information about this contact. It could be any information related to this contact in addition to type, title, name, and signature user profile ID.
+        "contactName": "A String", # Name of this contact.
+        "contactType": "A String", # Type of this contact.
+      },
+    ],
+    "buyerOrganizationName": "A String", # Name of the buyer organization.
+    "comments": "A String", # Comments in this order.
+    "advertiserId": "A String", # Advertiser ID of this order.
+    "approverUserProfileIds": [ # IDs for users that have to approve documents created for this order.
+      "A String",
+    ],
+    "siteId": [ # Site IDs this order is associated with.
+      "A String",
+    ],
+    "sellerOrderId": "A String", # Seller order ID associated with this order.
+    "projectId": "A String", # Project ID of this order.
+    "siteNames": [ # Free-form site names this order is associated with.
+      "A String",
+    ],
+    "planningTermId": "A String", # ID of the terms and conditions template used in this order.
+    "id": "A String", # ID of this order. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this order.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, projectId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None, siteId=None)</code>
+  <pre>Retrieves a list of orders, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  projectId: string, Project ID for orders. (required)
+  searchString: string, Allows searching for orders by name or ID. Wildcards (*) are allowed. For example, "order*2015" will return orders with names like "order June 2015", "order April 2015", or simply "order 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "order" will match orders with name "my order", "order 2015", or simply "order".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only orders with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  siteId: string, Select only orders that are associated with these site IDs. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Order List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#ordersListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#ordersListResponse".
+    "orders": [ # Order collection.
+      { # Describes properties of a DoubleClick Planning order.
+        "termsAndConditions": "A String", # Terms and conditions of this order.
+        "kind": "dfareporting#order", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#order".
+        "sellerOrganizationName": "A String", # Name of the seller organization.
+        "subaccountId": "A String", # Subaccount ID of this order.
+        "name": "A String", # Name of this order.
+        "buyerInvoiceId": "A String", # Buyer invoice ID associated with this order.
+        "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this order.
+          "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+        },
+        "notes": "A String", # Notes of this order.
+        "contacts": [ # Contacts for this order.
+          { # Contact of an order.
+            "signatureUserProfileId": "A String", # ID of the user profile containing the signature that will be embedded into order documents.
+            "contactTitle": "A String", # Title of this contact.
+            "contactInfo": "A String", # Free-form information about this contact. It could be any information related to this contact in addition to type, title, name, and signature user profile ID.
+            "contactName": "A String", # Name of this contact.
+            "contactType": "A String", # Type of this contact.
+          },
+        ],
+        "buyerOrganizationName": "A String", # Name of the buyer organization.
+        "comments": "A String", # Comments in this order.
+        "advertiserId": "A String", # Advertiser ID of this order.
+        "approverUserProfileIds": [ # IDs for users that have to approve documents created for this order.
+          "A String",
+        ],
+        "siteId": [ # Site IDs this order is associated with.
+          "A String",
+        ],
+        "sellerOrderId": "A String", # Seller order ID associated with this order.
+        "projectId": "A String", # Project ID of this order.
+        "siteNames": [ # Free-form site names this order is associated with.
+          "A String",
+        ],
+        "planningTermId": "A String", # ID of the terms and conditions template used in this order.
+        "id": "A String", # ID of this order. This is a read-only, auto-generated field.
+        "accountId": "A String", # Account ID of this order.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.placementGroups.html b/docs/dyn/dfareporting_v2_7.placementGroups.html
new file mode 100644
index 00000000000..162a205a8f0
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.placementGroups.html
@@ -0,0 +1,977 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.placementGroups.html">placementGroups</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one placement group by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new placement group.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, siteIds=None, placementGroupType=None, pricingTypes=None, campaignIds=None, advertiserIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, searchString=None, minEndDate=None, directorySiteIds=None, ids=None, sortField=None)</a></code></p>
+<p class="firstline">Retrieves a list of placement groups, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing placement group. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing placement group.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one placement group by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Placement group ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a package or roadblock.
+      "comment": "A String", # Comments for this placement group.
+      "primaryPlacementId": "A String", # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
+      "campaignId": "A String", # Campaign ID of this placement group. This field is required on insertion.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserId": "A String", # Advertiser ID of this placement group. This is a required field on insertion.
+      "directorySiteId": "A String", # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+      "placementGroupType": "A String", # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this placement group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this placement group. This is a read-only field that can be left blank.
+      "archived": True or False, # Whether this placement group is archived.
+      "childPlacementIds": [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
+        "A String",
+      ],
+      "contentCategoryId": "A String", # ID of the content category assigned to this placement group.
+      "externalId": "A String", # External ID for this placement.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "primaryPlacementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "createInfo": { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "siteId": "A String", # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+      "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement group.
+      "kind": "dfareporting#placementGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroup".
+      "subaccountId": "A String", # Subaccount ID of this placement group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this placement group. This is a required field and must be less than 256 characters long.
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
+        "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+        "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+        "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+        "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+        "capCostOption": "A String", # Placement cap cost option.
+        "pricingPeriods": [ # Pricing periods for this placement.
+          { # Pricing Period
+            "units": "A String", # Units of this pricing period.
+            "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+            "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+            "pricingComment": "A String", # Comments for this pricing period.
+          },
+        ],
+        "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+        "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+      },
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new placement group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a package or roadblock.
+    "comment": "A String", # Comments for this placement group.
+    "primaryPlacementId": "A String", # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
+    "campaignId": "A String", # Campaign ID of this placement group. This field is required on insertion.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserId": "A String", # Advertiser ID of this placement group. This is a required field on insertion.
+    "directorySiteId": "A String", # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+    "placementGroupType": "A String", # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this placement group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this placement group. This is a read-only field that can be left blank.
+    "archived": True or False, # Whether this placement group is archived.
+    "childPlacementIds": [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
+      "A String",
+    ],
+    "contentCategoryId": "A String", # ID of the content category assigned to this placement group.
+    "externalId": "A String", # External ID for this placement.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "primaryPlacementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "createInfo": { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "siteId": "A String", # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+    "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement group.
+    "kind": "dfareporting#placementGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroup".
+    "subaccountId": "A String", # Subaccount ID of this placement group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this placement group. This is a required field and must be less than 256 characters long.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
+      "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+      "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+      "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+      "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+      "capCostOption": "A String", # Placement cap cost option.
+      "pricingPeriods": [ # Pricing periods for this placement.
+        { # Pricing Period
+          "units": "A String", # Units of this pricing period.
+          "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+          "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+          "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+          "pricingComment": "A String", # Comments for this pricing period.
+        },
+      ],
+      "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+      "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+    },
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a package or roadblock.
+      "comment": "A String", # Comments for this placement group.
+      "primaryPlacementId": "A String", # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
+      "campaignId": "A String", # Campaign ID of this placement group. This field is required on insertion.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserId": "A String", # Advertiser ID of this placement group. This is a required field on insertion.
+      "directorySiteId": "A String", # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+      "placementGroupType": "A String", # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this placement group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this placement group. This is a read-only field that can be left blank.
+      "archived": True or False, # Whether this placement group is archived.
+      "childPlacementIds": [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
+        "A String",
+      ],
+      "contentCategoryId": "A String", # ID of the content category assigned to this placement group.
+      "externalId": "A String", # External ID for this placement.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "primaryPlacementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "createInfo": { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "siteId": "A String", # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+      "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement group.
+      "kind": "dfareporting#placementGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroup".
+      "subaccountId": "A String", # Subaccount ID of this placement group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this placement group. This is a required field and must be less than 256 characters long.
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
+        "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+        "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+        "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+        "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+        "capCostOption": "A String", # Placement cap cost option.
+        "pricingPeriods": [ # Pricing periods for this placement.
+          { # Pricing Period
+            "units": "A String", # Units of this pricing period.
+            "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+            "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+            "pricingComment": "A String", # Comments for this pricing period.
+          },
+        ],
+        "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+        "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+      },
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, siteIds=None, placementGroupType=None, pricingTypes=None, campaignIds=None, advertiserIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, searchString=None, minEndDate=None, directorySiteIds=None, ids=None, sortField=None)</code>
+  <pre>Retrieves a list of placement groups, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  siteIds: string, Select only placement groups that are associated with these sites. (repeated)
+  placementGroupType: string, Select only placement groups belonging with this group type. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting.
+    Allowed values
+      PLACEMENT_PACKAGE - 
+      PLACEMENT_ROADBLOCK - 
+  pricingTypes: string, Select only placement groups with these pricing types. (repeated)
+    Allowed values
+      PRICING_TYPE_CPA - 
+      PRICING_TYPE_CPC - 
+      PRICING_TYPE_CPM - 
+      PRICING_TYPE_CPM_ACTIVEVIEW - 
+      PRICING_TYPE_FLAT_RATE_CLICKS - 
+      PRICING_TYPE_FLAT_RATE_IMPRESSIONS - 
+  campaignIds: string, Select only placement groups that belong to these campaigns. (repeated)
+  advertiserIds: string, Select only placement groups that belong to these advertisers. (repeated)
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  maxStartDate: string, Select only placements or placement groups whose start date is on or before the specified maxStartDate. The date should be formatted as "yyyy-MM-dd".
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  maxEndDate: string, Select only placements or placement groups whose end date is on or before the specified maxEndDate. The date should be formatted as "yyyy-MM-dd".
+  placementStrategyIds: string, Select only placement groups that are associated with these placement strategies. (repeated)
+  contentCategoryIds: string, Select only placement groups that are associated with these content categories. (repeated)
+  archived: boolean, Select only archived placements. Don't set this field to select both archived and non-archived placements.
+  maxResults: integer, Maximum number of results to return.
+  minStartDate: string, Select only placements or placement groups whose start date is on or after the specified minStartDate. The date should be formatted as "yyyy-MM-dd".
+  searchString: string, Allows searching for placement groups by name or ID. Wildcards (*) are allowed. For example, "placement*2015" will return placement groups with names like "placement group June 2015", "placement group May 2015", or simply "placements 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "placementgroup" will match placement groups with name "my placementgroup", "placementgroup 2015", or simply "placementgroup".
+  minEndDate: string, Select only placements or placement groups whose end date is on or after the specified minEndDate. The date should be formatted as "yyyy-MM-dd".
+  directorySiteIds: string, Select only placement groups that are associated with these directory sites. (repeated)
+  ids: string, Select only placement groups with these IDs. (repeated)
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+
+Returns:
+  An object of the form:
+
+    { # Placement Group List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#placementGroupsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroupsListResponse".
+    "placementGroups": [ # Placement group collection.
+      { # Contains properties of a package or roadblock.
+          "comment": "A String", # Comments for this placement group.
+          "primaryPlacementId": "A String", # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
+          "campaignId": "A String", # Campaign ID of this placement group. This field is required on insertion.
+          "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "advertiserId": "A String", # Advertiser ID of this placement group. This is a required field on insertion.
+          "directorySiteId": "A String", # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+          "placementGroupType": "A String", # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "id": "A String", # ID of this placement group. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this placement group. This is a read-only field that can be left blank.
+          "archived": True or False, # Whether this placement group is archived.
+          "childPlacementIds": [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
+            "A String",
+          ],
+          "contentCategoryId": "A String", # ID of the content category assigned to this placement group.
+          "externalId": "A String", # External ID for this placement.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "primaryPlacementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "createInfo": { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "siteId": "A String", # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+          "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement group.
+          "kind": "dfareporting#placementGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroup".
+          "subaccountId": "A String", # Subaccount ID of this placement group. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this placement group. This is a required field and must be less than 256 characters long.
+          "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
+            "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+            "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+            "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+            "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+            "capCostOption": "A String", # Placement cap cost option.
+            "pricingPeriods": [ # Pricing periods for this placement.
+              { # Pricing Period
+                "units": "A String", # Units of this pricing period.
+                "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+                "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+                "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+                "pricingComment": "A String", # Comments for this pricing period.
+              },
+            ],
+            "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+            "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+          },
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing placement group. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Placement group ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a package or roadblock.
+    "comment": "A String", # Comments for this placement group.
+    "primaryPlacementId": "A String", # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
+    "campaignId": "A String", # Campaign ID of this placement group. This field is required on insertion.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserId": "A String", # Advertiser ID of this placement group. This is a required field on insertion.
+    "directorySiteId": "A String", # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+    "placementGroupType": "A String", # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this placement group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this placement group. This is a read-only field that can be left blank.
+    "archived": True or False, # Whether this placement group is archived.
+    "childPlacementIds": [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
+      "A String",
+    ],
+    "contentCategoryId": "A String", # ID of the content category assigned to this placement group.
+    "externalId": "A String", # External ID for this placement.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "primaryPlacementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "createInfo": { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "siteId": "A String", # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+    "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement group.
+    "kind": "dfareporting#placementGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroup".
+    "subaccountId": "A String", # Subaccount ID of this placement group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this placement group. This is a required field and must be less than 256 characters long.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
+      "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+      "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+      "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+      "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+      "capCostOption": "A String", # Placement cap cost option.
+      "pricingPeriods": [ # Pricing periods for this placement.
+        { # Pricing Period
+          "units": "A String", # Units of this pricing period.
+          "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+          "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+          "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+          "pricingComment": "A String", # Comments for this pricing period.
+        },
+      ],
+      "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+      "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+    },
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a package or roadblock.
+      "comment": "A String", # Comments for this placement group.
+      "primaryPlacementId": "A String", # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
+      "campaignId": "A String", # Campaign ID of this placement group. This field is required on insertion.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserId": "A String", # Advertiser ID of this placement group. This is a required field on insertion.
+      "directorySiteId": "A String", # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+      "placementGroupType": "A String", # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this placement group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this placement group. This is a read-only field that can be left blank.
+      "archived": True or False, # Whether this placement group is archived.
+      "childPlacementIds": [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
+        "A String",
+      ],
+      "contentCategoryId": "A String", # ID of the content category assigned to this placement group.
+      "externalId": "A String", # External ID for this placement.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "primaryPlacementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "createInfo": { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "siteId": "A String", # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+      "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement group.
+      "kind": "dfareporting#placementGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroup".
+      "subaccountId": "A String", # Subaccount ID of this placement group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this placement group. This is a required field and must be less than 256 characters long.
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
+        "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+        "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+        "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+        "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+        "capCostOption": "A String", # Placement cap cost option.
+        "pricingPeriods": [ # Pricing periods for this placement.
+          { # Pricing Period
+            "units": "A String", # Units of this pricing period.
+            "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+            "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+            "pricingComment": "A String", # Comments for this pricing period.
+          },
+        ],
+        "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+        "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+      },
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing placement group.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a package or roadblock.
+    "comment": "A String", # Comments for this placement group.
+    "primaryPlacementId": "A String", # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
+    "campaignId": "A String", # Campaign ID of this placement group. This field is required on insertion.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserId": "A String", # Advertiser ID of this placement group. This is a required field on insertion.
+    "directorySiteId": "A String", # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+    "placementGroupType": "A String", # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this placement group. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this placement group. This is a read-only field that can be left blank.
+    "archived": True or False, # Whether this placement group is archived.
+    "childPlacementIds": [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
+      "A String",
+    ],
+    "contentCategoryId": "A String", # ID of the content category assigned to this placement group.
+    "externalId": "A String", # External ID for this placement.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "primaryPlacementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "createInfo": { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "siteId": "A String", # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+    "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement group.
+    "kind": "dfareporting#placementGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroup".
+    "subaccountId": "A String", # Subaccount ID of this placement group. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this placement group. This is a required field and must be less than 256 characters long.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
+      "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+      "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+      "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+      "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+      "capCostOption": "A String", # Placement cap cost option.
+      "pricingPeriods": [ # Pricing periods for this placement.
+        { # Pricing Period
+          "units": "A String", # Units of this pricing period.
+          "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+          "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+          "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+          "pricingComment": "A String", # Comments for this pricing period.
+        },
+      ],
+      "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+      "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+    },
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a package or roadblock.
+      "comment": "A String", # Comments for this placement group.
+      "primaryPlacementId": "A String", # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
+      "campaignId": "A String", # Campaign ID of this placement group. This field is required on insertion.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserId": "A String", # Advertiser ID of this placement group. This is a required field on insertion.
+      "directorySiteId": "A String", # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+      "placementGroupType": "A String", # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this placement group. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this placement group. This is a read-only field that can be left blank.
+      "archived": True or False, # Whether this placement group is archived.
+      "childPlacementIds": [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
+        "A String",
+      ],
+      "contentCategoryId": "A String", # ID of the content category assigned to this placement group.
+      "externalId": "A String", # External ID for this placement.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "primaryPlacementIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "createInfo": { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "siteId": "A String", # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
+      "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement group.
+      "kind": "dfareporting#placementGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementGroup".
+      "subaccountId": "A String", # Subaccount ID of this placement group. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this placement group. This is a required field and must be less than 256 characters long.
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
+        "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+        "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+        "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+        "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+        "capCostOption": "A String", # Placement cap cost option.
+        "pricingPeriods": [ # Pricing periods for this placement.
+          { # Pricing Period
+            "units": "A String", # Units of this pricing period.
+            "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+            "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+            "pricingComment": "A String", # Comments for this pricing period.
+          },
+        ],
+        "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+        "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+      },
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.placementStrategies.html b/docs/dyn/dfareporting_v2_7.placementStrategies.html
new file mode 100644
index 00000000000..011f8abe95a
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.placementStrategies.html
@@ -0,0 +1,263 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.placementStrategies.html">placementStrategies</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, id)</a></code></p>
+<p class="firstline">Deletes an existing placement strategy.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one placement strategy by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new placement strategy.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of placement strategies, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing placement strategy. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing placement strategy.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, id)</code>
+  <pre>Deletes an existing placement strategy.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Placement strategy ID. (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one placement strategy by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Placement strategy ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a placement strategy.
+      "kind": "dfareporting#placementStrategy", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategy".
+      "id": "A String", # ID of this placement strategy. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.
+      "accountId": "A String", # Account ID of this placement strategy.This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new placement strategy.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a placement strategy.
+    "kind": "dfareporting#placementStrategy", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategy".
+    "id": "A String", # ID of this placement strategy. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.
+    "accountId": "A String", # Account ID of this placement strategy.This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a placement strategy.
+      "kind": "dfareporting#placementStrategy", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategy".
+      "id": "A String", # ID of this placement strategy. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.
+      "accountId": "A String", # Account ID of this placement strategy.This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
+  <pre>Retrieves a list of placement strategies, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "placementstrategy*2015" will return objects with names like "placementstrategy June 2015", "placementstrategy April 2015", or simply "placementstrategy 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "placementstrategy" will match objects with name "my placementstrategy", "placementstrategy 2015", or simply "placementstrategy".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only placement strategies with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Placement Strategy List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#placementStrategiesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategiesListResponse".
+    "placementStrategies": [ # Placement strategy collection.
+      { # Contains properties of a placement strategy.
+          "kind": "dfareporting#placementStrategy", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategy".
+          "id": "A String", # ID of this placement strategy. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.
+          "accountId": "A String", # Account ID of this placement strategy.This is a read-only field that can be left blank.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing placement strategy. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Placement strategy ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a placement strategy.
+    "kind": "dfareporting#placementStrategy", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategy".
+    "id": "A String", # ID of this placement strategy. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.
+    "accountId": "A String", # Account ID of this placement strategy.This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a placement strategy.
+      "kind": "dfareporting#placementStrategy", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategy".
+      "id": "A String", # ID of this placement strategy. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.
+      "accountId": "A String", # Account ID of this placement strategy.This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing placement strategy.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a placement strategy.
+    "kind": "dfareporting#placementStrategy", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategy".
+    "id": "A String", # ID of this placement strategy. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.
+    "accountId": "A String", # Account ID of this placement strategy.This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a placement strategy.
+      "kind": "dfareporting#placementStrategy", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementStrategy".
+      "id": "A String", # ID of this placement strategy. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.
+      "accountId": "A String", # Account ID of this placement strategy.This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.placements.html b/docs/dyn/dfareporting_v2_7.placements.html
new file mode 100644
index 00000000000..99dbcf39ae1
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.placements.html
@@ -0,0 +1,1656 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.placements.html">placements</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#generatetags">generatetags(profileId, campaignId=None, tagFormats=None, placementIds=None)</a></code></p>
+<p class="firstline">Generates tags for a placement.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one placement by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new placement.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, siteIds=None, paymentSource=None, pricingTypes=None, campaignIds=None, advertiserIds=None, sizeIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, compatibilities=None, searchString=None, minEndDate=None, directorySiteIds=None, sortField=None, ids=None, groupIds=None)</a></code></p>
+<p class="firstline">Retrieves a list of placements, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing placement. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing placement.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="generatetags">generatetags(profileId, campaignId=None, tagFormats=None, placementIds=None)</code>
+  <pre>Generates tags for a placement.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  campaignId: string, Generate placements belonging to this campaign. This is a required field.
+  tagFormats: string, Tag formats to generate for these placements. (repeated)
+    Allowed values
+      PLACEMENT_TAG_CLICK_COMMANDS - 
+      PLACEMENT_TAG_IFRAME_ILAYER - 
+      PLACEMENT_TAG_IFRAME_JAVASCRIPT - 
+      PLACEMENT_TAG_IFRAME_JAVASCRIPT_LEGACY - 
+      PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH - 
+      PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_3 - 
+      PLACEMENT_TAG_INTERNAL_REDIRECT - 
+      PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT - 
+      PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT_LEGACY - 
+      PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT - 
+      PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT - 
+      PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT_LEGACY - 
+      PLACEMENT_TAG_JAVASCRIPT - 
+      PLACEMENT_TAG_JAVASCRIPT_LEGACY - 
+      PLACEMENT_TAG_STANDARD - 
+      PLACEMENT_TAG_TRACKING - 
+      PLACEMENT_TAG_TRACKING_IFRAME - 
+      PLACEMENT_TAG_TRACKING_JAVASCRIPT - 
+  placementIds: string, Generate tags for these placements. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Placement GenerateTags Response
+    "kind": "dfareporting#placementsGenerateTagsResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementsGenerateTagsResponse".
+    "placementTags": [ # Set of generated tags for the specified placements.
+      { # Placement Tag
+        "tagDatas": [ # Tags generated for this placement.
+          { # Placement Tag Data
+            "clickTag": "A String", # Tag string to record a click.
+            "impressionTag": "A String", # Tag string for serving an ad.
+            "creativeId": "A String", # Creative associated with this placement tag.
+            "adId": "A String", # Ad associated with this placement tag.
+            "format": "A String", # TagData tag format of this tag.
+          },
+        ],
+        "placementId": "A String", # Placement ID
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one placement by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Placement ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a placement.
+      "comment": "A String", # Comments for this placement.
+      "videoActiveViewOptOut": True or False, # Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.
+      "campaignId": "A String", # Campaign ID of this placement. This field is a required field on insertion.
+      "paymentSource": "A String", # Payment source for this placement. This is a required field that is read-only after insertion.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserId": "A String", # Advertiser ID of this placement. This field can be left blank.
+      "keyName": "A String", # Key name of this placement. This is a read-only, auto-generated field.
+      "directorySiteId": "A String", # Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this placement. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this placement. This field can be left blank.
+      "archived": True or False, # Whether this placement is archived.
+      "videoSettings": { # Video Settings # A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.
+        "skippableSettings": { # Skippable Settings # Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.
+          "skippable": True or False, # Whether the user can skip creatives served to this placement.
+          "kind": "dfareporting#skippableSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#skippableSetting".
+          "skipOffset": { # Video Offset # Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+          "progressOffset": { # Video Offset # Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+        },
+        "kind": "dfareporting#videoSettings", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoSettings".
+        "companionSettings": { # Companion Settings # Settings for the companion creatives of video creatives served to this placement.
+          "kind": "dfareporting#companionSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#companionSetting".
+          "companionsDisabled": True or False, # Whether companions are disabled for this placement.
+          "imageOnly": True or False, # Whether to serve only static images as companions.
+          "enabledSizes": [ # Whitelist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes.
+            { # Represents the dimensions of ads, placements, creatives, or creative assets.
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          ],
+        },
+        "transcodeSettings": { # Transcode Settings # Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.
+          "kind": "dfareporting#transcodeSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#transcodeSetting".
+          "enabledVideoFormats": [ # Whitelist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.
+            42,
+          ],
+        },
+      },
+      "publisherUpdateInfo": { # Modification timestamp. # Information about the last publisher update. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "tagFormats": [ # Tag formats to generate for this placement. This field is required on insertion.
+          # Acceptable values are:
+          # - "PLACEMENT_TAG_STANDARD"
+          # - "PLACEMENT_TAG_IFRAME_JAVASCRIPT"
+          # - "PLACEMENT_TAG_IFRAME_ILAYER"
+          # - "PLACEMENT_TAG_INTERNAL_REDIRECT"
+          # - "PLACEMENT_TAG_JAVASCRIPT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT"
+          # - "PLACEMENT_TAG_CLICK_COMMANDS"
+          # - "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH"
+          # - "PLACEMENT_TAG_TRACKING"
+          # - "PLACEMENT_TAG_TRACKING_IFRAME"
+          # - "PLACEMENT_TAG_TRACKING_JAVASCRIPT"
+        "A String",
+      ],
+      "paymentApproved": True or False, # Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.
+      "tagSetting": { # Tag Settings # Tag settings for this placement.
+        "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+        "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+        "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+        "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+      },
+      "contentCategoryId": "A String", # ID of the content category assigned to this placement.
+      "externalId": "A String", # External ID for this placement.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "sslRequired": True or False, # Whether creatives assigned to this placement must be SSL-compliant.
+      "status": "A String", # Third-party placement status.
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "primary": True or False, # Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement.
+      "placementGroupId": "A String", # ID of this placement's group, if applicable.
+      "createInfo": { # Modification timestamp. # Information about the creation of this placement. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "siteId": "A String", # Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+      "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "compatibility": "A String", # Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.
+      "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement.
+      "placementGroupIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "kind": "dfareporting#placement", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placement".
+      "subaccountId": "A String", # Subaccount ID of this placement. This field can be left blank.
+      "name": "A String", # Name of this placement.This is a required field and must be less than 256 characters long.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this placement.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType.
+        "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+        "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+        "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+        "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+        "capCostOption": "A String", # Placement cap cost option.
+        "pricingPeriods": [ # Pricing periods for this placement.
+          { # Pricing Period
+            "units": "A String", # Units of this pricing period.
+            "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+            "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+            "pricingComment": "A String", # Comments for this pricing period.
+          },
+        ],
+        "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+        "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+      },
+      "vpaidAdapterChoice": "A String", # VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new placement.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a placement.
+    "comment": "A String", # Comments for this placement.
+    "videoActiveViewOptOut": True or False, # Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.
+    "campaignId": "A String", # Campaign ID of this placement. This field is a required field on insertion.
+    "paymentSource": "A String", # Payment source for this placement. This is a required field that is read-only after insertion.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserId": "A String", # Advertiser ID of this placement. This field can be left blank.
+    "keyName": "A String", # Key name of this placement. This is a read-only, auto-generated field.
+    "directorySiteId": "A String", # Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this placement. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this placement. This field can be left blank.
+    "archived": True or False, # Whether this placement is archived.
+    "videoSettings": { # Video Settings # A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.
+      "skippableSettings": { # Skippable Settings # Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.
+        "skippable": True or False, # Whether the user can skip creatives served to this placement.
+        "kind": "dfareporting#skippableSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#skippableSetting".
+        "skipOffset": { # Video Offset # Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.
+          "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+          "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+        },
+        "progressOffset": { # Video Offset # Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true.
+          "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+          "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+        },
+      },
+      "kind": "dfareporting#videoSettings", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoSettings".
+      "companionSettings": { # Companion Settings # Settings for the companion creatives of video creatives served to this placement.
+        "kind": "dfareporting#companionSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#companionSetting".
+        "companionsDisabled": True or False, # Whether companions are disabled for this placement.
+        "imageOnly": True or False, # Whether to serve only static images as companions.
+        "enabledSizes": [ # Whitelist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes.
+          { # Represents the dimensions of ads, placements, creatives, or creative assets.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        ],
+      },
+      "transcodeSettings": { # Transcode Settings # Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.
+        "kind": "dfareporting#transcodeSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#transcodeSetting".
+        "enabledVideoFormats": [ # Whitelist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.
+          42,
+        ],
+      },
+    },
+    "publisherUpdateInfo": { # Modification timestamp. # Information about the last publisher update. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "tagFormats": [ # Tag formats to generate for this placement. This field is required on insertion.
+        # Acceptable values are:
+        # - "PLACEMENT_TAG_STANDARD"
+        # - "PLACEMENT_TAG_IFRAME_JAVASCRIPT"
+        # - "PLACEMENT_TAG_IFRAME_ILAYER"
+        # - "PLACEMENT_TAG_INTERNAL_REDIRECT"
+        # - "PLACEMENT_TAG_JAVASCRIPT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT"
+        # - "PLACEMENT_TAG_CLICK_COMMANDS"
+        # - "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH"
+        # - "PLACEMENT_TAG_TRACKING"
+        # - "PLACEMENT_TAG_TRACKING_IFRAME"
+        # - "PLACEMENT_TAG_TRACKING_JAVASCRIPT"
+      "A String",
+    ],
+    "paymentApproved": True or False, # Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.
+    "tagSetting": { # Tag Settings # Tag settings for this placement.
+      "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+      "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+      "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+      "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+    },
+    "contentCategoryId": "A String", # ID of the content category assigned to this placement.
+    "externalId": "A String", # External ID for this placement.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "sslRequired": True or False, # Whether creatives assigned to this placement must be SSL-compliant.
+    "status": "A String", # Third-party placement status.
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "primary": True or False, # Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement.
+    "placementGroupId": "A String", # ID of this placement's group, if applicable.
+    "createInfo": { # Modification timestamp. # Information about the creation of this placement. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "siteId": "A String", # Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+    "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "compatibility": "A String", # Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.
+    "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement.
+    "placementGroupIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "kind": "dfareporting#placement", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placement".
+    "subaccountId": "A String", # Subaccount ID of this placement. This field can be left blank.
+    "name": "A String", # Name of this placement.This is a required field and must be less than 256 characters long.
+    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this placement.
+      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+    },
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType.
+      "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+      "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+      "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+      "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+      "capCostOption": "A String", # Placement cap cost option.
+      "pricingPeriods": [ # Pricing periods for this placement.
+        { # Pricing Period
+          "units": "A String", # Units of this pricing period.
+          "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+          "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+          "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+          "pricingComment": "A String", # Comments for this pricing period.
+        },
+      ],
+      "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+      "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+    },
+    "vpaidAdapterChoice": "A String", # VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a placement.
+      "comment": "A String", # Comments for this placement.
+      "videoActiveViewOptOut": True or False, # Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.
+      "campaignId": "A String", # Campaign ID of this placement. This field is a required field on insertion.
+      "paymentSource": "A String", # Payment source for this placement. This is a required field that is read-only after insertion.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserId": "A String", # Advertiser ID of this placement. This field can be left blank.
+      "keyName": "A String", # Key name of this placement. This is a read-only, auto-generated field.
+      "directorySiteId": "A String", # Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this placement. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this placement. This field can be left blank.
+      "archived": True or False, # Whether this placement is archived.
+      "videoSettings": { # Video Settings # A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.
+        "skippableSettings": { # Skippable Settings # Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.
+          "skippable": True or False, # Whether the user can skip creatives served to this placement.
+          "kind": "dfareporting#skippableSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#skippableSetting".
+          "skipOffset": { # Video Offset # Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+          "progressOffset": { # Video Offset # Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+        },
+        "kind": "dfareporting#videoSettings", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoSettings".
+        "companionSettings": { # Companion Settings # Settings for the companion creatives of video creatives served to this placement.
+          "kind": "dfareporting#companionSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#companionSetting".
+          "companionsDisabled": True or False, # Whether companions are disabled for this placement.
+          "imageOnly": True or False, # Whether to serve only static images as companions.
+          "enabledSizes": [ # Whitelist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes.
+            { # Represents the dimensions of ads, placements, creatives, or creative assets.
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          ],
+        },
+        "transcodeSettings": { # Transcode Settings # Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.
+          "kind": "dfareporting#transcodeSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#transcodeSetting".
+          "enabledVideoFormats": [ # Whitelist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.
+            42,
+          ],
+        },
+      },
+      "publisherUpdateInfo": { # Modification timestamp. # Information about the last publisher update. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "tagFormats": [ # Tag formats to generate for this placement. This field is required on insertion.
+          # Acceptable values are:
+          # - "PLACEMENT_TAG_STANDARD"
+          # - "PLACEMENT_TAG_IFRAME_JAVASCRIPT"
+          # - "PLACEMENT_TAG_IFRAME_ILAYER"
+          # - "PLACEMENT_TAG_INTERNAL_REDIRECT"
+          # - "PLACEMENT_TAG_JAVASCRIPT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT"
+          # - "PLACEMENT_TAG_CLICK_COMMANDS"
+          # - "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH"
+          # - "PLACEMENT_TAG_TRACKING"
+          # - "PLACEMENT_TAG_TRACKING_IFRAME"
+          # - "PLACEMENT_TAG_TRACKING_JAVASCRIPT"
+        "A String",
+      ],
+      "paymentApproved": True or False, # Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.
+      "tagSetting": { # Tag Settings # Tag settings for this placement.
+        "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+        "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+        "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+        "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+      },
+      "contentCategoryId": "A String", # ID of the content category assigned to this placement.
+      "externalId": "A String", # External ID for this placement.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "sslRequired": True or False, # Whether creatives assigned to this placement must be SSL-compliant.
+      "status": "A String", # Third-party placement status.
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "primary": True or False, # Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement.
+      "placementGroupId": "A String", # ID of this placement's group, if applicable.
+      "createInfo": { # Modification timestamp. # Information about the creation of this placement. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "siteId": "A String", # Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+      "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "compatibility": "A String", # Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.
+      "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement.
+      "placementGroupIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "kind": "dfareporting#placement", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placement".
+      "subaccountId": "A String", # Subaccount ID of this placement. This field can be left blank.
+      "name": "A String", # Name of this placement.This is a required field and must be less than 256 characters long.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this placement.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType.
+        "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+        "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+        "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+        "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+        "capCostOption": "A String", # Placement cap cost option.
+        "pricingPeriods": [ # Pricing periods for this placement.
+          { # Pricing Period
+            "units": "A String", # Units of this pricing period.
+            "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+            "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+            "pricingComment": "A String", # Comments for this pricing period.
+          },
+        ],
+        "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+        "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+      },
+      "vpaidAdapterChoice": "A String", # VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, siteIds=None, paymentSource=None, pricingTypes=None, campaignIds=None, advertiserIds=None, sizeIds=None, pageToken=None, maxStartDate=None, sortOrder=None, maxEndDate=None, placementStrategyIds=None, contentCategoryIds=None, archived=None, maxResults=None, minStartDate=None, compatibilities=None, searchString=None, minEndDate=None, directorySiteIds=None, sortField=None, ids=None, groupIds=None)</code>
+  <pre>Retrieves a list of placements, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  siteIds: string, Select only placements that are associated with these sites. (repeated)
+  paymentSource: string, Select only placements with this payment source.
+    Allowed values
+      PLACEMENT_AGENCY_PAID - 
+      PLACEMENT_PUBLISHER_PAID - 
+  pricingTypes: string, Select only placements with these pricing types. (repeated)
+    Allowed values
+      PRICING_TYPE_CPA - 
+      PRICING_TYPE_CPC - 
+      PRICING_TYPE_CPM - 
+      PRICING_TYPE_CPM_ACTIVEVIEW - 
+      PRICING_TYPE_FLAT_RATE_CLICKS - 
+      PRICING_TYPE_FLAT_RATE_IMPRESSIONS - 
+  campaignIds: string, Select only placements that belong to these campaigns. (repeated)
+  advertiserIds: string, Select only placements that belong to these advertisers. (repeated)
+  sizeIds: string, Select only placements that are associated with these sizes. (repeated)
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  maxStartDate: string, Select only placements or placement groups whose start date is on or before the specified maxStartDate. The date should be formatted as "yyyy-MM-dd".
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  maxEndDate: string, Select only placements or placement groups whose end date is on or before the specified maxEndDate. The date should be formatted as "yyyy-MM-dd".
+  placementStrategyIds: string, Select only placements that are associated with these placement strategies. (repeated)
+  contentCategoryIds: string, Select only placements that are associated with these content categories. (repeated)
+  archived: boolean, Select only archived placements. Don't set this field to select both archived and non-archived placements.
+  maxResults: integer, Maximum number of results to return.
+  minStartDate: string, Select only placements or placement groups whose start date is on or after the specified minStartDate. The date should be formatted as "yyyy-MM-dd".
+  compatibilities: string, Select only placements that are associated with these compatibilities. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. (repeated)
+    Allowed values
+      APP - 
+      APP_INTERSTITIAL - 
+      DISPLAY - 
+      DISPLAY_INTERSTITIAL - 
+      IN_STREAM_VIDEO - 
+  searchString: string, Allows searching for placements by name or ID. Wildcards (*) are allowed. For example, "placement*2015" will return placements with names like "placement June 2015", "placement May 2015", or simply "placements 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "placement" will match placements with name "my placement", "placement 2015", or simply "placement".
+  minEndDate: string, Select only placements or placement groups whose end date is on or after the specified minEndDate. The date should be formatted as "yyyy-MM-dd".
+  directorySiteIds: string, Select only placements that are associated with these directory sites. (repeated)
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only placements with these IDs. (repeated)
+  groupIds: string, Select only placements that belong to these placement groups. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Placement List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#placementsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placementsListResponse".
+    "placements": [ # Placement collection.
+      { # Contains properties of a placement.
+          "comment": "A String", # Comments for this placement.
+          "videoActiveViewOptOut": True or False, # Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.
+          "campaignId": "A String", # Campaign ID of this placement. This field is a required field on insertion.
+          "paymentSource": "A String", # Payment source for this placement. This is a required field that is read-only after insertion.
+          "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "advertiserId": "A String", # Advertiser ID of this placement. This field can be left blank.
+          "keyName": "A String", # Key name of this placement. This is a read-only, auto-generated field.
+          "directorySiteId": "A String", # Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "id": "A String", # ID of this placement. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this placement. This field can be left blank.
+          "archived": True or False, # Whether this placement is archived.
+          "videoSettings": { # Video Settings # A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.
+            "skippableSettings": { # Skippable Settings # Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.
+              "skippable": True or False, # Whether the user can skip creatives served to this placement.
+              "kind": "dfareporting#skippableSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#skippableSetting".
+              "skipOffset": { # Video Offset # Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.
+                "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+                "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+              },
+              "progressOffset": { # Video Offset # Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true.
+                "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+                "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+              },
+            },
+            "kind": "dfareporting#videoSettings", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoSettings".
+            "companionSettings": { # Companion Settings # Settings for the companion creatives of video creatives served to this placement.
+              "kind": "dfareporting#companionSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#companionSetting".
+              "companionsDisabled": True or False, # Whether companions are disabled for this placement.
+              "imageOnly": True or False, # Whether to serve only static images as companions.
+              "enabledSizes": [ # Whitelist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes.
+                { # Represents the dimensions of ads, placements, creatives, or creative assets.
+                  "width": 42, # Width of this size.
+                  "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+                  "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+                  "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+                  "height": 42, # Height of this size.
+                },
+              ],
+            },
+            "transcodeSettings": { # Transcode Settings # Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.
+              "kind": "dfareporting#transcodeSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#transcodeSetting".
+              "enabledVideoFormats": [ # Whitelist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.
+                42,
+              ],
+            },
+          },
+          "publisherUpdateInfo": { # Modification timestamp. # Information about the last publisher update. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "tagFormats": [ # Tag formats to generate for this placement. This field is required on insertion.
+              # Acceptable values are:
+              # - "PLACEMENT_TAG_STANDARD"
+              # - "PLACEMENT_TAG_IFRAME_JAVASCRIPT"
+              # - "PLACEMENT_TAG_IFRAME_ILAYER"
+              # - "PLACEMENT_TAG_INTERNAL_REDIRECT"
+              # - "PLACEMENT_TAG_JAVASCRIPT"
+              # - "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT"
+              # - "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT"
+              # - "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT"
+              # - "PLACEMENT_TAG_CLICK_COMMANDS"
+              # - "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH"
+              # - "PLACEMENT_TAG_TRACKING"
+              # - "PLACEMENT_TAG_TRACKING_IFRAME"
+              # - "PLACEMENT_TAG_TRACKING_JAVASCRIPT"
+            "A String",
+          ],
+          "paymentApproved": True or False, # Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.
+          "tagSetting": { # Tag Settings # Tag settings for this placement.
+            "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+            "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+            "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+            "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+          },
+          "contentCategoryId": "A String", # ID of the content category assigned to this placement.
+          "externalId": "A String", # External ID for this placement.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+          "sslRequired": True or False, # Whether creatives assigned to this placement must be SSL-compliant.
+          "status": "A String", # Third-party placement status.
+          "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "primary": True or False, # Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement.
+          "placementGroupId": "A String", # ID of this placement's group, if applicable.
+          "createInfo": { # Modification timestamp. # Information about the creation of this placement. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "siteId": "A String", # Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+          "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "compatibility": "A String", # Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.
+          "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement.
+          "placementGroupIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement group. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "kind": "dfareporting#placement", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placement".
+          "subaccountId": "A String", # Subaccount ID of this placement. This field can be left blank.
+          "name": "A String", # Name of this placement.This is a required field and must be less than 256 characters long.
+          "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this placement.
+            "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+            "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          },
+          "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement. This is a read-only field.
+            "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+          },
+          "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType.
+            "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+            "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+            "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+            "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+            "capCostOption": "A String", # Placement cap cost option.
+            "pricingPeriods": [ # Pricing periods for this placement.
+              { # Pricing Period
+                "units": "A String", # Units of this pricing period.
+                "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+                "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+                "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+                "pricingComment": "A String", # Comments for this pricing period.
+              },
+            ],
+            "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+            "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+          },
+          "vpaidAdapterChoice": "A String", # VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing placement. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Placement ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a placement.
+    "comment": "A String", # Comments for this placement.
+    "videoActiveViewOptOut": True or False, # Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.
+    "campaignId": "A String", # Campaign ID of this placement. This field is a required field on insertion.
+    "paymentSource": "A String", # Payment source for this placement. This is a required field that is read-only after insertion.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserId": "A String", # Advertiser ID of this placement. This field can be left blank.
+    "keyName": "A String", # Key name of this placement. This is a read-only, auto-generated field.
+    "directorySiteId": "A String", # Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this placement. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this placement. This field can be left blank.
+    "archived": True or False, # Whether this placement is archived.
+    "videoSettings": { # Video Settings # A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.
+      "skippableSettings": { # Skippable Settings # Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.
+        "skippable": True or False, # Whether the user can skip creatives served to this placement.
+        "kind": "dfareporting#skippableSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#skippableSetting".
+        "skipOffset": { # Video Offset # Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.
+          "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+          "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+        },
+        "progressOffset": { # Video Offset # Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true.
+          "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+          "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+        },
+      },
+      "kind": "dfareporting#videoSettings", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoSettings".
+      "companionSettings": { # Companion Settings # Settings for the companion creatives of video creatives served to this placement.
+        "kind": "dfareporting#companionSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#companionSetting".
+        "companionsDisabled": True or False, # Whether companions are disabled for this placement.
+        "imageOnly": True or False, # Whether to serve only static images as companions.
+        "enabledSizes": [ # Whitelist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes.
+          { # Represents the dimensions of ads, placements, creatives, or creative assets.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        ],
+      },
+      "transcodeSettings": { # Transcode Settings # Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.
+        "kind": "dfareporting#transcodeSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#transcodeSetting".
+        "enabledVideoFormats": [ # Whitelist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.
+          42,
+        ],
+      },
+    },
+    "publisherUpdateInfo": { # Modification timestamp. # Information about the last publisher update. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "tagFormats": [ # Tag formats to generate for this placement. This field is required on insertion.
+        # Acceptable values are:
+        # - "PLACEMENT_TAG_STANDARD"
+        # - "PLACEMENT_TAG_IFRAME_JAVASCRIPT"
+        # - "PLACEMENT_TAG_IFRAME_ILAYER"
+        # - "PLACEMENT_TAG_INTERNAL_REDIRECT"
+        # - "PLACEMENT_TAG_JAVASCRIPT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT"
+        # - "PLACEMENT_TAG_CLICK_COMMANDS"
+        # - "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH"
+        # - "PLACEMENT_TAG_TRACKING"
+        # - "PLACEMENT_TAG_TRACKING_IFRAME"
+        # - "PLACEMENT_TAG_TRACKING_JAVASCRIPT"
+      "A String",
+    ],
+    "paymentApproved": True or False, # Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.
+    "tagSetting": { # Tag Settings # Tag settings for this placement.
+      "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+      "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+      "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+      "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+    },
+    "contentCategoryId": "A String", # ID of the content category assigned to this placement.
+    "externalId": "A String", # External ID for this placement.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "sslRequired": True or False, # Whether creatives assigned to this placement must be SSL-compliant.
+    "status": "A String", # Third-party placement status.
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "primary": True or False, # Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement.
+    "placementGroupId": "A String", # ID of this placement's group, if applicable.
+    "createInfo": { # Modification timestamp. # Information about the creation of this placement. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "siteId": "A String", # Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+    "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "compatibility": "A String", # Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.
+    "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement.
+    "placementGroupIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "kind": "dfareporting#placement", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placement".
+    "subaccountId": "A String", # Subaccount ID of this placement. This field can be left blank.
+    "name": "A String", # Name of this placement.This is a required field and must be less than 256 characters long.
+    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this placement.
+      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+    },
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType.
+      "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+      "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+      "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+      "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+      "capCostOption": "A String", # Placement cap cost option.
+      "pricingPeriods": [ # Pricing periods for this placement.
+        { # Pricing Period
+          "units": "A String", # Units of this pricing period.
+          "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+          "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+          "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+          "pricingComment": "A String", # Comments for this pricing period.
+        },
+      ],
+      "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+      "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+    },
+    "vpaidAdapterChoice": "A String", # VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a placement.
+      "comment": "A String", # Comments for this placement.
+      "videoActiveViewOptOut": True or False, # Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.
+      "campaignId": "A String", # Campaign ID of this placement. This field is a required field on insertion.
+      "paymentSource": "A String", # Payment source for this placement. This is a required field that is read-only after insertion.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserId": "A String", # Advertiser ID of this placement. This field can be left blank.
+      "keyName": "A String", # Key name of this placement. This is a read-only, auto-generated field.
+      "directorySiteId": "A String", # Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this placement. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this placement. This field can be left blank.
+      "archived": True or False, # Whether this placement is archived.
+      "videoSettings": { # Video Settings # A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.
+        "skippableSettings": { # Skippable Settings # Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.
+          "skippable": True or False, # Whether the user can skip creatives served to this placement.
+          "kind": "dfareporting#skippableSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#skippableSetting".
+          "skipOffset": { # Video Offset # Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+          "progressOffset": { # Video Offset # Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+        },
+        "kind": "dfareporting#videoSettings", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoSettings".
+        "companionSettings": { # Companion Settings # Settings for the companion creatives of video creatives served to this placement.
+          "kind": "dfareporting#companionSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#companionSetting".
+          "companionsDisabled": True or False, # Whether companions are disabled for this placement.
+          "imageOnly": True or False, # Whether to serve only static images as companions.
+          "enabledSizes": [ # Whitelist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes.
+            { # Represents the dimensions of ads, placements, creatives, or creative assets.
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          ],
+        },
+        "transcodeSettings": { # Transcode Settings # Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.
+          "kind": "dfareporting#transcodeSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#transcodeSetting".
+          "enabledVideoFormats": [ # Whitelist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.
+            42,
+          ],
+        },
+      },
+      "publisherUpdateInfo": { # Modification timestamp. # Information about the last publisher update. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "tagFormats": [ # Tag formats to generate for this placement. This field is required on insertion.
+          # Acceptable values are:
+          # - "PLACEMENT_TAG_STANDARD"
+          # - "PLACEMENT_TAG_IFRAME_JAVASCRIPT"
+          # - "PLACEMENT_TAG_IFRAME_ILAYER"
+          # - "PLACEMENT_TAG_INTERNAL_REDIRECT"
+          # - "PLACEMENT_TAG_JAVASCRIPT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT"
+          # - "PLACEMENT_TAG_CLICK_COMMANDS"
+          # - "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH"
+          # - "PLACEMENT_TAG_TRACKING"
+          # - "PLACEMENT_TAG_TRACKING_IFRAME"
+          # - "PLACEMENT_TAG_TRACKING_JAVASCRIPT"
+        "A String",
+      ],
+      "paymentApproved": True or False, # Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.
+      "tagSetting": { # Tag Settings # Tag settings for this placement.
+        "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+        "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+        "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+        "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+      },
+      "contentCategoryId": "A String", # ID of the content category assigned to this placement.
+      "externalId": "A String", # External ID for this placement.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "sslRequired": True or False, # Whether creatives assigned to this placement must be SSL-compliant.
+      "status": "A String", # Third-party placement status.
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "primary": True or False, # Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement.
+      "placementGroupId": "A String", # ID of this placement's group, if applicable.
+      "createInfo": { # Modification timestamp. # Information about the creation of this placement. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "siteId": "A String", # Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+      "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "compatibility": "A String", # Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.
+      "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement.
+      "placementGroupIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "kind": "dfareporting#placement", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placement".
+      "subaccountId": "A String", # Subaccount ID of this placement. This field can be left blank.
+      "name": "A String", # Name of this placement.This is a required field and must be less than 256 characters long.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this placement.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType.
+        "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+        "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+        "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+        "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+        "capCostOption": "A String", # Placement cap cost option.
+        "pricingPeriods": [ # Pricing periods for this placement.
+          { # Pricing Period
+            "units": "A String", # Units of this pricing period.
+            "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+            "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+            "pricingComment": "A String", # Comments for this pricing period.
+          },
+        ],
+        "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+        "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+      },
+      "vpaidAdapterChoice": "A String", # VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing placement.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a placement.
+    "comment": "A String", # Comments for this placement.
+    "videoActiveViewOptOut": True or False, # Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.
+    "campaignId": "A String", # Campaign ID of this placement. This field is a required field on insertion.
+    "paymentSource": "A String", # Payment source for this placement. This is a required field that is read-only after insertion.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "advertiserId": "A String", # Advertiser ID of this placement. This field can be left blank.
+    "keyName": "A String", # Key name of this placement. This is a read-only, auto-generated field.
+    "directorySiteId": "A String", # Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this placement. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this placement. This field can be left blank.
+    "archived": True or False, # Whether this placement is archived.
+    "videoSettings": { # Video Settings # A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.
+      "skippableSettings": { # Skippable Settings # Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.
+        "skippable": True or False, # Whether the user can skip creatives served to this placement.
+        "kind": "dfareporting#skippableSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#skippableSetting".
+        "skipOffset": { # Video Offset # Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.
+          "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+          "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+        },
+        "progressOffset": { # Video Offset # Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true.
+          "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+          "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+        },
+      },
+      "kind": "dfareporting#videoSettings", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoSettings".
+      "companionSettings": { # Companion Settings # Settings for the companion creatives of video creatives served to this placement.
+        "kind": "dfareporting#companionSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#companionSetting".
+        "companionsDisabled": True or False, # Whether companions are disabled for this placement.
+        "imageOnly": True or False, # Whether to serve only static images as companions.
+        "enabledSizes": [ # Whitelist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes.
+          { # Represents the dimensions of ads, placements, creatives, or creative assets.
+            "width": 42, # Width of this size.
+            "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+            "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+            "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+            "height": 42, # Height of this size.
+          },
+        ],
+      },
+      "transcodeSettings": { # Transcode Settings # Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.
+        "kind": "dfareporting#transcodeSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#transcodeSetting".
+        "enabledVideoFormats": [ # Whitelist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.
+          42,
+        ],
+      },
+    },
+    "publisherUpdateInfo": { # Modification timestamp. # Information about the last publisher update. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "tagFormats": [ # Tag formats to generate for this placement. This field is required on insertion.
+        # Acceptable values are:
+        # - "PLACEMENT_TAG_STANDARD"
+        # - "PLACEMENT_TAG_IFRAME_JAVASCRIPT"
+        # - "PLACEMENT_TAG_IFRAME_ILAYER"
+        # - "PLACEMENT_TAG_INTERNAL_REDIRECT"
+        # - "PLACEMENT_TAG_JAVASCRIPT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT"
+        # - "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT"
+        # - "PLACEMENT_TAG_CLICK_COMMANDS"
+        # - "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH"
+        # - "PLACEMENT_TAG_TRACKING"
+        # - "PLACEMENT_TAG_TRACKING_IFRAME"
+        # - "PLACEMENT_TAG_TRACKING_JAVASCRIPT"
+      "A String",
+    ],
+    "paymentApproved": True or False, # Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.
+    "tagSetting": { # Tag Settings # Tag settings for this placement.
+      "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+      "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+      "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+      "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+    },
+    "contentCategoryId": "A String", # ID of the content category assigned to this placement.
+    "externalId": "A String", # External ID for this placement.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "sslRequired": True or False, # Whether creatives assigned to this placement must be SSL-compliant.
+    "status": "A String", # Third-party placement status.
+    "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "primary": True or False, # Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement.
+    "placementGroupId": "A String", # ID of this placement's group, if applicable.
+    "createInfo": { # Modification timestamp. # Information about the creation of this placement. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "siteId": "A String", # Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+    "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "compatibility": "A String", # Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.
+    "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement.
+    "placementGroupIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement group. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "kind": "dfareporting#placement", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placement".
+    "subaccountId": "A String", # Subaccount ID of this placement. This field can be left blank.
+    "name": "A String", # Name of this placement.This is a required field and must be less than 256 characters long.
+    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this placement.
+      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+    },
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement. This is a read-only field.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType.
+      "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+      "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+      "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+      "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+      "capCostOption": "A String", # Placement cap cost option.
+      "pricingPeriods": [ # Pricing periods for this placement.
+        { # Pricing Period
+          "units": "A String", # Units of this pricing period.
+          "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+          "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+          "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+          "pricingComment": "A String", # Comments for this pricing period.
+        },
+      ],
+      "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+      "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+    },
+    "vpaidAdapterChoice": "A String", # VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a placement.
+      "comment": "A String", # Comments for this placement.
+      "videoActiveViewOptOut": True or False, # Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.
+      "campaignId": "A String", # Campaign ID of this placement. This field is a required field on insertion.
+      "paymentSource": "A String", # Payment source for this placement. This is a required field that is read-only after insertion.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "advertiserId": "A String", # Advertiser ID of this placement. This field can be left blank.
+      "keyName": "A String", # Key name of this placement. This is a read-only, auto-generated field.
+      "directorySiteId": "A String", # Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this placement. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this placement. This field can be left blank.
+      "archived": True or False, # Whether this placement is archived.
+      "videoSettings": { # Video Settings # A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.
+        "skippableSettings": { # Skippable Settings # Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.
+          "skippable": True or False, # Whether the user can skip creatives served to this placement.
+          "kind": "dfareporting#skippableSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#skippableSetting".
+          "skipOffset": { # Video Offset # Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+          "progressOffset": { # Video Offset # Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true.
+            "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set.
+            "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set.
+          },
+        },
+        "kind": "dfareporting#videoSettings", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoSettings".
+        "companionSettings": { # Companion Settings # Settings for the companion creatives of video creatives served to this placement.
+          "kind": "dfareporting#companionSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#companionSetting".
+          "companionsDisabled": True or False, # Whether companions are disabled for this placement.
+          "imageOnly": True or False, # Whether to serve only static images as companions.
+          "enabledSizes": [ # Whitelist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes.
+            { # Represents the dimensions of ads, placements, creatives, or creative assets.
+              "width": 42, # Width of this size.
+              "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+              "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+              "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+              "height": 42, # Height of this size.
+            },
+          ],
+        },
+        "transcodeSettings": { # Transcode Settings # Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.
+          "kind": "dfareporting#transcodeSetting", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#transcodeSetting".
+          "enabledVideoFormats": [ # Whitelist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.
+            42,
+          ],
+        },
+      },
+      "publisherUpdateInfo": { # Modification timestamp. # Information about the last publisher update. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "tagFormats": [ # Tag formats to generate for this placement. This field is required on insertion.
+          # Acceptable values are:
+          # - "PLACEMENT_TAG_STANDARD"
+          # - "PLACEMENT_TAG_IFRAME_JAVASCRIPT"
+          # - "PLACEMENT_TAG_IFRAME_ILAYER"
+          # - "PLACEMENT_TAG_INTERNAL_REDIRECT"
+          # - "PLACEMENT_TAG_JAVASCRIPT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT"
+          # - "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT"
+          # - "PLACEMENT_TAG_CLICK_COMMANDS"
+          # - "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH"
+          # - "PLACEMENT_TAG_TRACKING"
+          # - "PLACEMENT_TAG_TRACKING_IFRAME"
+          # - "PLACEMENT_TAG_TRACKING_JAVASCRIPT"
+        "A String",
+      ],
+      "paymentApproved": True or False, # Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.
+      "tagSetting": { # Tag Settings # Tag settings for this placement.
+        "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+        "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+        "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+        "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+      },
+      "contentCategoryId": "A String", # ID of the content category assigned to this placement.
+      "externalId": "A String", # External ID for this placement.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this placement. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+      "sslRequired": True or False, # Whether creatives assigned to this placement must be SSL-compliant.
+      "status": "A String", # Third-party placement status.
+      "campaignIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "primary": True or False, # Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement.
+      "placementGroupId": "A String", # ID of this placement's group, if applicable.
+      "createInfo": { # Modification timestamp. # Information about the creation of this placement. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "siteId": "A String", # Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.
+      "siteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "compatibility": "A String", # Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.
+      "placementStrategyId": "A String", # ID of the placement strategy assigned to this placement.
+      "placementGroupIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the placement group. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "kind": "dfareporting#placement", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#placement".
+      "subaccountId": "A String", # Subaccount ID of this placement. This field can be left blank.
+      "name": "A String", # Name of this placement.This is a required field and must be less than 256 characters long.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this placement.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this placement. This is a read-only field.
+        "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+      },
+      "pricingSchedule": { # Pricing Schedule # Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType.
+        "startDate": "A String", # Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
+        "endDate": "A String", # Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
+        "flighted": True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
+        "disregardOverdelivery": True or False, # Whether cap costs are ignored by ad serving.
+        "capCostOption": "A String", # Placement cap cost option.
+        "pricingPeriods": [ # Pricing periods for this placement.
+          { # Pricing Period
+            "units": "A String", # Units of this pricing period.
+            "rateOrCostNanos": "A String", # Rate or cost of this pricing period.
+            "startDate": "A String", # Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+            "endDate": "A String", # Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
+            "pricingComment": "A String", # Comments for this pricing period.
+          },
+        ],
+        "pricingType": "A String", # Placement pricing type. This field is required on insertion.
+        "testingStartDate": "A String", # Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
+      },
+      "vpaidAdapterChoice": "A String", # VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.platformTypes.html b/docs/dyn/dfareporting_v2_7.platformTypes.html
new file mode 100644
index 00000000000..f5b36fcec6c
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.platformTypes.html
@@ -0,0 +1,124 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.platformTypes.html">platformTypes</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one platform type by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of platform types.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one platform type by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Platform type ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about a platform type that can be targeted by ads.
+    "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+    "id": "A String", # ID of this platform type.
+    "name": "A String", # Name of this platform type.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of platform types.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Platform Type List Response
+    "kind": "dfareporting#platformTypesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformTypesListResponse".
+    "platformTypes": [ # Platform type collection.
+      { # Contains information about a platform type that can be targeted by ads.
+        "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+        "id": "A String", # ID of this platform type.
+        "name": "A String", # Name of this platform type.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.postalCodes.html b/docs/dyn/dfareporting_v2_7.postalCodes.html
new file mode 100644
index 00000000000..5d43a97f57f
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.postalCodes.html
@@ -0,0 +1,128 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.postalCodes.html">postalCodes</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, code)</a></code></p>
+<p class="firstline">Gets one postal code by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of postal codes.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, code)</code>
+  <pre>Gets one postal code by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  code: string, Postal code ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about a postal code that can be targeted by ads.
+    "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+    "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+    "code": "A String", # Postal code. This is equivalent to the id field.
+    "id": "A String", # ID of this postal code.
+    "countryCode": "A String", # Country code of the country to which this postal code belongs.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of postal codes.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Postal Code List Response
+    "kind": "dfareporting#postalCodesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCodesListResponse".
+    "postalCodes": [ # Postal code collection.
+      { # Contains information about a postal code that can be targeted by ads.
+        "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+        "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+        "code": "A String", # Postal code. This is equivalent to the id field.
+        "id": "A String", # ID of this postal code.
+        "countryCode": "A String", # Country code of the country to which this postal code belongs.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.projects.html b/docs/dyn/dfareporting_v2_7.projects.html
new file mode 100644
index 00000000000..297d004bd4d
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.projects.html
@@ -0,0 +1,197 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.projects.html">projects</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one project by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of projects, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one project by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Project ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DoubleClick Planning project.
+    "startDate": "A String", # Start date of the project.
+    "targetCpmNanos": "A String", # CPM that the advertiser is targeting.
+    "endDate": "A String", # End date of the project.
+    "clientBillingCode": "A String", # Client billing code of this project.
+    "overview": "A String", # Overview of this project.
+    "targetCpaNanos": "A String", # CPA that the advertiser is targeting.
+    "advertiserId": "A String", # Advertiser ID of this project.
+    "targetImpressions": "A String", # Number of impressions that the advertiser is targeting.
+    "id": "A String", # ID of this project. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this project.
+    "targetCpcNanos": "A String", # CPC that the advertiser is targeting.
+    "targetCpmActiveViewNanos": "A String", # vCPM from Active View that the advertiser is targeting.
+    "targetClicks": "A String", # Number of clicks that the advertiser is targeting.
+    "audienceGender": "A String", # Audience gender of this project.
+    "kind": "dfareporting#project", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#project".
+    "subaccountId": "A String", # Subaccount ID of this project.
+    "name": "A String", # Name of this project.
+    "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this project.
+      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+    },
+    "budget": "A String", # Budget of this project in the currency specified by the current account. The value stored in this field represents only the non-fractional amount. For example, for USD, the smallest value that can be represented by this field is 1 US dollar.
+    "audienceAgeGroup": "A String", # Audience age group of this project.
+    "targetConversions": "A String", # Number of conversions that the advertiser is targeting.
+    "clientName": "A String", # Name of the project client.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, advertiserIds=None, ids=None, maxResults=None, sortOrder=None)</code>
+  <pre>Retrieves a list of projects, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for projects by name or ID. Wildcards (*) are allowed. For example, "project*2015" will return projects with names like "project June 2015", "project April 2015", or simply "project 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "project" will match projects with name "my project", "project 2015", or simply "project".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  advertiserIds: string, Select only projects with these advertiser IDs. (repeated)
+  ids: string, Select only projects with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Project List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#projectsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#projectsListResponse".
+    "projects": [ # Project collection.
+      { # Contains properties of a DoubleClick Planning project.
+        "startDate": "A String", # Start date of the project.
+        "targetCpmNanos": "A String", # CPM that the advertiser is targeting.
+        "endDate": "A String", # End date of the project.
+        "clientBillingCode": "A String", # Client billing code of this project.
+        "overview": "A String", # Overview of this project.
+        "targetCpaNanos": "A String", # CPA that the advertiser is targeting.
+        "advertiserId": "A String", # Advertiser ID of this project.
+        "targetImpressions": "A String", # Number of impressions that the advertiser is targeting.
+        "id": "A String", # ID of this project. This is a read-only, auto-generated field.
+        "accountId": "A String", # Account ID of this project.
+        "targetCpcNanos": "A String", # CPC that the advertiser is targeting.
+        "targetCpmActiveViewNanos": "A String", # vCPM from Active View that the advertiser is targeting.
+        "targetClicks": "A String", # Number of clicks that the advertiser is targeting.
+        "audienceGender": "A String", # Audience gender of this project.
+        "kind": "dfareporting#project", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#project".
+        "subaccountId": "A String", # Subaccount ID of this project.
+        "name": "A String", # Name of this project.
+        "lastModifiedInfo": { # Modification timestamp. # Information about the most recent modification of this project.
+          "time": "A String", # Timestamp of the last change in milliseconds since epoch.
+        },
+        "budget": "A String", # Budget of this project in the currency specified by the current account. The value stored in this field represents only the non-fractional amount. For example, for USD, the smallest value that can be represented by this field is 1 US dollar.
+        "audienceAgeGroup": "A String", # Audience age group of this project.
+        "targetConversions": "A String", # Number of conversions that the advertiser is targeting.
+        "clientName": "A String", # Name of the project client.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.regions.html b/docs/dyn/dfareporting_v2_7.regions.html
new file mode 100644
index 00000000000..cf2c373578d
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.regions.html
@@ -0,0 +1,106 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.regions.html">regions</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Retrieves a list of regions.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Retrieves a list of regions.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Region List Response
+    "regions": [ # Region collection.
+      { # Contains information about a region that can be targeted by ads.
+        "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+        "countryDartId": "A String", # DART ID of the country to which this region belongs.
+        "name": "A String", # Name of this region.
+        "countryCode": "A String", # Country code of the country to which this region belongs.
+        "regionCode": "A String", # Region code.
+        "dartId": "A String", # DART ID of this region.
+      },
+    ],
+    "kind": "dfareporting#regionsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#regionsListResponse".
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.remarketingListShares.html b/docs/dyn/dfareporting_v2_7.remarketingListShares.html
new file mode 100644
index 00000000000..de9057978a0
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.remarketingListShares.html
@@ -0,0 +1,183 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.remarketingListShares.html">remarketingListShares</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, remarketingListId)</a></code></p>
+<p class="firstline">Gets one remarketing list share by remarketing list ID.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, remarketingListId, body)</a></code></p>
+<p class="firstline">Updates an existing remarketing list share. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing remarketing list share.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, remarketingListId)</code>
+  <pre>Gets one remarketing list share by remarketing list ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  remarketingListId: string, Remarketing list ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a remarketing list's sharing information. Sharing allows other accounts or advertisers to target to your remarketing lists. This resource can be used to manage remarketing list sharing to other accounts and advertisers.
+      "sharedAdvertiserIds": [ # Advertisers that the remarketing list is shared with.
+        "A String",
+      ],
+      "kind": "dfareporting#remarketingListShare", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingListShare".
+      "remarketingListId": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+      "sharedAccountIds": [ # Accounts that the remarketing list is shared with.
+        "A String",
+      ],
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, remarketingListId, body)</code>
+  <pre>Updates an existing remarketing list share. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  remarketingListId: string, Remarketing list ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a remarketing list's sharing information. Sharing allows other accounts or advertisers to target to your remarketing lists. This resource can be used to manage remarketing list sharing to other accounts and advertisers.
+    "sharedAdvertiserIds": [ # Advertisers that the remarketing list is shared with.
+      "A String",
+    ],
+    "kind": "dfareporting#remarketingListShare", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingListShare".
+    "remarketingListId": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+    "sharedAccountIds": [ # Accounts that the remarketing list is shared with.
+      "A String",
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a remarketing list's sharing information. Sharing allows other accounts or advertisers to target to your remarketing lists. This resource can be used to manage remarketing list sharing to other accounts and advertisers.
+      "sharedAdvertiserIds": [ # Advertisers that the remarketing list is shared with.
+        "A String",
+      ],
+      "kind": "dfareporting#remarketingListShare", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingListShare".
+      "remarketingListId": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+      "sharedAccountIds": [ # Accounts that the remarketing list is shared with.
+        "A String",
+      ],
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing remarketing list share.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a remarketing list's sharing information. Sharing allows other accounts or advertisers to target to your remarketing lists. This resource can be used to manage remarketing list sharing to other accounts and advertisers.
+    "sharedAdvertiserIds": [ # Advertisers that the remarketing list is shared with.
+      "A String",
+    ],
+    "kind": "dfareporting#remarketingListShare", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingListShare".
+    "remarketingListId": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+    "sharedAccountIds": [ # Accounts that the remarketing list is shared with.
+      "A String",
+    ],
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a remarketing list's sharing information. Sharing allows other accounts or advertisers to target to your remarketing lists. This resource can be used to manage remarketing list sharing to other accounts and advertisers.
+      "sharedAdvertiserIds": [ # Advertisers that the remarketing list is shared with.
+        "A String",
+      ],
+      "kind": "dfareporting#remarketingListShare", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingListShare".
+      "remarketingListId": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+      "sharedAccountIds": [ # Accounts that the remarketing list is shared with.
+        "A String",
+      ],
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.remarketingLists.html b/docs/dyn/dfareporting_v2_7.remarketingLists.html
new file mode 100644
index 00000000000..4fd313310e3
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.remarketingLists.html
@@ -0,0 +1,532 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.remarketingLists.html">remarketingLists</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one remarketing list by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new remarketing list.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, floodlightActivityId=None, maxResults=None, active=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of remarketing lists, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing remarketing list. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing remarketing list.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one remarketing list by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Remarketing list ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.
+      "listPopulationRule": { # Remarketing List Population Rule. # Rule used to populate the remarketing list with users.
+        "floodlightActivityName": "A String", # Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this rule. This field can be left blank.
+        "listPopulationClauses": [ # Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs.
+          { # A group clause made up of list population terms representing constraints joined by ORs.
+            "terms": [ # Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.
+              { # Remarketing List Population Rule Term.
+                "remarketingListId": "A String", # ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.
+                "contains": True or False, # Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.
+                "negation": True or False, # Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "value": "A String", # Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "variableFriendlyName": "A String", # Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.
+                "operator": "A String", # Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "type": "A String", # List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.
+                "variableName": "A String", # Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              },
+            ],
+          },
+        ],
+      },
+      "kind": "dfareporting#remarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingList".
+      "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+      "description": "A String", # Remarketing list description.
+      "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+      "lifeSpan": "A String", # Number of days that a user should remain in the remarketing list without an impression.
+      "name": "A String", # Name of the remarketing list. This is a required field. Must be no greater than 128 characters long.
+      "advertiserId": "A String", # Dimension value for the advertiser ID that owns this remarketing list. This is a required field.
+      "listSource": "A String", # Product from which this remarketing list was originated.
+      "active": True or False, # Whether this remarketing list is active.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new remarketing list.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.
+    "listPopulationRule": { # Remarketing List Population Rule. # Rule used to populate the remarketing list with users.
+      "floodlightActivityName": "A String", # Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this rule. This field can be left blank.
+      "listPopulationClauses": [ # Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs.
+        { # A group clause made up of list population terms representing constraints joined by ORs.
+          "terms": [ # Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.
+            { # Remarketing List Population Rule Term.
+              "remarketingListId": "A String", # ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.
+              "contains": True or False, # Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.
+              "negation": True or False, # Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "value": "A String", # Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "variableFriendlyName": "A String", # Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.
+              "operator": "A String", # Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "type": "A String", # List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.
+              "variableName": "A String", # Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+            },
+          ],
+        },
+      ],
+    },
+    "kind": "dfareporting#remarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingList".
+    "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+    "description": "A String", # Remarketing list description.
+    "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+    "lifeSpan": "A String", # Number of days that a user should remain in the remarketing list without an impression.
+    "name": "A String", # Name of the remarketing list. This is a required field. Must be no greater than 128 characters long.
+    "advertiserId": "A String", # Dimension value for the advertiser ID that owns this remarketing list. This is a required field.
+    "listSource": "A String", # Product from which this remarketing list was originated.
+    "active": True or False, # Whether this remarketing list is active.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.
+      "listPopulationRule": { # Remarketing List Population Rule. # Rule used to populate the remarketing list with users.
+        "floodlightActivityName": "A String", # Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this rule. This field can be left blank.
+        "listPopulationClauses": [ # Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs.
+          { # A group clause made up of list population terms representing constraints joined by ORs.
+            "terms": [ # Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.
+              { # Remarketing List Population Rule Term.
+                "remarketingListId": "A String", # ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.
+                "contains": True or False, # Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.
+                "negation": True or False, # Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "value": "A String", # Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "variableFriendlyName": "A String", # Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.
+                "operator": "A String", # Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "type": "A String", # List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.
+                "variableName": "A String", # Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              },
+            ],
+          },
+        ],
+      },
+      "kind": "dfareporting#remarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingList".
+      "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+      "description": "A String", # Remarketing list description.
+      "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+      "lifeSpan": "A String", # Number of days that a user should remain in the remarketing list without an impression.
+      "name": "A String", # Name of the remarketing list. This is a required field. Must be no greater than 128 characters long.
+      "advertiserId": "A String", # Dimension value for the advertiser ID that owns this remarketing list. This is a required field.
+      "listSource": "A String", # Product from which this remarketing list was originated.
+      "active": True or False, # Whether this remarketing list is active.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, floodlightActivityId=None, maxResults=None, active=None, sortOrder=None)</code>
+  <pre>Retrieves a list of remarketing lists, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  advertiserId: string, Select only remarketing lists owned by this advertiser. (required)
+  name: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "remarketing list*2015" will return objects with names like "remarketing list June 2015", "remarketing list April 2015", or simply "remarketing list 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "remarketing list" will match objects with name "my remarketing list", "remarketing list 2015", or simply "remarketing list".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  floodlightActivityId: string, Select only remarketing lists that have this floodlight activity ID.
+  maxResults: integer, Maximum number of results to return.
+  active: boolean, Select only active or only inactive remarketing lists.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Remarketing list response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "remarketingLists": [ # Remarketing list collection.
+      { # Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.
+          "listPopulationRule": { # Remarketing List Population Rule. # Rule used to populate the remarketing list with users.
+            "floodlightActivityName": "A String", # Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.
+            "floodlightActivityId": "A String", # Floodlight activity ID associated with this rule. This field can be left blank.
+            "listPopulationClauses": [ # Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs.
+              { # A group clause made up of list population terms representing constraints joined by ORs.
+                "terms": [ # Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.
+                  { # Remarketing List Population Rule Term.
+                    "remarketingListId": "A String", # ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.
+                    "contains": True or False, # Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.
+                    "negation": True or False, # Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                    "value": "A String", # Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                    "variableFriendlyName": "A String", # Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.
+                    "operator": "A String", # Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                    "type": "A String", # List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.
+                    "variableName": "A String", # Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                  },
+                ],
+              },
+            ],
+          },
+          "kind": "dfareporting#remarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingList".
+          "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+          "description": "A String", # Remarketing list description.
+          "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+          "lifeSpan": "A String", # Number of days that a user should remain in the remarketing list without an impression.
+          "name": "A String", # Name of the remarketing list. This is a required field. Must be no greater than 128 characters long.
+          "advertiserId": "A String", # Dimension value for the advertiser ID that owns this remarketing list. This is a required field.
+          "listSource": "A String", # Product from which this remarketing list was originated.
+          "active": True or False, # Whether this remarketing list is active.
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "id": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+        },
+    ],
+    "kind": "dfareporting#remarketingListsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingListsListResponse".
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing remarketing list. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Remarketing list ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.
+    "listPopulationRule": { # Remarketing List Population Rule. # Rule used to populate the remarketing list with users.
+      "floodlightActivityName": "A String", # Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this rule. This field can be left blank.
+      "listPopulationClauses": [ # Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs.
+        { # A group clause made up of list population terms representing constraints joined by ORs.
+          "terms": [ # Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.
+            { # Remarketing List Population Rule Term.
+              "remarketingListId": "A String", # ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.
+              "contains": True or False, # Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.
+              "negation": True or False, # Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "value": "A String", # Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "variableFriendlyName": "A String", # Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.
+              "operator": "A String", # Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "type": "A String", # List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.
+              "variableName": "A String", # Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+            },
+          ],
+        },
+      ],
+    },
+    "kind": "dfareporting#remarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingList".
+    "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+    "description": "A String", # Remarketing list description.
+    "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+    "lifeSpan": "A String", # Number of days that a user should remain in the remarketing list without an impression.
+    "name": "A String", # Name of the remarketing list. This is a required field. Must be no greater than 128 characters long.
+    "advertiserId": "A String", # Dimension value for the advertiser ID that owns this remarketing list. This is a required field.
+    "listSource": "A String", # Product from which this remarketing list was originated.
+    "active": True or False, # Whether this remarketing list is active.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.
+      "listPopulationRule": { # Remarketing List Population Rule. # Rule used to populate the remarketing list with users.
+        "floodlightActivityName": "A String", # Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this rule. This field can be left blank.
+        "listPopulationClauses": [ # Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs.
+          { # A group clause made up of list population terms representing constraints joined by ORs.
+            "terms": [ # Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.
+              { # Remarketing List Population Rule Term.
+                "remarketingListId": "A String", # ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.
+                "contains": True or False, # Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.
+                "negation": True or False, # Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "value": "A String", # Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "variableFriendlyName": "A String", # Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.
+                "operator": "A String", # Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "type": "A String", # List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.
+                "variableName": "A String", # Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              },
+            ],
+          },
+        ],
+      },
+      "kind": "dfareporting#remarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingList".
+      "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+      "description": "A String", # Remarketing list description.
+      "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+      "lifeSpan": "A String", # Number of days that a user should remain in the remarketing list without an impression.
+      "name": "A String", # Name of the remarketing list. This is a required field. Must be no greater than 128 characters long.
+      "advertiserId": "A String", # Dimension value for the advertiser ID that owns this remarketing list. This is a required field.
+      "listSource": "A String", # Product from which this remarketing list was originated.
+      "active": True or False, # Whether this remarketing list is active.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing remarketing list.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.
+    "listPopulationRule": { # Remarketing List Population Rule. # Rule used to populate the remarketing list with users.
+      "floodlightActivityName": "A String", # Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.
+      "floodlightActivityId": "A String", # Floodlight activity ID associated with this rule. This field can be left blank.
+      "listPopulationClauses": [ # Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs.
+        { # A group clause made up of list population terms representing constraints joined by ORs.
+          "terms": [ # Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.
+            { # Remarketing List Population Rule Term.
+              "remarketingListId": "A String", # ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.
+              "contains": True or False, # Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.
+              "negation": True or False, # Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "value": "A String", # Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "variableFriendlyName": "A String", # Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.
+              "operator": "A String", # Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              "type": "A String", # List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.
+              "variableName": "A String", # Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+            },
+          ],
+        },
+      ],
+    },
+    "kind": "dfareporting#remarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingList".
+    "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+    "description": "A String", # Remarketing list description.
+    "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+    "lifeSpan": "A String", # Number of days that a user should remain in the remarketing list without an impression.
+    "name": "A String", # Name of the remarketing list. This is a required field. Must be no greater than 128 characters long.
+    "advertiserId": "A String", # Dimension value for the advertiser ID that owns this remarketing list. This is a required field.
+    "listSource": "A String", # Product from which this remarketing list was originated.
+    "active": True or False, # Whether this remarketing list is active.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.
+      "listPopulationRule": { # Remarketing List Population Rule. # Rule used to populate the remarketing list with users.
+        "floodlightActivityName": "A String", # Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.
+        "floodlightActivityId": "A String", # Floodlight activity ID associated with this rule. This field can be left blank.
+        "listPopulationClauses": [ # Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs.
+          { # A group clause made up of list population terms representing constraints joined by ORs.
+            "terms": [ # Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.
+              { # Remarketing List Population Rule Term.
+                "remarketingListId": "A String", # ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.
+                "contains": True or False, # Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.
+                "negation": True or False, # Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "value": "A String", # Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "variableFriendlyName": "A String", # Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.
+                "operator": "A String", # Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+                "type": "A String", # List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.
+                "variableName": "A String", # Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM.
+              },
+            ],
+          },
+        ],
+      },
+      "kind": "dfareporting#remarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#remarketingList".
+      "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+      "description": "A String", # Remarketing list description.
+      "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+      "lifeSpan": "A String", # Number of days that a user should remain in the remarketing list without an impression.
+      "name": "A String", # Name of the remarketing list. This is a required field. Must be no greater than 128 characters long.
+      "advertiserId": "A String", # Dimension value for the advertiser ID that owns this remarketing list. This is a required field.
+      "listSource": "A String", # Product from which this remarketing list was originated.
+      "active": True or False, # Whether this remarketing list is active.
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # Remarketing list ID. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.reports.compatibleFields.html b/docs/dyn/dfareporting_v2_7.reports.compatibleFields.html
new file mode 100644
index 00000000000..887db760eff
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.reports.compatibleFields.html
@@ -0,0 +1,551 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.reports.html">reports</a> . <a href="dfareporting_v2_7.reports.compatibleFields.html">compatibleFields</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#query">query(profileId, body)</a></code></p>
+<p class="firstline">Returns the fields that are compatible to be selected in the respective sections of a report criteria, given the fields already selected in the input report and user permissions.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="query">query(profileId, body)</code>
+  <pre>Returns the fields that are compatible to be selected in the respective sections of a report criteria, given the fields already selected in the input report and user permissions.
+
+Args:
+  profileId: string, The DFA user profile ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents a Report resource.
+    "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+      "conversionDimensions": [ # The list of conversion dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "reportProperties": { # The properties of the report.
+        "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+        "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+        "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+        "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+        "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+        "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+        "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+        "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+        "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+      },
+      "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "customRichMediaEvents": [ # The list of custom rich media events to include.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+    },
+    "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+    "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+    "name": "A String", # The name of the report.
+    "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+      "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+      "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+          # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+      "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+      "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+      "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+      "repeats": "A String", # The interval for which the report is repeated. Note:
+          # - "DAILY" also requires field "every" to be set.
+          # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+          # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+      "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+        "A String",
+      ],
+    },
+    "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+    "ownerProfileId": "A String", # The user profile id of the owner of this report.
+    "reachCriteria": { # The report criteria for a report of type "REACH".
+      "activities": { # Represents an activity group. # Activity group.
+        "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+        "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "metricNames": [ # List of names of floodlight activity metrics.
+          "A String",
+        ],
+      },
+      "dimensions": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+        "A String",
+      ],
+      "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+        "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+        "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+      },
+      "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+    },
+    "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+      "dimensions": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "customRichMediaEvents": [ # The list of custom rich media events to include.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "reportProperties": { # The properties of the report.
+        "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+        "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+        "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+      },
+    },
+    "fileName": "A String", # The filename used when generating report files for this report.
+    "delivery": { # The report's email delivery settings.
+      "message": "A String", # The message to be sent with each email.
+      "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+      "recipients": [ # The list of recipients to which to email the report.
+        { # Represents a recipient.
+          "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+          "deliveryType": "A String", # The delivery type for the recipient.
+          "email": "A String", # The email address of the recipient.
+        },
+      ],
+      "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+    },
+    "etag": "A String", # The eTag of this response for caching purposes.
+    "criteria": { # The report criteria for a report of type "STANDARD".
+      "activities": { # Represents an activity group. # Activity group.
+        "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+        "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "metricNames": [ # List of names of floodlight activity metrics.
+          "A String",
+        ],
+      },
+      "dimensions": [ # The list of standard dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range for which this report should be run.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+        "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+        "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+      },
+    },
+    "id": "A String", # The unique ID identifying this report resource.
+    "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+    "type": "A String", # The type of the report.
+    "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+      "breakdown": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+        "A String",
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+      "dimension": "A String", # The dimension option.
+    },
+    "accountId": "A String", # The account ID to which this report belongs.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Represents a response to the queryCompatibleFields method.
+    "kind": "dfareporting#compatibleFields", # The kind of resource this is, in this case dfareporting#compatibleFields.
+    "reachReportCompatibleFields": { # Represents fields that are compatible to be selected for a report of type "REACH". # Contains items that are compatible to be selected for a report of type "REACH".
+      "kind": "dfareporting#reachReportCompatibleFields", # The kind of resource this is, in this case dfareporting#reachReportCompatibleFields.
+      "dimensions": [ # Dimensions which are compatible to be selected in the "dimensions" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+      "reachByFrequencyMetrics": [ # Metrics which are compatible to be selected in the "reachByFrequencyMetricNames" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+      "pivotedActivityMetrics": [ # Metrics which are compatible to be selected as activity metrics to pivot on in the "activities" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+      "dimensionFilters": [ # Dimensions which are compatible to be selected in the "dimensionFilters" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+      "metrics": [ # Metrics which are compatible to be selected in the "metricNames" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+    },
+    "pathToConversionReportCompatibleFields": { # Represents fields that are compatible to be selected for a report of type "PATH_TO_CONVERSION". # Contains items that are compatible to be selected for a report of type "PATH_TO_CONVERSION".
+      "metrics": [ # Metrics which are compatible to be selected in the "metricNames" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+      "perInteractionDimensions": [ # Per-interaction dimensions which are compatible to be selected in the "perInteractionDimensions" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+      "kind": "dfareporting#pathToConversionReportCompatibleFields", # The kind of resource this is, in this case dfareporting#pathToConversionReportCompatibleFields.
+      "conversionDimensions": [ # Conversion dimensions which are compatible to be selected in the "conversionDimensions" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+      "customFloodlightVariables": [ # Custom floodlight variables which are compatible to be selected in the "customFloodlightVariables" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+    },
+    "crossDimensionReachReportCompatibleFields": { # Represents fields that are compatible to be selected for a report of type "CROSS_DIMENSION_REACH". # Contains items that are compatible to be selected for a report of type "CROSS_DIMENSION_REACH".
+      "breakdown": [ # Dimensions which are compatible to be selected in the "breakdown" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+      "metrics": [ # Metrics which are compatible to be selected in the "metricNames" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+      "kind": "dfareporting#crossDimensionReachReportCompatibleFields", # The kind of resource this is, in this case dfareporting#crossDimensionReachReportCompatibleFields.
+      "overlapMetrics": [ # Metrics which are compatible to be selected in the "overlapMetricNames" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+      "dimensionFilters": [ # Dimensions which are compatible to be selected in the "dimensionFilters" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+    },
+    "floodlightReportCompatibleFields": { # Represents fields that are compatible to be selected for a report of type "FlOODLIGHT". # Contains items that are compatible to be selected for a report of type "FLOODLIGHT".
+      "metrics": [ # Metrics which are compatible to be selected in the "metricNames" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+      "kind": "dfareporting#floodlightReportCompatibleFields", # The kind of resource this is, in this case dfareporting#floodlightReportCompatibleFields.
+      "dimensionFilters": [ # Dimensions which are compatible to be selected in the "dimensionFilters" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+      "dimensions": [ # Dimensions which are compatible to be selected in the "dimensions" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+    },
+    "reportCompatibleFields": { # Represents fields that are compatible to be selected for a report of type "STANDARD". # Contains items that are compatible to be selected for a report of type "STANDARD".
+      "metrics": [ # Metrics which are compatible to be selected in the "metricNames" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+      "kind": "dfareporting#reportCompatibleFields", # The kind of resource this is, in this case dfareporting#reportCompatibleFields.
+      "pivotedActivityMetrics": [ # Metrics which are compatible to be selected as activity metrics to pivot on in the "activities" section of the report.
+        { # Represents a metric.
+          "kind": "dfareporting#metric", # The kind of resource this is, in this case dfareporting#metric.
+          "name": "A String", # The metric name, e.g. dfa:impressions
+        },
+      ],
+      "dimensionFilters": [ # Dimensions which are compatible to be selected in the "dimensionFilters" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+      "dimensions": [ # Dimensions which are compatible to be selected in the "dimensions" section of the report.
+        { # Represents a dimension.
+          "kind": "dfareporting#dimension", # The kind of resource this is, in this case dfareporting#dimension.
+          "name": "A String", # The dimension name, e.g. dfa:advertiser
+        },
+      ],
+    },
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.reports.files.html b/docs/dyn/dfareporting_v2_7.reports.files.html
new file mode 100644
index 00000000000..6c8e4f0230d
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.reports.files.html
@@ -0,0 +1,203 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.reports.html">reports</a> . <a href="dfareporting_v2_7.reports.files.html">files</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, reportId, fileId)</a></code></p>
+<p class="firstline">Retrieves a report file.</p>
+<p class="toc_element">
+  <code><a href="#get_media">get_media(profileId, reportId, fileId)</a></code></p>
+<p class="firstline">Retrieves a report file.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, reportId, pageToken=None, sortField=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Lists files for a report.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, reportId, fileId)</code>
+  <pre>Retrieves a report file.
+
+Args:
+  profileId: string, The DFA profile ID. (required)
+  reportId: string, The ID of the report. (required)
+  fileId: string, The ID of the report file. (required)
+
+Returns:
+  An object of the form:
+
+    { # Represents a File resource. A file contains the metadata for a report run. It shows the status of the run and holds the URLs to the generated report data if the run is finished and the status is "REPORT_AVAILABLE".
+    "status": "A String", # The status of the report file.
+    "kind": "dfareporting#file", # The kind of resource this is, in this case dfareporting#file.
+    "format": "A String", # The output format of the report. Only available once the file is available.
+    "dateRange": { # Represents a date range. # The date range for which the file has report data. The date range will always be the absolute date range for which the report is run.
+      "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+      "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+      "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+      "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+    },
+    "fileName": "A String", # The filename of the file.
+    "etag": "A String", # The eTag of this response for caching purposes.
+    "reportId": "A String", # The ID of the report this file was generated from.
+    "urls": { # The URLs where the completed report file can be downloaded.
+      "browserUrl": "A String", # The URL for downloading the report data through a browser.
+      "apiUrl": "A String", # The URL for downloading the report data through the API.
+    },
+    "lastModifiedTime": "A String", # The timestamp in milliseconds since epoch when this file was last modified.
+    "id": "A String", # The unique ID of this report file.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get_media">get_media(profileId, reportId, fileId)</code>
+  <pre>Retrieves a report file.
+
+Args:
+  profileId: string, The DFA profile ID. (required)
+  reportId: string, The ID of the report. (required)
+  fileId: string, The ID of the report file. (required)
+
+Returns:
+  The media object as a string.
+
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, reportId, pageToken=None, sortField=None, maxResults=None, sortOrder=None)</code>
+  <pre>Lists files for a report.
+
+Args:
+  profileId: string, The DFA profile ID. (required)
+  reportId: string, The ID of the parent report. (required)
+  pageToken: string, The value of the nextToken from the previous result page.
+  sortField: string, The field by which to sort the list.
+    Allowed values
+      ID - Sort by file ID.
+      LAST_MODIFIED_TIME - Sort by 'lastmodifiedAt' field.
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is 'DESCENDING'.
+    Allowed values
+      ASCENDING - Ascending order.
+      DESCENDING - Descending order.
+
+Returns:
+  An object of the form:
+
+    { # Represents the list of File resources.
+    "nextPageToken": "A String", # Continuation token used to page through files. To retrieve the next page of results, set the next request's "pageToken" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted.
+    "items": [ # The files returned in this response.
+      { # Represents a File resource. A file contains the metadata for a report run. It shows the status of the run and holds the URLs to the generated report data if the run is finished and the status is "REPORT_AVAILABLE".
+        "status": "A String", # The status of the report file.
+        "kind": "dfareporting#file", # The kind of resource this is, in this case dfareporting#file.
+        "format": "A String", # The output format of the report. Only available once the file is available.
+        "dateRange": { # Represents a date range. # The date range for which the file has report data. The date range will always be the absolute date range for which the report is run.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "fileName": "A String", # The filename of the file.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "reportId": "A String", # The ID of the report this file was generated from.
+        "urls": { # The URLs where the completed report file can be downloaded.
+          "browserUrl": "A String", # The URL for downloading the report data through a browser.
+          "apiUrl": "A String", # The URL for downloading the report data through the API.
+        },
+        "lastModifiedTime": "A String", # The timestamp in milliseconds since epoch when this file was last modified.
+        "id": "A String", # The unique ID of this report file.
+      },
+    ],
+    "kind": "dfareporting#fileList", # The kind of list this is, in this case dfareporting#fileList.
+    "etag": "A String", # The eTag of this response for caching purposes.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.reports.html b/docs/dyn/dfareporting_v2_7.reports.html
new file mode 100644
index 00000000000..8ac050cbe00
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.reports.html
@@ -0,0 +1,2795 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.reports.html">reports</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.reports.compatibleFields.html">compatibleFields()</a></code>
+</p>
+<p class="firstline">Returns the compatibleFields Resource.</p>
+
+<p class="toc_element">
+  <code><a href="dfareporting_v2_7.reports.files.html">files()</a></code>
+</p>
+<p class="firstline">Returns the files Resource.</p>
+
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, reportId)</a></code></p>
+<p class="firstline">Deletes a report by its ID.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, reportId)</a></code></p>
+<p class="firstline">Retrieves a report by its ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Creates a report.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, pageToken=None, maxResults=None, sortOrder=None, sortField=None, scope=None)</a></code></p>
+<p class="firstline">Retrieves list of reports.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, reportId, body)</a></code></p>
+<p class="firstline">Updates a report. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#run">run(profileId, reportId, synchronous=None)</a></code></p>
+<p class="firstline">Runs a report.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, reportId, body)</a></code></p>
+<p class="firstline">Updates a report.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, reportId)</code>
+  <pre>Deletes a report by its ID.
+
+Args:
+  profileId: string, The DFA user profile ID. (required)
+  reportId: string, The ID of the report. (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, reportId)</code>
+  <pre>Retrieves a report by its ID.
+
+Args:
+  profileId: string, The DFA user profile ID. (required)
+  reportId: string, The ID of the report. (required)
+
+Returns:
+  An object of the form:
+
+    { # Represents a Report resource.
+      "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+        "conversionDimensions": [ # The list of conversion dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "reportProperties": { # The properties of the report.
+          "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+          "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+          "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+          "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+          "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+          "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+          "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+          "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+          "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+        },
+        "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "customRichMediaEvents": [ # The list of custom rich media events to include.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+      },
+      "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+      "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+      "name": "A String", # The name of the report.
+      "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+        "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+        "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+            # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+        "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+        "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+        "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+        "repeats": "A String", # The interval for which the report is repeated. Note:
+            # - "DAILY" also requires field "every" to be set.
+            # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+            # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+        "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+          "A String",
+        ],
+      },
+      "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+      "ownerProfileId": "A String", # The user profile id of the owner of this report.
+      "reachCriteria": { # The report criteria for a report of type "REACH".
+        "activities": { # Represents an activity group. # Activity group.
+          "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+          "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+          "metricNames": [ # List of names of floodlight activity metrics.
+            "A String",
+          ],
+        },
+        "dimensions": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+          "A String",
+        ],
+        "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+          "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+          "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+        },
+        "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+      },
+      "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+        "dimensions": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "customRichMediaEvents": [ # The list of custom rich media events to include.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "reportProperties": { # The properties of the report.
+          "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+          "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+          "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+        },
+      },
+      "fileName": "A String", # The filename used when generating report files for this report.
+      "delivery": { # The report's email delivery settings.
+        "message": "A String", # The message to be sent with each email.
+        "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+        "recipients": [ # The list of recipients to which to email the report.
+          { # Represents a recipient.
+            "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+            "deliveryType": "A String", # The delivery type for the recipient.
+            "email": "A String", # The email address of the recipient.
+          },
+        ],
+        "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+      },
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "criteria": { # The report criteria for a report of type "STANDARD".
+        "activities": { # Represents an activity group. # Activity group.
+          "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+          "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+          "metricNames": [ # List of names of floodlight activity metrics.
+            "A String",
+          ],
+        },
+        "dimensions": [ # The list of standard dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range for which this report should be run.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+          "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+          "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+        },
+      },
+      "id": "A String", # The unique ID identifying this report resource.
+      "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+      "type": "A String", # The type of the report.
+      "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+        "breakdown": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+          "A String",
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+        "dimension": "A String", # The dimension option.
+      },
+      "accountId": "A String", # The account ID to which this report belongs.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Creates a report.
+
+Args:
+  profileId: string, The DFA user profile ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents a Report resource.
+    "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+      "conversionDimensions": [ # The list of conversion dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "reportProperties": { # The properties of the report.
+        "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+        "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+        "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+        "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+        "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+        "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+        "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+        "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+        "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+      },
+      "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "customRichMediaEvents": [ # The list of custom rich media events to include.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+    },
+    "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+    "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+    "name": "A String", # The name of the report.
+    "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+      "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+      "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+          # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+      "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+      "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+      "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+      "repeats": "A String", # The interval for which the report is repeated. Note:
+          # - "DAILY" also requires field "every" to be set.
+          # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+          # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+      "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+        "A String",
+      ],
+    },
+    "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+    "ownerProfileId": "A String", # The user profile id of the owner of this report.
+    "reachCriteria": { # The report criteria for a report of type "REACH".
+      "activities": { # Represents an activity group. # Activity group.
+        "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+        "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "metricNames": [ # List of names of floodlight activity metrics.
+          "A String",
+        ],
+      },
+      "dimensions": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+        "A String",
+      ],
+      "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+        "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+        "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+      },
+      "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+    },
+    "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+      "dimensions": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "customRichMediaEvents": [ # The list of custom rich media events to include.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "reportProperties": { # The properties of the report.
+        "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+        "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+        "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+      },
+    },
+    "fileName": "A String", # The filename used when generating report files for this report.
+    "delivery": { # The report's email delivery settings.
+      "message": "A String", # The message to be sent with each email.
+      "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+      "recipients": [ # The list of recipients to which to email the report.
+        { # Represents a recipient.
+          "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+          "deliveryType": "A String", # The delivery type for the recipient.
+          "email": "A String", # The email address of the recipient.
+        },
+      ],
+      "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+    },
+    "etag": "A String", # The eTag of this response for caching purposes.
+    "criteria": { # The report criteria for a report of type "STANDARD".
+      "activities": { # Represents an activity group. # Activity group.
+        "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+        "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "metricNames": [ # List of names of floodlight activity metrics.
+          "A String",
+        ],
+      },
+      "dimensions": [ # The list of standard dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range for which this report should be run.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+        "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+        "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+      },
+    },
+    "id": "A String", # The unique ID identifying this report resource.
+    "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+    "type": "A String", # The type of the report.
+    "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+      "breakdown": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+        "A String",
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+      "dimension": "A String", # The dimension option.
+    },
+    "accountId": "A String", # The account ID to which this report belongs.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Represents a Report resource.
+      "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+        "conversionDimensions": [ # The list of conversion dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "reportProperties": { # The properties of the report.
+          "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+          "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+          "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+          "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+          "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+          "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+          "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+          "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+          "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+        },
+        "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "customRichMediaEvents": [ # The list of custom rich media events to include.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+      },
+      "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+      "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+      "name": "A String", # The name of the report.
+      "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+        "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+        "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+            # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+        "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+        "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+        "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+        "repeats": "A String", # The interval for which the report is repeated. Note:
+            # - "DAILY" also requires field "every" to be set.
+            # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+            # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+        "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+          "A String",
+        ],
+      },
+      "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+      "ownerProfileId": "A String", # The user profile id of the owner of this report.
+      "reachCriteria": { # The report criteria for a report of type "REACH".
+        "activities": { # Represents an activity group. # Activity group.
+          "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+          "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+          "metricNames": [ # List of names of floodlight activity metrics.
+            "A String",
+          ],
+        },
+        "dimensions": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+          "A String",
+        ],
+        "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+          "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+          "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+        },
+        "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+      },
+      "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+        "dimensions": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "customRichMediaEvents": [ # The list of custom rich media events to include.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "reportProperties": { # The properties of the report.
+          "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+          "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+          "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+        },
+      },
+      "fileName": "A String", # The filename used when generating report files for this report.
+      "delivery": { # The report's email delivery settings.
+        "message": "A String", # The message to be sent with each email.
+        "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+        "recipients": [ # The list of recipients to which to email the report.
+          { # Represents a recipient.
+            "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+            "deliveryType": "A String", # The delivery type for the recipient.
+            "email": "A String", # The email address of the recipient.
+          },
+        ],
+        "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+      },
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "criteria": { # The report criteria for a report of type "STANDARD".
+        "activities": { # Represents an activity group. # Activity group.
+          "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+          "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+          "metricNames": [ # List of names of floodlight activity metrics.
+            "A String",
+          ],
+        },
+        "dimensions": [ # The list of standard dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range for which this report should be run.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+          "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+          "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+        },
+      },
+      "id": "A String", # The unique ID identifying this report resource.
+      "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+      "type": "A String", # The type of the report.
+      "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+        "breakdown": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+          "A String",
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+        "dimension": "A String", # The dimension option.
+      },
+      "accountId": "A String", # The account ID to which this report belongs.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, pageToken=None, maxResults=None, sortOrder=None, sortField=None, scope=None)</code>
+  <pre>Retrieves list of reports.
+
+Args:
+  profileId: string, The DFA user profile ID. (required)
+  pageToken: string, The value of the nextToken from the previous result page.
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is 'DESCENDING'.
+    Allowed values
+      ASCENDING - Ascending order.
+      DESCENDING - Descending order.
+  sortField: string, The field by which to sort the list.
+    Allowed values
+      ID - Sort by report ID.
+      LAST_MODIFIED_TIME - Sort by 'lastModifiedTime' field.
+      NAME - Sort by name of reports.
+  scope: string, The scope that defines which results are returned, default is 'MINE'.
+    Allowed values
+      ALL - All reports in account.
+      MINE - My reports.
+
+Returns:
+  An object of the form:
+
+    { # Represents the list of reports.
+    "nextPageToken": "A String", # Continuation token used to page through reports. To retrieve the next page of results, set the next request's "pageToken" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted.
+    "items": [ # The reports returned in this response.
+      { # Represents a Report resource.
+          "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+            "conversionDimensions": [ # The list of conversion dimensions the report should include.
+              { # Represents a sorted dimension.
+                "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+                "name": "A String", # The name of the dimension.
+                "sortOrder": "A String", # An optional sort order for the dimension column.
+              },
+            ],
+            "metricNames": [ # The list of names of metrics the report should include.
+              "A String",
+            ],
+            "dateRange": { # Represents a date range. # The date range this report should be run for.
+              "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+              "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+            },
+            "reportProperties": { # The properties of the report.
+              "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+              "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+              "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+              "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+              "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+              "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+              "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+              "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+              "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+            },
+            "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+              { # Represents a sorted dimension.
+                "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+                "name": "A String", # The name of the dimension.
+                "sortOrder": "A String", # An optional sort order for the dimension column.
+              },
+            ],
+            "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+              { # Represents a DimensionValue resource.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+            ],
+            "customRichMediaEvents": [ # The list of custom rich media events to include.
+              { # Represents a DimensionValue resource.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+            ],
+            "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+              { # Represents a sorted dimension.
+                "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+                "name": "A String", # The name of the dimension.
+                "sortOrder": "A String", # An optional sort order for the dimension column.
+              },
+            ],
+          },
+          "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+          "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+          "name": "A String", # The name of the report.
+          "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+            "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+            "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+                # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+            "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+            "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+            "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+            "repeats": "A String", # The interval for which the report is repeated. Note:
+                # - "DAILY" also requires field "every" to be set.
+                # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+                # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+            "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+              "A String",
+            ],
+          },
+          "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+          "ownerProfileId": "A String", # The user profile id of the owner of this report.
+          "reachCriteria": { # The report criteria for a report of type "REACH".
+            "activities": { # Represents an activity group. # Activity group.
+              "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+              "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+                { # Represents a DimensionValue resource.
+                  "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                  "value": "A String", # The value of the dimension.
+                  "dimensionName": "A String", # The name of the dimension.
+                  "etag": "A String", # The eTag of this response for caching purposes.
+                  "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                  "id": "A String", # The ID associated with the value if available.
+                },
+              ],
+              "metricNames": [ # List of names of floodlight activity metrics.
+                "A String",
+              ],
+            },
+            "dimensions": [ # The list of dimensions the report should include.
+              { # Represents a sorted dimension.
+                "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+                "name": "A String", # The name of the dimension.
+                "sortOrder": "A String", # An optional sort order for the dimension column.
+              },
+            ],
+            "metricNames": [ # The list of names of metrics the report should include.
+              "A String",
+            ],
+            "dateRange": { # Represents a date range. # The date range this report should be run for.
+              "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+              "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+            },
+            "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+                # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+              { # Represents a DimensionValue resource.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+            ],
+            "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+              "A String",
+            ],
+            "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+              "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+              "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+                { # Represents a DimensionValue resource.
+                  "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                  "value": "A String", # The value of the dimension.
+                  "dimensionName": "A String", # The name of the dimension.
+                  "etag": "A String", # The eTag of this response for caching purposes.
+                  "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                  "id": "A String", # The ID associated with the value if available.
+                },
+              ],
+            },
+            "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+          },
+          "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+            "dimensions": [ # The list of dimensions the report should include.
+              { # Represents a sorted dimension.
+                "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+                "name": "A String", # The name of the dimension.
+                "sortOrder": "A String", # An optional sort order for the dimension column.
+              },
+            ],
+            "metricNames": [ # The list of names of metrics the report should include.
+              "A String",
+            ],
+            "dateRange": { # Represents a date range. # The date range this report should be run for.
+              "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+              "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+            },
+            "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+                # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+              { # Represents a DimensionValue resource.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+            ],
+            "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+            "customRichMediaEvents": [ # The list of custom rich media events to include.
+              { # Represents a DimensionValue resource.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+            ],
+            "reportProperties": { # The properties of the report.
+              "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+              "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+              "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+            },
+          },
+          "fileName": "A String", # The filename used when generating report files for this report.
+          "delivery": { # The report's email delivery settings.
+            "message": "A String", # The message to be sent with each email.
+            "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+            "recipients": [ # The list of recipients to which to email the report.
+              { # Represents a recipient.
+                "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+                "deliveryType": "A String", # The delivery type for the recipient.
+                "email": "A String", # The email address of the recipient.
+              },
+            ],
+            "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+          },
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "criteria": { # The report criteria for a report of type "STANDARD".
+            "activities": { # Represents an activity group. # Activity group.
+              "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+              "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+                { # Represents a DimensionValue resource.
+                  "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                  "value": "A String", # The value of the dimension.
+                  "dimensionName": "A String", # The name of the dimension.
+                  "etag": "A String", # The eTag of this response for caching purposes.
+                  "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                  "id": "A String", # The ID associated with the value if available.
+                },
+              ],
+              "metricNames": [ # List of names of floodlight activity metrics.
+                "A String",
+              ],
+            },
+            "dimensions": [ # The list of standard dimensions the report should include.
+              { # Represents a sorted dimension.
+                "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+                "name": "A String", # The name of the dimension.
+                "sortOrder": "A String", # An optional sort order for the dimension column.
+              },
+            ],
+            "metricNames": [ # The list of names of metrics the report should include.
+              "A String",
+            ],
+            "dateRange": { # Represents a date range. # The date range for which this report should be run.
+              "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+              "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+            },
+            "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+                # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+              { # Represents a DimensionValue resource.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+            ],
+            "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+              "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+              "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+                { # Represents a DimensionValue resource.
+                  "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                  "value": "A String", # The value of the dimension.
+                  "dimensionName": "A String", # The name of the dimension.
+                  "etag": "A String", # The eTag of this response for caching purposes.
+                  "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                  "id": "A String", # The ID associated with the value if available.
+                },
+              ],
+            },
+          },
+          "id": "A String", # The unique ID identifying this report resource.
+          "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+          "type": "A String", # The type of the report.
+          "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+            "breakdown": [ # The list of dimensions the report should include.
+              { # Represents a sorted dimension.
+                "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+                "name": "A String", # The name of the dimension.
+                "sortOrder": "A String", # An optional sort order for the dimension column.
+              },
+            ],
+            "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+              "A String",
+            ],
+            "metricNames": [ # The list of names of metrics the report should include.
+              "A String",
+            ],
+            "dateRange": { # Represents a date range. # The date range this report should be run for.
+              "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+              "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+              "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+            },
+            "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+              { # Represents a DimensionValue resource.
+                "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+                "value": "A String", # The value of the dimension.
+                "dimensionName": "A String", # The name of the dimension.
+                "etag": "A String", # The eTag of this response for caching purposes.
+                "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+                "id": "A String", # The ID associated with the value if available.
+              },
+            ],
+            "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+            "dimension": "A String", # The dimension option.
+          },
+          "accountId": "A String", # The account ID to which this report belongs.
+        },
+    ],
+    "kind": "dfareporting#reportList", # The kind of list this is, in this case dfareporting#reportList.
+    "etag": "A String", # The eTag of this response for caching purposes.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, reportId, body)</code>
+  <pre>Updates a report. This method supports patch semantics.
+
+Args:
+  profileId: string, The DFA user profile ID. (required)
+  reportId: string, The ID of the report. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents a Report resource.
+    "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+      "conversionDimensions": [ # The list of conversion dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "reportProperties": { # The properties of the report.
+        "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+        "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+        "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+        "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+        "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+        "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+        "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+        "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+        "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+      },
+      "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "customRichMediaEvents": [ # The list of custom rich media events to include.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+    },
+    "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+    "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+    "name": "A String", # The name of the report.
+    "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+      "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+      "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+          # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+      "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+      "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+      "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+      "repeats": "A String", # The interval for which the report is repeated. Note:
+          # - "DAILY" also requires field "every" to be set.
+          # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+          # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+      "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+        "A String",
+      ],
+    },
+    "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+    "ownerProfileId": "A String", # The user profile id of the owner of this report.
+    "reachCriteria": { # The report criteria for a report of type "REACH".
+      "activities": { # Represents an activity group. # Activity group.
+        "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+        "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "metricNames": [ # List of names of floodlight activity metrics.
+          "A String",
+        ],
+      },
+      "dimensions": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+        "A String",
+      ],
+      "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+        "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+        "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+      },
+      "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+    },
+    "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+      "dimensions": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "customRichMediaEvents": [ # The list of custom rich media events to include.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "reportProperties": { # The properties of the report.
+        "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+        "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+        "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+      },
+    },
+    "fileName": "A String", # The filename used when generating report files for this report.
+    "delivery": { # The report's email delivery settings.
+      "message": "A String", # The message to be sent with each email.
+      "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+      "recipients": [ # The list of recipients to which to email the report.
+        { # Represents a recipient.
+          "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+          "deliveryType": "A String", # The delivery type for the recipient.
+          "email": "A String", # The email address of the recipient.
+        },
+      ],
+      "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+    },
+    "etag": "A String", # The eTag of this response for caching purposes.
+    "criteria": { # The report criteria for a report of type "STANDARD".
+      "activities": { # Represents an activity group. # Activity group.
+        "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+        "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "metricNames": [ # List of names of floodlight activity metrics.
+          "A String",
+        ],
+      },
+      "dimensions": [ # The list of standard dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range for which this report should be run.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+        "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+        "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+      },
+    },
+    "id": "A String", # The unique ID identifying this report resource.
+    "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+    "type": "A String", # The type of the report.
+    "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+      "breakdown": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+        "A String",
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+      "dimension": "A String", # The dimension option.
+    },
+    "accountId": "A String", # The account ID to which this report belongs.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Represents a Report resource.
+      "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+        "conversionDimensions": [ # The list of conversion dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "reportProperties": { # The properties of the report.
+          "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+          "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+          "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+          "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+          "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+          "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+          "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+          "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+          "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+        },
+        "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "customRichMediaEvents": [ # The list of custom rich media events to include.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+      },
+      "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+      "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+      "name": "A String", # The name of the report.
+      "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+        "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+        "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+            # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+        "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+        "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+        "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+        "repeats": "A String", # The interval for which the report is repeated. Note:
+            # - "DAILY" also requires field "every" to be set.
+            # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+            # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+        "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+          "A String",
+        ],
+      },
+      "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+      "ownerProfileId": "A String", # The user profile id of the owner of this report.
+      "reachCriteria": { # The report criteria for a report of type "REACH".
+        "activities": { # Represents an activity group. # Activity group.
+          "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+          "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+          "metricNames": [ # List of names of floodlight activity metrics.
+            "A String",
+          ],
+        },
+        "dimensions": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+          "A String",
+        ],
+        "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+          "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+          "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+        },
+        "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+      },
+      "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+        "dimensions": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "customRichMediaEvents": [ # The list of custom rich media events to include.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "reportProperties": { # The properties of the report.
+          "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+          "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+          "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+        },
+      },
+      "fileName": "A String", # The filename used when generating report files for this report.
+      "delivery": { # The report's email delivery settings.
+        "message": "A String", # The message to be sent with each email.
+        "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+        "recipients": [ # The list of recipients to which to email the report.
+          { # Represents a recipient.
+            "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+            "deliveryType": "A String", # The delivery type for the recipient.
+            "email": "A String", # The email address of the recipient.
+          },
+        ],
+        "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+      },
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "criteria": { # The report criteria for a report of type "STANDARD".
+        "activities": { # Represents an activity group. # Activity group.
+          "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+          "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+          "metricNames": [ # List of names of floodlight activity metrics.
+            "A String",
+          ],
+        },
+        "dimensions": [ # The list of standard dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range for which this report should be run.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+          "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+          "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+        },
+      },
+      "id": "A String", # The unique ID identifying this report resource.
+      "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+      "type": "A String", # The type of the report.
+      "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+        "breakdown": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+          "A String",
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+        "dimension": "A String", # The dimension option.
+      },
+      "accountId": "A String", # The account ID to which this report belongs.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="run">run(profileId, reportId, synchronous=None)</code>
+  <pre>Runs a report.
+
+Args:
+  profileId: string, The DFA profile ID. (required)
+  reportId: string, The ID of the report. (required)
+  synchronous: boolean, If set and true, tries to run the report synchronously.
+
+Returns:
+  An object of the form:
+
+    { # Represents a File resource. A file contains the metadata for a report run. It shows the status of the run and holds the URLs to the generated report data if the run is finished and the status is "REPORT_AVAILABLE".
+    "status": "A String", # The status of the report file.
+    "kind": "dfareporting#file", # The kind of resource this is, in this case dfareporting#file.
+    "format": "A String", # The output format of the report. Only available once the file is available.
+    "dateRange": { # Represents a date range. # The date range for which the file has report data. The date range will always be the absolute date range for which the report is run.
+      "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+      "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+      "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+      "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+    },
+    "fileName": "A String", # The filename of the file.
+    "etag": "A String", # The eTag of this response for caching purposes.
+    "reportId": "A String", # The ID of the report this file was generated from.
+    "urls": { # The URLs where the completed report file can be downloaded.
+      "browserUrl": "A String", # The URL for downloading the report data through a browser.
+      "apiUrl": "A String", # The URL for downloading the report data through the API.
+    },
+    "lastModifiedTime": "A String", # The timestamp in milliseconds since epoch when this file was last modified.
+    "id": "A String", # The unique ID of this report file.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, reportId, body)</code>
+  <pre>Updates a report.
+
+Args:
+  profileId: string, The DFA user profile ID. (required)
+  reportId: string, The ID of the report. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents a Report resource.
+    "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+      "conversionDimensions": [ # The list of conversion dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "reportProperties": { # The properties of the report.
+        "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+        "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+        "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+        "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+        "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+        "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+        "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+        "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+        "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+      },
+      "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "customRichMediaEvents": [ # The list of custom rich media events to include.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+    },
+    "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+    "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+    "name": "A String", # The name of the report.
+    "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+      "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+      "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+          # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+      "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+      "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+      "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+      "repeats": "A String", # The interval for which the report is repeated. Note:
+          # - "DAILY" also requires field "every" to be set.
+          # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+          # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+      "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+        "A String",
+      ],
+    },
+    "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+    "ownerProfileId": "A String", # The user profile id of the owner of this report.
+    "reachCriteria": { # The report criteria for a report of type "REACH".
+      "activities": { # Represents an activity group. # Activity group.
+        "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+        "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "metricNames": [ # List of names of floodlight activity metrics.
+          "A String",
+        ],
+      },
+      "dimensions": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+        "A String",
+      ],
+      "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+        "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+        "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+      },
+      "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+    },
+    "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+      "dimensions": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "customRichMediaEvents": [ # The list of custom rich media events to include.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "reportProperties": { # The properties of the report.
+        "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+        "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+        "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+      },
+    },
+    "fileName": "A String", # The filename used when generating report files for this report.
+    "delivery": { # The report's email delivery settings.
+      "message": "A String", # The message to be sent with each email.
+      "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+      "recipients": [ # The list of recipients to which to email the report.
+        { # Represents a recipient.
+          "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+          "deliveryType": "A String", # The delivery type for the recipient.
+          "email": "A String", # The email address of the recipient.
+        },
+      ],
+      "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+    },
+    "etag": "A String", # The eTag of this response for caching purposes.
+    "criteria": { # The report criteria for a report of type "STANDARD".
+      "activities": { # Represents an activity group. # Activity group.
+        "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+        "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "metricNames": [ # List of names of floodlight activity metrics.
+          "A String",
+        ],
+      },
+      "dimensions": [ # The list of standard dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range for which this report should be run.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+        "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+        "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+      },
+    },
+    "id": "A String", # The unique ID identifying this report resource.
+    "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+    "type": "A String", # The type of the report.
+    "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+      "breakdown": [ # The list of dimensions the report should include.
+        { # Represents a sorted dimension.
+          "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+          "name": "A String", # The name of the dimension.
+          "sortOrder": "A String", # An optional sort order for the dimension column.
+        },
+      ],
+      "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+        "A String",
+      ],
+      "metricNames": [ # The list of names of metrics the report should include.
+        "A String",
+      ],
+      "dateRange": { # Represents a date range. # The date range this report should be run for.
+        "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+        "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+        "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+      },
+      "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+        { # Represents a DimensionValue resource.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+      ],
+      "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+      "dimension": "A String", # The dimension option.
+    },
+    "accountId": "A String", # The account ID to which this report belongs.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Represents a Report resource.
+      "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION".
+        "conversionDimensions": [ # The list of conversion dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "reportProperties": { # The properties of the report.
+          "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+          "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path.
+          "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.
+          "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+          "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+          "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90.
+          "includeAttributedIPConversions": True or False, # Deprecated: has no effect.
+          "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+          "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.
+        },
+        "perInteractionDimensions": [ # The list of per interaction dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "activityFilters": [ # The list of 'dfa:activity' values to filter on.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "customRichMediaEvents": [ # The list of custom rich media events to include.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "customFloodlightVariables": [ # The list of custom floodlight variables the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+      },
+      "kind": "dfareporting#report", # The kind of resource this is, in this case dfareporting#report.
+      "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable.
+      "name": "A String", # The name of the report.
+      "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY".
+        "startDate": "A String", # Start date of date range for which scheduled reports should be run.
+        "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month.
+            # Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month.
+        "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY".
+        "expirationDate": "A String", # The expiration date when the scheduled report stops running.
+        "active": True or False, # Whether the schedule is active or not. Must be set to either true or false.
+        "repeats": "A String", # The interval for which the report is repeated. Note:
+            # - "DAILY" also requires field "every" to be set.
+            # - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set.
+            # - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set.
+        "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run.
+          "A String",
+        ],
+      },
+      "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format.
+      "ownerProfileId": "A String", # The user profile id of the owner of this report.
+      "reachCriteria": { # The report criteria for a report of type "REACH".
+        "activities": { # Represents an activity group. # Activity group.
+          "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+          "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+          "metricNames": [ # List of names of floodlight activity metrics.
+            "A String",
+          ],
+        },
+        "dimensions": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "reachByFrequencyMetricNames": [ # The list of names of  Reach By Frequency metrics the report should include.
+          "A String",
+        ],
+        "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+          "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+          "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+        },
+        "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last three months.
+      },
+      "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT".
+        "dimensions": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "customRichMediaEvents": [ # The list of custom rich media events to include.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "reportProperties": { # The properties of the report.
+          "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.
+          "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.
+          "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path.
+        },
+      },
+      "fileName": "A String", # The filename used when generating report files for this report.
+      "delivery": { # The report's email delivery settings.
+        "message": "A String", # The message to be sent with each email.
+        "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled.
+        "recipients": [ # The list of recipients to which to email the report.
+          { # Represents a recipient.
+            "kind": "dfareporting#recipient", # The kind of resource this is, in this case dfareporting#recipient.
+            "deliveryType": "A String", # The delivery type for the recipient.
+            "email": "A String", # The email address of the recipient.
+          },
+        ],
+        "emailOwner": True or False, # Whether the report should be emailed to the report owner.
+      },
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "criteria": { # The report criteria for a report of type "STANDARD".
+        "activities": { # Represents an activity group. # Activity group.
+          "kind": "dfareporting#activities", # The kind of resource this is, in this case dfareporting#activities.
+          "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup".
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+          "metricNames": [ # List of names of floodlight activity metrics.
+            "A String",
+          ],
+        },
+        "dimensions": [ # The list of standard dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range for which this report should be run.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+            # Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group.
+          "kind": "dfareporting#customRichMediaEvents", # The kind of resource this is, in this case dfareporting#customRichMediaEvents.
+          "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.
+            { # Represents a DimensionValue resource.
+              "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+              "value": "A String", # The value of the dimension.
+              "dimensionName": "A String", # The name of the dimension.
+              "etag": "A String", # The eTag of this response for caching purposes.
+              "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+              "id": "A String", # The ID associated with the value if available.
+            },
+          ],
+        },
+      },
+      "id": "A String", # The unique ID identifying this report resource.
+      "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified.
+      "type": "A String", # The type of the report.
+      "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH".
+        "breakdown": [ # The list of dimensions the report should include.
+          { # Represents a sorted dimension.
+            "kind": "dfareporting#sortedDimension", # The kind of resource this is, in this case dfareporting#sortedDimension.
+            "name": "A String", # The name of the dimension.
+            "sortOrder": "A String", # An optional sort order for the dimension column.
+          },
+        ],
+        "overlapMetricNames": [ # The list of names of overlap metrics the report should include.
+          "A String",
+        ],
+        "metricNames": [ # The list of names of metrics the report should include.
+          "A String",
+        ],
+        "dateRange": { # Represents a date range. # The date range this report should be run for.
+          "startDate": "A String", # The start date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "kind": "dfareporting#dateRange", # The kind of resource this is, in this case dfareporting#dateRange.
+          "endDate": "A String", # The end date of the date range, inclusive. A string of the format: "yyyy-MM-dd".
+          "relativeDateRange": "A String", # The date range relative to the date of when the report is run.
+        },
+        "dimensionFilters": [ # The list of filters on which dimensions are filtered.
+          { # Represents a DimensionValue resource.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+        ],
+        "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true.
+        "dimension": "A String", # The dimension option.
+      },
+      "accountId": "A String", # The account ID to which this report belongs.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.sites.html b/docs/dyn/dfareporting_v2_7.sites.html
new file mode 100644
index 00000000000..4912582badf
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.sites.html
@@ -0,0 +1,683 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.sites.html">sites</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one site by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new site.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, unmappedSite=None, campaignIds=None, acceptsInStreamVideoPlacements=None, pageToken=None, acceptsPublisherPaidPlacements=None, sortOrder=None, acceptsInterstitialPlacements=None, maxResults=None, adWordsSite=None, approved=None, searchString=None, subaccountId=None, directorySiteIds=None, sortField=None, ids=None)</a></code></p>
+<p class="firstline">Retrieves a list of sites, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing site. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing site.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one site by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Site ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a site.
+      "kind": "dfareporting#site", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#site".
+      "subaccountId": "A String", # Subaccount ID of this site. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteSettings": { # Site Settings # Site-wide settings.
+        "disableBrandSafeAds": True or False, # Whether brand safe ads are disabled for this site.
+        "activeViewOptOut": True or False, # Whether active view creatives are disabled for this site.
+        "videoActiveViewOptOutTemplate": True or False, # Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.
+        "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this site.
+          "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        },
+        "disableNewCookie": True or False, # Whether new cookies are disabled for this site.
+        "tagSetting": { # Tag Settings # Configuration settings for dynamic and image floodlight tags.
+          "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+          "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+          "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+          "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+        },
+        "vpaidAdapterChoiceTemplate": "A String", # Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter, and Flash VPAID creatives use the Flash adapter).
+        "creativeSettings": { # Creative Settings # Site-wide creative settings.
+          "iFrameHeader": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+          "iFrameFooter": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+        },
+      },
+      "approved": True or False, # Whether this site is approved.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteContacts": [ # Site contacts.
+        { # Site Contact
+          "firstName": "A String", # First name of this site contact.
+          "title": "A String", # Title or designation of this site contact.
+          "lastName": "A String", # Last name of this site contact.
+          "address": "A String", # Address of this site contact.
+          "email": "A String", # Email address of this site contact. This is a required field.
+          "phone": "A String", # Primary phone number of this site contact.
+          "contactType": "A String", # Site contact type.
+          "id": "A String", # ID of this site contact. This is a read-only, auto-generated field.
+        },
+      ],
+      "keyName": "A String", # Key name of this site. This is a read-only, auto-generated field.
+      "directorySiteId": "A String", # Directory site associated with this site. This is a required field that is read-only after insertion.
+      "id": "A String", # ID of this site. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this site. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new site.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a site.
+    "kind": "dfareporting#site", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#site".
+    "subaccountId": "A String", # Subaccount ID of this site. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteSettings": { # Site Settings # Site-wide settings.
+      "disableBrandSafeAds": True or False, # Whether brand safe ads are disabled for this site.
+      "activeViewOptOut": True or False, # Whether active view creatives are disabled for this site.
+      "videoActiveViewOptOutTemplate": True or False, # Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this site.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "disableNewCookie": True or False, # Whether new cookies are disabled for this site.
+      "tagSetting": { # Tag Settings # Configuration settings for dynamic and image floodlight tags.
+        "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+        "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+        "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+        "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+      },
+      "vpaidAdapterChoiceTemplate": "A String", # Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter, and Flash VPAID creatives use the Flash adapter).
+      "creativeSettings": { # Creative Settings # Site-wide creative settings.
+        "iFrameHeader": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+        "iFrameFooter": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+      },
+    },
+    "approved": True or False, # Whether this site is approved.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteContacts": [ # Site contacts.
+      { # Site Contact
+        "firstName": "A String", # First name of this site contact.
+        "title": "A String", # Title or designation of this site contact.
+        "lastName": "A String", # Last name of this site contact.
+        "address": "A String", # Address of this site contact.
+        "email": "A String", # Email address of this site contact. This is a required field.
+        "phone": "A String", # Primary phone number of this site contact.
+        "contactType": "A String", # Site contact type.
+        "id": "A String", # ID of this site contact. This is a read-only, auto-generated field.
+      },
+    ],
+    "keyName": "A String", # Key name of this site. This is a read-only, auto-generated field.
+    "directorySiteId": "A String", # Directory site associated with this site. This is a required field that is read-only after insertion.
+    "id": "A String", # ID of this site. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this site. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a site.
+      "kind": "dfareporting#site", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#site".
+      "subaccountId": "A String", # Subaccount ID of this site. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteSettings": { # Site Settings # Site-wide settings.
+        "disableBrandSafeAds": True or False, # Whether brand safe ads are disabled for this site.
+        "activeViewOptOut": True or False, # Whether active view creatives are disabled for this site.
+        "videoActiveViewOptOutTemplate": True or False, # Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.
+        "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this site.
+          "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        },
+        "disableNewCookie": True or False, # Whether new cookies are disabled for this site.
+        "tagSetting": { # Tag Settings # Configuration settings for dynamic and image floodlight tags.
+          "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+          "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+          "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+          "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+        },
+        "vpaidAdapterChoiceTemplate": "A String", # Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter, and Flash VPAID creatives use the Flash adapter).
+        "creativeSettings": { # Creative Settings # Site-wide creative settings.
+          "iFrameHeader": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+          "iFrameFooter": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+        },
+      },
+      "approved": True or False, # Whether this site is approved.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteContacts": [ # Site contacts.
+        { # Site Contact
+          "firstName": "A String", # First name of this site contact.
+          "title": "A String", # Title or designation of this site contact.
+          "lastName": "A String", # Last name of this site contact.
+          "address": "A String", # Address of this site contact.
+          "email": "A String", # Email address of this site contact. This is a required field.
+          "phone": "A String", # Primary phone number of this site contact.
+          "contactType": "A String", # Site contact type.
+          "id": "A String", # ID of this site contact. This is a read-only, auto-generated field.
+        },
+      ],
+      "keyName": "A String", # Key name of this site. This is a read-only, auto-generated field.
+      "directorySiteId": "A String", # Directory site associated with this site. This is a required field that is read-only after insertion.
+      "id": "A String", # ID of this site. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this site. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, unmappedSite=None, campaignIds=None, acceptsInStreamVideoPlacements=None, pageToken=None, acceptsPublisherPaidPlacements=None, sortOrder=None, acceptsInterstitialPlacements=None, maxResults=None, adWordsSite=None, approved=None, searchString=None, subaccountId=None, directorySiteIds=None, sortField=None, ids=None)</code>
+  <pre>Retrieves a list of sites, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  unmappedSite: boolean, Select only sites that have not been mapped to a directory site.
+  campaignIds: string, Select only sites with these campaign IDs. (repeated)
+  acceptsInStreamVideoPlacements: boolean, This search filter is no longer supported and will have no effect on the results returned.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  acceptsPublisherPaidPlacements: boolean, Select only sites that accept publisher paid placements.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  acceptsInterstitialPlacements: boolean, This search filter is no longer supported and will have no effect on the results returned.
+  maxResults: integer, Maximum number of results to return.
+  adWordsSite: boolean, Select only AdWords sites.
+  approved: boolean, Select only approved sites.
+  searchString: string, Allows searching for objects by name, ID or keyName. Wildcards (*) are allowed. For example, "site*2015" will return objects with names like "site June 2015", "site April 2015", or simply "site 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "site" will match objects with name "my site", "site 2015", or simply "site".
+  subaccountId: string, Select only sites with this subaccount ID.
+  directorySiteIds: string, Select only sites with these directory site IDs. (repeated)
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only sites with these IDs. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Site List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#sitesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#sitesListResponse".
+    "sites": [ # Site collection.
+      { # Contains properties of a site.
+          "kind": "dfareporting#site", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#site".
+          "subaccountId": "A String", # Subaccount ID of this site. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account.
+          "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "siteSettings": { # Site Settings # Site-wide settings.
+            "disableBrandSafeAds": True or False, # Whether brand safe ads are disabled for this site.
+            "activeViewOptOut": True or False, # Whether active view creatives are disabled for this site.
+            "videoActiveViewOptOutTemplate": True or False, # Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.
+            "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this site.
+              "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+              "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+            },
+            "disableNewCookie": True or False, # Whether new cookies are disabled for this site.
+            "tagSetting": { # Tag Settings # Configuration settings for dynamic and image floodlight tags.
+              "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+              "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+              "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+              "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+            },
+            "vpaidAdapterChoiceTemplate": "A String", # Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter, and Flash VPAID creatives use the Flash adapter).
+            "creativeSettings": { # Creative Settings # Site-wide creative settings.
+              "iFrameHeader": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+              "iFrameFooter": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+            },
+          },
+          "approved": True or False, # Whether this site is approved.
+          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this site. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "siteContacts": [ # Site contacts.
+            { # Site Contact
+              "firstName": "A String", # First name of this site contact.
+              "title": "A String", # Title or designation of this site contact.
+              "lastName": "A String", # Last name of this site contact.
+              "address": "A String", # Address of this site contact.
+              "email": "A String", # Email address of this site contact. This is a required field.
+              "phone": "A String", # Primary phone number of this site contact.
+              "contactType": "A String", # Site contact type.
+              "id": "A String", # ID of this site contact. This is a read-only, auto-generated field.
+            },
+          ],
+          "keyName": "A String", # Key name of this site. This is a read-only, auto-generated field.
+          "directorySiteId": "A String", # Directory site associated with this site. This is a required field that is read-only after insertion.
+          "id": "A String", # ID of this site. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this site. This is a read-only field that can be left blank.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing site. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Site ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a site.
+    "kind": "dfareporting#site", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#site".
+    "subaccountId": "A String", # Subaccount ID of this site. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteSettings": { # Site Settings # Site-wide settings.
+      "disableBrandSafeAds": True or False, # Whether brand safe ads are disabled for this site.
+      "activeViewOptOut": True or False, # Whether active view creatives are disabled for this site.
+      "videoActiveViewOptOutTemplate": True or False, # Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this site.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "disableNewCookie": True or False, # Whether new cookies are disabled for this site.
+      "tagSetting": { # Tag Settings # Configuration settings for dynamic and image floodlight tags.
+        "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+        "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+        "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+        "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+      },
+      "vpaidAdapterChoiceTemplate": "A String", # Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter, and Flash VPAID creatives use the Flash adapter).
+      "creativeSettings": { # Creative Settings # Site-wide creative settings.
+        "iFrameHeader": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+        "iFrameFooter": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+      },
+    },
+    "approved": True or False, # Whether this site is approved.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteContacts": [ # Site contacts.
+      { # Site Contact
+        "firstName": "A String", # First name of this site contact.
+        "title": "A String", # Title or designation of this site contact.
+        "lastName": "A String", # Last name of this site contact.
+        "address": "A String", # Address of this site contact.
+        "email": "A String", # Email address of this site contact. This is a required field.
+        "phone": "A String", # Primary phone number of this site contact.
+        "contactType": "A String", # Site contact type.
+        "id": "A String", # ID of this site contact. This is a read-only, auto-generated field.
+      },
+    ],
+    "keyName": "A String", # Key name of this site. This is a read-only, auto-generated field.
+    "directorySiteId": "A String", # Directory site associated with this site. This is a required field that is read-only after insertion.
+    "id": "A String", # ID of this site. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this site. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a site.
+      "kind": "dfareporting#site", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#site".
+      "subaccountId": "A String", # Subaccount ID of this site. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteSettings": { # Site Settings # Site-wide settings.
+        "disableBrandSafeAds": True or False, # Whether brand safe ads are disabled for this site.
+        "activeViewOptOut": True or False, # Whether active view creatives are disabled for this site.
+        "videoActiveViewOptOutTemplate": True or False, # Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.
+        "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this site.
+          "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        },
+        "disableNewCookie": True or False, # Whether new cookies are disabled for this site.
+        "tagSetting": { # Tag Settings # Configuration settings for dynamic and image floodlight tags.
+          "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+          "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+          "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+          "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+        },
+        "vpaidAdapterChoiceTemplate": "A String", # Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter, and Flash VPAID creatives use the Flash adapter).
+        "creativeSettings": { # Creative Settings # Site-wide creative settings.
+          "iFrameHeader": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+          "iFrameFooter": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+        },
+      },
+      "approved": True or False, # Whether this site is approved.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteContacts": [ # Site contacts.
+        { # Site Contact
+          "firstName": "A String", # First name of this site contact.
+          "title": "A String", # Title or designation of this site contact.
+          "lastName": "A String", # Last name of this site contact.
+          "address": "A String", # Address of this site contact.
+          "email": "A String", # Email address of this site contact. This is a required field.
+          "phone": "A String", # Primary phone number of this site contact.
+          "contactType": "A String", # Site contact type.
+          "id": "A String", # ID of this site contact. This is a read-only, auto-generated field.
+        },
+      ],
+      "keyName": "A String", # Key name of this site. This is a read-only, auto-generated field.
+      "directorySiteId": "A String", # Directory site associated with this site. This is a required field that is read-only after insertion.
+      "id": "A String", # ID of this site. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this site. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing site.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a site.
+    "kind": "dfareporting#site", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#site".
+    "subaccountId": "A String", # Subaccount ID of this site. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account.
+    "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteSettings": { # Site Settings # Site-wide settings.
+      "disableBrandSafeAds": True or False, # Whether brand safe ads are disabled for this site.
+      "activeViewOptOut": True or False, # Whether active view creatives are disabled for this site.
+      "videoActiveViewOptOutTemplate": True or False, # Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.
+      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this site.
+        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+      },
+      "disableNewCookie": True or False, # Whether new cookies are disabled for this site.
+      "tagSetting": { # Tag Settings # Configuration settings for dynamic and image floodlight tags.
+        "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+        "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+        "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+        "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+      },
+      "vpaidAdapterChoiceTemplate": "A String", # Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter, and Flash VPAID creatives use the Flash adapter).
+      "creativeSettings": { # Creative Settings # Site-wide creative settings.
+        "iFrameHeader": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+        "iFrameFooter": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+      },
+    },
+    "approved": True or False, # Whether this site is approved.
+    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this site. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "siteContacts": [ # Site contacts.
+      { # Site Contact
+        "firstName": "A String", # First name of this site contact.
+        "title": "A String", # Title or designation of this site contact.
+        "lastName": "A String", # Last name of this site contact.
+        "address": "A String", # Address of this site contact.
+        "email": "A String", # Email address of this site contact. This is a required field.
+        "phone": "A String", # Primary phone number of this site contact.
+        "contactType": "A String", # Site contact type.
+        "id": "A String", # ID of this site contact. This is a read-only, auto-generated field.
+      },
+    ],
+    "keyName": "A String", # Key name of this site. This is a read-only, auto-generated field.
+    "directorySiteId": "A String", # Directory site associated with this site. This is a required field that is read-only after insertion.
+    "id": "A String", # ID of this site. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this site. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a site.
+      "kind": "dfareporting#site", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#site".
+      "subaccountId": "A String", # Subaccount ID of this site. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account.
+      "directorySiteIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteSettings": { # Site Settings # Site-wide settings.
+        "disableBrandSafeAds": True or False, # Whether brand safe ads are disabled for this site.
+        "activeViewOptOut": True or False, # Whether active view creatives are disabled for this site.
+        "videoActiveViewOptOutTemplate": True or False, # Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.
+        "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this site.
+          "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+          "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used.
+        },
+        "disableNewCookie": True or False, # Whether new cookies are disabled for this site.
+        "tagSetting": { # Tag Settings # Configuration settings for dynamic and image floodlight tags.
+          "includeClickThroughUrls": True or False, # Whether static landing page URLs should be included in the tags. This setting applies only to placements.
+          "includeClickTracking": True or False, # Whether click-tracking string should be included in the tags.
+          "additionalKeyValues": "A String", # Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field.
+          "keywordOption": "A String", # Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.
+        },
+        "vpaidAdapterChoiceTemplate": "A String", # Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter, and Flash VPAID creatives use the Flash adapter).
+        "creativeSettings": { # Creative Settings # Site-wide creative settings.
+          "iFrameHeader": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+          "iFrameFooter": "A String", # Header text for iFrames for this site. Must be less than or equal to 2000 characters long.
+        },
+      },
+      "approved": True or False, # Whether this site is approved.
+      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this site. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "siteContacts": [ # Site contacts.
+        { # Site Contact
+          "firstName": "A String", # First name of this site contact.
+          "title": "A String", # Title or designation of this site contact.
+          "lastName": "A String", # Last name of this site contact.
+          "address": "A String", # Address of this site contact.
+          "email": "A String", # Email address of this site contact. This is a required field.
+          "phone": "A String", # Primary phone number of this site contact.
+          "contactType": "A String", # Site contact type.
+          "id": "A String", # ID of this site contact. This is a read-only, auto-generated field.
+        },
+      ],
+      "keyName": "A String", # Key name of this site. This is a read-only, auto-generated field.
+      "directorySiteId": "A String", # Directory site associated with this site. This is a required field that is read-only after insertion.
+      "id": "A String", # ID of this site. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this site. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.sizes.html b/docs/dyn/dfareporting_v2_7.sizes.html
new file mode 100644
index 00000000000..f2122aacffe
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.sizes.html
@@ -0,0 +1,165 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.sizes.html">sizes</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one size by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new size.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, iabStandard=None, width=None, ids=None, height=None)</a></code></p>
+<p class="firstline">Retrieves a list of sizes, possibly filtered.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one size by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Size ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Represents the dimensions of ads, placements, creatives, or creative assets.
+    "width": 42, # Width of this size.
+    "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+    "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+    "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+    "height": 42, # Height of this size.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new size.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Represents the dimensions of ads, placements, creatives, or creative assets.
+  "width": 42, # Width of this size.
+  "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+  "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+  "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+  "height": 42, # Height of this size.
+}
+
+
+Returns:
+  An object of the form:
+
+    { # Represents the dimensions of ads, placements, creatives, or creative assets.
+    "width": 42, # Width of this size.
+    "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+    "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+    "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+    "height": 42, # Height of this size.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, iabStandard=None, width=None, ids=None, height=None)</code>
+  <pre>Retrieves a list of sizes, possibly filtered.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  iabStandard: boolean, Select only IAB standard sizes.
+  width: integer, Select only sizes with this width.
+  ids: string, Select only sizes with these IDs. (repeated)
+  height: integer, Select only sizes with this height.
+
+Returns:
+  An object of the form:
+
+    { # Size List Response
+    "kind": "dfareporting#sizesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#sizesListResponse".
+    "sizes": [ # Size collection.
+      { # Represents the dimensions of ads, placements, creatives, or creative assets.
+        "width": 42, # Width of this size.
+        "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+        "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+        "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+        "height": 42, # Height of this size.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.subaccounts.html b/docs/dyn/dfareporting_v2_7.subaccounts.html
new file mode 100644
index 00000000000..aea098b4350
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.subaccounts.html
@@ -0,0 +1,274 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.subaccounts.html">subaccounts</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one subaccount by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new subaccount.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Gets a list of subaccounts, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing subaccount. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing subaccount.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one subaccount by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Subaccount ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM subaccount.
+      "kind": "dfareporting#subaccount", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccount".
+      "availablePermissionIds": [ # IDs of the available user role permissions for this subaccount.
+        "A String",
+      ],
+      "id": "A String", # ID of this subaccount. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account.
+      "accountId": "A String", # ID of the account that contains this subaccount. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new subaccount.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM subaccount.
+    "kind": "dfareporting#subaccount", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccount".
+    "availablePermissionIds": [ # IDs of the available user role permissions for this subaccount.
+      "A String",
+    ],
+    "id": "A String", # ID of this subaccount. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account.
+    "accountId": "A String", # ID of the account that contains this subaccount. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM subaccount.
+      "kind": "dfareporting#subaccount", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccount".
+      "availablePermissionIds": [ # IDs of the available user role permissions for this subaccount.
+        "A String",
+      ],
+      "id": "A String", # ID of this subaccount. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account.
+      "accountId": "A String", # ID of the account that contains this subaccount. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
+  <pre>Gets a list of subaccounts, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "subaccount*2015" will return objects with names like "subaccount June 2015", "subaccount April 2015", or simply "subaccount 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "subaccount" will match objects with name "my subaccount", "subaccount 2015", or simply "subaccount".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only subaccounts with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Subaccount List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#subaccountsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccountsListResponse".
+    "subaccounts": [ # Subaccount collection.
+      { # Contains properties of a DCM subaccount.
+          "kind": "dfareporting#subaccount", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccount".
+          "availablePermissionIds": [ # IDs of the available user role permissions for this subaccount.
+            "A String",
+          ],
+          "id": "A String", # ID of this subaccount. This is a read-only, auto-generated field.
+          "name": "A String", # Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account.
+          "accountId": "A String", # ID of the account that contains this subaccount. This is a read-only field that can be left blank.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing subaccount. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Subaccount ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM subaccount.
+    "kind": "dfareporting#subaccount", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccount".
+    "availablePermissionIds": [ # IDs of the available user role permissions for this subaccount.
+      "A String",
+    ],
+    "id": "A String", # ID of this subaccount. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account.
+    "accountId": "A String", # ID of the account that contains this subaccount. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM subaccount.
+      "kind": "dfareporting#subaccount", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccount".
+      "availablePermissionIds": [ # IDs of the available user role permissions for this subaccount.
+        "A String",
+      ],
+      "id": "A String", # ID of this subaccount. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account.
+      "accountId": "A String", # ID of the account that contains this subaccount. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing subaccount.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a DCM subaccount.
+    "kind": "dfareporting#subaccount", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccount".
+    "availablePermissionIds": [ # IDs of the available user role permissions for this subaccount.
+      "A String",
+    ],
+    "id": "A String", # ID of this subaccount. This is a read-only, auto-generated field.
+    "name": "A String", # Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account.
+    "accountId": "A String", # ID of the account that contains this subaccount. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a DCM subaccount.
+      "kind": "dfareporting#subaccount", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#subaccount".
+      "availablePermissionIds": [ # IDs of the available user role permissions for this subaccount.
+        "A String",
+      ],
+      "id": "A String", # ID of this subaccount. This is a read-only, auto-generated field.
+      "name": "A String", # Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account.
+      "accountId": "A String", # ID of the account that contains this subaccount. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.targetableRemarketingLists.html b/docs/dyn/dfareporting_v2_7.targetableRemarketingLists.html
new file mode 100644
index 00000000000..09066608c68
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.targetableRemarketingLists.html
@@ -0,0 +1,187 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.targetableRemarketingLists.html">targetableRemarketingLists</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one remarketing list by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, maxResults=None, active=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one remarketing list by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Remarketing list ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a targetable remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource is a read-only view of a remarketing list to be used to faciliate targeting ads to specific lists. Remarketing lists that are owned by your advertisers and those that are shared to your advertisers or account are accessible via this resource. To manage remarketing lists that are owned by your advertisers, use the RemarketingLists resource.
+    "kind": "dfareporting#targetableRemarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetableRemarketingList".
+    "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+    "description": "A String", # Targetable remarketing list description.
+    "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+    "lifeSpan": "A String", # Number of days that a user should remain in the targetable remarketing list without an impression.
+    "name": "A String", # Name of the targetable remarketing list. Is no greater than 128 characters long.
+    "advertiserId": "A String", # Dimension value for the advertiser ID that owns this targetable remarketing list.
+    "listSource": "A String", # Product from which this targetable remarketing list was originated.
+    "active": True or False, # Whether this targetable remarketing list is active.
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # Targetable remarketing list ID.
+    "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, advertiserId, name=None, pageToken=None, sortField=None, maxResults=None, active=None, sortOrder=None)</code>
+  <pre>Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  advertiserId: string, Select only targetable remarketing lists targetable by these advertisers. (required)
+  name: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "remarketing list*2015" will return objects with names like "remarketing list June 2015", "remarketing list April 2015", or simply "remarketing list 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "remarketing list" will match objects with name "my remarketing list", "remarketing list 2015", or simply "remarketing list".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  maxResults: integer, Maximum number of results to return.
+  active: boolean, Select only active or only inactive targetable remarketing lists.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Targetable remarketing list response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#targetableRemarketingListsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetableRemarketingListsListResponse".
+    "targetableRemarketingLists": [ # Targetable remarketing list collection.
+      { # Contains properties of a targetable remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource is a read-only view of a remarketing list to be used to faciliate targeting ads to specific lists. Remarketing lists that are owned by your advertisers and those that are shared to your advertisers or account are accessible via this resource. To manage remarketing lists that are owned by your advertisers, use the RemarketingLists resource.
+        "kind": "dfareporting#targetableRemarketingList", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetableRemarketingList".
+        "subaccountId": "A String", # Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+        "description": "A String", # Targetable remarketing list description.
+        "listSize": "A String", # Number of users currently in the list. This is a read-only field.
+        "lifeSpan": "A String", # Number of days that a user should remain in the targetable remarketing list without an impression.
+        "name": "A String", # Name of the targetable remarketing list. Is no greater than 128 characters long.
+        "advertiserId": "A String", # Dimension value for the advertiser ID that owns this targetable remarketing list.
+        "listSource": "A String", # Product from which this targetable remarketing list was originated.
+        "active": True or False, # Whether this targetable remarketing list is active.
+        "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser.
+          "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+          "value": "A String", # The value of the dimension.
+          "dimensionName": "A String", # The name of the dimension.
+          "etag": "A String", # The eTag of this response for caching purposes.
+          "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+          "id": "A String", # The ID associated with the value if available.
+        },
+        "id": "A String", # Targetable remarketing list ID.
+        "accountId": "A String", # Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.targetingTemplates.html b/docs/dyn/dfareporting_v2_7.targetingTemplates.html
new file mode 100644
index 00000000000..17fb5222043
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.targetingTemplates.html
@@ -0,0 +1,1523 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.targetingTemplates.html">targetingTemplates</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one targeting template by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new targeting template.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</a></code></p>
+<p class="firstline">Retrieves a list of targeting templates, optionally filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing targeting template. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing targeting template.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one targeting template by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Targeting template ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
+      "kind": "dfareporting#targetingTemplate", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplate".
+      "subaccountId": "A String", # Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+      "name": "A String", # Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
+      "dayPartTargeting": { # Day Part Targeting. # Time and day targeting criteria.
+        "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+        "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+          42,
+        ],
+        "daysOfWeek": [ # Days of the week when the ad will serve.
+            #
+            # Acceptable values are:
+            # - "SUNDAY"
+            # - "MONDAY"
+            # - "TUESDAY"
+            # - "WEDNESDAY"
+            # - "THURSDAY"
+            # - "FRIDAY"
+            # - "SATURDAY"
+          "A String",
+        ],
+      },
+      "technologyTargeting": { # Technology Targeting. # Technology platform targeting criteria.
+        "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a platform type that can be targeted by ads.
+            "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+            "id": "A String", # ID of this platform type.
+            "name": "A String", # Name of this platform type.
+          },
+        ],
+        "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+          { # Contains information about a particular version of an operating system that can be targeted by ads.
+            "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+            "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+            "name": "A String", # Name of this operating system version.
+            "id": "A String", # ID of this operating system version.
+            "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+              "mobile": True or False, # Whether this operating system is for mobile.
+              "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+              "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+              "name": "A String", # Name of this operating system.
+              "desktop": True or False, # Whether this operating system is for desktop.
+            },
+            "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+          },
+        ],
+        "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a browser that can be targeted by ads.
+            "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+            "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+            "name": "A String", # Name of this browser.
+            "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+            "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+            "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          },
+        ],
+        "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+          { # Contains information about an operating system that can be targeted by ads.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+        ],
+        "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+          { # Contains information about a mobile carrier that can be targeted by ads.
+            "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+            "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+            "id": "A String", # ID of this mobile carrier.
+            "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+            "name": "A String", # Name of this mobile carrier.
+          },
+        ],
+        "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+            "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+            "id": "A String", # ID of this connection type.
+            "name": "A String", # Name of this connection type.
+          },
+        ],
+      },
+      "listTargetingExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting criteria.
+        "expression": "A String", # Expression describing which lists are being targeted by the ad.
+      },
+      "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting criteria.
+        "expression": "A String", # Keyword expression being targeted by the ad.
+      },
+      "languageTargeting": { # Language Targeting. # Language targeting criteria.
+        "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a language that can be targeted by ads.
+            "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+            "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+            "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+            "name": "A String", # Name of this language.
+          },
+        ],
+      },
+      "advertiserId": "A String", # Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
+      "geoTargeting": { # Geographical Targeting. # Geographical targeting criteria.
+        "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+          { # Contains information about a country that can be targeted by ads.
+            "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+            "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+            "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+            "countryCode": "A String", # Country code.
+            "name": "A String", # Name of this country.
+          },
+        ],
+        "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+        "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+          { # Contains information about a postal code that can be targeted by ads.
+            "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+            "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+            "code": "A String", # Postal code. This is equivalent to the id field.
+            "id": "A String", # ID of this postal code.
+            "countryCode": "A String", # Country code of the country to which this postal code belongs.
+          },
+        ],
+        "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+          { # Contains information about a region that can be targeted by ads.
+            "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+            "countryDartId": "A String", # DART ID of the country to which this region belongs.
+            "name": "A String", # Name of this region.
+            "countryCode": "A String", # Country code of the country to which this region belongs.
+            "regionCode": "A String", # Region code.
+            "dartId": "A String", # DART ID of this region.
+          },
+        ],
+        "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+          { # Contains information about a city that can be targeted by ads.
+            "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+            "countryDartId": "A String", # DART ID of the country to which this city belongs.
+            "name": "A String", # Name of this city.
+            "countryCode": "A String", # Country code of the country to which this city belongs.
+            "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+            "regionCode": "A String", # Region code of the region to which this city belongs.
+            "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+            "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+            "regionDartId": "A String", # DART ID of the region to which this city belongs.
+          },
+        ],
+        "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+          { # Contains information about a metro region that can be targeted by ads.
+            "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+            "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+            "name": "A String", # Name of this metro region.
+            "countryCode": "A String", # Country code of the country to which this metro region belongs.
+            "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+            "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+            "dartId": "A String", # DART ID of this metro region.
+          },
+        ],
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this targeting template. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new targeting template.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
+    "kind": "dfareporting#targetingTemplate", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplate".
+    "subaccountId": "A String", # Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+    "name": "A String", # Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
+    "dayPartTargeting": { # Day Part Targeting. # Time and day targeting criteria.
+      "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+      "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+        42,
+      ],
+      "daysOfWeek": [ # Days of the week when the ad will serve.
+          #
+          # Acceptable values are:
+          # - "SUNDAY"
+          # - "MONDAY"
+          # - "TUESDAY"
+          # - "WEDNESDAY"
+          # - "THURSDAY"
+          # - "FRIDAY"
+          # - "SATURDAY"
+        "A String",
+      ],
+    },
+    "technologyTargeting": { # Technology Targeting. # Technology platform targeting criteria.
+      "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a platform type that can be targeted by ads.
+          "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+          "id": "A String", # ID of this platform type.
+          "name": "A String", # Name of this platform type.
+        },
+      ],
+      "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+        { # Contains information about a particular version of an operating system that can be targeted by ads.
+          "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+          "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+          "name": "A String", # Name of this operating system version.
+          "id": "A String", # ID of this operating system version.
+          "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+          "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+        },
+      ],
+      "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a browser that can be targeted by ads.
+          "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+          "name": "A String", # Name of this browser.
+          "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+          "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+          "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+        },
+      ],
+      "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+        { # Contains information about an operating system that can be targeted by ads.
+          "mobile": True or False, # Whether this operating system is for mobile.
+          "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+          "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+          "name": "A String", # Name of this operating system.
+          "desktop": True or False, # Whether this operating system is for desktop.
+        },
+      ],
+      "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+        { # Contains information about a mobile carrier that can be targeted by ads.
+          "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+          "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+          "id": "A String", # ID of this mobile carrier.
+          "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+          "name": "A String", # Name of this mobile carrier.
+        },
+      ],
+      "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+          "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+          "id": "A String", # ID of this connection type.
+          "name": "A String", # Name of this connection type.
+        },
+      ],
+    },
+    "listTargetingExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting criteria.
+      "expression": "A String", # Expression describing which lists are being targeted by the ad.
+    },
+    "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting criteria.
+      "expression": "A String", # Keyword expression being targeted by the ad.
+    },
+    "languageTargeting": { # Language Targeting. # Language targeting criteria.
+      "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a language that can be targeted by ads.
+          "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+          "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+          "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+          "name": "A String", # Name of this language.
+        },
+      ],
+    },
+    "advertiserId": "A String", # Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
+    "geoTargeting": { # Geographical Targeting. # Geographical targeting criteria.
+      "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+        { # Contains information about a country that can be targeted by ads.
+          "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+          "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+          "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+          "countryCode": "A String", # Country code.
+          "name": "A String", # Name of this country.
+        },
+      ],
+      "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+      "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+        { # Contains information about a postal code that can be targeted by ads.
+          "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+          "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+          "code": "A String", # Postal code. This is equivalent to the id field.
+          "id": "A String", # ID of this postal code.
+          "countryCode": "A String", # Country code of the country to which this postal code belongs.
+        },
+      ],
+      "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+        { # Contains information about a region that can be targeted by ads.
+          "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+          "countryDartId": "A String", # DART ID of the country to which this region belongs.
+          "name": "A String", # Name of this region.
+          "countryCode": "A String", # Country code of the country to which this region belongs.
+          "regionCode": "A String", # Region code.
+          "dartId": "A String", # DART ID of this region.
+        },
+      ],
+      "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+        { # Contains information about a city that can be targeted by ads.
+          "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+          "countryDartId": "A String", # DART ID of the country to which this city belongs.
+          "name": "A String", # Name of this city.
+          "countryCode": "A String", # Country code of the country to which this city belongs.
+          "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+          "regionCode": "A String", # Region code of the region to which this city belongs.
+          "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+          "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+          "regionDartId": "A String", # DART ID of the region to which this city belongs.
+        },
+      ],
+      "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+        { # Contains information about a metro region that can be targeted by ads.
+          "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+          "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+          "name": "A String", # Name of this metro region.
+          "countryCode": "A String", # Country code of the country to which this metro region belongs.
+          "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+          "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+          "dartId": "A String", # DART ID of this metro region.
+        },
+      ],
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this targeting template. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
+      "kind": "dfareporting#targetingTemplate", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplate".
+      "subaccountId": "A String", # Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+      "name": "A String", # Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
+      "dayPartTargeting": { # Day Part Targeting. # Time and day targeting criteria.
+        "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+        "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+          42,
+        ],
+        "daysOfWeek": [ # Days of the week when the ad will serve.
+            #
+            # Acceptable values are:
+            # - "SUNDAY"
+            # - "MONDAY"
+            # - "TUESDAY"
+            # - "WEDNESDAY"
+            # - "THURSDAY"
+            # - "FRIDAY"
+            # - "SATURDAY"
+          "A String",
+        ],
+      },
+      "technologyTargeting": { # Technology Targeting. # Technology platform targeting criteria.
+        "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a platform type that can be targeted by ads.
+            "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+            "id": "A String", # ID of this platform type.
+            "name": "A String", # Name of this platform type.
+          },
+        ],
+        "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+          { # Contains information about a particular version of an operating system that can be targeted by ads.
+            "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+            "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+            "name": "A String", # Name of this operating system version.
+            "id": "A String", # ID of this operating system version.
+            "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+              "mobile": True or False, # Whether this operating system is for mobile.
+              "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+              "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+              "name": "A String", # Name of this operating system.
+              "desktop": True or False, # Whether this operating system is for desktop.
+            },
+            "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+          },
+        ],
+        "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a browser that can be targeted by ads.
+            "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+            "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+            "name": "A String", # Name of this browser.
+            "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+            "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+            "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          },
+        ],
+        "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+          { # Contains information about an operating system that can be targeted by ads.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+        ],
+        "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+          { # Contains information about a mobile carrier that can be targeted by ads.
+            "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+            "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+            "id": "A String", # ID of this mobile carrier.
+            "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+            "name": "A String", # Name of this mobile carrier.
+          },
+        ],
+        "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+            "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+            "id": "A String", # ID of this connection type.
+            "name": "A String", # Name of this connection type.
+          },
+        ],
+      },
+      "listTargetingExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting criteria.
+        "expression": "A String", # Expression describing which lists are being targeted by the ad.
+      },
+      "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting criteria.
+        "expression": "A String", # Keyword expression being targeted by the ad.
+      },
+      "languageTargeting": { # Language Targeting. # Language targeting criteria.
+        "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a language that can be targeted by ads.
+            "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+            "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+            "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+            "name": "A String", # Name of this language.
+          },
+        ],
+      },
+      "advertiserId": "A String", # Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
+      "geoTargeting": { # Geographical Targeting. # Geographical targeting criteria.
+        "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+          { # Contains information about a country that can be targeted by ads.
+            "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+            "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+            "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+            "countryCode": "A String", # Country code.
+            "name": "A String", # Name of this country.
+          },
+        ],
+        "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+        "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+          { # Contains information about a postal code that can be targeted by ads.
+            "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+            "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+            "code": "A String", # Postal code. This is equivalent to the id field.
+            "id": "A String", # ID of this postal code.
+            "countryCode": "A String", # Country code of the country to which this postal code belongs.
+          },
+        ],
+        "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+          { # Contains information about a region that can be targeted by ads.
+            "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+            "countryDartId": "A String", # DART ID of the country to which this region belongs.
+            "name": "A String", # Name of this region.
+            "countryCode": "A String", # Country code of the country to which this region belongs.
+            "regionCode": "A String", # Region code.
+            "dartId": "A String", # DART ID of this region.
+          },
+        ],
+        "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+          { # Contains information about a city that can be targeted by ads.
+            "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+            "countryDartId": "A String", # DART ID of the country to which this city belongs.
+            "name": "A String", # Name of this city.
+            "countryCode": "A String", # Country code of the country to which this city belongs.
+            "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+            "regionCode": "A String", # Region code of the region to which this city belongs.
+            "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+            "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+            "regionDartId": "A String", # DART ID of the region to which this city belongs.
+          },
+        ],
+        "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+          { # Contains information about a metro region that can be targeted by ads.
+            "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+            "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+            "name": "A String", # Name of this metro region.
+            "countryCode": "A String", # Country code of the country to which this metro region belongs.
+            "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+            "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+            "dartId": "A String", # DART ID of this metro region.
+          },
+        ],
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this targeting template. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, advertiserId=None, searchString=None, pageToken=None, sortField=None, ids=None, maxResults=None, sortOrder=None)</code>
+  <pre>Retrieves a list of targeting templates, optionally filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  advertiserId: string, Select only targeting templates with this advertiser ID.
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "template*2015" will return objects with names like "template June 2015", "template April 2015", or simply "template 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "template" will match objects with name "my template", "template 2015", or simply "template".
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+  ids: string, Select only targeting templates with these IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+
+Returns:
+  An object of the form:
+
+    { # Targeting Template List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#targetingTemplatesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplatesListResponse".
+    "targetingTemplates": [ # Targeting template collection.
+      { # Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
+          "kind": "dfareporting#targetingTemplate", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplate".
+          "subaccountId": "A String", # Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+          "name": "A String", # Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
+          "dayPartTargeting": { # Day Part Targeting. # Time and day targeting criteria.
+            "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+            "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+              42,
+            ],
+            "daysOfWeek": [ # Days of the week when the ad will serve.
+                #
+                # Acceptable values are:
+                # - "SUNDAY"
+                # - "MONDAY"
+                # - "TUESDAY"
+                # - "WEDNESDAY"
+                # - "THURSDAY"
+                # - "FRIDAY"
+                # - "SATURDAY"
+              "A String",
+            ],
+          },
+          "technologyTargeting": { # Technology Targeting. # Technology platform targeting criteria.
+            "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+              { # Contains information about a platform type that can be targeted by ads.
+                "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+                "id": "A String", # ID of this platform type.
+                "name": "A String", # Name of this platform type.
+              },
+            ],
+            "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+              { # Contains information about a particular version of an operating system that can be targeted by ads.
+                "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+                "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+                "name": "A String", # Name of this operating system version.
+                "id": "A String", # ID of this operating system version.
+                "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+                  "mobile": True or False, # Whether this operating system is for mobile.
+                  "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+                  "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+                  "name": "A String", # Name of this operating system.
+                  "desktop": True or False, # Whether this operating system is for desktop.
+                },
+                "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+              },
+            ],
+            "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+              { # Contains information about a browser that can be targeted by ads.
+                "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+                "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+                "name": "A String", # Name of this browser.
+                "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+                "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+                "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+              },
+            ],
+            "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+              { # Contains information about an operating system that can be targeted by ads.
+                "mobile": True or False, # Whether this operating system is for mobile.
+                "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+                "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+                "name": "A String", # Name of this operating system.
+                "desktop": True or False, # Whether this operating system is for desktop.
+              },
+            ],
+            "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+              { # Contains information about a mobile carrier that can be targeted by ads.
+                "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+                "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+                "id": "A String", # ID of this mobile carrier.
+                "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+                "name": "A String", # Name of this mobile carrier.
+              },
+            ],
+            "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+              { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+                "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+                "id": "A String", # ID of this connection type.
+                "name": "A String", # Name of this connection type.
+              },
+            ],
+          },
+          "listTargetingExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting criteria.
+            "expression": "A String", # Expression describing which lists are being targeted by the ad.
+          },
+          "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting criteria.
+            "expression": "A String", # Keyword expression being targeted by the ad.
+          },
+          "languageTargeting": { # Language Targeting. # Language targeting criteria.
+            "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+              { # Contains information about a language that can be targeted by ads.
+                "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+                "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+                "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+                "name": "A String", # Name of this language.
+              },
+            ],
+          },
+          "advertiserId": "A String", # Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
+          "geoTargeting": { # Geographical Targeting. # Geographical targeting criteria.
+            "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+              { # Contains information about a country that can be targeted by ads.
+                "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+                "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+                "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+                "countryCode": "A String", # Country code.
+                "name": "A String", # Name of this country.
+              },
+            ],
+            "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+            "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+              { # Contains information about a postal code that can be targeted by ads.
+                "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+                "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+                "code": "A String", # Postal code. This is equivalent to the id field.
+                "id": "A String", # ID of this postal code.
+                "countryCode": "A String", # Country code of the country to which this postal code belongs.
+              },
+            ],
+            "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+              { # Contains information about a region that can be targeted by ads.
+                "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+                "countryDartId": "A String", # DART ID of the country to which this region belongs.
+                "name": "A String", # Name of this region.
+                "countryCode": "A String", # Country code of the country to which this region belongs.
+                "regionCode": "A String", # Region code.
+                "dartId": "A String", # DART ID of this region.
+              },
+            ],
+            "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+              { # Contains information about a city that can be targeted by ads.
+                "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+                "countryDartId": "A String", # DART ID of the country to which this city belongs.
+                "name": "A String", # Name of this city.
+                "countryCode": "A String", # Country code of the country to which this city belongs.
+                "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+                "regionCode": "A String", # Region code of the region to which this city belongs.
+                "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+                "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+                "regionDartId": "A String", # DART ID of the region to which this city belongs.
+              },
+            ],
+            "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+              { # Contains information about a metro region that can be targeted by ads.
+                "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+                "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+                "name": "A String", # Name of this metro region.
+                "countryCode": "A String", # Country code of the country to which this metro region belongs.
+                "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+                "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+                "dartId": "A String", # DART ID of this metro region.
+              },
+            ],
+          },
+          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+            "value": "A String", # The value of the dimension.
+            "dimensionName": "A String", # The name of the dimension.
+            "etag": "A String", # The eTag of this response for caching purposes.
+            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+            "id": "A String", # The ID associated with the value if available.
+          },
+          "id": "A String", # ID of this targeting template. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing targeting template. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, Targeting template ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
+    "kind": "dfareporting#targetingTemplate", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplate".
+    "subaccountId": "A String", # Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+    "name": "A String", # Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
+    "dayPartTargeting": { # Day Part Targeting. # Time and day targeting criteria.
+      "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+      "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+        42,
+      ],
+      "daysOfWeek": [ # Days of the week when the ad will serve.
+          #
+          # Acceptable values are:
+          # - "SUNDAY"
+          # - "MONDAY"
+          # - "TUESDAY"
+          # - "WEDNESDAY"
+          # - "THURSDAY"
+          # - "FRIDAY"
+          # - "SATURDAY"
+        "A String",
+      ],
+    },
+    "technologyTargeting": { # Technology Targeting. # Technology platform targeting criteria.
+      "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a platform type that can be targeted by ads.
+          "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+          "id": "A String", # ID of this platform type.
+          "name": "A String", # Name of this platform type.
+        },
+      ],
+      "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+        { # Contains information about a particular version of an operating system that can be targeted by ads.
+          "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+          "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+          "name": "A String", # Name of this operating system version.
+          "id": "A String", # ID of this operating system version.
+          "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+          "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+        },
+      ],
+      "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a browser that can be targeted by ads.
+          "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+          "name": "A String", # Name of this browser.
+          "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+          "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+          "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+        },
+      ],
+      "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+        { # Contains information about an operating system that can be targeted by ads.
+          "mobile": True or False, # Whether this operating system is for mobile.
+          "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+          "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+          "name": "A String", # Name of this operating system.
+          "desktop": True or False, # Whether this operating system is for desktop.
+        },
+      ],
+      "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+        { # Contains information about a mobile carrier that can be targeted by ads.
+          "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+          "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+          "id": "A String", # ID of this mobile carrier.
+          "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+          "name": "A String", # Name of this mobile carrier.
+        },
+      ],
+      "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+          "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+          "id": "A String", # ID of this connection type.
+          "name": "A String", # Name of this connection type.
+        },
+      ],
+    },
+    "listTargetingExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting criteria.
+      "expression": "A String", # Expression describing which lists are being targeted by the ad.
+    },
+    "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting criteria.
+      "expression": "A String", # Keyword expression being targeted by the ad.
+    },
+    "languageTargeting": { # Language Targeting. # Language targeting criteria.
+      "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a language that can be targeted by ads.
+          "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+          "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+          "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+          "name": "A String", # Name of this language.
+        },
+      ],
+    },
+    "advertiserId": "A String", # Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
+    "geoTargeting": { # Geographical Targeting. # Geographical targeting criteria.
+      "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+        { # Contains information about a country that can be targeted by ads.
+          "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+          "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+          "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+          "countryCode": "A String", # Country code.
+          "name": "A String", # Name of this country.
+        },
+      ],
+      "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+      "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+        { # Contains information about a postal code that can be targeted by ads.
+          "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+          "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+          "code": "A String", # Postal code. This is equivalent to the id field.
+          "id": "A String", # ID of this postal code.
+          "countryCode": "A String", # Country code of the country to which this postal code belongs.
+        },
+      ],
+      "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+        { # Contains information about a region that can be targeted by ads.
+          "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+          "countryDartId": "A String", # DART ID of the country to which this region belongs.
+          "name": "A String", # Name of this region.
+          "countryCode": "A String", # Country code of the country to which this region belongs.
+          "regionCode": "A String", # Region code.
+          "dartId": "A String", # DART ID of this region.
+        },
+      ],
+      "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+        { # Contains information about a city that can be targeted by ads.
+          "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+          "countryDartId": "A String", # DART ID of the country to which this city belongs.
+          "name": "A String", # Name of this city.
+          "countryCode": "A String", # Country code of the country to which this city belongs.
+          "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+          "regionCode": "A String", # Region code of the region to which this city belongs.
+          "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+          "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+          "regionDartId": "A String", # DART ID of the region to which this city belongs.
+        },
+      ],
+      "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+        { # Contains information about a metro region that can be targeted by ads.
+          "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+          "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+          "name": "A String", # Name of this metro region.
+          "countryCode": "A String", # Country code of the country to which this metro region belongs.
+          "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+          "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+          "dartId": "A String", # DART ID of this metro region.
+        },
+      ],
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this targeting template. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
+      "kind": "dfareporting#targetingTemplate", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplate".
+      "subaccountId": "A String", # Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+      "name": "A String", # Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
+      "dayPartTargeting": { # Day Part Targeting. # Time and day targeting criteria.
+        "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+        "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+          42,
+        ],
+        "daysOfWeek": [ # Days of the week when the ad will serve.
+            #
+            # Acceptable values are:
+            # - "SUNDAY"
+            # - "MONDAY"
+            # - "TUESDAY"
+            # - "WEDNESDAY"
+            # - "THURSDAY"
+            # - "FRIDAY"
+            # - "SATURDAY"
+          "A String",
+        ],
+      },
+      "technologyTargeting": { # Technology Targeting. # Technology platform targeting criteria.
+        "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a platform type that can be targeted by ads.
+            "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+            "id": "A String", # ID of this platform type.
+            "name": "A String", # Name of this platform type.
+          },
+        ],
+        "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+          { # Contains information about a particular version of an operating system that can be targeted by ads.
+            "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+            "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+            "name": "A String", # Name of this operating system version.
+            "id": "A String", # ID of this operating system version.
+            "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+              "mobile": True or False, # Whether this operating system is for mobile.
+              "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+              "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+              "name": "A String", # Name of this operating system.
+              "desktop": True or False, # Whether this operating system is for desktop.
+            },
+            "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+          },
+        ],
+        "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a browser that can be targeted by ads.
+            "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+            "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+            "name": "A String", # Name of this browser.
+            "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+            "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+            "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          },
+        ],
+        "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+          { # Contains information about an operating system that can be targeted by ads.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+        ],
+        "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+          { # Contains information about a mobile carrier that can be targeted by ads.
+            "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+            "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+            "id": "A String", # ID of this mobile carrier.
+            "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+            "name": "A String", # Name of this mobile carrier.
+          },
+        ],
+        "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+            "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+            "id": "A String", # ID of this connection type.
+            "name": "A String", # Name of this connection type.
+          },
+        ],
+      },
+      "listTargetingExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting criteria.
+        "expression": "A String", # Expression describing which lists are being targeted by the ad.
+      },
+      "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting criteria.
+        "expression": "A String", # Keyword expression being targeted by the ad.
+      },
+      "languageTargeting": { # Language Targeting. # Language targeting criteria.
+        "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a language that can be targeted by ads.
+            "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+            "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+            "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+            "name": "A String", # Name of this language.
+          },
+        ],
+      },
+      "advertiserId": "A String", # Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
+      "geoTargeting": { # Geographical Targeting. # Geographical targeting criteria.
+        "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+          { # Contains information about a country that can be targeted by ads.
+            "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+            "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+            "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+            "countryCode": "A String", # Country code.
+            "name": "A String", # Name of this country.
+          },
+        ],
+        "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+        "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+          { # Contains information about a postal code that can be targeted by ads.
+            "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+            "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+            "code": "A String", # Postal code. This is equivalent to the id field.
+            "id": "A String", # ID of this postal code.
+            "countryCode": "A String", # Country code of the country to which this postal code belongs.
+          },
+        ],
+        "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+          { # Contains information about a region that can be targeted by ads.
+            "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+            "countryDartId": "A String", # DART ID of the country to which this region belongs.
+            "name": "A String", # Name of this region.
+            "countryCode": "A String", # Country code of the country to which this region belongs.
+            "regionCode": "A String", # Region code.
+            "dartId": "A String", # DART ID of this region.
+          },
+        ],
+        "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+          { # Contains information about a city that can be targeted by ads.
+            "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+            "countryDartId": "A String", # DART ID of the country to which this city belongs.
+            "name": "A String", # Name of this city.
+            "countryCode": "A String", # Country code of the country to which this city belongs.
+            "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+            "regionCode": "A String", # Region code of the region to which this city belongs.
+            "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+            "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+            "regionDartId": "A String", # DART ID of the region to which this city belongs.
+          },
+        ],
+        "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+          { # Contains information about a metro region that can be targeted by ads.
+            "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+            "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+            "name": "A String", # Name of this metro region.
+            "countryCode": "A String", # Country code of the country to which this metro region belongs.
+            "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+            "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+            "dartId": "A String", # DART ID of this metro region.
+          },
+        ],
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this targeting template. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing targeting template.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
+    "kind": "dfareporting#targetingTemplate", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplate".
+    "subaccountId": "A String", # Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+    "name": "A String", # Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
+    "dayPartTargeting": { # Day Part Targeting. # Time and day targeting criteria.
+      "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+      "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+        42,
+      ],
+      "daysOfWeek": [ # Days of the week when the ad will serve.
+          #
+          # Acceptable values are:
+          # - "SUNDAY"
+          # - "MONDAY"
+          # - "TUESDAY"
+          # - "WEDNESDAY"
+          # - "THURSDAY"
+          # - "FRIDAY"
+          # - "SATURDAY"
+        "A String",
+      ],
+    },
+    "technologyTargeting": { # Technology Targeting. # Technology platform targeting criteria.
+      "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a platform type that can be targeted by ads.
+          "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+          "id": "A String", # ID of this platform type.
+          "name": "A String", # Name of this platform type.
+        },
+      ],
+      "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+        { # Contains information about a particular version of an operating system that can be targeted by ads.
+          "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+          "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+          "name": "A String", # Name of this operating system version.
+          "id": "A String", # ID of this operating system version.
+          "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+          "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+        },
+      ],
+      "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a browser that can be targeted by ads.
+          "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+          "name": "A String", # Name of this browser.
+          "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+          "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+          "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+        },
+      ],
+      "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+        { # Contains information about an operating system that can be targeted by ads.
+          "mobile": True or False, # Whether this operating system is for mobile.
+          "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+          "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+          "name": "A String", # Name of this operating system.
+          "desktop": True or False, # Whether this operating system is for desktop.
+        },
+      ],
+      "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+        { # Contains information about a mobile carrier that can be targeted by ads.
+          "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+          "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+          "id": "A String", # ID of this mobile carrier.
+          "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+          "name": "A String", # Name of this mobile carrier.
+        },
+      ],
+      "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+          "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+          "id": "A String", # ID of this connection type.
+          "name": "A String", # Name of this connection type.
+        },
+      ],
+    },
+    "listTargetingExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting criteria.
+      "expression": "A String", # Expression describing which lists are being targeted by the ad.
+    },
+    "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting criteria.
+      "expression": "A String", # Keyword expression being targeted by the ad.
+    },
+    "languageTargeting": { # Language Targeting. # Language targeting criteria.
+      "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+        { # Contains information about a language that can be targeted by ads.
+          "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+          "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+          "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+          "name": "A String", # Name of this language.
+        },
+      ],
+    },
+    "advertiserId": "A String", # Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
+    "geoTargeting": { # Geographical Targeting. # Geographical targeting criteria.
+      "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+        { # Contains information about a country that can be targeted by ads.
+          "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+          "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+          "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+          "countryCode": "A String", # Country code.
+          "name": "A String", # Name of this country.
+        },
+      ],
+      "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+      "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+        { # Contains information about a postal code that can be targeted by ads.
+          "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+          "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+          "code": "A String", # Postal code. This is equivalent to the id field.
+          "id": "A String", # ID of this postal code.
+          "countryCode": "A String", # Country code of the country to which this postal code belongs.
+        },
+      ],
+      "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+        { # Contains information about a region that can be targeted by ads.
+          "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+          "countryDartId": "A String", # DART ID of the country to which this region belongs.
+          "name": "A String", # Name of this region.
+          "countryCode": "A String", # Country code of the country to which this region belongs.
+          "regionCode": "A String", # Region code.
+          "dartId": "A String", # DART ID of this region.
+        },
+      ],
+      "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+        { # Contains information about a city that can be targeted by ads.
+          "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+          "countryDartId": "A String", # DART ID of the country to which this city belongs.
+          "name": "A String", # Name of this city.
+          "countryCode": "A String", # Country code of the country to which this city belongs.
+          "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+          "regionCode": "A String", # Region code of the region to which this city belongs.
+          "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+          "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+          "regionDartId": "A String", # DART ID of the region to which this city belongs.
+        },
+      ],
+      "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+        { # Contains information about a metro region that can be targeted by ads.
+          "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+          "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+          "name": "A String", # Name of this metro region.
+          "countryCode": "A String", # Country code of the country to which this metro region belongs.
+          "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+          "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+          "dartId": "A String", # DART ID of this metro region.
+        },
+      ],
+    },
+    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+      "value": "A String", # The value of the dimension.
+      "dimensionName": "A String", # The name of the dimension.
+      "etag": "A String", # The eTag of this response for caching purposes.
+      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+      "id": "A String", # The ID associated with the value if available.
+    },
+    "id": "A String", # ID of this targeting template. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
+      "kind": "dfareporting#targetingTemplate", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetingTemplate".
+      "subaccountId": "A String", # Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+      "name": "A String", # Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
+      "dayPartTargeting": { # Day Part Targeting. # Time and day targeting criteria.
+        "userLocalTime": True or False, # Whether or not to use the user's local time. If false, the America/New York time zone applies.
+        "hoursOfDay": [ # Hours of the day when the ad will serve. Must be an integer between 0 and 23 (inclusive), where 0 is midnight to 1 AM, and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example, if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm.
+          42,
+        ],
+        "daysOfWeek": [ # Days of the week when the ad will serve.
+            #
+            # Acceptable values are:
+            # - "SUNDAY"
+            # - "MONDAY"
+            # - "TUESDAY"
+            # - "WEDNESDAY"
+            # - "THURSDAY"
+            # - "FRIDAY"
+            # - "SATURDAY"
+          "A String",
+        ],
+      },
+      "technologyTargeting": { # Technology Targeting. # Technology platform targeting criteria.
+        "platformTypes": [ # Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a platform type that can be targeted by ads.
+            "kind": "dfareporting#platformType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#platformType".
+            "id": "A String", # ID of this platform type.
+            "name": "A String", # Name of this platform type.
+          },
+        ],
+        "operatingSystemVersions": [ # Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems.
+          { # Contains information about a particular version of an operating system that can be targeted by ads.
+            "majorVersion": "A String", # Major version (leftmost number) of this operating system version.
+            "kind": "dfareporting#operatingSystemVersion", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystemVersion".
+            "name": "A String", # Name of this operating system version.
+            "id": "A String", # ID of this operating system version.
+            "operatingSystem": { # Contains information about an operating system that can be targeted by ads. # Operating system of this operating system version.
+              "mobile": True or False, # Whether this operating system is for mobile.
+              "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+              "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+              "name": "A String", # Name of this operating system.
+              "desktop": True or False, # Whether this operating system is for desktop.
+            },
+            "minorVersion": "A String", # Minor version (number after the first dot) of this operating system version.
+          },
+        ],
+        "browsers": [ # Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a browser that can be targeted by ads.
+            "majorVersion": "A String", # Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+            "kind": "dfareporting#browser", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#browser".
+            "name": "A String", # Name of this browser.
+            "browserVersionId": "A String", # ID referring to this grouping of browser and version numbers. This is the ID used for targeting.
+            "dartId": "A String", # DART ID of this browser. This is the ID used when generating reports.
+            "minorVersion": "A String", # Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.
+          },
+        ],
+        "operatingSystems": [ # Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.
+          { # Contains information about an operating system that can be targeted by ads.
+            "mobile": True or False, # Whether this operating system is for mobile.
+            "dartId": "A String", # DART ID of this operating system. This is the ID used for targeting.
+            "kind": "dfareporting#operatingSystem", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#operatingSystem".
+            "name": "A String", # Name of this operating system.
+            "desktop": True or False, # Whether this operating system is for desktop.
+          },
+        ],
+        "mobileCarriers": [ # Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.
+          { # Contains information about a mobile carrier that can be targeted by ads.
+            "kind": "dfareporting#mobileCarrier", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#mobileCarrier".
+            "countryDartId": "A String", # DART ID of the country to which this mobile carrier belongs.
+            "id": "A String", # ID of this mobile carrier.
+            "countryCode": "A String", # Country code of the country to which this mobile carrier belongs.
+            "name": "A String", # Name of this mobile carrier.
+          },
+        ],
+        "connectionTypes": [ # Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.
+            "kind": "dfareporting#connectionType", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#connectionType".
+            "id": "A String", # ID of this connection type.
+            "name": "A String", # Name of this connection type.
+          },
+        ],
+      },
+      "listTargetingExpression": { # Remarketing List Targeting Expression. # Remarketing list targeting criteria.
+        "expression": "A String", # Expression describing which lists are being targeted by the ad.
+      },
+      "keyValueTargetingExpression": { # Key Value Targeting Expression. # Key-value targeting criteria.
+        "expression": "A String", # Keyword expression being targeted by the ad.
+      },
+      "languageTargeting": { # Language Targeting. # Language targeting criteria.
+        "languages": [ # Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.
+          { # Contains information about a language that can be targeted by ads.
+            "languageCode": "A String", # Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are "en" for English or "zh_CN" for Simplified Chinese.
+            "kind": "dfareporting#language", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#language".
+            "id": "A String", # Language ID of this language. This is the ID used for targeting and generating reports.
+            "name": "A String", # Name of this language.
+          },
+        ],
+      },
+      "advertiserId": "A String", # Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
+      "geoTargeting": { # Geographical Targeting. # Geographical targeting criteria.
+        "countries": [ # Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.
+          { # Contains information about a country that can be targeted by ads.
+            "dartId": "A String", # DART ID of this country. This is the ID used for targeting and generating reports.
+            "sslEnabled": True or False, # Whether ad serving supports secure servers in this country.
+            "kind": "dfareporting#country", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#country".
+            "countryCode": "A String", # Country code.
+            "name": "A String", # Name of this country.
+          },
+        ],
+        "excludeCountries": True or False, # Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.
+        "postalCodes": [ # Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code.
+          { # Contains information about a postal code that can be targeted by ads.
+            "countryDartId": "A String", # DART ID of the country to which this postal code belongs.
+            "kind": "dfareporting#postalCode", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#postalCode".
+            "code": "A String", # Postal code. This is equivalent to the id field.
+            "id": "A String", # ID of this postal code.
+            "countryCode": "A String", # Country code of the country to which this postal code belongs.
+          },
+        ],
+        "regions": [ # Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.
+          { # Contains information about a region that can be targeted by ads.
+            "kind": "dfareporting#region", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#region".
+            "countryDartId": "A String", # DART ID of the country to which this region belongs.
+            "name": "A String", # Name of this region.
+            "countryCode": "A String", # Country code of the country to which this region belongs.
+            "regionCode": "A String", # Region code.
+            "dartId": "A String", # DART ID of this region.
+          },
+        ],
+        "cities": [ # Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.
+          { # Contains information about a city that can be targeted by ads.
+            "kind": "dfareporting#city", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#city".
+            "countryDartId": "A String", # DART ID of the country to which this city belongs.
+            "name": "A String", # Name of this city.
+            "countryCode": "A String", # Country code of the country to which this city belongs.
+            "metroCode": "A String", # Metro region code of the metro region (DMA) to which this city belongs.
+            "regionCode": "A String", # Region code of the region to which this city belongs.
+            "metroDmaId": "A String", # ID of the metro region (DMA) to which this city belongs.
+            "dartId": "A String", # DART ID of this city. This is the ID used for targeting and generating reports.
+            "regionDartId": "A String", # DART ID of the region to which this city belongs.
+          },
+        ],
+        "metros": [ # Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.
+          { # Contains information about a metro region that can be targeted by ads.
+            "kind": "dfareporting#metro", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#metro".
+            "countryDartId": "A String", # DART ID of the country to which this metro region belongs.
+            "name": "A String", # Name of this metro region.
+            "countryCode": "A String", # Country code of the country to which this metro region belongs.
+            "metroCode": "A String", # Metro code of this metro region. This is equivalent to dma_id.
+            "dmaId": "A String", # DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.
+            "dartId": "A String", # DART ID of this metro region.
+          },
+        ],
+      },
+      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
+        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
+        "value": "A String", # The value of the dimension.
+        "dimensionName": "A String", # The name of the dimension.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
+        "id": "A String", # The ID associated with the value if available.
+      },
+      "id": "A String", # ID of this targeting template. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.userProfiles.html b/docs/dyn/dfareporting_v2_7.userProfiles.html
new file mode 100644
index 00000000000..6c593408408
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.userProfiles.html
@@ -0,0 +1,133 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.userProfiles.html">userProfiles</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId)</a></code></p>
+<p class="firstline">Gets one user profile by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list()</a></code></p>
+<p class="firstline">Retrieves list of user profiles for a user.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId)</code>
+  <pre>Gets one user profile by ID.
+
+Args:
+  profileId: string, The user profile ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Represents a UserProfile resource.
+    "userName": "A String", # The user name.
+    "kind": "dfareporting#userProfile", # The kind of resource this is, in this case dfareporting#userProfile.
+    "subAccountId": "A String", # The sub account ID this profile belongs to if applicable.
+    "accountName": "A String", # The account name this profile belongs to.
+    "etag": "A String", # The eTag of this response for caching purposes.
+    "subAccountName": "A String", # The sub account name this profile belongs to if applicable.
+    "profileId": "A String", # The unique ID of the user profile.
+    "accountId": "A String", # The account ID to which this profile belongs.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list()</code>
+  <pre>Retrieves list of user profiles for a user.
+
+Args:
+
+Returns:
+  An object of the form:
+
+    { # Represents the list of user profiles.
+    "items": [ # The user profiles returned in this response.
+      { # Represents a UserProfile resource.
+        "userName": "A String", # The user name.
+        "kind": "dfareporting#userProfile", # The kind of resource this is, in this case dfareporting#userProfile.
+        "subAccountId": "A String", # The sub account ID this profile belongs to if applicable.
+        "accountName": "A String", # The account name this profile belongs to.
+        "etag": "A String", # The eTag of this response for caching purposes.
+        "subAccountName": "A String", # The sub account name this profile belongs to if applicable.
+        "profileId": "A String", # The unique ID of the user profile.
+        "accountId": "A String", # The account ID to which this profile belongs.
+      },
+    ],
+    "kind": "dfareporting#userProfileList", # The kind of list this is, in this case dfareporting#userProfileList.
+    "etag": "A String", # The eTag of this response for caching purposes.
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.userRolePermissionGroups.html b/docs/dyn/dfareporting_v2_7.userRolePermissionGroups.html
new file mode 100644
index 00000000000..729f64374e5
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.userRolePermissionGroups.html
@@ -0,0 +1,124 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.userRolePermissionGroups.html">userRolePermissionGroups</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one user role permission group by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Gets a list of all supported user role permission groups.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one user role permission group by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, User role permission group ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Represents a grouping of related user role permissions.
+    "kind": "dfareporting#userRolePermissionGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermissionGroup".
+    "id": "A String", # ID of this user role permission.
+    "name": "A String", # Name of this user role permission group.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Gets a list of all supported user role permission groups.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # User Role Permission Group List Response
+    "userRolePermissionGroups": [ # User role permission group collection.
+      { # Represents a grouping of related user role permissions.
+        "kind": "dfareporting#userRolePermissionGroup", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermissionGroup".
+        "id": "A String", # ID of this user role permission.
+        "name": "A String", # Name of this user role permission group.
+      },
+    ],
+    "kind": "dfareporting#userRolePermissionGroupsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermissionGroupsListResponse".
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.userRolePermissions.html b/docs/dyn/dfareporting_v2_7.userRolePermissions.html
new file mode 100644
index 00000000000..6edb7d144e3
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.userRolePermissions.html
@@ -0,0 +1,129 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.userRolePermissions.html">userRolePermissions</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one user role permission by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, ids=None)</a></code></p>
+<p class="firstline">Gets a list of user role permissions, possibly filtered.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one user role permission by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, User role permission ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of a user role permission.
+    "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+    "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+    "availability": "A String", # Levels of availability for a user role permission.
+    "name": "A String", # Name of this user role permission.
+    "id": "A String", # ID of this user role permission.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, ids=None)</code>
+  <pre>Gets a list of user role permissions, possibly filtered.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  ids: string, Select only user role permissions with these IDs. (repeated)
+
+Returns:
+  An object of the form:
+
+    { # User Role Permission List Response
+    "userRolePermissions": [ # User role permission collection.
+      { # Contains properties of a user role permission.
+        "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+        "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+        "availability": "A String", # Levels of availability for a user role permission.
+        "name": "A String", # Name of this user role permission.
+        "id": "A String", # ID of this user role permission.
+      },
+    ],
+    "kind": "dfareporting#userRolePermissionsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermissionsListResponse".
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.userRoles.html b/docs/dyn/dfareporting_v2_7.userRoles.html
new file mode 100644
index 00000000000..9404d8177f3
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.userRoles.html
@@ -0,0 +1,361 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.userRoles.html">userRoles</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(profileId, id)</a></code></p>
+<p class="firstline">Deletes an existing user role.</p>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one user role by ID.</p>
+<p class="toc_element">
+  <code><a href="#insert">insert(profileId, body)</a></code></p>
+<p class="firstline">Inserts a new user role.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId, searchString=None, subaccountId=None, pageToken=None, ids=None, maxResults=None, accountUserRoleOnly=None, sortOrder=None, sortField=None)</a></code></p>
+<p class="firstline">Retrieves a list of user roles, possibly filtered. This method supports paging.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
+<p class="firstline">Updates an existing user role. This method supports patch semantics.</p>
+<p class="toc_element">
+  <code><a href="#update">update(profileId, body)</a></code></p>
+<p class="firstline">Updates an existing user role.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(profileId, id)</code>
+  <pre>Deletes an existing user role.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, User role ID. (required)
+</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one user role by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, User role ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of auser role, which is used to manage user access.
+      "defaultUserRole": True or False, # Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.
+      "kind": "dfareporting#userRole", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRole".
+      "subaccountId": "A String", # Subaccount ID of this user role. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account.
+      "parentUserRoleId": "A String", # ID of the user role that this user role is based on or copied from. This is a required field.
+      "permissions": [ # List of permissions associated with this user role.
+        { # Contains properties of a user role permission.
+          "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+          "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+          "availability": "A String", # Levels of availability for a user role permission.
+          "name": "A String", # Name of this user role permission.
+          "id": "A String", # ID of this user role permission.
+        },
+      ],
+      "id": "A String", # ID of this user role. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this user role. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="insert">insert(profileId, body)</code>
+  <pre>Inserts a new user role.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of auser role, which is used to manage user access.
+    "defaultUserRole": True or False, # Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.
+    "kind": "dfareporting#userRole", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRole".
+    "subaccountId": "A String", # Subaccount ID of this user role. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account.
+    "parentUserRoleId": "A String", # ID of the user role that this user role is based on or copied from. This is a required field.
+    "permissions": [ # List of permissions associated with this user role.
+      { # Contains properties of a user role permission.
+        "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+        "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+        "availability": "A String", # Levels of availability for a user role permission.
+        "name": "A String", # Name of this user role permission.
+        "id": "A String", # ID of this user role permission.
+      },
+    ],
+    "id": "A String", # ID of this user role. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this user role. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of auser role, which is used to manage user access.
+      "defaultUserRole": True or False, # Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.
+      "kind": "dfareporting#userRole", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRole".
+      "subaccountId": "A String", # Subaccount ID of this user role. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account.
+      "parentUserRoleId": "A String", # ID of the user role that this user role is based on or copied from. This is a required field.
+      "permissions": [ # List of permissions associated with this user role.
+        { # Contains properties of a user role permission.
+          "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+          "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+          "availability": "A String", # Levels of availability for a user role permission.
+          "name": "A String", # Name of this user role permission.
+          "id": "A String", # ID of this user role permission.
+        },
+      ],
+      "id": "A String", # ID of this user role. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this user role. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId, searchString=None, subaccountId=None, pageToken=None, ids=None, maxResults=None, accountUserRoleOnly=None, sortOrder=None, sortField=None)</code>
+  <pre>Retrieves a list of user roles, possibly filtered. This method supports paging.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "userrole*2015" will return objects with names like "userrole June 2015", "userrole April 2015", or simply "userrole 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "userrole" will match objects with name "my userrole", "userrole 2015", or simply "userrole".
+  subaccountId: string, Select only user roles that belong to this subaccount.
+  pageToken: string, Value of the nextPageToken from the previous result page.
+  ids: string, Select only user roles with the specified IDs. (repeated)
+  maxResults: integer, Maximum number of results to return.
+  accountUserRoleOnly: boolean, Select only account level user roles not associated with any specific subaccount.
+  sortOrder: string, Order of sorted results, default is ASCENDING.
+    Allowed values
+      ASCENDING - 
+      DESCENDING - 
+  sortField: string, Field by which to sort the list.
+    Allowed values
+      ID - 
+      NAME - 
+
+Returns:
+  An object of the form:
+
+    { # User Role List Response
+    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
+    "kind": "dfareporting#userRolesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolesListResponse".
+    "userRoles": [ # User role collection.
+      { # Contains properties of auser role, which is used to manage user access.
+          "defaultUserRole": True or False, # Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.
+          "kind": "dfareporting#userRole", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRole".
+          "subaccountId": "A String", # Subaccount ID of this user role. This is a read-only field that can be left blank.
+          "name": "A String", # Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account.
+          "parentUserRoleId": "A String", # ID of the user role that this user role is based on or copied from. This is a required field.
+          "permissions": [ # List of permissions associated with this user role.
+            { # Contains properties of a user role permission.
+              "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+              "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+              "availability": "A String", # Levels of availability for a user role permission.
+              "name": "A String", # Name of this user role permission.
+              "id": "A String", # ID of this user role permission.
+            },
+          ],
+          "id": "A String", # ID of this user role. This is a read-only, auto-generated field.
+          "accountId": "A String", # Account ID of this user role. This is a read-only field that can be left blank.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="patch">patch(profileId, id, body)</code>
+  <pre>Updates an existing user role. This method supports patch semantics.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: string, User role ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of auser role, which is used to manage user access.
+    "defaultUserRole": True or False, # Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.
+    "kind": "dfareporting#userRole", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRole".
+    "subaccountId": "A String", # Subaccount ID of this user role. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account.
+    "parentUserRoleId": "A String", # ID of the user role that this user role is based on or copied from. This is a required field.
+    "permissions": [ # List of permissions associated with this user role.
+      { # Contains properties of a user role permission.
+        "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+        "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+        "availability": "A String", # Levels of availability for a user role permission.
+        "name": "A String", # Name of this user role permission.
+        "id": "A String", # ID of this user role permission.
+      },
+    ],
+    "id": "A String", # ID of this user role. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this user role. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of auser role, which is used to manage user access.
+      "defaultUserRole": True or False, # Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.
+      "kind": "dfareporting#userRole", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRole".
+      "subaccountId": "A String", # Subaccount ID of this user role. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account.
+      "parentUserRoleId": "A String", # ID of the user role that this user role is based on or copied from. This is a required field.
+      "permissions": [ # List of permissions associated with this user role.
+        { # Contains properties of a user role permission.
+          "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+          "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+          "availability": "A String", # Levels of availability for a user role permission.
+          "name": "A String", # Name of this user role permission.
+          "id": "A String", # ID of this user role permission.
+        },
+      ],
+      "id": "A String", # ID of this user role. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this user role. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(profileId, body)</code>
+  <pre>Updates an existing user role.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Contains properties of auser role, which is used to manage user access.
+    "defaultUserRole": True or False, # Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.
+    "kind": "dfareporting#userRole", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRole".
+    "subaccountId": "A String", # Subaccount ID of this user role. This is a read-only field that can be left blank.
+    "name": "A String", # Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account.
+    "parentUserRoleId": "A String", # ID of the user role that this user role is based on or copied from. This is a required field.
+    "permissions": [ # List of permissions associated with this user role.
+      { # Contains properties of a user role permission.
+        "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+        "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+        "availability": "A String", # Levels of availability for a user role permission.
+        "name": "A String", # Name of this user role permission.
+        "id": "A String", # ID of this user role permission.
+      },
+    ],
+    "id": "A String", # ID of this user role. This is a read-only, auto-generated field.
+    "accountId": "A String", # Account ID of this user role. This is a read-only field that can be left blank.
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # Contains properties of auser role, which is used to manage user access.
+      "defaultUserRole": True or False, # Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.
+      "kind": "dfareporting#userRole", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRole".
+      "subaccountId": "A String", # Subaccount ID of this user role. This is a read-only field that can be left blank.
+      "name": "A String", # Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account.
+      "parentUserRoleId": "A String", # ID of the user role that this user role is based on or copied from. This is a required field.
+      "permissions": [ # List of permissions associated with this user role.
+        { # Contains properties of a user role permission.
+          "permissionGroupId": "A String", # ID of the permission group that this user role permission belongs to.
+          "kind": "dfareporting#userRolePermission", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#userRolePermission".
+          "availability": "A String", # Levels of availability for a user role permission.
+          "name": "A String", # Name of this user role permission.
+          "id": "A String", # ID of this user role permission.
+        },
+      ],
+      "id": "A String", # ID of this user role. This is a read-only, auto-generated field.
+      "accountId": "A String", # Account ID of this user role. This is a read-only field that can be left blank.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dfareporting_v2_7.videoFormats.html b/docs/dyn/dfareporting_v2_7.videoFormats.html
new file mode 100644
index 00000000000..8dacccae5b1
--- /dev/null
+++ b/docs/dyn/dfareporting_v2_7.videoFormats.html
@@ -0,0 +1,140 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.videoFormats.html">videoFormats</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(profileId, id)</a></code></p>
+<p class="firstline">Gets one video format by ID.</p>
+<p class="toc_element">
+  <code><a href="#list">list(profileId)</a></code></p>
+<p class="firstline">Lists available video formats.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(profileId, id)</code>
+  <pre>Gets one video format by ID.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+  id: integer, Video format ID. (required)
+
+Returns:
+  An object of the form:
+
+    { # Contains information about supported video formats.
+    "fileType": "A String", # File type of the video format.
+    "resolution": { # Represents the dimensions of ads, placements, creatives, or creative assets. # The resolution of this video format.
+      "width": 42, # Width of this size.
+      "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+      "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+      "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+      "height": 42, # Height of this size.
+    },
+    "id": 42, # ID of the video format.
+    "kind": "dfareporting#videoFormat", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoFormat".
+    "targetBitRate": 42, # The target bit rate of this video format.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(profileId)</code>
+  <pre>Lists available video formats.
+
+Args:
+  profileId: string, User profile ID associated with this request. (required)
+
+Returns:
+  An object of the form:
+
+    { # Video Format List Response
+    "kind": "dfareporting#videoFormatsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoFormatsListResponse".
+    "videoFormats": [ # Video format collection.
+      { # Contains information about supported video formats.
+        "fileType": "A String", # File type of the video format.
+        "resolution": { # Represents the dimensions of ads, placements, creatives, or creative assets. # The resolution of this video format.
+          "width": 42, # Width of this size.
+          "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size".
+          "iab": True or False, # IAB standard size. This is a read-only, auto-generated field.
+          "id": "A String", # ID of this size. This is a read-only, auto-generated field.
+          "height": 42, # Height of this size.
+        },
+        "id": 42, # ID of the video format.
+        "kind": "dfareporting#videoFormat", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#videoFormat".
+        "targetBitRate": 42, # The target bit rate of this video format.
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/dns_v2beta1.dnskeys.html b/docs/dyn/dns_v2beta1.dnskeys.html
index 95d6a9b94ac..9895347b62a 100644
--- a/docs/dyn/dns_v2beta1.dnskeys.html
+++ b/docs/dyn/dns_v2beta1.dnskeys.html
@@ -72,7 +72,7 @@
 
 </style>
 
-<h1><a href="dns_v2beta1.html">Google Cloud DNS API</a> . <a href="dns_v2beta1.dnskeys.html">dnskeys</a></h1>
+<h1><a href="dns_v2beta1.html">Google Cloud DNS API</a> . <a href="dns_v2beta1.dnsKeys.html">dnsKeys</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#get">get(project, managedZone, dnsKeyId, digestType=None, clientOperationId=None)</a></code></p>
diff --git a/docs/dyn/dns_v2beta1.html b/docs/dyn/dns_v2beta1.html
index 6445953c099..1c1f582709e 100644
--- a/docs/dyn/dns_v2beta1.html
+++ b/docs/dyn/dns_v2beta1.html
@@ -80,9 +80,9 @@ <h2>Instance Methods</h2>
 <p class="firstline">Returns the changes Resource.</p>
 
 <p class="toc_element">
-  <code><a href="dns_v2beta1.dnskeys.html">dnskeys()</a></code>
+  <code><a href="dns_v2beta1.dnsKeys.html">dnsKeys()</a></code>
 </p>
-<p class="firstline">Returns the dnskeys Resource.</p>
+<p class="firstline">Returns the dnsKeys Resource.</p>
 
 <p class="toc_element">
   <code><a href="dns_v2beta1.managedZoneOperations.html">managedZoneOperations()</a></code>
diff --git a/docs/dyn/drive_v2.changes.html b/docs/dyn/drive_v2.changes.html
index a3eb2eb4f6d..e0a37c5dfc5 100644
--- a/docs/dyn/drive_v2.changes.html
+++ b/docs/dyn/drive_v2.changes.html
@@ -101,21 +101,23 @@ <h3>Method Details</h3>
     "kind": "drive#change", # This is always drive#change.
     "deleted": True or False, # Whether the file has been deleted.
     "file": { # The metadata for a file. # The updated state of the file. Present if the file has not been deleted.
-      "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+      "hasThumbnail": True or False, # Whether this file has a thumbnail.
       "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
       "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
       "appDataContents": True or False, # Whether this file is in the Application Data folder.
-      "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+      "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
       "labels": { # A group of labels for the file.
         "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+        "modified": True or False, # Whether the file has been modified by this user.
+        "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
         "hidden": True or False, # Deprecated.
-        "viewed": True or False, # Whether this file has been viewed by this user.
         "starred": True or False, # Whether this file is starred by the user.
-        "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+        "viewed": True or False, # Whether this file has been viewed by this user.
       },
       "indexableText": { # Indexable text attributes for the file (can only be written)
         "text": "A String", # The text to be indexed for this file.
       },
+      "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
       "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
       "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
       "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -144,11 +146,7 @@ <h3>Method Details</h3>
         "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
         "emailAddress": "A String", # The email address of the user.
       },
-      "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-        "width": 42, # The width of the video in pixels.
-        "durationMillis": "A String", # The duration of the video in milliseconds.
-        "height": 42, # The height of the video in pixels.
-      },
+      "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
       "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
         "picture": { # The user's profile picture.
           "url": "A String", # A URL that points to a profile picture of this user.
@@ -188,8 +186,8 @@ <h3>Method Details</h3>
           "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
           "name": "A String", # The name for this permission.
           "kind": "drive#permission", # This is always drive#permission.
-          "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-          "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+          "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+          "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
           "authKey": "A String", # The authkey parameter required for this permission.
           "etag": "A String", # The ETag of the permission.
           "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -244,6 +242,11 @@ <h3>Method Details</h3>
       },
       "description": "A String", # A short description of the file.
       "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+      "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+        "width": 42, # The width of the video in pixels.
+        "durationMillis": "A String", # The duration of the video in milliseconds.
+        "height": 42, # The height of the video in pixels.
+      },
       "editable": True or False, # Whether the file can be edited by the current user.
       "kind": "drive#file", # The type of file. This is always drive#file.
       "canComment": True or False, # Whether the current user can comment on the file.
@@ -272,7 +275,7 @@ <h3>Method Details</h3>
       "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
       "title": "A String", # The title of this file.
       "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-      "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+      "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
         "mimeType": "A String", # The MIME type of the thumbnail.
         "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
       },
@@ -282,8 +285,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -343,21 +346,23 @@ <h3>Method Details</h3>
         "kind": "drive#change", # This is always drive#change.
         "deleted": True or False, # Whether the file has been deleted.
         "file": { # The metadata for a file. # The updated state of the file. Present if the file has not been deleted.
-          "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+          "hasThumbnail": True or False, # Whether this file has a thumbnail.
           "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
           "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
           "appDataContents": True or False, # Whether this file is in the Application Data folder.
-          "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+          "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
           "labels": { # A group of labels for the file.
             "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+            "modified": True or False, # Whether the file has been modified by this user.
+            "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
             "hidden": True or False, # Deprecated.
-            "viewed": True or False, # Whether this file has been viewed by this user.
             "starred": True or False, # Whether this file is starred by the user.
-            "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+            "viewed": True or False, # Whether this file has been viewed by this user.
           },
           "indexableText": { # Indexable text attributes for the file (can only be written)
             "text": "A String", # The text to be indexed for this file.
           },
+          "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
           "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
           "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
           "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -386,11 +391,7 @@ <h3>Method Details</h3>
             "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
             "emailAddress": "A String", # The email address of the user.
           },
-          "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-            "width": 42, # The width of the video in pixels.
-            "durationMillis": "A String", # The duration of the video in milliseconds.
-            "height": 42, # The height of the video in pixels.
-          },
+          "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
           "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
             "picture": { # The user's profile picture.
               "url": "A String", # A URL that points to a profile picture of this user.
@@ -430,8 +431,8 @@ <h3>Method Details</h3>
               "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
               "name": "A String", # The name for this permission.
               "kind": "drive#permission", # This is always drive#permission.
-              "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-              "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+              "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+              "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
               "authKey": "A String", # The authkey parameter required for this permission.
               "etag": "A String", # The ETag of the permission.
               "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -486,6 +487,11 @@ <h3>Method Details</h3>
           },
           "description": "A String", # A short description of the file.
           "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+          "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+            "width": 42, # The width of the video in pixels.
+            "durationMillis": "A String", # The duration of the video in milliseconds.
+            "height": 42, # The height of the video in pixels.
+          },
           "editable": True or False, # Whether the file can be edited by the current user.
           "kind": "drive#file", # The type of file. This is always drive#file.
           "canComment": True or False, # Whether the current user can comment on the file.
@@ -514,7 +520,7 @@ <h3>Method Details</h3>
           "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
           "title": "A String", # The title of this file.
           "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-          "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+          "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
             "mimeType": "A String", # The MIME type of the thumbnail.
             "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
           },
@@ -524,8 +530,8 @@ <h3>Method Details</h3>
             "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
             "name": "A String", # The name for this permission.
             "kind": "drive#permission", # This is always drive#permission.
-            "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-            "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+            "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+            "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
             "authKey": "A String", # The authkey parameter required for this permission.
             "etag": "A String", # The ETag of the permission.
             "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
diff --git a/docs/dyn/drive_v2.files.html b/docs/dyn/drive_v2.files.html
index 9de4c2cb564..834122b9e66 100644
--- a/docs/dyn/drive_v2.files.html
+++ b/docs/dyn/drive_v2.files.html
@@ -99,7 +99,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get_media">get_media(fileId, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
 <p class="firstline">Gets a file's metadata by ID.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(body=None, media_body=None, convert=None, useContentAsIndexableText=None, visibility=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None, pinned=None)</a></code></p>
+  <code><a href="#insert">insert(body=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, visibility=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, media_mime_type=None, timedTextLanguage=None)</a></code></p>
 <p class="firstline">Insert a new file.</p>
 <p class="toc_element">
   <code><a href="#list">list(orderBy=None, q=None, projection=None, pageToken=None, maxResults=None, spaces=None, corpus=None)</a></code></p>
@@ -120,7 +120,7 @@ <h2>Instance Methods</h2>
   <code><a href="#untrash">untrash(fileId)</a></code></p>
 <p class="firstline">Restores a file from the trash.</p>
 <p class="toc_element">
-  <code><a href="#update">update(fileId, body=None, newRevision=None, modifiedDateBehavior=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, addParents=None, removeParents=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)</a></code></p>
+  <code><a href="#update">update(fileId, body=None, newRevision=None, modifiedDateBehavior=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, addParents=None, removeParents=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, media_mime_type=None, setModifiedDate=None, timedTextLanguage=None)</a></code></p>
 <p class="firstline">Updates file metadata and/or content.</p>
 <p class="toc_element">
   <code><a href="#watch">watch(fileId, body, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
@@ -139,21 +139,23 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The metadata for a file.
-  "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+  "hasThumbnail": True or False, # Whether this file has a thumbnail.
   "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
   "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
   "appDataContents": True or False, # Whether this file is in the Application Data folder.
-  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
   "labels": { # A group of labels for the file.
     "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+    "modified": True or False, # Whether the file has been modified by this user.
+    "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
     "hidden": True or False, # Deprecated.
-    "viewed": True or False, # Whether this file has been viewed by this user.
     "starred": True or False, # Whether this file is starred by the user.
-    "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+    "viewed": True or False, # Whether this file has been viewed by this user.
   },
   "indexableText": { # Indexable text attributes for the file (can only be written)
     "text": "A String", # The text to be indexed for this file.
   },
+  "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
   "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
   "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
   "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -182,11 +184,7 @@ <h3>Method Details</h3>
     "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
     "emailAddress": "A String", # The email address of the user.
   },
-  "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-    "width": 42, # The width of the video in pixels.
-    "durationMillis": "A String", # The duration of the video in milliseconds.
-    "height": 42, # The height of the video in pixels.
-  },
+  "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
   "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
     "picture": { # The user's profile picture.
       "url": "A String", # A URL that points to a profile picture of this user.
@@ -226,8 +224,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -282,6 +280,11 @@ <h3>Method Details</h3>
   },
   "description": "A String", # A short description of the file.
   "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+  "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+    "width": 42, # The width of the video in pixels.
+    "durationMillis": "A String", # The duration of the video in milliseconds.
+    "height": 42, # The height of the video in pixels.
+  },
   "editable": True or False, # Whether the file can be edited by the current user.
   "kind": "drive#file", # The type of file. This is always drive#file.
   "canComment": True or False, # Whether the current user can comment on the file.
@@ -310,7 +313,7 @@ <h3>Method Details</h3>
   "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
   "title": "A String", # The title of this file.
   "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-  "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+  "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
     "mimeType": "A String", # The MIME type of the thumbnail.
     "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
   },
@@ -320,8 +323,8 @@ <h3>Method Details</h3>
     "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
     "name": "A String", # The name for this permission.
     "kind": "drive#permission", # This is always drive#permission.
-    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
     "authKey": "A String", # The authkey parameter required for this permission.
     "etag": "A String", # The ETag of the permission.
     "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -367,21 +370,23 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
-    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
     "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
     "appDataContents": True or False, # Whether this file is in the Application Data folder.
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
     "labels": { # A group of labels for the file.
       "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+      "modified": True or False, # Whether the file has been modified by this user.
+      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
       "hidden": True or False, # Deprecated.
-      "viewed": True or False, # Whether this file has been viewed by this user.
       "starred": True or False, # Whether this file is starred by the user.
-      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+      "viewed": True or False, # Whether this file has been viewed by this user.
     },
     "indexableText": { # Indexable text attributes for the file (can only be written)
       "text": "A String", # The text to be indexed for this file.
     },
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -410,11 +415,7 @@ <h3>Method Details</h3>
       "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
       "emailAddress": "A String", # The email address of the user.
     },
-    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-      "width": 42, # The width of the video in pixels.
-      "durationMillis": "A String", # The duration of the video in milliseconds.
-      "height": 42, # The height of the video in pixels.
-    },
+    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
     "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
       "picture": { # The user's profile picture.
         "url": "A String", # A URL that points to a profile picture of this user.
@@ -454,8 +455,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -510,6 +511,11 @@ <h3>Method Details</h3>
     },
     "description": "A String", # A short description of the file.
     "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+      "width": 42, # The width of the video in pixels.
+      "durationMillis": "A String", # The duration of the video in milliseconds.
+      "height": 42, # The height of the video in pixels.
+    },
     "editable": True or False, # Whether the file can be edited by the current user.
     "kind": "drive#file", # The type of file. This is always drive#file.
     "canComment": True or False, # Whether the current user can comment on the file.
@@ -538,7 +544,7 @@ <h3>Method Details</h3>
     "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
     "title": "A String", # The title of this file.
     "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-    "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+    "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
       "mimeType": "A String", # The MIME type of the thumbnail.
       "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
     },
@@ -548,8 +554,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -656,21 +662,23 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
-    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
     "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
     "appDataContents": True or False, # Whether this file is in the Application Data folder.
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
     "labels": { # A group of labels for the file.
       "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+      "modified": True or False, # Whether the file has been modified by this user.
+      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
       "hidden": True or False, # Deprecated.
-      "viewed": True or False, # Whether this file has been viewed by this user.
       "starred": True or False, # Whether this file is starred by the user.
-      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+      "viewed": True or False, # Whether this file has been viewed by this user.
     },
     "indexableText": { # Indexable text attributes for the file (can only be written)
       "text": "A String", # The text to be indexed for this file.
     },
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -699,11 +707,7 @@ <h3>Method Details</h3>
       "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
       "emailAddress": "A String", # The email address of the user.
     },
-    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-      "width": 42, # The width of the video in pixels.
-      "durationMillis": "A String", # The duration of the video in milliseconds.
-      "height": 42, # The height of the video in pixels.
-    },
+    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
     "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
       "picture": { # The user's profile picture.
         "url": "A String", # A URL that points to a profile picture of this user.
@@ -743,8 +747,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -799,6 +803,11 @@ <h3>Method Details</h3>
     },
     "description": "A String", # A short description of the file.
     "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+      "width": 42, # The width of the video in pixels.
+      "durationMillis": "A String", # The duration of the video in milliseconds.
+      "height": 42, # The height of the video in pixels.
+    },
     "editable": True or False, # Whether the file can be edited by the current user.
     "kind": "drive#file", # The type of file. This is always drive#file.
     "canComment": True or False, # Whether the current user can comment on the file.
@@ -827,7 +836,7 @@ <h3>Method Details</h3>
     "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
     "title": "A String", # The title of this file.
     "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-    "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+    "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
       "mimeType": "A String", # The MIME type of the thumbnail.
       "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
     },
@@ -837,8 +846,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -891,7 +900,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(body=None, media_body=None, convert=None, useContentAsIndexableText=None, visibility=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None, pinned=None)</code>
+    <code class="details" id="insert">insert(body=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, visibility=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, media_mime_type=None, timedTextLanguage=None)</code>
   <pre>Insert a new file.
 
 Args:
@@ -899,21 +908,23 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The metadata for a file.
-  "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+  "hasThumbnail": True or False, # Whether this file has a thumbnail.
   "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
   "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
   "appDataContents": True or False, # Whether this file is in the Application Data folder.
-  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
   "labels": { # A group of labels for the file.
     "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+    "modified": True or False, # Whether the file has been modified by this user.
+    "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
     "hidden": True or False, # Deprecated.
-    "viewed": True or False, # Whether this file has been viewed by this user.
     "starred": True or False, # Whether this file is starred by the user.
-    "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+    "viewed": True or False, # Whether this file has been viewed by this user.
   },
   "indexableText": { # Indexable text attributes for the file (can only be written)
     "text": "A String", # The text to be indexed for this file.
   },
+  "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
   "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
   "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
   "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -942,11 +953,7 @@ <h3>Method Details</h3>
     "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
     "emailAddress": "A String", # The email address of the user.
   },
-  "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-    "width": 42, # The width of the video in pixels.
-    "durationMillis": "A String", # The duration of the video in milliseconds.
-    "height": 42, # The height of the video in pixels.
-  },
+  "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
   "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
     "picture": { # The user's profile picture.
       "url": "A String", # A URL that points to a profile picture of this user.
@@ -986,8 +993,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1042,6 +1049,11 @@ <h3>Method Details</h3>
   },
   "description": "A String", # A short description of the file.
   "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+  "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+    "width": 42, # The width of the video in pixels.
+    "durationMillis": "A String", # The duration of the video in milliseconds.
+    "height": 42, # The height of the video in pixels.
+  },
   "editable": True or False, # Whether the file can be edited by the current user.
   "kind": "drive#file", # The type of file. This is always drive#file.
   "canComment": True or False, # Whether the current user can comment on the file.
@@ -1070,7 +1082,7 @@ <h3>Method Details</h3>
   "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
   "title": "A String", # The title of this file.
   "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-  "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+  "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
     "mimeType": "A String", # The MIME type of the thumbnail.
     "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
   },
@@ -1080,8 +1092,8 @@ <h3>Method Details</h3>
     "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
     "name": "A String", # The name for this permission.
     "kind": "drive#permission", # This is always drive#permission.
-    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
     "authKey": "A String", # The authkey parameter required for this permission.
     "etag": "A String", # The ETag of the permission.
     "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1113,37 +1125,40 @@ <h3>Method Details</h3>
 }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
-  convert: boolean, Whether to convert this file to the corresponding Google Docs format.
-  useContentAsIndexableText: boolean, Whether to use the content as indexable text.
+  ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
+  ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
+  pinned: boolean, Whether to pin the head revision of the uploaded file. A file can have a maximum of 200 pinned revisions.
   visibility: string, The visibility of the new file. This parameter is only relevant when convert=false.
     Allowed values
       DEFAULT - The visibility of the new file is determined by the user's default visibility/sharing policies.
       PRIVATE - The new file will be visible to only the owner.
-  ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
-  ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
-  timedTextLanguage: string, The language of the timed text.
   timedTextTrackName: string, The timed text track name.
-  pinned: boolean, Whether to pin the head revision of the uploaded file. A file can have a maximum of 200 pinned revisions.
+  convert: boolean, Whether to convert this file to the corresponding Google Docs format.
+  useContentAsIndexableText: boolean, Whether to use the content as indexable text.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
+  timedTextLanguage: string, The language of the timed text.
 
 Returns:
   An object of the form:
 
     { # The metadata for a file.
-    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
     "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
     "appDataContents": True or False, # Whether this file is in the Application Data folder.
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
     "labels": { # A group of labels for the file.
       "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+      "modified": True or False, # Whether the file has been modified by this user.
+      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
       "hidden": True or False, # Deprecated.
-      "viewed": True or False, # Whether this file has been viewed by this user.
       "starred": True or False, # Whether this file is starred by the user.
-      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+      "viewed": True or False, # Whether this file has been viewed by this user.
     },
     "indexableText": { # Indexable text attributes for the file (can only be written)
       "text": "A String", # The text to be indexed for this file.
     },
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -1172,11 +1187,7 @@ <h3>Method Details</h3>
       "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
       "emailAddress": "A String", # The email address of the user.
     },
-    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-      "width": 42, # The width of the video in pixels.
-      "durationMillis": "A String", # The duration of the video in milliseconds.
-      "height": 42, # The height of the video in pixels.
-    },
+    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
     "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
       "picture": { # The user's profile picture.
         "url": "A String", # A URL that points to a profile picture of this user.
@@ -1216,8 +1227,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1272,6 +1283,11 @@ <h3>Method Details</h3>
     },
     "description": "A String", # A short description of the file.
     "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+      "width": 42, # The width of the video in pixels.
+      "durationMillis": "A String", # The duration of the video in milliseconds.
+      "height": 42, # The height of the video in pixels.
+    },
     "editable": True or False, # Whether the file can be edited by the current user.
     "kind": "drive#file", # The type of file. This is always drive#file.
     "canComment": True or False, # Whether the current user can comment on the file.
@@ -1300,7 +1316,7 @@ <h3>Method Details</h3>
     "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
     "title": "A String", # The title of this file.
     "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-    "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+    "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
       "mimeType": "A String", # The MIME type of the thumbnail.
       "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
     },
@@ -1310,8 +1326,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1370,21 +1386,23 @@ <h3>Method Details</h3>
     "kind": "drive#fileList", # This is always drive#fileList.
     "items": [ # The actual list of files.
       { # The metadata for a file.
-        "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+        "hasThumbnail": True or False, # Whether this file has a thumbnail.
         "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
         "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
         "appDataContents": True or False, # Whether this file is in the Application Data folder.
-        "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+        "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
         "labels": { # A group of labels for the file.
           "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+          "modified": True or False, # Whether the file has been modified by this user.
+          "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
           "hidden": True or False, # Deprecated.
-          "viewed": True or False, # Whether this file has been viewed by this user.
           "starred": True or False, # Whether this file is starred by the user.
-          "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+          "viewed": True or False, # Whether this file has been viewed by this user.
         },
         "indexableText": { # Indexable text attributes for the file (can only be written)
           "text": "A String", # The text to be indexed for this file.
         },
+        "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
         "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
         "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
         "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -1413,11 +1431,7 @@ <h3>Method Details</h3>
           "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
           "emailAddress": "A String", # The email address of the user.
         },
-        "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-          "width": 42, # The width of the video in pixels.
-          "durationMillis": "A String", # The duration of the video in milliseconds.
-          "height": 42, # The height of the video in pixels.
-        },
+        "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
         "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
           "picture": { # The user's profile picture.
             "url": "A String", # A URL that points to a profile picture of this user.
@@ -1457,8 +1471,8 @@ <h3>Method Details</h3>
             "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
             "name": "A String", # The name for this permission.
             "kind": "drive#permission", # This is always drive#permission.
-            "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-            "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+            "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+            "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
             "authKey": "A String", # The authkey parameter required for this permission.
             "etag": "A String", # The ETag of the permission.
             "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1513,6 +1527,11 @@ <h3>Method Details</h3>
         },
         "description": "A String", # A short description of the file.
         "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+        "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+          "width": 42, # The width of the video in pixels.
+          "durationMillis": "A String", # The duration of the video in milliseconds.
+          "height": 42, # The height of the video in pixels.
+        },
         "editable": True or False, # Whether the file can be edited by the current user.
         "kind": "drive#file", # The type of file. This is always drive#file.
         "canComment": True or False, # Whether the current user can comment on the file.
@@ -1541,7 +1560,7 @@ <h3>Method Details</h3>
         "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
         "title": "A String", # The title of this file.
         "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-        "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+        "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
           "mimeType": "A String", # The MIME type of the thumbnail.
           "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
         },
@@ -1551,8 +1570,8 @@ <h3>Method Details</h3>
           "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
           "name": "A String", # The name for this permission.
           "kind": "drive#permission", # This is always drive#permission.
-          "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-          "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+          "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+          "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
           "authKey": "A String", # The authkey parameter required for this permission.
           "etag": "A String", # The ETag of the permission.
           "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1613,21 +1632,23 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The metadata for a file.
-  "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+  "hasThumbnail": True or False, # Whether this file has a thumbnail.
   "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
   "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
   "appDataContents": True or False, # Whether this file is in the Application Data folder.
-  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
   "labels": { # A group of labels for the file.
     "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+    "modified": True or False, # Whether the file has been modified by this user.
+    "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
     "hidden": True or False, # Deprecated.
-    "viewed": True or False, # Whether this file has been viewed by this user.
     "starred": True or False, # Whether this file is starred by the user.
-    "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+    "viewed": True or False, # Whether this file has been viewed by this user.
   },
   "indexableText": { # Indexable text attributes for the file (can only be written)
     "text": "A String", # The text to be indexed for this file.
   },
+  "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
   "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
   "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
   "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -1656,11 +1677,7 @@ <h3>Method Details</h3>
     "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
     "emailAddress": "A String", # The email address of the user.
   },
-  "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-    "width": 42, # The width of the video in pixels.
-    "durationMillis": "A String", # The duration of the video in milliseconds.
-    "height": 42, # The height of the video in pixels.
-  },
+  "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
   "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
     "picture": { # The user's profile picture.
       "url": "A String", # A URL that points to a profile picture of this user.
@@ -1700,8 +1717,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1756,6 +1773,11 @@ <h3>Method Details</h3>
   },
   "description": "A String", # A short description of the file.
   "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+  "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+    "width": 42, # The width of the video in pixels.
+    "durationMillis": "A String", # The duration of the video in milliseconds.
+    "height": 42, # The height of the video in pixels.
+  },
   "editable": True or False, # Whether the file can be edited by the current user.
   "kind": "drive#file", # The type of file. This is always drive#file.
   "canComment": True or False, # Whether the current user can comment on the file.
@@ -1784,7 +1806,7 @@ <h3>Method Details</h3>
   "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
   "title": "A String", # The title of this file.
   "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-  "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+  "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
     "mimeType": "A String", # The MIME type of the thumbnail.
     "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
   },
@@ -1794,8 +1816,8 @@ <h3>Method Details</h3>
     "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
     "name": "A String", # The name for this permission.
     "kind": "drive#permission", # This is always drive#permission.
-    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
     "authKey": "A String", # The authkey parameter required for this permission.
     "etag": "A String", # The ETag of the permission.
     "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1851,21 +1873,23 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
-    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
     "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
     "appDataContents": True or False, # Whether this file is in the Application Data folder.
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
     "labels": { # A group of labels for the file.
       "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+      "modified": True or False, # Whether the file has been modified by this user.
+      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
       "hidden": True or False, # Deprecated.
-      "viewed": True or False, # Whether this file has been viewed by this user.
       "starred": True or False, # Whether this file is starred by the user.
-      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+      "viewed": True or False, # Whether this file has been viewed by this user.
     },
     "indexableText": { # Indexable text attributes for the file (can only be written)
       "text": "A String", # The text to be indexed for this file.
     },
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -1894,11 +1918,7 @@ <h3>Method Details</h3>
       "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
       "emailAddress": "A String", # The email address of the user.
     },
-    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-      "width": 42, # The width of the video in pixels.
-      "durationMillis": "A String", # The duration of the video in milliseconds.
-      "height": 42, # The height of the video in pixels.
-    },
+    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
     "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
       "picture": { # The user's profile picture.
         "url": "A String", # A URL that points to a profile picture of this user.
@@ -1938,8 +1958,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -1994,6 +2014,11 @@ <h3>Method Details</h3>
     },
     "description": "A String", # A short description of the file.
     "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+      "width": 42, # The width of the video in pixels.
+      "durationMillis": "A String", # The duration of the video in milliseconds.
+      "height": 42, # The height of the video in pixels.
+    },
     "editable": True or False, # Whether the file can be edited by the current user.
     "kind": "drive#file", # The type of file. This is always drive#file.
     "canComment": True or False, # Whether the current user can comment on the file.
@@ -2022,7 +2047,7 @@ <h3>Method Details</h3>
     "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
     "title": "A String", # The title of this file.
     "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-    "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+    "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
       "mimeType": "A String", # The MIME type of the thumbnail.
       "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
     },
@@ -2032,8 +2057,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2076,21 +2101,23 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
-    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
     "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
     "appDataContents": True or False, # Whether this file is in the Application Data folder.
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
     "labels": { # A group of labels for the file.
       "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+      "modified": True or False, # Whether the file has been modified by this user.
+      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
       "hidden": True or False, # Deprecated.
-      "viewed": True or False, # Whether this file has been viewed by this user.
       "starred": True or False, # Whether this file is starred by the user.
-      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+      "viewed": True or False, # Whether this file has been viewed by this user.
     },
     "indexableText": { # Indexable text attributes for the file (can only be written)
       "text": "A String", # The text to be indexed for this file.
     },
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -2119,11 +2146,7 @@ <h3>Method Details</h3>
       "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
       "emailAddress": "A String", # The email address of the user.
     },
-    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-      "width": 42, # The width of the video in pixels.
-      "durationMillis": "A String", # The duration of the video in milliseconds.
-      "height": 42, # The height of the video in pixels.
-    },
+    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
     "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
       "picture": { # The user's profile picture.
         "url": "A String", # A URL that points to a profile picture of this user.
@@ -2163,8 +2186,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2219,6 +2242,11 @@ <h3>Method Details</h3>
     },
     "description": "A String", # A short description of the file.
     "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+      "width": 42, # The width of the video in pixels.
+      "durationMillis": "A String", # The duration of the video in milliseconds.
+      "height": 42, # The height of the video in pixels.
+    },
     "editable": True or False, # Whether the file can be edited by the current user.
     "kind": "drive#file", # The type of file. This is always drive#file.
     "canComment": True or False, # Whether the current user can comment on the file.
@@ -2247,7 +2275,7 @@ <h3>Method Details</h3>
     "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
     "title": "A String", # The title of this file.
     "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-    "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+    "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
       "mimeType": "A String", # The MIME type of the thumbnail.
       "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
     },
@@ -2257,8 +2285,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2301,21 +2329,23 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
-    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
     "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
     "appDataContents": True or False, # Whether this file is in the Application Data folder.
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
     "labels": { # A group of labels for the file.
       "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+      "modified": True or False, # Whether the file has been modified by this user.
+      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
       "hidden": True or False, # Deprecated.
-      "viewed": True or False, # Whether this file has been viewed by this user.
       "starred": True or False, # Whether this file is starred by the user.
-      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+      "viewed": True or False, # Whether this file has been viewed by this user.
     },
     "indexableText": { # Indexable text attributes for the file (can only be written)
       "text": "A String", # The text to be indexed for this file.
     },
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -2344,11 +2374,7 @@ <h3>Method Details</h3>
       "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
       "emailAddress": "A String", # The email address of the user.
     },
-    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-      "width": 42, # The width of the video in pixels.
-      "durationMillis": "A String", # The duration of the video in milliseconds.
-      "height": 42, # The height of the video in pixels.
-    },
+    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
     "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
       "picture": { # The user's profile picture.
         "url": "A String", # A URL that points to a profile picture of this user.
@@ -2388,8 +2414,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2444,6 +2470,11 @@ <h3>Method Details</h3>
     },
     "description": "A String", # A short description of the file.
     "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+      "width": 42, # The width of the video in pixels.
+      "durationMillis": "A String", # The duration of the video in milliseconds.
+      "height": 42, # The height of the video in pixels.
+    },
     "editable": True or False, # Whether the file can be edited by the current user.
     "kind": "drive#file", # The type of file. This is always drive#file.
     "canComment": True or False, # Whether the current user can comment on the file.
@@ -2472,7 +2503,7 @@ <h3>Method Details</h3>
     "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
     "title": "A String", # The title of this file.
     "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-    "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+    "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
       "mimeType": "A String", # The MIME type of the thumbnail.
       "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
     },
@@ -2482,8 +2513,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2526,21 +2557,23 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
-    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
     "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
     "appDataContents": True or False, # Whether this file is in the Application Data folder.
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
     "labels": { # A group of labels for the file.
       "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+      "modified": True or False, # Whether the file has been modified by this user.
+      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
       "hidden": True or False, # Deprecated.
-      "viewed": True or False, # Whether this file has been viewed by this user.
       "starred": True or False, # Whether this file is starred by the user.
-      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+      "viewed": True or False, # Whether this file has been viewed by this user.
     },
     "indexableText": { # Indexable text attributes for the file (can only be written)
       "text": "A String", # The text to be indexed for this file.
     },
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -2569,11 +2602,7 @@ <h3>Method Details</h3>
       "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
       "emailAddress": "A String", # The email address of the user.
     },
-    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-      "width": 42, # The width of the video in pixels.
-      "durationMillis": "A String", # The duration of the video in milliseconds.
-      "height": 42, # The height of the video in pixels.
-    },
+    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
     "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
       "picture": { # The user's profile picture.
         "url": "A String", # A URL that points to a profile picture of this user.
@@ -2613,8 +2642,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2669,6 +2698,11 @@ <h3>Method Details</h3>
     },
     "description": "A String", # A short description of the file.
     "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+      "width": 42, # The width of the video in pixels.
+      "durationMillis": "A String", # The duration of the video in milliseconds.
+      "height": 42, # The height of the video in pixels.
+    },
     "editable": True or False, # Whether the file can be edited by the current user.
     "kind": "drive#file", # The type of file. This is always drive#file.
     "canComment": True or False, # Whether the current user can comment on the file.
@@ -2697,7 +2731,7 @@ <h3>Method Details</h3>
     "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
     "title": "A String", # The title of this file.
     "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-    "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+    "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
       "mimeType": "A String", # The MIME type of the thumbnail.
       "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
     },
@@ -2707,8 +2741,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2741,7 +2775,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(fileId, body=None, newRevision=None, modifiedDateBehavior=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, addParents=None, removeParents=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)</code>
+    <code class="details" id="update">update(fileId, body=None, newRevision=None, modifiedDateBehavior=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, addParents=None, removeParents=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, media_mime_type=None, setModifiedDate=None, timedTextLanguage=None)</code>
   <pre>Updates file metadata and/or content.
 
 Args:
@@ -2750,21 +2784,23 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The metadata for a file.
-  "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+  "hasThumbnail": True or False, # Whether this file has a thumbnail.
   "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
   "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
   "appDataContents": True or False, # Whether this file is in the Application Data folder.
-  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
   "labels": { # A group of labels for the file.
     "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+    "modified": True or False, # Whether the file has been modified by this user.
+    "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
     "hidden": True or False, # Deprecated.
-    "viewed": True or False, # Whether this file has been viewed by this user.
     "starred": True or False, # Whether this file is starred by the user.
-    "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+    "viewed": True or False, # Whether this file has been viewed by this user.
   },
   "indexableText": { # Indexable text attributes for the file (can only be written)
     "text": "A String", # The text to be indexed for this file.
   },
+  "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
   "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
   "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
   "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -2793,11 +2829,7 @@ <h3>Method Details</h3>
     "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
     "emailAddress": "A String", # The email address of the user.
   },
-  "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-    "width": 42, # The width of the video in pixels.
-    "durationMillis": "A String", # The duration of the video in milliseconds.
-    "height": 42, # The height of the video in pixels.
-  },
+  "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
   "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
     "picture": { # The user's profile picture.
       "url": "A String", # A URL that points to a profile picture of this user.
@@ -2837,8 +2869,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2893,6 +2925,11 @@ <h3>Method Details</h3>
   },
   "description": "A String", # A short description of the file.
   "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+  "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+    "width": 42, # The width of the video in pixels.
+    "durationMillis": "A String", # The duration of the video in milliseconds.
+    "height": 42, # The height of the video in pixels.
+  },
   "editable": True or False, # Whether the file can be edited by the current user.
   "kind": "drive#file", # The type of file. This is always drive#file.
   "canComment": True or False, # Whether the current user can comment on the file.
@@ -2921,7 +2958,7 @@ <h3>Method Details</h3>
   "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
   "title": "A String", # The title of this file.
   "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-  "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+  "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
     "mimeType": "A String", # The MIME type of the thumbnail.
     "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
   },
@@ -2931,8 +2968,8 @@ <h3>Method Details</h3>
     "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
     "name": "A String", # The name for this permission.
     "kind": "drive#permission", # This is always drive#permission.
-    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
     "authKey": "A String", # The authkey parameter required for this permission.
     "etag": "A String", # The ETag of the permission.
     "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -2982,6 +3019,7 @@ <h3>Method Details</h3>
   timedTextTrackName: string, The timed text track name.
   convert: boolean, This parameter is deprecated and has no function.
   useContentAsIndexableText: boolean, Whether to use the content as indexable text.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   setModifiedDate: boolean, Whether to set the modified date with the supplied modified date.
   timedTextLanguage: string, The language of the timed text.
 
@@ -2989,21 +3027,23 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
-    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
     "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
     "appDataContents": True or False, # Whether this file is in the Application Data folder.
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
     "labels": { # A group of labels for the file.
       "restricted": True or False, # Whether viewers and commenters are prevented from downloading, printing, and copying this file.
+      "modified": True or False, # Whether the file has been modified by this user.
+      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
       "hidden": True or False, # Deprecated.
-      "viewed": True or False, # Whether this file has been viewed by this user.
       "starred": True or False, # Whether this file is starred by the user.
-      "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
+      "viewed": True or False, # Whether this file has been viewed by this user.
     },
     "indexableText": { # Indexable text attributes for the file (can only be written)
       "text": "A String", # The text to be indexed for this file.
     },
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "lastModifyingUserName": "A String", # Name of the last user to modify this file.
@@ -3032,11 +3072,7 @@ <h3>Method Details</h3>
       "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
       "emailAddress": "A String", # The email address of the user.
     },
-    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
-      "width": 42, # The width of the video in pixels.
-      "durationMillis": "A String", # The duration of the video in milliseconds.
-      "height": 42, # The height of the video in pixels.
-    },
+    "mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
     "lastModifyingUser": { # Information about a Drive user. # The last user to modify this file.
       "picture": { # The user's profile picture.
         "url": "A String", # A URL that points to a profile picture of this user.
@@ -3076,8 +3112,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -3132,6 +3168,11 @@ <h3>Method Details</h3>
     },
     "description": "A String", # A short description of the file.
     "webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
+    "videoMediaMetadata": { # Metadata about video media. This will only be present for video types.
+      "width": 42, # The width of the video in pixels.
+      "durationMillis": "A String", # The duration of the video in milliseconds.
+      "height": 42, # The height of the video in pixels.
+    },
     "editable": True or False, # Whether the file can be edited by the current user.
     "kind": "drive#file", # The type of file. This is always drive#file.
     "canComment": True or False, # Whether the current user can comment on the file.
@@ -3160,7 +3201,7 @@ <h3>Method Details</h3>
     "alternateLink": "A String", # A link for opening the file in a relevant Google editor or viewer.
     "title": "A String", # The title of this file.
     "modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
-    "thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
+    "thumbnail": { # A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.
       "mimeType": "A String", # The MIME type of the thumbnail.
       "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
     },
@@ -3170,8 +3211,8 @@ <h3>Method Details</h3>
       "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
       "name": "A String", # The name for this permission.
       "kind": "drive#permission", # This is always drive#permission.
-      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+      "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+      "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
       "authKey": "A String", # The authkey parameter required for this permission.
       "etag": "A String", # The ETag of the permission.
       "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
diff --git a/docs/dyn/drive_v2.permissions.html b/docs/dyn/drive_v2.permissions.html
index 9d4d4804536..9434d8a6f81 100644
--- a/docs/dyn/drive_v2.permissions.html
+++ b/docs/dyn/drive_v2.permissions.html
@@ -122,8 +122,8 @@ <h3>Method Details</h3>
     "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
     "name": "A String", # The name for this permission.
     "kind": "drive#permission", # This is always drive#permission.
-    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
     "authKey": "A String", # The authkey parameter required for this permission.
     "etag": "A String", # The ETag of the permission.
     "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -175,8 +175,8 @@ <h3>Method Details</h3>
   "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
   "name": "A String", # The name for this permission.
   "kind": "drive#permission", # This is always drive#permission.
-  "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-  "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+  "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+  "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
   "authKey": "A String", # The authkey parameter required for this permission.
   "etag": "A String", # The ETag of the permission.
   "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -208,8 +208,8 @@ <h3>Method Details</h3>
     "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
     "name": "A String", # The name for this permission.
     "kind": "drive#permission", # This is always drive#permission.
-    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
     "authKey": "A String", # The authkey parameter required for this permission.
     "etag": "A String", # The ETag of the permission.
     "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -248,8 +248,8 @@ <h3>Method Details</h3>
         "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
         "name": "A String", # The name for this permission.
         "kind": "drive#permission", # This is always drive#permission.
-        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+        "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+        "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
         "authKey": "A String", # The authkey parameter required for this permission.
         "etag": "A String", # The ETag of the permission.
         "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -291,8 +291,8 @@ <h3>Method Details</h3>
   "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
   "name": "A String", # The name for this permission.
   "kind": "drive#permission", # This is always drive#permission.
-  "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-  "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+  "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+  "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
   "authKey": "A String", # The authkey parameter required for this permission.
   "etag": "A String", # The ETag of the permission.
   "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -324,8 +324,8 @@ <h3>Method Details</h3>
     "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
     "name": "A String", # The name for this permission.
     "kind": "drive#permission", # This is always drive#permission.
-    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
     "authKey": "A String", # The authkey parameter required for this permission.
     "etag": "A String", # The ETag of the permission.
     "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -362,8 +362,8 @@ <h3>Method Details</h3>
   "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
   "name": "A String", # The name for this permission.
   "kind": "drive#permission", # This is always drive#permission.
-  "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-  "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+  "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+  "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
   "authKey": "A String", # The authkey parameter required for this permission.
   "etag": "A String", # The ETag of the permission.
   "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
@@ -395,8 +395,8 @@ <h3>Method Details</h3>
     "domain": "A String", # The domain name of the entity this permission refers to. This is an output-only field which is present when the permission type is user, group or domain.
     "name": "A String", # The name for this permission.
     "kind": "drive#permission", # This is always drive#permission.
-    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
-    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored.
+    "value": "A String", # The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
+    "id": "A String", # The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored.
     "authKey": "A String", # The authkey parameter required for this permission.
     "etag": "A String", # The ETag of the permission.
     "emailAddress": "A String", # The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group.
diff --git a/docs/dyn/drive_v2.realtime.html b/docs/dyn/drive_v2.realtime.html
index 63cdfa185c8..c3e29d21f8f 100644
--- a/docs/dyn/drive_v2.realtime.html
+++ b/docs/dyn/drive_v2.realtime.html
@@ -81,7 +81,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get_media">get_media(fileId, revision=None)</a></code></p>
 <p class="firstline">Exports the contents of the Realtime API data model associated with this file as JSON.</p>
 <p class="toc_element">
-  <code><a href="#update">update(fileId, media_body=None, baseRevision=None)</a></code></p>
+  <code><a href="#update">update(fileId, media_body=None, media_mime_type=None, baseRevision=None)</a></code></p>
 <p class="firstline">Overwrites the Realtime API data model associated with this file with the provided JSON data model.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -105,12 +105,13 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(fileId, media_body=None, baseRevision=None)</code>
+    <code class="details" id="update">update(fileId, media_body=None, media_mime_type=None, baseRevision=None)</code>
   <pre>Overwrites the Realtime API data model associated with this file with the provided JSON data model.
 
 Args:
   fileId: string, The ID of the file that the Realtime API data model is associated with. (required)
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   baseRevision: string, The revision of the model to diff the uploaded model against. If set, the uploaded model is diffed against the provided revision and those differences are merged with any changes made to the model after the provided revision. If not set, the uploaded model replaces the current model on the server.
 </pre>
 </div>
diff --git a/docs/dyn/drive_v3.changes.html b/docs/dyn/drive_v3.changes.html
index 68dc54211e9..0dcb58fc979 100644
--- a/docs/dyn/drive_v3.changes.html
+++ b/docs/dyn/drive_v3.changes.html
@@ -125,11 +125,13 @@ <h3>Method Details</h3>
         "removed": True or False, # Whether the file has been removed from the view of the changes list, for example by deletion or lost access.
         "time": "A String", # The time of this change (RFC 3339 date-time).
         "file": { # The metadata for a file. # The updated state of the file. Present if the file has not been removed.
+          "hasThumbnail": True or False, # Whether this file has a thumbnail.
           "mimeType": "A String", # The MIME type of the file.
               # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
               # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
           "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-          "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+          "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+          "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
           "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
           "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
           "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -209,6 +211,7 @@ <h3>Method Details</h3>
           "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
               # Note that setting modifiedTime will also update modifiedByMeTime for the user.
           "viewedByMe": True or False, # Whether the file has been viewed by this user.
+          "modifiedByMe": True or False, # Whether the file has been modified by this user.
           "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
             { # Information about a Drive user.
               "me": True or False, # Whether this user is the requesting user.
diff --git a/docs/dyn/drive_v3.files.html b/docs/dyn/drive_v3.files.html
index 84dc17cc792..16cb74e55e0 100644
--- a/docs/dyn/drive_v3.files.html
+++ b/docs/dyn/drive_v3.files.html
@@ -78,7 +78,7 @@ <h2>Instance Methods</h2>
   <code><a href="#copy">copy(fileId, body, keepRevisionForever=None, ignoreDefaultVisibility=None, ocrLanguage=None)</a></code></p>
 <p class="firstline">Creates a copy of a file and applies any requested updates with patch semantics.</p>
 <p class="toc_element">
-  <code><a href="#create">create(body=None, media_body=None, keepRevisionForever=None, useContentAsIndexableText=None, ignoreDefaultVisibility=None, ocrLanguage=None)</a></code></p>
+  <code><a href="#create">create(body=None, media_body=None, keepRevisionForever=None, media_mime_type=None, useContentAsIndexableText=None, ignoreDefaultVisibility=None, ocrLanguage=None)</a></code></p>
 <p class="firstline">Creates a new file.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(fileId)</a></code></p>
@@ -108,7 +108,7 @@ <h2>Instance Methods</h2>
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#update">update(fileId, body=None, media_body=None, addParents=None, removeParents=None, useContentAsIndexableText=None, keepRevisionForever=None, ocrLanguage=None)</a></code></p>
+  <code><a href="#update">update(fileId, body=None, media_body=None, addParents=None, removeParents=None, media_mime_type=None, useContentAsIndexableText=None, keepRevisionForever=None, ocrLanguage=None)</a></code></p>
 <p class="firstline">Updates a file's metadata and/or content with patch semantics.</p>
 <p class="toc_element">
   <code><a href="#watch">watch(fileId, body, acknowledgeAbuse=None)</a></code></p>
@@ -127,11 +127,13 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The metadata for a file.
+  "hasThumbnail": True or False, # Whether this file has a thumbnail.
   "mimeType": "A String", # The MIME type of the file.
       # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
       # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
   "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+  "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
   "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
   "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
   "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -211,6 +213,7 @@ <h3>Method Details</h3>
   "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
       # Note that setting modifiedTime will also update modifiedByMeTime for the user.
   "viewedByMe": True or False, # Whether the file has been viewed by this user.
+  "modifiedByMe": True or False, # Whether the file has been modified by this user.
   "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
     { # Information about a Drive user.
       "me": True or False, # Whether this user is the requesting user.
@@ -283,11 +286,13 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "mimeType": "A String", # The MIME type of the file.
         # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
         # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
     "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -367,6 +372,7 @@ <h3>Method Details</h3>
     "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
         # Note that setting modifiedTime will also update modifiedByMeTime for the user.
     "viewedByMe": True or False, # Whether the file has been viewed by this user.
+    "modifiedByMe": True or False, # Whether the file has been modified by this user.
     "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
       { # Information about a Drive user.
         "me": True or False, # Whether this user is the requesting user.
@@ -433,7 +439,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="create">create(body=None, media_body=None, keepRevisionForever=None, useContentAsIndexableText=None, ignoreDefaultVisibility=None, ocrLanguage=None)</code>
+    <code class="details" id="create">create(body=None, media_body=None, keepRevisionForever=None, media_mime_type=None, useContentAsIndexableText=None, ignoreDefaultVisibility=None, ocrLanguage=None)</code>
   <pre>Creates a new file.
 
 Args:
@@ -441,11 +447,13 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The metadata for a file.
+  "hasThumbnail": True or False, # Whether this file has a thumbnail.
   "mimeType": "A String", # The MIME type of the file.
       # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
       # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
   "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+  "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
   "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
   "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
   "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -525,6 +533,7 @@ <h3>Method Details</h3>
   "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
       # Note that setting modifiedTime will also update modifiedByMeTime for the user.
   "viewedByMe": True or False, # Whether the file has been viewed by this user.
+  "modifiedByMe": True or False, # Whether the file has been modified by this user.
   "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
     { # Information about a Drive user.
       "me": True or False, # Whether this user is the requesting user.
@@ -591,6 +600,7 @@ <h3>Method Details</h3>
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
   keepRevisionForever: boolean, Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Drive.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   useContentAsIndexableText: boolean, Whether to use the uploaded content as indexable text.
   ignoreDefaultVisibility: boolean, Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.
   ocrLanguage: string, A language hint for OCR processing during image import (ISO 639-1 code).
@@ -599,11 +609,13 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "mimeType": "A String", # The MIME type of the file.
         # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
         # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
     "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -683,6 +695,7 @@ <h3>Method Details</h3>
     "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
         # Note that setting modifiedTime will also update modifiedByMeTime for the user.
     "viewedByMe": True or False, # Whether the file has been viewed by this user.
+    "modifiedByMe": True or False, # Whether the file has been modified by this user.
     "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
       { # Information about a Drive user.
         "me": True or False, # Whether this user is the requesting user.
@@ -817,11 +830,13 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "mimeType": "A String", # The MIME type of the file.
         # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
         # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
     "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -901,6 +916,7 @@ <h3>Method Details</h3>
     "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
         # Note that setting modifiedTime will also update modifiedByMeTime for the user.
     "viewedByMe": True or False, # Whether the file has been viewed by this user.
+    "modifiedByMe": True or False, # Whether the file has been modified by this user.
     "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
       { # Information about a Drive user.
         "me": True or False, # Whether this user is the requesting user.
@@ -1001,11 +1017,13 @@ <h3>Method Details</h3>
     { # A list of files.
     "files": [ # The page of files.
       { # The metadata for a file.
+        "hasThumbnail": True or False, # Whether this file has a thumbnail.
         "mimeType": "A String", # The MIME type of the file.
             # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
             # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
         "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-        "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+        "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+        "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
         "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
         "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
         "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -1085,6 +1103,7 @@ <h3>Method Details</h3>
         "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
             # Note that setting modifiedTime will also update modifiedByMeTime for the user.
         "viewedByMe": True or False, # Whether the file has been viewed by this user.
+        "modifiedByMe": True or False, # Whether the file has been modified by this user.
         "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
           { # Information about a Drive user.
             "me": True or False, # Whether this user is the requesting user.
@@ -1169,7 +1188,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(fileId, body=None, media_body=None, addParents=None, removeParents=None, useContentAsIndexableText=None, keepRevisionForever=None, ocrLanguage=None)</code>
+    <code class="details" id="update">update(fileId, body=None, media_body=None, addParents=None, removeParents=None, media_mime_type=None, useContentAsIndexableText=None, keepRevisionForever=None, ocrLanguage=None)</code>
   <pre>Updates a file's metadata and/or content with patch semantics.
 
 Args:
@@ -1178,11 +1197,13 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The metadata for a file.
+  "hasThumbnail": True or False, # Whether this file has a thumbnail.
   "mimeType": "A String", # The MIME type of the file.
       # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
       # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
   "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+  "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+  "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
   "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
   "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
   "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -1262,6 +1283,7 @@ <h3>Method Details</h3>
   "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
       # Note that setting modifiedTime will also update modifiedByMeTime for the user.
   "viewedByMe": True or False, # Whether the file has been viewed by this user.
+  "modifiedByMe": True or False, # Whether the file has been modified by this user.
   "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
     { # Information about a Drive user.
       "me": True or False, # Whether this user is the requesting user.
@@ -1329,6 +1351,7 @@ <h3>Method Details</h3>
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
   addParents: string, A comma-separated list of parent IDs to add.
   removeParents: string, A comma-separated list of parent IDs to remove.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   useContentAsIndexableText: boolean, Whether to use the uploaded content as indexable text.
   keepRevisionForever: boolean, Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Drive.
   ocrLanguage: string, A language hint for OCR processing during image import (ISO 639-1 code).
@@ -1337,11 +1360,13 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The metadata for a file.
+    "hasThumbnail": True or False, # Whether this file has a thumbnail.
     "mimeType": "A String", # The MIME type of the file.
         # Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
         # If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.
     "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time).
-    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours.
+    "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
+    "thumbnailVersion": "A String", # The thumbnail version for use in client-contructable thumbnail URLs or thumbnail cache invalidation.
     "explicitlyTrashed": True or False, # Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
     "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app.
     "writersCanShare": True or False, # Whether users with only writer permission can modify the file's permissions.
@@ -1421,6 +1446,7 @@ <h3>Method Details</h3>
     "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time).
         # Note that setting modifiedTime will also update modifiedByMeTime for the user.
     "viewedByMe": True or False, # Whether the file has been viewed by this user.
+    "modifiedByMe": True or False, # Whether the file has been modified by this user.
     "owners": [ # The owners of the file. Currently, only certain legacy files may have more than one owner.
       { # Information about a Drive user.
         "me": True or False, # Whether this user is the requesting user.
diff --git a/docs/dyn/firebasedynamiclinks_v1.shortLinks.html b/docs/dyn/firebasedynamiclinks_v1.shortLinks.html
index ca5bcab60ae..f09450e83d2 100644
--- a/docs/dyn/firebasedynamiclinks_v1.shortLinks.html
+++ b/docs/dyn/firebasedynamiclinks_v1.shortLinks.html
@@ -122,9 +122,6 @@ <h3>Method Details</h3>
               # track sales from a specific marketing campaign.
         },
       },
-      "isAd": True or False, # Declares that the Dynamic Link is used in an advertisement.
-          # See the 'ad' parameter in the
-          # [documentation](https://firebase.google.com/docs/dynamic-links/android#create-a-dynamic-link-programmatically).
       "iosInfo": { # iOS related attributes to the Dynamic Link.. # iOS related information. See iOS related parameters in the
           # [documentation](https://firebase.google.com/docs/dynamic-links/ios#create-a-dynamic-link-programmatically).
         "iosCustomScheme": "A String", # Custom (destination) scheme to use for iOS. By default, we’ll use the
diff --git a/docs/dyn/fitness_v1.users.dataSources.datasets.html b/docs/dyn/fitness_v1.users.dataSources.datasets.html
index 8142faedd4a..4bedb9d4289 100644
--- a/docs/dyn/fitness_v1.users.dataSources.datasets.html
+++ b/docs/dyn/fitness_v1.users.dataSources.datasets.html
@@ -134,7 +134,7 @@ <h3>Method Details</h3>
               # Only one of integer and floating point fields will be populated, depending on the format enum value within data source's type field.
             { # Holder object for the value of a single field in a data point.
                 #
-                # A field value has a particular format and is only ever set to one of an integer or a floating point value.
+                # A field value has a particular format and is only ever set to one of an integer or a floating point value. LINT.IfChange
               "mapVal": [ # Map value. The valid key space and units for the corresponding value of each entry should be documented as part of the data type definition. Keys should be kept small whenever possible. Data streams with large keys and high data frequency may be down sampled.
                 {
                   "value": { # Holder object for the value of an entry in a map field of a data point.
@@ -203,7 +203,7 @@ <h3>Method Details</h3>
             # Only one of integer and floating point fields will be populated, depending on the format enum value within data source's type field.
           { # Holder object for the value of a single field in a data point.
               #
-              # A field value has a particular format and is only ever set to one of an integer or a floating point value.
+              # A field value has a particular format and is only ever set to one of an integer or a floating point value. LINT.IfChange
             "mapVal": [ # Map value. The valid key space and units for the corresponding value of each entry should be documented as part of the data type definition. Keys should be kept small whenever possible. Data streams with large keys and high data frequency may be down sampled.
               {
                 "value": { # Holder object for the value of an entry in a map field of a data point.
@@ -251,7 +251,7 @@ <h3>Method Details</h3>
               # Only one of integer and floating point fields will be populated, depending on the format enum value within data source's type field.
             { # Holder object for the value of a single field in a data point.
                 #
-                # A field value has a particular format and is only ever set to one of an integer or a floating point value.
+                # A field value has a particular format and is only ever set to one of an integer or a floating point value. LINT.IfChange
               "mapVal": [ # Map value. The valid key space and units for the corresponding value of each entry should be documented as part of the data type definition. Keys should be kept small whenever possible. Data streams with large keys and high data frequency may be down sampled.
                 {
                   "value": { # Holder object for the value of an entry in a map field of a data point.
diff --git a/docs/dyn/fitness_v1.users.dataset.html b/docs/dyn/fitness_v1.users.dataset.html
index 5eb1e41ff6b..8b68b2f30c3 100644
--- a/docs/dyn/fitness_v1.users.dataset.html
+++ b/docs/dyn/fitness_v1.users.dataset.html
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
                       # Only one of integer and floating point fields will be populated, depending on the format enum value within data source's type field.
                     { # Holder object for the value of a single field in a data point.
                         #
-                        # A field value has a particular format and is only ever set to one of an integer or a floating point value.
+                        # A field value has a particular format and is only ever set to one of an integer or a floating point value. LINT.IfChange
                       "mapVal": [ # Map value. The valid key space and units for the corresponding value of each entry should be documented as part of the data type definition. Keys should be kept small whenever possible. Data streams with large keys and high data frequency may be down sampled.
                         {
                           "value": { # Holder object for the value of an entry in a map field of a data point.
diff --git a/docs/dyn/fusiontables_v1.table.html b/docs/dyn/fusiontables_v1.table.html
index 6cba52caa88..a229092bf88 100644
--- a/docs/dyn/fusiontables_v1.table.html
+++ b/docs/dyn/fusiontables_v1.table.html
@@ -84,10 +84,10 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(tableId)</a></code></p>
 <p class="firstline">Retrieves a specific table by its id.</p>
 <p class="toc_element">
-  <code><a href="#importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</a></code></p>
+  <code><a href="#importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</a></code></p>
 <p class="firstline">Import more rows into a table.</p>
 <p class="toc_element">
-  <code><a href="#importTable">importTable(name, media_body=None, encoding=None, delimiter=None)</a></code></p>
+  <code><a href="#importTable">importTable(name, media_body=None, encoding=None, delimiter=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Import a new table.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(body)</a></code></p>
@@ -194,7 +194,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</code>
+    <code class="details" id="importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</code>
   <pre>Import more rows into a table.
 
 Args:
@@ -203,6 +203,7 @@ <h3>Method Details</h3>
   startLine: integer, The index of the first line from which to start importing, inclusive. Default is 0.
   isStrict: boolean, Whether the CSV must have the same number of values for each row. If false, rows with fewer values will be padded with empty values. Default is true.
   encoding: string, The encoding of the content. Default is UTF-8. Use 'auto-detect' if you are unsure of the encoding.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ','.
   endLine: integer, The index of the last line from which to start importing, exclusive. Thus, the number of imported lines is endLine - startLine. If this parameter is not provided, the file will be imported until the last line of the file. If endLine is negative, then the imported content will exclude the last endLine lines. That is, if endline is negative, no line will be imported whose index is greater than N + endLine where N is the number of lines in the file, and the number of imported lines will be N + endLine - startLine.
 
@@ -216,7 +217,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="importTable">importTable(name, media_body=None, encoding=None, delimiter=None)</code>
+    <code class="details" id="importTable">importTable(name, media_body=None, encoding=None, delimiter=None, media_mime_type=None)</code>
   <pre>Import a new table.
 
 Args:
@@ -224,6 +225,7 @@ <h3>Method Details</h3>
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
   encoding: string, The encoding of the content. Default is UTF-8. Use 'auto-detect' if you are unsure of the encoding.
   delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ','.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/fusiontables_v2.table.html b/docs/dyn/fusiontables_v2.table.html
index 52cde047d66..0f1c00e8cea 100644
--- a/docs/dyn/fusiontables_v2.table.html
+++ b/docs/dyn/fusiontables_v2.table.html
@@ -84,10 +84,10 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(tableId)</a></code></p>
 <p class="firstline">Retrieves a specific table by its ID.</p>
 <p class="toc_element">
-  <code><a href="#importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</a></code></p>
+  <code><a href="#importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</a></code></p>
 <p class="firstline">Imports more rows into a table.</p>
 <p class="toc_element">
-  <code><a href="#importTable">importTable(name, media_body=None, encoding=None, delimiter=None)</a></code></p>
+  <code><a href="#importTable">importTable(name, media_body=None, encoding=None, delimiter=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Imports a new table.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(body)</a></code></p>
@@ -102,7 +102,7 @@ <h2>Instance Methods</h2>
   <code><a href="#patch">patch(tableId, body, replaceViewDefinition=None)</a></code></p>
 <p class="firstline">Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated. This method supports patch semantics.</p>
 <p class="toc_element">
-  <code><a href="#replaceRows">replaceRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</a></code></p>
+  <code><a href="#replaceRows">replaceRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</a></code></p>
 <p class="firstline">Replaces rows of an existing table. Current rows remain visible until all replacement rows are ready.</p>
 <p class="toc_element">
   <code><a href="#update">update(tableId, body, replaceViewDefinition=None)</a></code></p>
@@ -223,7 +223,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</code>
+    <code class="details" id="importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</code>
   <pre>Imports more rows into a table.
 
 Args:
@@ -232,6 +232,7 @@ <h3>Method Details</h3>
   startLine: integer, The index of the first line from which to start importing, inclusive. Default is 0.
   isStrict: boolean, Whether the imported CSV must have the same number of values for each row. If false, rows with fewer values will be padded with empty values. Default is true.
   encoding: string, The encoding of the content. Default is UTF-8. Use auto-detect if you are unsure of the encoding.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
   endLine: integer, The index of the line up to which data will be imported. Default is to import the entire file. If endLine is negative, it is an offset from the end of the file; the imported content will exclude the last endLine lines.
 
@@ -245,7 +246,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="importTable">importTable(name, media_body=None, encoding=None, delimiter=None)</code>
+    <code class="details" id="importTable">importTable(name, media_body=None, encoding=None, delimiter=None, media_mime_type=None)</code>
   <pre>Imports a new table.
 
 Args:
@@ -253,6 +254,7 @@ <h3>Method Details</h3>
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
   encoding: string, The encoding of the content. Default is UTF-8. Use auto-detect if you are unsure of the encoding.
   delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
@@ -565,7 +567,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="replaceRows">replaceRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</code>
+    <code class="details" id="replaceRows">replaceRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</code>
   <pre>Replaces rows of an existing table. Current rows remain visible until all replacement rows are ready.
 
 Args:
@@ -574,6 +576,7 @@ <h3>Method Details</h3>
   startLine: integer, The index of the first line from which to start importing, inclusive. Default is 0.
   isStrict: boolean, Whether the imported CSV must have the same number of column values for each row. If true, throws an exception if the CSV does not have the same number of columns. If false, rows with fewer column values will be padded with empty values. Default is true.
   encoding: string, The encoding of the content. Default is UTF-8. Use 'auto-detect' if you are unsure of the encoding.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
   endLine: integer, The index of the line up to which data will be imported. Default is to import the entire file. If endLine is negative, it is an offset from the end of the file; the imported content will exclude the last endLine lines.
 
diff --git a/docs/dyn/gamesConfiguration_v1configuration.imageConfigurations.html b/docs/dyn/gamesConfiguration_v1configuration.imageConfigurations.html
index 05d8a8ad444..5b99373ecc0 100644
--- a/docs/dyn/gamesConfiguration_v1configuration.imageConfigurations.html
+++ b/docs/dyn/gamesConfiguration_v1configuration.imageConfigurations.html
@@ -75,11 +75,11 @@
 <h1><a href="gamesConfiguration_v1configuration.html">Google Play Game Services Publishing API</a> . <a href="gamesConfiguration_v1configuration.imageConfigurations.html">imageConfigurations</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#upload">upload(resourceId, imageType, media_body=None)</a></code></p>
+  <code><a href="#upload">upload(resourceId, imageType, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Uploads an image for a resource with the given ID and image type.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="upload">upload(resourceId, imageType, media_body=None)</code>
+    <code class="details" id="upload">upload(resourceId, imageType, media_body=None, media_mime_type=None)</code>
   <pre>Uploads an image for a resource with the given ID and image type.
 
 Args:
@@ -89,6 +89,7 @@ <h3>Method Details</h3>
       ACHIEVEMENT_ICON - The icon image for an achievement resource.
       LEADERBOARD_ICON - The icon image for a leaderboard resource.
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/genomics_v1.operations.html b/docs/dyn/genomics_v1.operations.html
index b4684a934b7..590e9f24348 100644
--- a/docs/dyn/genomics_v1.operations.html
+++ b/docs/dyn/genomics_v1.operations.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
 Args:
   name: string, The name of the operation collection. (required)
   pageSize: integer, The maximum number of results to return. If unspecified, defaults to 256. The maximum value is 2048.
-  filter: string, A string for filtering Operations. The following filter fields are supported: * projectId: Required. Corresponds to OperationMetadata.projectId. * createTime: The time this job was created, in seconds from the [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `projectId = my-project AND createTime >= 1432140000 AND createTime <= 1432150000 AND status = RUNNING`
+  filter: string, A string for filtering Operations. The following filter fields are supported: * projectId: Required. Corresponds to OperationMetadata.projectId. * createTime: The time this job was created, in seconds from the [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `projectId = my-project AND createTime >= 1432140000 AND createTime <= 1432150000 AND status = RUNNING` * `projectId = my-project AND labels.color = *` * `projectId = my-project AND labels.color = red`
   pageToken: string, The standard list page token.
   x__xgafv: string, V1 error format.
 
diff --git a/docs/dyn/genomics_v1alpha2.operations.html b/docs/dyn/genomics_v1alpha2.operations.html
index 39b7939b698..9c9d39fdcda 100644
--- a/docs/dyn/genomics_v1alpha2.operations.html
+++ b/docs/dyn/genomics_v1alpha2.operations.html
@@ -147,7 +147,7 @@ <h3>Method Details</h3>
 Args:
   name: string, The name of the operation collection. (required)
   pageSize: integer, The maximum number of results to return. If unspecified, defaults to 256. The maximum value is 2048.
-  filter: string, A string for filtering Operations. The following filter fields are supported: * projectId: Required. Corresponds to OperationMetadata.projectId. * createTime: The time this job was created, in seconds from the [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `projectId = my-project AND createTime >= 1432140000 AND createTime <= 1432150000 AND status = RUNNING`
+  filter: string, A string for filtering Operations. The following filter fields are supported: * projectId: Required. Corresponds to OperationMetadata.projectId. * createTime: The time this job was created, in seconds from the [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `= 1432140000` * `projectId = my-project AND createTime >= 1432140000 AND createTime <= 1432150000 AND status = RUNNING` * `projectId = my-project AND labels.color = *` * `projectId = my-project AND labels.color = red`
   pageToken: string, The standard list page token.
   x__xgafv: string, V1 error format.
 
diff --git a/docs/dyn/genomics_v1alpha2.pipelines.html b/docs/dyn/genomics_v1alpha2.pipelines.html
index 993c52bbe3a..eb8ab7f3a5c 100644
--- a/docs/dyn/genomics_v1alpha2.pipelines.html
+++ b/docs/dyn/genomics_v1alpha2.pipelines.html
@@ -447,13 +447,16 @@ <h3>Method Details</h3>
         "gcsPath": "A String", # The location in Google Cloud Storage to which the pipeline logs will be copied. Can be specified as a fully qualified directory path, in which case logs will be output with a unique identifier as the filename in that directory, or as a fully specified path, which must end in `.log`, in which case that path will be used, and the user must ensure that logs are not overwritten. Stdout and stderr logs from the run are also generated and output as `-stdout.log` and `-stderr.log`.
       },
       "projectId": "A String", # Required. The project in which to run the pipeline. The caller must have WRITER access to all Google Cloud services and resources (e.g. Google Compute Engine) will be used.
+      "labels": { # Labels to apply to this pipeline run. Labels will also be applied to compute resources (VM, disks) created by this pipeline run. When listing operations, operations can filtered by labels. Label keys may not be empty; label values may be empty. Non-empty labels must be 1-63 characters long, and comply with [RFC1035] (https://www.ietf.org/rfc/rfc1035.txt). Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+        "a_key": "A String",
+      },
       "serviceAccount": { # A Google Cloud Service Account. # The Google Cloud Service Account that will be used to access data and services. By default, the compute service account associated with `projectId` is used.
         "scopes": [ # List of scopes to be enabled for this service account on the VM. The following scopes are automatically included: * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/devstorage.full_control * https://www.googleapis.com/auth/genomics * https://www.googleapis.com/auth/logging.write * https://www.googleapis.com/auth/monitoring.write
           "A String",
         ],
         "email": "A String", # Email address of the service account. Defaults to `default`, which uses the compute service account associated with the project.
       },
-      "clientId": "A String", # Client-specified pipeline operation identifier.
+      "clientId": "A String", # This field is deprecated. Use `labels` instead. Client-specified pipeline operation identifier.
       "outputs": { # Pipeline output arguments; keys are defined in the pipeline documentation. All output parameters of without default values must be specified. If parameters with defaults are specified here, the defaults will be overridden.
         "a_key": "A String",
       },
diff --git a/docs/dyn/gmail_v1.users.drafts.html b/docs/dyn/gmail_v1.users.drafts.html
index 702e37cc863..a021d4578e1 100644
--- a/docs/dyn/gmail_v1.users.drafts.html
+++ b/docs/dyn/gmail_v1.users.drafts.html
@@ -75,7 +75,7 @@
 <h1><a href="gmail_v1.html">Gmail API</a> . <a href="gmail_v1.users.html">users</a> . <a href="gmail_v1.users.drafts.html">drafts</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#create">create(userId, body=None, media_body=None)</a></code></p>
+  <code><a href="#create">create(userId, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Creates a new draft with the DRAFT label.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(userId, id)</a></code></p>
@@ -90,14 +90,14 @@ <h2>Instance Methods</h2>
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#send">send(userId, body=None, media_body=None)</a></code></p>
+  <code><a href="#send">send(userId, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Sends the specified, existing draft to the recipients in the To, Cc, and Bcc headers.</p>
 <p class="toc_element">
-  <code><a href="#update">update(userId, id, body=None, media_body=None)</a></code></p>
+  <code><a href="#update">update(userId, id, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Replaces a draft's content.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(userId, body=None, media_body=None)</code>
+    <code class="details" id="create">create(userId, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Creates a new draft with the DRAFT label.
 
 Args:
@@ -111,9 +111,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -144,6 +144,7 @@ <h3>Method Details</h3>
 }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
@@ -154,9 +155,9 @@ <h3>Method Details</h3>
       "historyId": "A String", # The ID of the last history record that modified this message.
       "payload": { # A single MIME message part. # The parsed email structure in the message parts.
         "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-          "data": "A String", # 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.
+          "data": "A String", # 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.
           "attachmentId": "A String", # 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.
-          "size": 42, # Total number of bytes in the body of the message part.
+          "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
         },
         "mimeType": "A String", # The MIME type of the message part.
         "partId": "A String", # The immutable ID of the message part.
@@ -220,9 +221,9 @@ <h3>Method Details</h3>
       "historyId": "A String", # The ID of the last history record that modified this message.
       "payload": { # A single MIME message part. # The parsed email structure in the message parts.
         "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-          "data": "A String", # 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.
+          "data": "A String", # 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.
           "attachmentId": "A String", # 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.
-          "size": 42, # Total number of bytes in the body of the message part.
+          "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
         },
         "mimeType": "A String", # The MIME type of the message part.
         "partId": "A String", # The immutable ID of the message part.
@@ -277,9 +278,9 @@ <h3>Method Details</h3>
           "historyId": "A String", # The ID of the last history record that modified this message.
           "payload": { # A single MIME message part. # The parsed email structure in the message parts.
             "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-              "data": "A String", # 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.
+              "data": "A String", # 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.
               "attachmentId": "A String", # 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.
-              "size": 42, # Total number of bytes in the body of the message part.
+              "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
             },
             "mimeType": "A String", # The MIME type of the message part.
             "partId": "A String", # The immutable ID of the message part.
@@ -327,7 +328,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="send">send(userId, body=None, media_body=None)</code>
+    <code class="details" id="send">send(userId, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Sends the specified, existing draft to the recipients in the To, Cc, and Bcc headers.
 
 Args:
@@ -341,9 +342,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -374,6 +375,7 @@ <h3>Method Details</h3>
 }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
@@ -383,9 +385,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -415,7 +417,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(userId, id, body=None, media_body=None)</code>
+    <code class="details" id="update">update(userId, id, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Replaces a draft's content.
 
 Args:
@@ -430,9 +432,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -463,6 +465,7 @@ <h3>Method Details</h3>
 }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
@@ -473,9 +476,9 @@ <h3>Method Details</h3>
       "historyId": "A String", # The ID of the last history record that modified this message.
       "payload": { # A single MIME message part. # The parsed email structure in the message parts.
         "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-          "data": "A String", # 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.
+          "data": "A String", # 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.
           "attachmentId": "A String", # 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.
-          "size": 42, # Total number of bytes in the body of the message part.
+          "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
         },
         "mimeType": "A String", # The MIME type of the message part.
         "partId": "A String", # The immutable ID of the message part.
diff --git a/docs/dyn/gmail_v1.users.history.html b/docs/dyn/gmail_v1.users.history.html
index ae0040d03fe..f460c35acf2 100644
--- a/docs/dyn/gmail_v1.users.history.html
+++ b/docs/dyn/gmail_v1.users.history.html
@@ -110,9 +110,9 @@ <h3>Method Details</h3>
               "historyId": "A String", # The ID of the last history record that modified this message.
               "payload": { # A single MIME message part. # The parsed email structure in the message parts.
                 "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-                  "data": "A String", # 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.
+                  "data": "A String", # 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.
                   "attachmentId": "A String", # 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.
-                  "size": 42, # Total number of bytes in the body of the message part.
+                  "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
                 },
                 "mimeType": "A String", # The MIME type of the message part.
                 "partId": "A String", # The immutable ID of the message part.
@@ -147,9 +147,9 @@ <h3>Method Details</h3>
             "historyId": "A String", # The ID of the last history record that modified this message.
             "payload": { # A single MIME message part. # The parsed email structure in the message parts.
               "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-                "data": "A String", # 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.
+                "data": "A String", # 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.
                 "attachmentId": "A String", # 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.
-                "size": 42, # Total number of bytes in the body of the message part.
+                "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
               },
               "mimeType": "A String", # The MIME type of the message part.
               "partId": "A String", # The immutable ID of the message part.
@@ -184,9 +184,9 @@ <h3>Method Details</h3>
               "historyId": "A String", # The ID of the last history record that modified this message.
               "payload": { # A single MIME message part. # The parsed email structure in the message parts.
                 "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-                  "data": "A String", # 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.
+                  "data": "A String", # 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.
                   "attachmentId": "A String", # 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.
-                  "size": 42, # Total number of bytes in the body of the message part.
+                  "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
                 },
                 "mimeType": "A String", # The MIME type of the message part.
                 "partId": "A String", # The immutable ID of the message part.
@@ -225,9 +225,9 @@ <h3>Method Details</h3>
               "historyId": "A String", # The ID of the last history record that modified this message.
               "payload": { # A single MIME message part. # The parsed email structure in the message parts.
                 "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-                  "data": "A String", # 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.
+                  "data": "A String", # 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.
                   "attachmentId": "A String", # 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.
-                  "size": 42, # Total number of bytes in the body of the message part.
+                  "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
                 },
                 "mimeType": "A String", # The MIME type of the message part.
                 "partId": "A String", # The immutable ID of the message part.
@@ -263,9 +263,9 @@ <h3>Method Details</h3>
               "historyId": "A String", # The ID of the last history record that modified this message.
               "payload": { # A single MIME message part. # The parsed email structure in the message parts.
                 "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-                  "data": "A String", # 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.
+                  "data": "A String", # 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.
                   "attachmentId": "A String", # 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.
-                  "size": 42, # Total number of bytes in the body of the message part.
+                  "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
                 },
                 "mimeType": "A String", # The MIME type of the message part.
                 "partId": "A String", # The immutable ID of the message part.
diff --git a/docs/dyn/gmail_v1.users.messages.attachments.html b/docs/dyn/gmail_v1.users.messages.attachments.html
index 0e040b2c73d..a5ea7fb03b5 100644
--- a/docs/dyn/gmail_v1.users.messages.attachments.html
+++ b/docs/dyn/gmail_v1.users.messages.attachments.html
@@ -91,9 +91,9 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The body of a single MIME message part.
-    "data": "A String", # 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.
+    "data": "A String", # 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.
     "attachmentId": "A String", # 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.
-    "size": 42, # Total number of bytes in the body of the message part.
+    "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
   }</pre>
 </div>
 
diff --git a/docs/dyn/gmail_v1.users.messages.html b/docs/dyn/gmail_v1.users.messages.html
index 65bb8709c15..e66cef779f5 100644
--- a/docs/dyn/gmail_v1.users.messages.html
+++ b/docs/dyn/gmail_v1.users.messages.html
@@ -82,6 +82,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#batchDelete">batchDelete(userId, body)</a></code></p>
 <p class="firstline">Deletes many messages by message ID. Provides no guarantees that messages were not already deleted or even existed at all.</p>
+<p class="toc_element">
+  <code><a href="#batchModify">batchModify(userId, body)</a></code></p>
+<p class="firstline">Modifies the labels on the specified messages.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(userId, id)</a></code></p>
 <p class="firstline">Immediately and permanently deletes the specified message. This operation cannot be undone. Prefer messages.trash instead.</p>
@@ -89,10 +92,10 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(userId, id, format=None, metadataHeaders=None)</a></code></p>
 <p class="firstline">Gets the specified message.</p>
 <p class="toc_element">
-  <code><a href="#import_">import_(userId, body=None, media_body=None, internalDateSource=None, neverMarkSpam=None, processForCalendar=None, deleted=None)</a></code></p>
+  <code><a href="#import_">import_(userId, body=None, media_body=None, internalDateSource=None, neverMarkSpam=None, media_mime_type=None, deleted=None, processForCalendar=None)</a></code></p>
 <p class="firstline">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.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(userId, body=None, media_body=None, internalDateSource=None, deleted=None)</a></code></p>
+  <code><a href="#insert">insert(userId, body=None, media_body=None, internalDateSource=None, media_mime_type=None, deleted=None)</a></code></p>
 <p class="firstline">Directly inserts a message into only this user's mailbox similar to IMAP APPEND, bypassing most scanning and classification. Does not send a message.</p>
 <p class="toc_element">
   <code><a href="#list">list(userId, labelIds=None, q=None, pageToken=None, maxResults=None, includeSpamTrash=None)</a></code></p>
@@ -104,7 +107,7 @@ <h2>Instance Methods</h2>
   <code><a href="#modify">modify(userId, id, body)</a></code></p>
 <p class="firstline">Modifies the labels on the specified message.</p>
 <p class="toc_element">
-  <code><a href="#send">send(userId, body=None, media_body=None)</a></code></p>
+  <code><a href="#send">send(userId, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Sends the specified message to the recipients in the To, Cc, and Bcc headers.</p>
 <p class="toc_element">
   <code><a href="#trash">trash(userId, id)</a></code></p>
@@ -131,6 +134,30 @@ <h3>Method Details</h3>
 </pre>
 </div>
 
+<div class="method">
+    <code class="details" id="batchModify">batchModify(userId, body)</code>
+  <pre>Modifies the labels on the specified messages.
+
+Args:
+  userId: string, The user's email address. The special value me can be used to indicate the authenticated user. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{
+    "removeLabelIds": [ # A list of label IDs to remove from messages.
+      "A String",
+    ],
+    "ids": [ # The IDs of the messages to modify. There is a limit of 1000 ids per request.
+      "A String",
+    ],
+    "addLabelIds": [ # A list of label IDs to add to messages.
+      "A String",
+    ],
+  }
+
+</pre>
+</div>
+
 <div class="method">
     <code class="details" id="delete">delete(userId, id)</code>
   <pre>Immediately and permanently deletes the specified message. This operation cannot be undone. Prefer messages.trash instead.
@@ -164,9 +191,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -196,7 +223,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="import_">import_(userId, body=None, media_body=None, internalDateSource=None, neverMarkSpam=None, processForCalendar=None, deleted=None)</code>
+    <code class="details" id="import_">import_(userId, body=None, media_body=None, internalDateSource=None, neverMarkSpam=None, media_mime_type=None, deleted=None, processForCalendar=None)</code>
   <pre>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.
 
 Args:
@@ -209,9 +236,9 @@ <h3>Method Details</h3>
   "historyId": "A String", # The ID of the last history record that modified this message.
   "payload": { # A single MIME message part. # The parsed email structure in the message parts.
     "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-      "data": "A String", # 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.
+      "data": "A String", # 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.
       "attachmentId": "A String", # 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.
-      "size": 42, # Total number of bytes in the body of the message part.
+      "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
     },
     "mimeType": "A String", # The MIME type of the message part.
     "partId": "A String", # The immutable ID of the message part.
@@ -245,8 +272,9 @@ <h3>Method Details</h3>
       dateHeader - 
       receivedTime - 
   neverMarkSpam: boolean, Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox.
-  processForCalendar: boolean, Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   deleted: boolean, Mark the email as permanently deleted (not TRASH) and only visible in Google Apps Vault to a Vault administrator. Only used for Google Apps for Work accounts.
+  processForCalendar: boolean, Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user.
 
 Returns:
   An object of the form:
@@ -256,9 +284,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -288,7 +316,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(userId, body=None, media_body=None, internalDateSource=None, deleted=None)</code>
+    <code class="details" id="insert">insert(userId, body=None, media_body=None, internalDateSource=None, media_mime_type=None, deleted=None)</code>
   <pre>Directly inserts a message into only this user's mailbox similar to IMAP APPEND, bypassing most scanning and classification. Does not send a message.
 
 Args:
@@ -301,9 +329,9 @@ <h3>Method Details</h3>
   "historyId": "A String", # The ID of the last history record that modified this message.
   "payload": { # A single MIME message part. # The parsed email structure in the message parts.
     "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-      "data": "A String", # 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.
+      "data": "A String", # 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.
       "attachmentId": "A String", # 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.
-      "size": 42, # Total number of bytes in the body of the message part.
+      "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
     },
     "mimeType": "A String", # The MIME type of the message part.
     "partId": "A String", # The immutable ID of the message part.
@@ -336,6 +364,7 @@ <h3>Method Details</h3>
     Allowed values
       dateHeader - 
       receivedTime - 
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   deleted: boolean, Mark the email as permanently deleted (not TRASH) and only visible in Google Apps Vault to a Vault administrator. Only used for Google Apps for Work accounts.
 
 Returns:
@@ -346,9 +375,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -384,7 +413,7 @@ <h3>Method Details</h3>
 Args:
   userId: string, The user's email address. The special value me can be used to indicate the authenticated user. (required)
   labelIds: string, Only return messages with labels that match all of the specified label IDs. (repeated)
-  q: string, 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".
+  q: string, 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.
   pageToken: string, Page token to retrieve a specific page of results in the list.
   maxResults: integer, Maximum number of messages to return.
   includeSpamTrash: boolean, Include messages from SPAM and TRASH in the results.
@@ -401,9 +430,9 @@ <h3>Method Details</h3>
         "historyId": "A String", # The ID of the last history record that modified this message.
         "payload": { # A single MIME message part. # The parsed email structure in the message parts.
           "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-            "data": "A String", # 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.
+            "data": "A String", # 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.
             "attachmentId": "A String", # 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.
-            "size": 42, # Total number of bytes in the body of the message part.
+            "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
           },
           "mimeType": "A String", # The MIME type of the message part.
           "partId": "A String", # The immutable ID of the message part.
@@ -476,9 +505,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -508,7 +537,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="send">send(userId, body=None, media_body=None)</code>
+    <code class="details" id="send">send(userId, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Sends the specified message to the recipients in the To, Cc, and Bcc headers.
 
 Args:
@@ -521,9 +550,9 @@ <h3>Method Details</h3>
   "historyId": "A String", # The ID of the last history record that modified this message.
   "payload": { # A single MIME message part. # The parsed email structure in the message parts.
     "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-      "data": "A String", # 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.
+      "data": "A String", # 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.
       "attachmentId": "A String", # 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.
-      "size": 42, # Total number of bytes in the body of the message part.
+      "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
     },
     "mimeType": "A String", # The MIME type of the message part.
     "partId": "A String", # The immutable ID of the message part.
@@ -552,6 +581,7 @@ <h3>Method Details</h3>
 }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
@@ -561,9 +591,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -608,9 +638,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
@@ -655,9 +685,9 @@ <h3>Method Details</h3>
     "historyId": "A String", # The ID of the last history record that modified this message.
     "payload": { # A single MIME message part. # The parsed email structure in the message parts.
       "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-        "data": "A String", # 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.
+        "data": "A String", # 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.
         "attachmentId": "A String", # 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.
-        "size": 42, # Total number of bytes in the body of the message part.
+        "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
       },
       "mimeType": "A String", # The MIME type of the message part.
       "partId": "A String", # The immutable ID of the message part.
diff --git a/docs/dyn/gmail_v1.users.settings.html b/docs/dyn/gmail_v1.users.settings.html
index cb5f4686813..9675a3545a9 100644
--- a/docs/dyn/gmail_v1.users.settings.html
+++ b/docs/dyn/gmail_v1.users.settings.html
@@ -175,7 +175,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Vacation auto-reply settings for an account. These settings correspond to the "Vacation responder" feature in the web interface. See  for more details.
+    { # Vacation auto-reply settings for an account. These settings correspond to the "Vacation responder" feature in the web interface.
       "responseSubject": "A String", # Optional text to prepend to the subject line in vacation responses. In order to enable auto-replies, either the response subject or the response body must be nonempty.
       "responseBodyPlainText": "A String", # Response body in plain text format.
       "restrictToContacts": True or False, # Flag that determines whether responses are sent to recipients who are not in the user's list of contacts.
@@ -274,7 +274,7 @@ <h3>Method Details</h3>
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Vacation auto-reply settings for an account. These settings correspond to the "Vacation responder" feature in the web interface. See  for more details.
+{ # Vacation auto-reply settings for an account. These settings correspond to the "Vacation responder" feature in the web interface.
     "responseSubject": "A String", # Optional text to prepend to the subject line in vacation responses. In order to enable auto-replies, either the response subject or the response body must be nonempty.
     "responseBodyPlainText": "A String", # Response body in plain text format.
     "restrictToContacts": True or False, # Flag that determines whether responses are sent to recipients who are not in the user's list of contacts.
@@ -289,7 +289,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Vacation auto-reply settings for an account. These settings correspond to the "Vacation responder" feature in the web interface. See  for more details.
+    { # Vacation auto-reply settings for an account. These settings correspond to the "Vacation responder" feature in the web interface.
       "responseSubject": "A String", # Optional text to prepend to the subject line in vacation responses. In order to enable auto-replies, either the response subject or the response body must be nonempty.
       "responseBodyPlainText": "A String", # Response body in plain text format.
       "restrictToContacts": True or False, # Flag that determines whether responses are sent to recipients who are not in the user's list of contacts.
diff --git a/docs/dyn/gmail_v1.users.settings.sendAs.html b/docs/dyn/gmail_v1.users.settings.sendAs.html
index dbf37e328e4..6d0231ff7b7 100644
--- a/docs/dyn/gmail_v1.users.settings.sendAs.html
+++ b/docs/dyn/gmail_v1.users.settings.sendAs.html
@@ -105,7 +105,7 @@ <h3>Method Details</h3>
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # 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.
+{ # 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.
   "smtpMsa": { # Configuration for communication with an SMTP service. # 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.
     "securityMode": "A String", # The protocol that will be used to secure communication with the SMTP service. Required.
     "username": "A String", # The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
@@ -116,7 +116,7 @@ <h3>Method Details</h3>
   "displayName": "A String", # 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.
   "replyToAddress": "A String", # An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
   "signature": "A String", # An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.
-  "treatAsAlias": True or False, # 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.
+  "treatAsAlias": True or False, # Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
   "sendAsEmail": "A String", # The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
   "isPrimary": True or False, # Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
   "verificationStatus": "A String", # Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
@@ -127,7 +127,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # 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.
+    { # 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.
     "smtpMsa": { # Configuration for communication with an SMTP service. # 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.
       "securityMode": "A String", # The protocol that will be used to secure communication with the SMTP service. Required.
       "username": "A String", # The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
@@ -138,7 +138,7 @@ <h3>Method Details</h3>
     "displayName": "A String", # 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.
     "replyToAddress": "A String", # An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
     "signature": "A String", # An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.
-    "treatAsAlias": True or False, # 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.
+    "treatAsAlias": True or False, # Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
     "sendAsEmail": "A String", # The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
     "isPrimary": True or False, # Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
     "verificationStatus": "A String", # Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
@@ -167,7 +167,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # 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.
+    { # 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.
     "smtpMsa": { # Configuration for communication with an SMTP service. # 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.
       "securityMode": "A String", # The protocol that will be used to secure communication with the SMTP service. Required.
       "username": "A String", # The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
@@ -178,7 +178,7 @@ <h3>Method Details</h3>
     "displayName": "A String", # 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.
     "replyToAddress": "A String", # An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
     "signature": "A String", # An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.
-    "treatAsAlias": True or False, # 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.
+    "treatAsAlias": True or False, # Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
     "sendAsEmail": "A String", # The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
     "isPrimary": True or False, # Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
     "verificationStatus": "A String", # Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
@@ -198,7 +198,7 @@ <h3>Method Details</h3>
 
     { # Response for the ListSendAs method.
     "sendAs": [ # List of send-as aliases.
-      { # 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.
+      { # 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.
         "smtpMsa": { # Configuration for communication with an SMTP service. # 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.
           "securityMode": "A String", # The protocol that will be used to secure communication with the SMTP service. Required.
           "username": "A String", # The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
@@ -209,7 +209,7 @@ <h3>Method Details</h3>
         "displayName": "A String", # 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.
         "replyToAddress": "A String", # An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
         "signature": "A String", # An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.
-        "treatAsAlias": True or False, # 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.
+        "treatAsAlias": True or False, # Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
         "sendAsEmail": "A String", # The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
         "isPrimary": True or False, # Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
         "verificationStatus": "A String", # Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
@@ -229,7 +229,7 @@ <h3>Method Details</h3>
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # 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.
+{ # 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.
   "smtpMsa": { # Configuration for communication with an SMTP service. # 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.
     "securityMode": "A String", # The protocol that will be used to secure communication with the SMTP service. Required.
     "username": "A String", # The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
@@ -240,7 +240,7 @@ <h3>Method Details</h3>
   "displayName": "A String", # 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.
   "replyToAddress": "A String", # An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
   "signature": "A String", # An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.
-  "treatAsAlias": True or False, # 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.
+  "treatAsAlias": True or False, # Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
   "sendAsEmail": "A String", # The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
   "isPrimary": True or False, # Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
   "verificationStatus": "A String", # Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
@@ -251,7 +251,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # 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.
+    { # 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.
     "smtpMsa": { # Configuration for communication with an SMTP service. # 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.
       "securityMode": "A String", # The protocol that will be used to secure communication with the SMTP service. Required.
       "username": "A String", # The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
@@ -262,7 +262,7 @@ <h3>Method Details</h3>
     "displayName": "A String", # 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.
     "replyToAddress": "A String", # An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
     "signature": "A String", # An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.
-    "treatAsAlias": True or False, # 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.
+    "treatAsAlias": True or False, # Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
     "sendAsEmail": "A String", # The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
     "isPrimary": True or False, # Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
     "verificationStatus": "A String", # Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
@@ -280,7 +280,7 @@ <h3>Method Details</h3>
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # 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.
+{ # 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.
   "smtpMsa": { # Configuration for communication with an SMTP service. # 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.
     "securityMode": "A String", # The protocol that will be used to secure communication with the SMTP service. Required.
     "username": "A String", # The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
@@ -291,7 +291,7 @@ <h3>Method Details</h3>
   "displayName": "A String", # 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.
   "replyToAddress": "A String", # An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
   "signature": "A String", # An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.
-  "treatAsAlias": True or False, # 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.
+  "treatAsAlias": True or False, # Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
   "sendAsEmail": "A String", # The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
   "isPrimary": True or False, # Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
   "verificationStatus": "A String", # Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
@@ -302,7 +302,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # 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.
+    { # 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.
     "smtpMsa": { # Configuration for communication with an SMTP service. # 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.
       "securityMode": "A String", # The protocol that will be used to secure communication with the SMTP service. Required.
       "username": "A String", # The username that will be used for authentication with the SMTP service. This is a write-only field that can be specified in requests to create or update SendAs settings; it is never populated in responses.
@@ -313,7 +313,7 @@ <h3>Method Details</h3>
     "displayName": "A String", # 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.
     "replyToAddress": "A String", # An optional email address that is included in a "Reply-To:" header for mail sent using this alias. If this is empty, Gmail will not generate a "Reply-To:" header.
     "signature": "A String", # An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.
-    "treatAsAlias": True or False, # 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.
+    "treatAsAlias": True or False, # Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom "from" aliases.
     "sendAsEmail": "A String", # The email address that appears in the "From:" header for mail sent using this alias. This is read-only for all operations except create.
     "isPrimary": True or False, # Whether this address is the primary address used to login to the account. Every Gmail account has exactly one primary address, and it cannot be deleted from the collection of send-as aliases. This field is read-only.
     "verificationStatus": "A String", # Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom "from" aliases.
diff --git a/docs/dyn/gmail_v1.users.threads.html b/docs/dyn/gmail_v1.users.threads.html
index 334231ce877..245e9ab6c39 100644
--- a/docs/dyn/gmail_v1.users.threads.html
+++ b/docs/dyn/gmail_v1.users.threads.html
@@ -131,9 +131,9 @@ <h3>Method Details</h3>
         "historyId": "A String", # The ID of the last history record that modified this message.
         "payload": { # A single MIME message part. # The parsed email structure in the message parts.
           "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-            "data": "A String", # 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.
+            "data": "A String", # 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.
             "attachmentId": "A String", # 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.
-            "size": 42, # Total number of bytes in the body of the message part.
+            "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
           },
           "mimeType": "A String", # The MIME type of the message part.
           "partId": "A String", # The immutable ID of the message part.
@@ -173,7 +173,7 @@ <h3>Method Details</h3>
 Args:
   userId: string, The user's email address. The special value me can be used to indicate the authenticated user. (required)
   labelIds: string, Only return threads with labels that match all of the specified label IDs. (repeated)
-  q: string, 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".
+  q: string, 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.
   pageToken: string, Page token to retrieve a specific page of results in the list.
   maxResults: integer, Maximum number of threads to return.
   includeSpamTrash: boolean, Include threads from SPAM and TRASH in the results.
@@ -193,9 +193,9 @@ <h3>Method Details</h3>
             "historyId": "A String", # The ID of the last history record that modified this message.
             "payload": { # A single MIME message part. # The parsed email structure in the message parts.
               "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-                "data": "A String", # 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.
+                "data": "A String", # 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.
                 "attachmentId": "A String", # 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.
-                "size": 42, # Total number of bytes in the body of the message part.
+                "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
               },
               "mimeType": "A String", # The MIME type of the message part.
               "partId": "A String", # The immutable ID of the message part.
@@ -275,9 +275,9 @@ <h3>Method Details</h3>
         "historyId": "A String", # The ID of the last history record that modified this message.
         "payload": { # A single MIME message part. # The parsed email structure in the message parts.
           "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-            "data": "A String", # 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.
+            "data": "A String", # 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.
             "attachmentId": "A String", # 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.
-            "size": 42, # Total number of bytes in the body of the message part.
+            "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
           },
           "mimeType": "A String", # The MIME type of the message part.
           "partId": "A String", # The immutable ID of the message part.
@@ -329,9 +329,9 @@ <h3>Method Details</h3>
         "historyId": "A String", # The ID of the last history record that modified this message.
         "payload": { # A single MIME message part. # The parsed email structure in the message parts.
           "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-            "data": "A String", # 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.
+            "data": "A String", # 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.
             "attachmentId": "A String", # 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.
-            "size": 42, # Total number of bytes in the body of the message part.
+            "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
           },
           "mimeType": "A String", # The MIME type of the message part.
           "partId": "A String", # The immutable ID of the message part.
@@ -383,9 +383,9 @@ <h3>Method Details</h3>
         "historyId": "A String", # The ID of the last history record that modified this message.
         "payload": { # A single MIME message part. # The parsed email structure in the message parts.
           "body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
-            "data": "A String", # 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.
+            "data": "A String", # 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.
             "attachmentId": "A String", # 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.
-            "size": 42, # Total number of bytes in the body of the message part.
+            "size": 42, # Number of bytes for the message part data (encoding notwithstanding).
           },
           "mimeType": "A String", # The MIME type of the message part.
           "partId": "A String", # The immutable ID of the message part.
diff --git a/docs/dyn/groupsmigration_v1.archive.html b/docs/dyn/groupsmigration_v1.archive.html
index 8bf887550b2..87035c0c02c 100644
--- a/docs/dyn/groupsmigration_v1.archive.html
+++ b/docs/dyn/groupsmigration_v1.archive.html
@@ -75,16 +75,17 @@
 <h1><a href="groupsmigration_v1.html">Groups Migration API</a> . <a href="groupsmigration_v1.archive.html">archive</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#insert">insert(groupId, media_body=None)</a></code></p>
+  <code><a href="#insert">insert(groupId, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Inserts a new mail into the archive of the Google group.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="insert">insert(groupId, media_body=None)</code>
+    <code class="details" id="insert">insert(groupId, media_body=None, media_mime_type=None)</code>
   <pre>Inserts a new mail into the archive of the Google group.
 
 Args:
   groupId: string, The group ID (required)
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/identitytoolkit_v3.relyingparty.html b/docs/dyn/identitytoolkit_v3.relyingparty.html
index 2d514abba7e..03e9cbb4559 100644
--- a/docs/dyn/identitytoolkit_v3.relyingparty.html
+++ b/docs/dyn/identitytoolkit_v3.relyingparty.html
@@ -204,6 +204,7 @@ <h3>Method Details</h3>
 
 { # Request to download user account in batch.
     "nextPageToken": "A String", # The token for the next page. This should be taken from the previous response.
+    "targetProjectId": "A String", # Specify which project (field value is actually project id) to operate. Only used when provided credential.
     "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
     "maxResults": 42, # The max number of results to return in the response.
   }
@@ -217,6 +218,7 @@ <h3>Method Details</h3>
     "kind": "identitytoolkit#DownloadAccountResponse", # The fixed string "identitytoolkit#DownloadAccountResponse".
     "users": [ # The user accounts data.
       { # Template for an individual account info.
+        "rawPassword": "A String", # The user's plain text password.
         "passwordHash": "A String", # The user's hashed password.
         "displayName": "A String", # The name of the user.
         "localId": "A String", # The local ID of the user.
@@ -232,7 +234,6 @@ <h3>Method Details</h3>
             "federatedId": "A String", # User's identifier at IDP.
             "displayName": "A String", # The user's display name at the IDP.
             "photoUrl": "A String", # The user's photo url at the IDP.
-            "rawUserInfo": "A String", # Raw IDP-returned user info.
             "providerId": "A String", # The IdP ID. For white listed IdPs it's a short domain name, e.g., google.com, aol.com, live.net and yahoo.com. For other OpenID IdPs it's the OP identifier.
             "rawId": "A String", # User's raw identifier directly returned from IDP.
             "email": "A String", # User's email at IDP.
@@ -276,6 +277,7 @@ <h3>Method Details</h3>
     "kind": "identitytoolkit#GetAccountInfoResponse", # The fixed string "identitytoolkit#GetAccountInfoResponse".
     "users": [ # The info of the users.
       { # Template for an individual account info.
+        "rawPassword": "A String", # The user's plain text password.
         "passwordHash": "A String", # The user's hashed password.
         "displayName": "A String", # The name of the user.
         "localId": "A String", # The local ID of the user.
@@ -291,7 +293,6 @@ <h3>Method Details</h3>
             "federatedId": "A String", # User's identifier at IDP.
             "displayName": "A String", # The user's display name at the IDP.
             "photoUrl": "A String", # The user's photo url at the IDP.
-            "rawUserInfo": "A String", # Raw IDP-returned user info.
             "providerId": "A String", # The IdP ID. For white listed IdPs it's a short domain name, e.g., google.com, aol.com, live.net and yahoo.com. For other OpenID IdPs it's the OP identifier.
             "rawId": "A String", # User's raw identifier directly returned from IDP.
             "email": "A String", # User's email at IDP.
@@ -350,6 +351,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # Response of getting the project configuration.
+    "dynamicLinksDomain": "A String",
     "apiKey": "A String", # Browser API key, needed when making http request to Apiary.
     "useEmailSending": True or False, # Whether to use email sending provided by Firebear.
     "projectId": "A String", # Project ID of the relying party.
@@ -631,9 +633,12 @@ <h3>Method Details</h3>
 { # Request to signup new user, create anonymous user or anonymous user reauth.
     "instanceId": "A String", # Instance id token of the app.
     "displayName": "A String", # The name of the user.
+    "photoUrl": "A String", # The photo url of the user.
     "captchaResponse": "A String", # Response to the captcha.
-    "idToken": "A String", # The GITKit token of the authenticated user.
+    "emailVerified": True or False, # Mark the email as verified or not. Only can be used by service account.
+    "disabled": True or False, # Whether to disable the user. Only can be used by service account.
     "captchaChallenge": "A String", # The captcha challenge.
+    "idToken": "A String", # The GITKit token of the authenticated user.
     "password": "A String", # The new password of the user.
     "email": "A String", # The email of the user.
   }
@@ -664,8 +669,10 @@ <h3>Method Details</h3>
 { # Request to upload user account in batch.
     "hashAlgorithm": "A String", # The password hash algorithm.
     "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
+    "allowOverwrite": True or False, # Whether allow overwrite existing account when user local_id exists.
     "users": [ # The account info to be stored.
       { # Template for an individual account info.
+        "rawPassword": "A String", # The user's plain text password.
         "passwordHash": "A String", # The user's hashed password.
         "displayName": "A String", # The name of the user.
         "localId": "A String", # The local ID of the user.
@@ -681,7 +688,6 @@ <h3>Method Details</h3>
             "federatedId": "A String", # User's identifier at IDP.
             "displayName": "A String", # The user's display name at the IDP.
             "photoUrl": "A String", # The user's photo url at the IDP.
-            "rawUserInfo": "A String", # Raw IDP-returned user info.
             "providerId": "A String", # The IdP ID. For white listed IdPs it's a short domain name, e.g., google.com, aol.com, live.net and yahoo.com. For other OpenID IdPs it's the OP identifier.
             "rawId": "A String", # User's raw identifier directly returned from IDP.
             "email": "A String", # User's email at IDP.
diff --git a/docs/dyn/language_v1.documents.html b/docs/dyn/language_v1.documents.html
new file mode 100644
index 00000000000..3e0e122c583
--- /dev/null
+++ b/docs/dyn/language_v1.documents.html
@@ -0,0 +1,505 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="language_v1.html">Google Cloud Natural Language API</a> . <a href="language_v1.documents.html">documents</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#analyzeEntities">analyzeEntities(body, x__xgafv=None)</a></code></p>
+<p class="firstline">Finds named entities (currently finds proper names) in the text,</p>
+<p class="toc_element">
+  <code><a href="#analyzeSentiment">analyzeSentiment(body, x__xgafv=None)</a></code></p>
+<p class="firstline">Analyzes the sentiment of the provided text.</p>
+<p class="toc_element">
+  <code><a href="#analyzeSyntax">analyzeSyntax(body, x__xgafv=None)</a></code></p>
+<p class="firstline">Analyzes the syntax of the text and provides sentence boundaries and</p>
+<p class="toc_element">
+  <code><a href="#annotateText">annotateText(body, x__xgafv=None)</a></code></p>
+<p class="firstline">A convenience method that provides all the features that analyzeSentiment,</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="analyzeEntities">analyzeEntities(body, x__xgafv=None)</code>
+  <pre>Finds named entities (currently finds proper names) in the text,
+entity types, salience, mentions for each entity, and other properties.
+
+Args:
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # The entity analysis request message.
+    "document": { # ################################################################ # # Input document.
+        #
+        # Represents the input to API methods.
+      "content": "A String", # The content of the input in string format.
+      "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
+          # returns an `INVALID_ARGUMENT` error.
+      "language": "A String", # The language of the document (if not specified, the language is
+          # automatically detected). Both ISO and BCP-47 language codes are
+          # accepted.<br>
+          # **Current Language Restrictions:**
+          #
+          #  * Only English, Spanish, and Japanese textual content are supported.
+          # If the language (either specified by the caller or automatically detected)
+          # is not supported by the called API method, an `INVALID_ARGUMENT` error
+          # is returned.
+      "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
+          # This URI must be of the form: gs://bucket_name/object_name. For more
+          # details, see https://cloud.google.com/storage/docs/reference-uris.
+          # NOTE: Cloud Storage object versioning is not supported.
+    },
+    "encodingType": "A String", # The encoding type used by the API to calculate offsets.
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The entity analysis response message.
+    "entities": [ # The recognized entities in the input document.
+      { # Represents a phrase in the text that is a known entity, such as
+          # a person, an organization, or location. The API associates information, such
+          # as salience and mentions, with entities.
+        "type": "A String", # The entity type.
+        "mentions": [ # The mentions of this entity in the input document. The API currently
+            # supports proper noun mentions.
+          { # Represents a mention for an entity in the text. Currently, proper noun
+              # mentions are supported.
+            "text": { # Represents an output piece of text. # The mention text.
+              "content": "A String", # The content of the output text.
+              "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+                  # document according to the EncodingType specified in the API request.
+            },
+            "type": "A String", # The type of the entity mention.
+          },
+        ],
+        "salience": 3.14, # The salience score associated with the entity in the [0, 1.0] range.
+            #
+            # The salience score for an entity provides information about the
+            # importance or centrality of that entity to the entire document text.
+            # Scores closer to 0 are less salient, while scores closer to 1.0 are highly
+            # salient.
+        "name": "A String", # The representative name for the entity.
+        "metadata": { # Metadata associated with the entity.
+            #
+            # Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
+            # available. The associated keys are "wikipedia_url" and "mid", respectively.
+          "a_key": "A String",
+        },
+      },
+    ],
+    "language": "A String", # The language of the text, which will be the same as the language specified
+        # in the request or, if not specified, the automatically-detected language.
+        # See `Document.language` field for more details.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="analyzeSentiment">analyzeSentiment(body, x__xgafv=None)</code>
+  <pre>Analyzes the sentiment of the provided text.
+
+Args:
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # The sentiment analysis request message.
+    "document": { # ################################################################ # # Input document. Currently, `analyzeSentiment` only supports English text
+        # (Document.language="EN").
+        #
+        # Represents the input to API methods.
+      "content": "A String", # The content of the input in string format.
+      "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
+          # returns an `INVALID_ARGUMENT` error.
+      "language": "A String", # The language of the document (if not specified, the language is
+          # automatically detected). Both ISO and BCP-47 language codes are
+          # accepted.<br>
+          # **Current Language Restrictions:**
+          #
+          #  * Only English, Spanish, and Japanese textual content are supported.
+          # If the language (either specified by the caller or automatically detected)
+          # is not supported by the called API method, an `INVALID_ARGUMENT` error
+          # is returned.
+      "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
+          # This URI must be of the form: gs://bucket_name/object_name. For more
+          # details, see https://cloud.google.com/storage/docs/reference-uris.
+          # NOTE: Cloud Storage object versioning is not supported.
+    },
+    "encodingType": "A String", # The encoding type used by the API to calculate sentence offsets.
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The sentiment analysis response message.
+    "documentSentiment": { # Represents the feeling associated with the entire text or entities in # The overall sentiment of the input document.
+        # the text.
+      "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+          # (positive sentiment).
+      "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
+          # the absolute magnitude of sentiment regardless of score (positive or
+          # negative).
+    },
+    "language": "A String", # The language of the text, which will be the same as the language specified
+        # in the request or, if not specified, the automatically-detected language.
+        # See `Document.language` field for more details.
+    "sentences": [ # The sentiment for all the sentences in the document.
+      { # Represents a sentence in the input document.
+        "text": { # Represents an output piece of text. # The sentence text.
+          "content": "A String", # The content of the output text.
+          "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+              # document according to the EncodingType specified in the API request.
+        },
+        "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
+            # AnnotateTextRequest.Features.extract_document_sentiment is set to
+            # true, this field will contain the sentiment for the sentence.
+            # the text.
+          "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+              # (positive sentiment).
+          "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
+              # the absolute magnitude of sentiment regardless of score (positive or
+              # negative).
+        },
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="analyzeSyntax">analyzeSyntax(body, x__xgafv=None)</code>
+  <pre>Analyzes the syntax of the text and provides sentence boundaries and
+tokenization along with part of speech tags, dependency trees, and other
+properties.
+
+Args:
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # The syntax analysis request message.
+    "document": { # ################################################################ # # Input document.
+        #
+        # Represents the input to API methods.
+      "content": "A String", # The content of the input in string format.
+      "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
+          # returns an `INVALID_ARGUMENT` error.
+      "language": "A String", # The language of the document (if not specified, the language is
+          # automatically detected). Both ISO and BCP-47 language codes are
+          # accepted.<br>
+          # **Current Language Restrictions:**
+          #
+          #  * Only English, Spanish, and Japanese textual content are supported.
+          # If the language (either specified by the caller or automatically detected)
+          # is not supported by the called API method, an `INVALID_ARGUMENT` error
+          # is returned.
+      "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
+          # This URI must be of the form: gs://bucket_name/object_name. For more
+          # details, see https://cloud.google.com/storage/docs/reference-uris.
+          # NOTE: Cloud Storage object versioning is not supported.
+    },
+    "encodingType": "A String", # The encoding type used by the API to calculate offsets.
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The syntax analysis response message.
+    "tokens": [ # Tokens, along with their syntactic information, in the input document.
+      { # Represents the smallest syntactic building block of the text.
+        "text": { # Represents an output piece of text. # The token text.
+          "content": "A String", # The content of the output text.
+          "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+              # document according to the EncodingType specified in the API request.
+        },
+        "dependencyEdge": { # Represents dependency parse tree information for a token. (For more # Dependency tree parse for this token.
+            # information on dependency labels, see
+            # http://www.aclweb.org/anthology/P13-2017
+          "headTokenIndex": 42, # Represents the head of this token in the dependency tree.
+              # This is the index of the token which has an arc going to this token.
+              # The index is the position of the token in the array of tokens returned
+              # by the API method. If this token is a root token, then the
+              # `head_token_index` is its own index.
+          "label": "A String", # The parse label for the token.
+        },
+        "partOfSpeech": { # Represents part of speech information for a token. Parts of speech # Parts of speech tag for this token.
+            # are as defined in
+            # http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
+          "case": "A String", # The grammatical case.
+          "reciprocity": "A String", # The grammatical reciprocity.
+          "mood": "A String", # The grammatical mood.
+          "form": "A String", # The grammatical form.
+          "gender": "A String", # The grammatical gender.
+          "number": "A String", # The grammatical number.
+          "person": "A String", # The grammatical person.
+          "tag": "A String", # The part of speech tag.
+          "tense": "A String", # The grammatical tense.
+          "aspect": "A String", # The grammatical aspect.
+          "proper": "A String", # The grammatical properness.
+          "voice": "A String", # The grammatical voice.
+        },
+        "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
+      },
+    ],
+    "language": "A String", # The language of the text, which will be the same as the language specified
+        # in the request or, if not specified, the automatically-detected language.
+        # See `Document.language` field for more details.
+    "sentences": [ # Sentences in the input document.
+      { # Represents a sentence in the input document.
+        "text": { # Represents an output piece of text. # The sentence text.
+          "content": "A String", # The content of the output text.
+          "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+              # document according to the EncodingType specified in the API request.
+        },
+        "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
+            # AnnotateTextRequest.Features.extract_document_sentiment is set to
+            # true, this field will contain the sentiment for the sentence.
+            # the text.
+          "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+              # (positive sentiment).
+          "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
+              # the absolute magnitude of sentiment regardless of score (positive or
+              # negative).
+        },
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="annotateText">annotateText(body, x__xgafv=None)</code>
+  <pre>A convenience method that provides all the features that analyzeSentiment,
+analyzeEntities, and analyzeSyntax provide in one call.
+
+Args:
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # The request message for the text annotation API, which can perform multiple
+      # analysis types (sentiment, entities, and syntax) in one call.
+    "document": { # ################################################################ # # Input document.
+        #
+        # Represents the input to API methods.
+      "content": "A String", # The content of the input in string format.
+      "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
+          # returns an `INVALID_ARGUMENT` error.
+      "language": "A String", # The language of the document (if not specified, the language is
+          # automatically detected). Both ISO and BCP-47 language codes are
+          # accepted.<br>
+          # **Current Language Restrictions:**
+          #
+          #  * Only English, Spanish, and Japanese textual content are supported.
+          # If the language (either specified by the caller or automatically detected)
+          # is not supported by the called API method, an `INVALID_ARGUMENT` error
+          # is returned.
+      "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
+          # This URI must be of the form: gs://bucket_name/object_name. For more
+          # details, see https://cloud.google.com/storage/docs/reference-uris.
+          # NOTE: Cloud Storage object versioning is not supported.
+    },
+    "encodingType": "A String", # The encoding type used by the API to calculate offsets.
+    "features": { # All available features for sentiment, syntax, and semantic analysis. # The enabled features.
+        # Setting each one to true will enable that specific analysis for the input.
+      "extractSyntax": True or False, # Extract syntax information.
+      "extractEntities": True or False, # Extract entities.
+      "extractDocumentSentiment": True or False, # Extract document-level sentiment.
+    },
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The text annotations response message.
+    "tokens": [ # Tokens, along with their syntactic information, in the input document.
+        # Populated if the user enables
+        # AnnotateTextRequest.Features.extract_syntax.
+      { # Represents the smallest syntactic building block of the text.
+        "text": { # Represents an output piece of text. # The token text.
+          "content": "A String", # The content of the output text.
+          "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+              # document according to the EncodingType specified in the API request.
+        },
+        "dependencyEdge": { # Represents dependency parse tree information for a token. (For more # Dependency tree parse for this token.
+            # information on dependency labels, see
+            # http://www.aclweb.org/anthology/P13-2017
+          "headTokenIndex": 42, # Represents the head of this token in the dependency tree.
+              # This is the index of the token which has an arc going to this token.
+              # The index is the position of the token in the array of tokens returned
+              # by the API method. If this token is a root token, then the
+              # `head_token_index` is its own index.
+          "label": "A String", # The parse label for the token.
+        },
+        "partOfSpeech": { # Represents part of speech information for a token. Parts of speech # Parts of speech tag for this token.
+            # are as defined in
+            # http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
+          "case": "A String", # The grammatical case.
+          "reciprocity": "A String", # The grammatical reciprocity.
+          "mood": "A String", # The grammatical mood.
+          "form": "A String", # The grammatical form.
+          "gender": "A String", # The grammatical gender.
+          "number": "A String", # The grammatical number.
+          "person": "A String", # The grammatical person.
+          "tag": "A String", # The part of speech tag.
+          "tense": "A String", # The grammatical tense.
+          "aspect": "A String", # The grammatical aspect.
+          "proper": "A String", # The grammatical properness.
+          "voice": "A String", # The grammatical voice.
+        },
+        "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
+      },
+    ],
+    "entities": [ # Entities, along with their semantic information, in the input document.
+        # Populated if the user enables
+        # AnnotateTextRequest.Features.extract_entities.
+      { # Represents a phrase in the text that is a known entity, such as
+          # a person, an organization, or location. The API associates information, such
+          # as salience and mentions, with entities.
+        "type": "A String", # The entity type.
+        "mentions": [ # The mentions of this entity in the input document. The API currently
+            # supports proper noun mentions.
+          { # Represents a mention for an entity in the text. Currently, proper noun
+              # mentions are supported.
+            "text": { # Represents an output piece of text. # The mention text.
+              "content": "A String", # The content of the output text.
+              "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+                  # document according to the EncodingType specified in the API request.
+            },
+            "type": "A String", # The type of the entity mention.
+          },
+        ],
+        "salience": 3.14, # The salience score associated with the entity in the [0, 1.0] range.
+            #
+            # The salience score for an entity provides information about the
+            # importance or centrality of that entity to the entire document text.
+            # Scores closer to 0 are less salient, while scores closer to 1.0 are highly
+            # salient.
+        "name": "A String", # The representative name for the entity.
+        "metadata": { # Metadata associated with the entity.
+            #
+            # Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
+            # available. The associated keys are "wikipedia_url" and "mid", respectively.
+          "a_key": "A String",
+        },
+      },
+    ],
+    "documentSentiment": { # Represents the feeling associated with the entire text or entities in # The overall sentiment for the document. Populated if the user enables
+        # AnnotateTextRequest.Features.extract_document_sentiment.
+        # the text.
+      "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+          # (positive sentiment).
+      "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
+          # the absolute magnitude of sentiment regardless of score (positive or
+          # negative).
+    },
+    "language": "A String", # The language of the text, which will be the same as the language specified
+        # in the request or, if not specified, the automatically-detected language.
+        # See `Document.language` field for more details.
+    "sentences": [ # Sentences in the input document. Populated if the user enables
+        # AnnotateTextRequest.Features.extract_syntax.
+      { # Represents a sentence in the input document.
+        "text": { # Represents an output piece of text. # The sentence text.
+          "content": "A String", # The content of the output text.
+          "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+              # document according to the EncodingType specified in the API request.
+        },
+        "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
+            # AnnotateTextRequest.Features.extract_document_sentiment is set to
+            # true, this field will contain the sentiment for the sentence.
+            # the text.
+          "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+              # (positive sentiment).
+          "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
+              # the absolute magnitude of sentiment regardless of score (positive or
+              # negative).
+        },
+      },
+    ],
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/language_v1.html b/docs/dyn/language_v1.html
new file mode 100644
index 00000000000..10c0c51f266
--- /dev/null
+++ b/docs/dyn/language_v1.html
@@ -0,0 +1,103 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="language_v1.html">Google Cloud Natural Language API</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="language_v1.documents.html">documents()</a></code>
+</p>
+<p class="firstline">Returns the documents Resource.</p>
+
+<p class="toc_element">
+  <code><a href="#new_batch_http_request">new_batch_http_request()</a></code></p>
+<p class="firstline">Create a BatchHttpRequest object based on the discovery document.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="new_batch_http_request">new_batch_http_request()</code>
+  <pre>Create a BatchHttpRequest object based on the discovery document.
+
+        Args:
+          callback: callable, A callback to be called for each response, of the
+            form callback(id, response, exception). The first parameter is the
+            request id, and the second is the deserialized response object. The
+            third is an apiclient.errors.HttpError exception object if an HTTP
+            error occurred while processing the request, or None if no error
+            occurred.
+
+        Returns:
+          A BatchHttpRequest object based on the discovery document.
+        </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/language_v1beta1.documents.html b/docs/dyn/language_v1beta1.documents.html
index 8e6da6b5b1f..bf6cf970879 100644
--- a/docs/dyn/language_v1beta1.documents.html
+++ b/docs/dyn/language_v1beta1.documents.html
@@ -80,6 +80,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#analyzeSentiment">analyzeSentiment(body, x__xgafv=None)</a></code></p>
 <p class="firstline">Analyzes the sentiment of the provided text.</p>
+<p class="toc_element">
+  <code><a href="#analyzeSyntax">analyzeSyntax(body, x__xgafv=None)</a></code></p>
+<p class="firstline">Analyzes the syntax of the text and provides sentence boundaries and</p>
 <p class="toc_element">
   <code><a href="#annotateText">annotateText(body, x__xgafv=None)</a></code></p>
 <p class="firstline">A convenience method that provides all the features that analyzeSentiment,</p>
@@ -105,13 +108,14 @@ <h3>Method Details</h3>
           # accepted.<br>
           # **Current Language Restrictions:**
           #
-          #  * Only English, Spanish, and Japanese textual content
-          #    are supported, with the following additional restriction:
-          #    * `analyzeSentiment` only supports English text.
+          #  * Only English, Spanish, and Japanese textual content are supported.
           # If the language (either specified by the caller or automatically detected)
           # is not supported by the called API method, an `INVALID_ARGUMENT` error
           # is returned.
       "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
+          # This URI must be of the form: gs://bucket_name/object_name. For more
+          # details, see https://cloud.google.com/storage/docs/reference-uris.
+          # NOTE: Cloud Storage object versioning is not supported.
     },
     "encodingType": "A String", # The encoding type used by the API to calculate offsets.
   }
@@ -139,6 +143,7 @@ <h3>Method Details</h3>
               "beginOffset": 42, # The API calculates the beginning offset of the content in the original
                   # document according to the EncodingType specified in the API request.
             },
+            "type": "A String", # The type of the entity mention.
           },
         ],
         "salience": 3.14, # The salience score associated with the entity in the [0, 1.0] range.
@@ -150,8 +155,8 @@ <h3>Method Details</h3>
         "name": "A String", # The representative name for the entity.
         "metadata": { # Metadata associated with the entity.
             #
-            # Currently, only Wikipedia URLs are provided, if available.
-            # The associated key is "wikipedia_url".
+            # Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
+            # available. The associated keys are "wikipedia_url" and "mid", respectively.
           "a_key": "A String",
         },
       },
@@ -183,14 +188,17 @@ <h3>Method Details</h3>
           # accepted.<br>
           # **Current Language Restrictions:**
           #
-          #  * Only English, Spanish, and Japanese textual content
-          #    are supported, with the following additional restriction:
-          #    * `analyzeSentiment` only supports English text.
+          #  * Only English, Spanish, and Japanese textual content are supported.
           # If the language (either specified by the caller or automatically detected)
           # is not supported by the called API method, an `INVALID_ARGUMENT` error
           # is returned.
       "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
+          # This URI must be of the form: gs://bucket_name/object_name. For more
+          # details, see https://cloud.google.com/storage/docs/reference-uris.
+          # NOTE: Cloud Storage object versioning is not supported.
     },
+    "encodingType": "A String", # The encoding type used by the API to calculate sentence offsets for the
+        # sentence sentiment.
   }
 
   x__xgafv: string, V1 error format.
@@ -204,14 +212,142 @@ <h3>Method Details</h3>
     { # The sentiment analysis response message.
     "documentSentiment": { # Represents the feeling associated with the entire text or entities in # The overall sentiment of the input document.
         # the text.
-      "polarity": 3.14, # Polarity of the sentiment in the [-1.0, 1.0] range. Larger numbers
-          # represent more positive sentiments.
+      "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
+          # favor of score. Please refer to our documentation at
+          # https://cloud.google.com/natural-language/docs for more information.
+      "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+          # (positive sentiment).
       "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
-          # the absolute magnitude of sentiment regardless of polarity (positive or
+          # the absolute magnitude of sentiment regardless of score (positive or
           # negative).
     },
     "language": "A String", # The language of the text, which will be the same as the language specified
         # in the request or, if not specified, the automatically-detected language.
+    "sentences": [ # The sentiment for all the sentences in the document.
+      { # Represents a sentence in the input document.
+        "text": { # Represents an output piece of text. # The sentence text.
+          "content": "A String", # The content of the output text.
+          "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+              # document according to the EncodingType specified in the API request.
+        },
+        "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
+            # AnnotateTextRequest.Features.extract_document_sentiment is set to
+            # true, this field will contain the sentiment for the sentence.
+            # the text.
+          "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
+              # favor of score. Please refer to our documentation at
+              # https://cloud.google.com/natural-language/docs for more information.
+          "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+              # (positive sentiment).
+          "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
+              # the absolute magnitude of sentiment regardless of score (positive or
+              # negative).
+        },
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="analyzeSyntax">analyzeSyntax(body, x__xgafv=None)</code>
+  <pre>Analyzes the syntax of the text and provides sentence boundaries and
+tokenization along with part of speech tags, dependency trees, and other
+properties.
+
+Args:
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # The syntax analysis request message.
+    "document": { # ################################################################ # # Input document.
+        #
+        # Represents the input to API methods.
+      "content": "A String", # The content of the input in string format.
+      "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
+          # returns an `INVALID_ARGUMENT` error.
+      "language": "A String", # The language of the document (if not specified, the language is
+          # automatically detected). Both ISO and BCP-47 language codes are
+          # accepted.<br>
+          # **Current Language Restrictions:**
+          #
+          #  * Only English, Spanish, and Japanese textual content are supported.
+          # If the language (either specified by the caller or automatically detected)
+          # is not supported by the called API method, an `INVALID_ARGUMENT` error
+          # is returned.
+      "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
+          # This URI must be of the form: gs://bucket_name/object_name. For more
+          # details, see https://cloud.google.com/storage/docs/reference-uris.
+          # NOTE: Cloud Storage object versioning is not supported.
+    },
+    "encodingType": "A String", # The encoding type used by the API to calculate offsets.
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The syntax analysis response message.
+    "tokens": [ # Tokens, along with their syntactic information, in the input document.
+      { # Represents the smallest syntactic building block of the text.
+        "text": { # Represents an output piece of text. # The token text.
+          "content": "A String", # The content of the output text.
+          "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+              # document according to the EncodingType specified in the API request.
+        },
+        "dependencyEdge": { # Represents dependency parse tree information for a token. # Dependency tree parse for this token.
+          "headTokenIndex": 42, # Represents the head of this token in the dependency tree.
+              # This is the index of the token which has an arc going to this token.
+              # The index is the position of the token in the array of tokens returned
+              # by the API method. If this token is a root token, then the
+              # `head_token_index` is its own index.
+          "label": "A String", # The parse label for the token.
+        },
+        "partOfSpeech": { # Represents part of speech information for a token. # Parts of speech tag for this token.
+          "case": "A String", # The grammatical case.
+          "reciprocity": "A String", # The grammatical reciprocity.
+          "mood": "A String", # The grammatical mood.
+          "form": "A String", # The grammatical form.
+          "gender": "A String", # The grammatical gender.
+          "number": "A String", # The grammatical number.
+          "person": "A String", # The grammatical person.
+          "tag": "A String", # The part of speech tag.
+          "tense": "A String", # The grammatical tense.
+          "aspect": "A String", # The grammatical aspect.
+          "proper": "A String", # The grammatical properness.
+          "voice": "A String", # The grammatical voice.
+        },
+        "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
+      },
+    ],
+    "language": "A String", # The language of the text, which will be the same as the language specified
+        # in the request or, if not specified, the automatically-detected language.
+        # See Document.language field for more details.
+    "sentences": [ # Sentences in the input document.
+      { # Represents a sentence in the input document.
+        "text": { # Represents an output piece of text. # The sentence text.
+          "content": "A String", # The content of the output text.
+          "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+              # document according to the EncodingType specified in the API request.
+        },
+        "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
+            # AnnotateTextRequest.Features.extract_document_sentiment is set to
+            # true, this field will contain the sentiment for the sentence.
+            # the text.
+          "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
+              # favor of score. Please refer to our documentation at
+              # https://cloud.google.com/natural-language/docs for more information.
+          "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+              # (positive sentiment).
+          "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
+              # the absolute magnitude of sentiment regardless of score (positive or
+              # negative).
+        },
+      },
+    ],
   }</pre>
 </div>
 
@@ -237,13 +373,14 @@ <h3>Method Details</h3>
           # accepted.<br>
           # **Current Language Restrictions:**
           #
-          #  * Only English, Spanish, and Japanese textual content
-          #    are supported, with the following additional restriction:
-          #    * `analyzeSentiment` only supports English text.
+          #  * Only English, Spanish, and Japanese textual content are supported.
           # If the language (either specified by the caller or automatically detected)
           # is not supported by the called API method, an `INVALID_ARGUMENT` error
           # is returned.
       "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
+          # This URI must be of the form: gs://bucket_name/object_name. For more
+          # details, see https://cloud.google.com/storage/docs/reference-uris.
+          # NOTE: Cloud Storage object versioning is not supported.
     },
     "encodingType": "A String", # The encoding type used by the API to calculate offsets.
     "features": { # All available features for sentiment, syntax, and semantic analysis. # The enabled features.
@@ -281,10 +418,20 @@ <h3>Method Details</h3>
           "label": "A String", # The parse label for the token.
         },
         "partOfSpeech": { # Represents part of speech information for a token. # Parts of speech tag for this token.
+          "case": "A String", # The grammatical case.
+          "reciprocity": "A String", # The grammatical reciprocity.
+          "mood": "A String", # The grammatical mood.
+          "form": "A String", # The grammatical form.
+          "gender": "A String", # The grammatical gender.
+          "number": "A String", # The grammatical number.
+          "person": "A String", # The grammatical person.
           "tag": "A String", # The part of speech tag.
+          "tense": "A String", # The grammatical tense.
+          "aspect": "A String", # The grammatical aspect.
+          "proper": "A String", # The grammatical properness.
+          "voice": "A String", # The grammatical voice.
         },
-        "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_(morphology))
-            # of the token.
+        "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
       },
     ],
     "entities": [ # Entities, along with their semantic information, in the input document.
@@ -303,6 +450,7 @@ <h3>Method Details</h3>
               "beginOffset": 42, # The API calculates the beginning offset of the content in the original
                   # document according to the EncodingType specified in the API request.
             },
+            "type": "A String", # The type of the entity mention.
           },
         ],
         "salience": 3.14, # The salience score associated with the entity in the [0, 1.0] range.
@@ -314,8 +462,8 @@ <h3>Method Details</h3>
         "name": "A String", # The representative name for the entity.
         "metadata": { # Metadata associated with the entity.
             #
-            # Currently, only Wikipedia URLs are provided, if available.
-            # The associated key is "wikipedia_url".
+            # Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
+            # available. The associated keys are "wikipedia_url" and "mid", respectively.
           "a_key": "A String",
         },
       },
@@ -323,10 +471,13 @@ <h3>Method Details</h3>
     "documentSentiment": { # Represents the feeling associated with the entire text or entities in # The overall sentiment for the document. Populated if the user enables
         # AnnotateTextRequest.Features.extract_document_sentiment.
         # the text.
-      "polarity": 3.14, # Polarity of the sentiment in the [-1.0, 1.0] range. Larger numbers
-          # represent more positive sentiments.
+      "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
+          # favor of score. Please refer to our documentation at
+          # https://cloud.google.com/natural-language/docs for more information.
+      "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+          # (positive sentiment).
       "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
-          # the absolute magnitude of sentiment regardless of polarity (positive or
+          # the absolute magnitude of sentiment regardless of score (positive or
           # negative).
     },
     "language": "A String", # The language of the text, which will be the same as the language specified
@@ -340,6 +491,19 @@ <h3>Method Details</h3>
           "beginOffset": 42, # The API calculates the beginning offset of the content in the original
               # document according to the EncodingType specified in the API request.
         },
+        "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
+            # AnnotateTextRequest.Features.extract_document_sentiment is set to
+            # true, this field will contain the sentiment for the sentence.
+            # the text.
+          "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
+              # favor of score. Please refer to our documentation at
+              # https://cloud.google.com/natural-language/docs for more information.
+          "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+              # (positive sentiment).
+          "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
+              # the absolute magnitude of sentiment regardless of score (positive or
+              # negative).
+        },
       },
     ],
   }</pre>
diff --git a/docs/dyn/logging_v2.billingAccounts.html b/docs/dyn/logging_v2.billingAccounts.html
index 28a34a180db..00172cf8eda 100644
--- a/docs/dyn/logging_v2.billingAccounts.html
+++ b/docs/dyn/logging_v2.billingAccounts.html
@@ -79,4 +79,9 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the logs Resource.</p>
 
+<p class="toc_element">
+  <code><a href="logging_v2.billingAccounts.sinks.html">sinks()</a></code>
+</p>
+<p class="firstline">Returns the sinks Resource.</p>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.billingAccounts.logs.html b/docs/dyn/logging_v2.billingAccounts.logs.html
index e606c5972f1..d5d9c12a804 100644
--- a/docs/dyn/logging_v2.billingAccounts.logs.html
+++ b/docs/dyn/logging_v2.billingAccounts.logs.html
@@ -76,16 +76,23 @@ <h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#delete">delete(logName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a log and all its log entries.</p>
+<p class="firstline">Deletes all the log entries in a log. The log reappears if it receives new entries.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists the logs in projects or organizations. Only logs that have entries are listed.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="delete">delete(logName=None, x__xgafv=None)</code>
-  <pre>Deletes a log and all its log entries.
-The log will reappear if it receives new entries.
+  <pre>Deletes all the log entries in a log. The log reappears if it receives new entries.
 
 Args:
-  logName: string, Required. The resource name of the log to delete.  Example:
-`"projects/my-project/logs/syslog"`. (required)
+  logName: string, Required. The resource name of the log to delete:
+"projects/[PROJECT_ID]/logs/[LOG_ID]"
+"organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+[LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog", "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -94,16 +101,53 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists the logs in projects or organizations. Only logs that have entries are listed.
+
+Args:
+  parent: string, Required. The resource name that owns the logs:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListLogs.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
+    "logNames": [ # A list of log names. For example, "projects/my-project/syslog" or "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
+      "A String",
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.billingAccounts.sinks.html b/docs/dyn/logging_v2.billingAccounts.sinks.html
new file mode 100644
index 00000000000..4a00d87416a
--- /dev/null
+++ b/docs/dyn/logging_v2.billingAccounts.sinks.html
@@ -0,0 +1,312 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.billingAccounts.html">billingAccounts</a> . <a href="logging_v2.billingAccounts.sinks.html">sinks</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.</p>
+<p class="toc_element">
+  <code><a href="#delete">delete(sinkName=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.</p>
+<p class="toc_element">
+  <code><a href="#get">get(sinkName=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets a sink.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists sinks.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.
+
+Args:
+  parent: string, Required. The resource in which to create the sink:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+Examples: "projects/my-logging-project", "organizations/123456789". (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+  }
+
+  uniqueWriterIdentity: boolean, Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then the value returned as writer_identity is cloud-logs@google.com, the same identity used before the addition of writer identities to this API. The sink's destination must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="delete">delete(sinkName=None, x__xgafv=None)</code>
+  <pre>Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.
+
+Args:
+  sinkName: string, Required. The full resource name of the sink to delete, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+It is an error if the sink does not exist. Example: "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does not exist. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(sinkName=None, x__xgafv=None)</code>
+  <pre>Gets a sink.
+
+Args:
+  sinkName: string, Required. The parent resource name of the sink:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists sinks.
+
+Args:
+  parent: string, Required. The parent resource whose sinks are to be listed. Examples: "projects/my-logging-project", "organizations/123456789". (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListSinks.
+    "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
+    "sinks": [ # A list of sinks.
+      { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+          "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+          "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+          "destination": "A String", # Required. The export destination:
+              # "storage.googleapis.com/[GCS_BUCKET]"
+              # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+              # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+              # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+          "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+              # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+          "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+          "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+          "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.
+
+Args:
+  sinkName: string, Required. The full resource name of the sink to update, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+  }
+
+  uniqueWriterIdentity: boolean, Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both the old and new values of this field:
+If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity.
+If the old value was false and the new value is true, then writer_identity is changed to a unique service account.
+It is an error if the old value was true and the new value is false.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.entries.html b/docs/dyn/logging_v2.entries.html
index 923dbafde71..d901a2c95d2 100644
--- a/docs/dyn/logging_v2.entries.html
+++ b/docs/dyn/logging_v2.entries.html
@@ -76,48 +76,31 @@ <h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list">list(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists log entries.  Use this method to retrieve log entries from Cloud</p>
+<p class="firstline">Lists log entries. Use this method to retrieve log entries from Stackdriver Logging. For ways to export log entries, see Exporting Logs.</p>
 <p class="toc_element">
   <code><a href="#write">write(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Writes log entries to Stackdriver Logging.  All log entries are</p>
+<p class="firstline">Writes log entries to Stackdriver Logging. All log entries are written by this method.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="list">list(body, x__xgafv=None)</code>
-  <pre>Lists log entries.  Use this method to retrieve log entries from Cloud
-Logging.  For ways to export log entries, see
-[Exporting Logs](/logging/docs/export).
+  <pre>Lists log entries. Use this method to retrieve log entries from Stackdriver Logging. For ways to export log entries, see Exporting Logs.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # The parameters to `ListLogEntries`.
-    "orderBy": "A String", # Optional. How the results should be sorted.  Presently, the only permitted
-        # values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
-        # option returns entries in order of increasing values of
-        # `LogEntry.timestamp` (oldest first), and the second option returns entries
-        # in order of decreasing timestamps (newest first).  Entries with equal
-        # timestamps are returned in order of `LogEntry.insertId`.
-    "resourceNames": [ # Required. One or more cloud resources from which to retrieve log entries.
-        # Example: `"projects/my-project-1A"`, `"projects/1234567890"`.  Projects
-        # listed in `projectIds` are added to this list.
+{ # The parameters to ListLogEntries.
+    "orderBy": "A String", # Optional. How the results should be sorted. Presently, the only permitted values are "timestamp asc" (default) and "timestamp desc". The first option returns entries in order of increasing values of LogEntry.timestamp (oldest first), and the second option returns entries in order of decreasing timestamps (newest first). Entries with equal timestamps are returned in order of LogEntry.insertId.
+    "resourceNames": [ # Required. Names of one or more resources from which to retrieve log entries:
+        # "projects/[PROJECT_ID]"
+        # "organizations/[ORGANIZATION_ID]"
+        # Projects listed in the project_ids field are added to this list.
       "A String",
     ],
-    "pageSize": 42, # Optional. The maximum number of results to return from this request.
-        # Non-positive values are ignored.  The presence of `nextPageToken` in the
-        # response indicates that more results might be available.
-    "filter": "A String", # Optional. A filter that chooses which log entries to return.  See [Advanced
-        # Logs Filters](/logging/docs/view/advanced_filters).  Only log entries that
-        # match the filter are returned.  An empty filter matches all log entries.
-    "pageToken": "A String", # Optional. If present, then retrieve the next batch of results from the
-        # preceding call to this method.  `pageToken` must be the value of
-        # `nextPageToken` from the previous response.  The values of other method
-        # parameters should be identical to those in the previous call.
-    "projectIds": [ # Deprecated. One or more project identifiers or project numbers from which
-        # to retrieve log entries.  Examples: `"my-project-1A"`, `"1234567890"`. If
-        # present, these project identifiers are converted to resource format and
-        # added to the list of resources in `resourceNames`. Callers should use
-        # `resourceNames` rather than this parameter.
+    "pageSize": 42, # Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+    "filter": "A String", # Optional. A filter that chooses which log entries to return. See Advanced Logs Filters. Only log entries that match the filter are returned. An empty filter matches all log entries in the resources listed in resource_names. Referencing a parent resource that is not listed in resource_names will cause the filter to return no results. The maximum length of the filter is 20000 characters.
+    "pageToken": "A String", # Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+    "projectIds": [ # Deprecated. Use resource_names instead. One or more project identifiers or project numbers from which to retrieve log entries. Example: "my-project-1A". If present, these project identifiers are converted to resource name format and added to the list of resources in resource_names.
       "A String",
     ],
   }
@@ -130,115 +113,64 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Result returned from `ListLogEntries`.
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call this
-        # method again using the value of `nextPageToken` as `pageToken`.
+    { # Result returned from ListLogEntries.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.If a value for next_page_token appears and the entries field is empty, it means that the search found no log entries so far but it did not have time to search all the possible log entries. Retry the method with this value for page_token to continue the search. Alternatively, consider speeding up the search by changing your filter to specify a single log name or resource type, or to narrow the time range of the search.
     "entries": [ # A list of log entries.
       { # An individual entry in a log.
-        "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
-            # log entry, if applicable.
-            # defined by the HTTP specification. Product-specific logging
-            # information MUST be defined in a separate message.
-          "status": 42, # The response code indicating the status of response.
-              # Examples: 200, 404.
-          "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
-              # being served from cache. This field is only meaningful if `cache_hit` is
-              # True.
-          "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
-          "latency": "A String", # The request processing latency on the server, from the time the request was
-              # received until the response was sent.
-          "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
-              # cache fill was attempted.
-          "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query
-              # portion of the URL that was requested.
-              # Example: `"http://example.com/some/info?color=red"`.
-          "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
-              # sent to.
+        "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message. # Optional. Information about the HTTP request associated with this log entry, if applicable.
+          "status": 42, # The response code indicating the status of response. Examples: 200, 404.
+          "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before being served from cache. This field is only meaningful if cache_hit is True.
+          "requestMethod": "A String", # The request method. Examples: "GET", "HEAD", "PUT", "POST".
+          "latency": "A String", # The request processing latency on the server, from the time the request was received until the response was sent.
+          "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.
+          "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query portion of the URL that was requested. Example: "http://example.com/some/info?color=red".
+          "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was sent to.
           "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
-          "cacheHit": True or False, # Whether or not an entity was served from cache
-              # (with or without validation).
-          "referer": "A String", # The referer URL of the request, as defined in
-              # [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
-          "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
-              # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
-          "userAgent": "A String", # The user agent sent by the client. Example:
-              # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
-          "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
-              # headers and the request body.
-          "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
-              # including the response headers and the response body.
+          "cacheHit": True or False, # Whether or not an entity was served from cache (with or without validation).
+          "referer": "A String", # The referer URL of the request, as defined in HTTP/1.1 Header Field Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+          "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP request. Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
+          "userAgent": "A String", # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".
+          "requestSize": "A String", # The size of the HTTP request message in bytes, including the request headers and the request body.
+          "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes, including the response headers and the response body.
         },
-        "resource": { # An object representing a resource that can be used for monitoring, logging, # Required. The monitored resource associated with this log entry.
-            # Example: a log entry that reports a database error would be
-            # associated with the monitored resource designating the particular
-            # database that reported the error.
-            # billing, or other purposes. Examples include virtual machine instances,
-            # databases, and storage devices such as disks. The `type` field identifies a
-            # MonitoredResourceDescriptor object that describes the resource's
-            # schema. Information in the `labels` field identifies the actual resource and
-            # its attributes according to the schema. For example, a particular Compute
-            # Engine VM instance could be represented by the following object, because the
-            # MonitoredResourceDescriptor for `"gce_instance"` has labels
-            # `"instance_id"` and `"zone"`:
-            #
-            #     { "type": "gce_instance",
-            #       "labels": { "instance_id": "12345678901234",
-            #                   "zone": "us-central1-a" }}
-          "labels": { # Required. Values for all of the labels listed in the associated monitored
-              # resource descriptor. For example, Cloud SQL databases use the labels
-              # `"database_id"` and `"zone"`.
+        "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # Required. The monitored resource associated with this log entry. Example: a log entry that reports a database error would be associated with the monitored resource designating the particular database that reported the error.
+            # { "type": "gce_instance",
+            #   "labels": { "instance_id": "12345678901234",
+            #               "zone": "us-central1-a" }}
+          "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
             "a_key": "A String",
           },
-          "type": "A String", # Required. The monitored resource type. This field must match
-              # the `type` field of a MonitoredResourceDescriptor object. For
-              # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+          "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
         },
-        "severity": "A String", # Optional. The severity of the log entry. The default value is
-            # `LogSeverity.DEFAULT`.
         "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
-        "timestamp": "A String", # Optional. The time the event described by the log entry occurred.  If
-            # omitted, Stackdriver Logging will use the time the log entry is received.
-        "labels": { # Optional. A set of user-defined (key, value) data that provides additional
-            # information about the log entry.
+        "trace": "A String", # Optional. Resource name of the trace associated with the log entry, if any. If it contains a relative resource name, the name is assumed to be relative to //tracing.googleapis.com. Example: projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824
+        "timestamp": "A String", # Optional. The time the event described by the log entry occurred. If omitted, Stackdriver Logging will use the time the log entry is received.
+        "labels": { # Optional. A set of user-defined (key, value) data that provides additional information about the log entry.
           "a_key": "A String",
         },
-        "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this
-            # field, the logging service considers other log entries in the
-            # same project with the same ID as duplicates which can be removed.  If
-            # omitted, Stackdriver Logging will generate a unique ID for this
-            # log entry.
-        "jsonPayload": { # The log entry payload, represented as a structure that
-            # is expressed as a JSON object.
+        "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this field, the logging service considers other log entries in the same project with the same ID as duplicates which can be removed. If omitted, Stackdriver Logging will generate a unique ID for this log entry.
+        "jsonPayload": { # The log entry payload, represented as a structure that is expressed as a JSON object.
           "a_key": "", # Properties of the object.
         },
-        "logName": "A String", # Required. The resource name of the log to which this log entry
-            # belongs. The format of the name is
-            # `"projects/<project-id>/logs/<log-id>"`.  Examples:
-            # `"projects/my-projectid/logs/syslog"`,
-            # `"projects/my-projectid/logs/library.googleapis.com%2Fbook_log"`.
-            #
-            # The log ID part of resource name must be less than 512 characters
-            # long and can only include the following characters: upper and
-            # lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
-            # characters: forward-slash, underscore, hyphen, and period.
-            # Forward-slash (`/`) characters in the log ID must be URL-encoded.
-        "protoPayload": { # The log entry payload, represented as a protocol buffer.  Some
-            # Google Cloud Platform services use this field for their log
-            # entry payloads.
+        "logName": "A String", # Required. The resource name of the log to which this log entry belongs:
+            # "projects/[PROJECT_ID]/logs/[LOG_ID]"
+            # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+            # [LOG_ID] must be URL-encoded within log_name. Example: "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must be less than 512 characters long and can only include the following characters: upper and lower case alphanumeric characters, forward-slash, underscore, hyphen, and period.For backward compatibility, if log_name begins with a forward-slash, such as /projects/..., then the log entry is ingested as usual but the forward-slash is removed. Listing the log entry will not show the leading slash and filtering for a log name with a leading slash will never return any results.
+        "protoPayload": { # The log entry payload, represented as a protocol buffer. Some Google Cloud Platform services use this field for their log entry payloads.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
-            # applicable.
-            # a log entry is associated.
+        "operation": { # Additional information about a potentially long-running operation with which a log entry is associated. # Optional. Information about an operation associated with the log entry, if applicable.
           "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
-          "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
-              # same identifier are assumed to be part of the same operation.
-          "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
-              # `id` and `producer` must be globally unique.  Examples for `producer`:
-              # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+          "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the same identifier are assumed to be part of the same operation.
+          "producer": "A String", # Optional. An arbitrary producer identifier. The combination of id and producer must be globally unique. Examples for producer: "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".
           "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
         },
+        "sourceLocation": { # Additional information about the source code location that produced the log entry. # Optional. Source code location information associated with the log entry, if any.
+          "function": "A String", # Optional. Human-readable name of the function or method being invoked, with optional context such as the class or package name. This information may be used in contexts such as the logs viewer, where a file and line number are less meaningful. The format can vary by language. For example: qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).
+          "line": "A String", # Optional. Line within the source file. 1-based; 0 indicates no line number available.
+          "file": "A String", # Optional. Source file name. Depending on the runtime environment, this might be a simple name or a fully-qualified name.
+        },
+        "severity": "A String", # Optional. The severity of the log entry. The default value is LogSeverity.DEFAULT.
       },
     ],
   }</pre>
@@ -246,171 +178,90 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="write">write(body, x__xgafv=None)</code>
-  <pre>Writes log entries to Stackdriver Logging.  All log entries are
-written by this method.
+  <pre>Writes log entries to Stackdriver Logging. All log entries are written by this method.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # The parameters to WriteLogEntries.
-    "resource": { # An object representing a resource that can be used for monitoring, logging, # Optional. A default monitored resource object that is assigned to all log
-        # entries in `entries` that do not specify a value for `resource`. Example:
-        # 
-        #     { "type": "gce_instance",
-        #       "labels": {
-        #         "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
-        # 
+    "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # Optional. A default monitored resource object that is assigned to all log entries in entries that do not specify a value for resource. Example:
+        # { "type": "gce_instance",
+        #   "labels": {
+        #     "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
         # See LogEntry.
-        # billing, or other purposes. Examples include virtual machine instances,
-        # databases, and storage devices such as disks. The `type` field identifies a
-        # MonitoredResourceDescriptor object that describes the resource's
-        # schema. Information in the `labels` field identifies the actual resource and
-        # its attributes according to the schema. For example, a particular Compute
-        # Engine VM instance could be represented by the following object, because the
-        # MonitoredResourceDescriptor for `"gce_instance"` has labels
-        # `"instance_id"` and `"zone"`:
-        #
-        #     { "type": "gce_instance",
-        #       "labels": { "instance_id": "12345678901234",
-        #                   "zone": "us-central1-a" }}
-      "labels": { # Required. Values for all of the labels listed in the associated monitored
-          # resource descriptor. For example, Cloud SQL databases use the labels
-          # `"database_id"` and `"zone"`.
+        # { "type": "gce_instance",
+        #   "labels": { "instance_id": "12345678901234",
+        #               "zone": "us-central1-a" }}
+      "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
         "a_key": "A String",
       },
-      "type": "A String", # Required. The monitored resource type. This field must match
-          # the `type` field of a MonitoredResourceDescriptor object. For
-          # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+      "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
     },
-    "partialSuccess": True or False, # Optional. Whether valid entries should be written even if some other
-        # entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
-        # entry is not written, the response status will be the error associated
-        # with one of the failed entries and include error details in the form of
-        # WriteLogEntriesPartialErrors.
-    "labels": { # Optional. Default labels that are added to the `labels` field of all log
-        # entries in `entries`. If a log entry already has a label with the same key
-        # as a label in this parameter, then the log entry's label is not changed.
-        # See LogEntry.
+    "partialSuccess": True or False, # Optional. Whether valid entries should be written even if some other entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any entry is not written, the response status will be the error associated with one of the failed entries and include error details in the form of WriteLogEntriesPartialErrors.
+    "labels": { # Optional. Default labels that are added to the labels field of all log entries in entries. If a log entry already has a label with the same key as a label in this parameter, then the log entry's label is not changed. See LogEntry.
       "a_key": "A String",
     },
-    "logName": "A String", # Optional. A default log resource name that is assigned to all log entries
-        # in `entries` that do not specify a value for `log_name`.  Example:
-        # `"projects/my-project/logs/syslog"`.  See
-        # LogEntry.
-    "entries": [ # Required. The log entries to write. Values supplied for the fields
-        # `log_name`, `resource`, and `labels` in this `entries.write` request are
-        # added to those log entries that do not provide their own values for the
-        # fields.
-        # 
-        # To improve throughput and to avoid exceeding the
-        # [quota limit](/logging/quota-policy) for calls to `entries.write`,
-        # you should write multiple log entries at once rather than
-        # calling this method for each individual log entry.
+    "logName": "A String", # Optional. A default log resource name that is assigned to all log entries in entries that do not specify a value for log_name:
+        # "projects/[PROJECT_ID]/logs/[LOG_ID]"
+        # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+        # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog" or "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry.
+    "entries": [ # Required. The log entries to write. Values supplied for the fields log_name, resource, and labels in this entries.write request are added to those log entries that do not provide their own values for the fields.To improve throughput and to avoid exceeding the quota limit for calls to entries.write, you should write multiple log entries at once rather than calling this method for each individual log entry.
       { # An individual entry in a log.
-        "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
-            # log entry, if applicable.
-            # defined by the HTTP specification. Product-specific logging
-            # information MUST be defined in a separate message.
-          "status": 42, # The response code indicating the status of response.
-              # Examples: 200, 404.
-          "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
-              # being served from cache. This field is only meaningful if `cache_hit` is
-              # True.
-          "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
-          "latency": "A String", # The request processing latency on the server, from the time the request was
-              # received until the response was sent.
-          "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
-              # cache fill was attempted.
-          "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query
-              # portion of the URL that was requested.
-              # Example: `"http://example.com/some/info?color=red"`.
-          "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
-              # sent to.
+        "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message. # Optional. Information about the HTTP request associated with this log entry, if applicable.
+          "status": 42, # The response code indicating the status of response. Examples: 200, 404.
+          "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before being served from cache. This field is only meaningful if cache_hit is True.
+          "requestMethod": "A String", # The request method. Examples: "GET", "HEAD", "PUT", "POST".
+          "latency": "A String", # The request processing latency on the server, from the time the request was received until the response was sent.
+          "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.
+          "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query portion of the URL that was requested. Example: "http://example.com/some/info?color=red".
+          "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was sent to.
           "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
-          "cacheHit": True or False, # Whether or not an entity was served from cache
-              # (with or without validation).
-          "referer": "A String", # The referer URL of the request, as defined in
-              # [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
-          "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
-              # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
-          "userAgent": "A String", # The user agent sent by the client. Example:
-              # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
-          "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
-              # headers and the request body.
-          "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
-              # including the response headers and the response body.
+          "cacheHit": True or False, # Whether or not an entity was served from cache (with or without validation).
+          "referer": "A String", # The referer URL of the request, as defined in HTTP/1.1 Header Field Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+          "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP request. Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
+          "userAgent": "A String", # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".
+          "requestSize": "A String", # The size of the HTTP request message in bytes, including the request headers and the request body.
+          "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes, including the response headers and the response body.
         },
-        "resource": { # An object representing a resource that can be used for monitoring, logging, # Required. The monitored resource associated with this log entry.
-            # Example: a log entry that reports a database error would be
-            # associated with the monitored resource designating the particular
-            # database that reported the error.
-            # billing, or other purposes. Examples include virtual machine instances,
-            # databases, and storage devices such as disks. The `type` field identifies a
-            # MonitoredResourceDescriptor object that describes the resource's
-            # schema. Information in the `labels` field identifies the actual resource and
-            # its attributes according to the schema. For example, a particular Compute
-            # Engine VM instance could be represented by the following object, because the
-            # MonitoredResourceDescriptor for `"gce_instance"` has labels
-            # `"instance_id"` and `"zone"`:
-            #
-            #     { "type": "gce_instance",
-            #       "labels": { "instance_id": "12345678901234",
-            #                   "zone": "us-central1-a" }}
-          "labels": { # Required. Values for all of the labels listed in the associated monitored
-              # resource descriptor. For example, Cloud SQL databases use the labels
-              # `"database_id"` and `"zone"`.
+        "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # Required. The monitored resource associated with this log entry. Example: a log entry that reports a database error would be associated with the monitored resource designating the particular database that reported the error.
+            # { "type": "gce_instance",
+            #   "labels": { "instance_id": "12345678901234",
+            #               "zone": "us-central1-a" }}
+          "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
             "a_key": "A String",
           },
-          "type": "A String", # Required. The monitored resource type. This field must match
-              # the `type` field of a MonitoredResourceDescriptor object. For
-              # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+          "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
         },
-        "severity": "A String", # Optional. The severity of the log entry. The default value is
-            # `LogSeverity.DEFAULT`.
         "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
-        "timestamp": "A String", # Optional. The time the event described by the log entry occurred.  If
-            # omitted, Stackdriver Logging will use the time the log entry is received.
-        "labels": { # Optional. A set of user-defined (key, value) data that provides additional
-            # information about the log entry.
+        "trace": "A String", # Optional. Resource name of the trace associated with the log entry, if any. If it contains a relative resource name, the name is assumed to be relative to //tracing.googleapis.com. Example: projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824
+        "timestamp": "A String", # Optional. The time the event described by the log entry occurred. If omitted, Stackdriver Logging will use the time the log entry is received.
+        "labels": { # Optional. A set of user-defined (key, value) data that provides additional information about the log entry.
           "a_key": "A String",
         },
-        "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this
-            # field, the logging service considers other log entries in the
-            # same project with the same ID as duplicates which can be removed.  If
-            # omitted, Stackdriver Logging will generate a unique ID for this
-            # log entry.
-        "jsonPayload": { # The log entry payload, represented as a structure that
-            # is expressed as a JSON object.
+        "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this field, the logging service considers other log entries in the same project with the same ID as duplicates which can be removed. If omitted, Stackdriver Logging will generate a unique ID for this log entry.
+        "jsonPayload": { # The log entry payload, represented as a structure that is expressed as a JSON object.
           "a_key": "", # Properties of the object.
         },
-        "logName": "A String", # Required. The resource name of the log to which this log entry
-            # belongs. The format of the name is
-            # `"projects/<project-id>/logs/<log-id>"`.  Examples:
-            # `"projects/my-projectid/logs/syslog"`,
-            # `"projects/my-projectid/logs/library.googleapis.com%2Fbook_log"`.
-            #
-            # The log ID part of resource name must be less than 512 characters
-            # long and can only include the following characters: upper and
-            # lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
-            # characters: forward-slash, underscore, hyphen, and period.
-            # Forward-slash (`/`) characters in the log ID must be URL-encoded.
-        "protoPayload": { # The log entry payload, represented as a protocol buffer.  Some
-            # Google Cloud Platform services use this field for their log
-            # entry payloads.
+        "logName": "A String", # Required. The resource name of the log to which this log entry belongs:
+            # "projects/[PROJECT_ID]/logs/[LOG_ID]"
+            # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+            # [LOG_ID] must be URL-encoded within log_name. Example: "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must be less than 512 characters long and can only include the following characters: upper and lower case alphanumeric characters, forward-slash, underscore, hyphen, and period.For backward compatibility, if log_name begins with a forward-slash, such as /projects/..., then the log entry is ingested as usual but the forward-slash is removed. Listing the log entry will not show the leading slash and filtering for a log name with a leading slash will never return any results.
+        "protoPayload": { # The log entry payload, represented as a protocol buffer. Some Google Cloud Platform services use this field for their log entry payloads.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
-            # applicable.
-            # a log entry is associated.
+        "operation": { # Additional information about a potentially long-running operation with which a log entry is associated. # Optional. Information about an operation associated with the log entry, if applicable.
           "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
-          "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
-              # same identifier are assumed to be part of the same operation.
-          "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
-              # `id` and `producer` must be globally unique.  Examples for `producer`:
-              # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+          "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the same identifier are assumed to be part of the same operation.
+          "producer": "A String", # Optional. An arbitrary producer identifier. The combination of id and producer must be globally unique. Examples for producer: "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".
           "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
         },
+        "sourceLocation": { # Additional information about the source code location that produced the log entry. # Optional. Source code location information associated with the log entry, if any.
+          "function": "A String", # Optional. Human-readable name of the function or method being invoked, with optional context such as the class or package name. This information may be used in contexts such as the logs viewer, where a file and line number are less meaningful. The format can vary by language. For example: qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).
+          "line": "A String", # Optional. Line within the source file. 1-based; 0 indicates no line number available.
+          "file": "A String", # Optional. Source file name. Depending on the runtime environment, this might be a simple name or a fully-qualified name.
+        },
+        "severity": "A String", # Optional. The severity of the log entry. The default value is LogSeverity.DEFAULT.
       },
     ],
   }
@@ -423,8 +274,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Result returned from WriteLogEntries.
-      # empty
+    { # Result returned from WriteLogEntries. empty
   }</pre>
 </div>
 
diff --git a/docs/dyn/logging_v2.folders.html b/docs/dyn/logging_v2.folders.html
new file mode 100644
index 00000000000..d4725d43fd6
--- /dev/null
+++ b/docs/dyn/logging_v2.folders.html
@@ -0,0 +1,87 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.folders.html">folders</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="logging_v2.folders.logs.html">logs()</a></code>
+</p>
+<p class="firstline">Returns the logs Resource.</p>
+
+<p class="toc_element">
+  <code><a href="logging_v2.folders.sinks.html">sinks()</a></code>
+</p>
+<p class="firstline">Returns the sinks Resource.</p>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.folders.logs.html b/docs/dyn/logging_v2.folders.logs.html
new file mode 100644
index 00000000000..c2d6b2c73f8
--- /dev/null
+++ b/docs/dyn/logging_v2.folders.logs.html
@@ -0,0 +1,153 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.folders.html">folders</a> . <a href="logging_v2.folders.logs.html">logs</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#delete">delete(logName=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Deletes all the log entries in a log. The log reappears if it receives new entries.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists the logs in projects or organizations. Only logs that have entries are listed.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="delete">delete(logName=None, x__xgafv=None)</code>
+  <pre>Deletes all the log entries in a log. The log reappears if it receives new entries.
+
+Args:
+  logName: string, Required. The resource name of the log to delete:
+"projects/[PROJECT_ID]/logs/[LOG_ID]"
+"organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+[LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog", "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists the logs in projects or organizations. Only logs that have entries are listed.
+
+Args:
+  parent: string, Required. The resource name that owns the logs:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListLogs.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
+    "logNames": [ # A list of log names. For example, "projects/my-project/syslog" or "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
+      "A String",
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.folders.sinks.html b/docs/dyn/logging_v2.folders.sinks.html
new file mode 100644
index 00000000000..5fe02f0abf7
--- /dev/null
+++ b/docs/dyn/logging_v2.folders.sinks.html
@@ -0,0 +1,312 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.folders.html">folders</a> . <a href="logging_v2.folders.sinks.html">sinks</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.</p>
+<p class="toc_element">
+  <code><a href="#delete">delete(sinkName=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.</p>
+<p class="toc_element">
+  <code><a href="#get">get(sinkName=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets a sink.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists sinks.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.
+
+Args:
+  parent: string, Required. The resource in which to create the sink:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+Examples: "projects/my-logging-project", "organizations/123456789". (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+  }
+
+  uniqueWriterIdentity: boolean, Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then the value returned as writer_identity is cloud-logs@google.com, the same identity used before the addition of writer identities to this API. The sink's destination must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="delete">delete(sinkName=None, x__xgafv=None)</code>
+  <pre>Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.
+
+Args:
+  sinkName: string, Required. The full resource name of the sink to delete, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+It is an error if the sink does not exist. Example: "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does not exist. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(sinkName=None, x__xgafv=None)</code>
+  <pre>Gets a sink.
+
+Args:
+  sinkName: string, Required. The parent resource name of the sink:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists sinks.
+
+Args:
+  parent: string, Required. The parent resource whose sinks are to be listed. Examples: "projects/my-logging-project", "organizations/123456789". (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListSinks.
+    "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
+    "sinks": [ # A list of sinks.
+      { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+          "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+          "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+          "destination": "A String", # Required. The export destination:
+              # "storage.googleapis.com/[GCS_BUCKET]"
+              # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+              # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+              # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+          "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+              # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+          "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+          "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+          "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+        },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.
+
+Args:
+  sinkName: string, Required. The full resource name of the sink to update, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+  }
+
+  uniqueWriterIdentity: boolean, Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both the old and new values of this field:
+If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity.
+If the old value was false and the new value is true, then writer_identity is changed to a unique service account.
+It is an error if the old value was true and the new value is false.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.html b/docs/dyn/logging_v2.html
index a13b9c1947f..58b98d28511 100644
--- a/docs/dyn/logging_v2.html
+++ b/docs/dyn/logging_v2.html
@@ -84,6 +84,11 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the entries Resource.</p>
 
+<p class="toc_element">
+  <code><a href="logging_v2.folders.html">folders()</a></code>
+</p>
+<p class="firstline">Returns the folders Resource.</p>
+
 <p class="toc_element">
   <code><a href="logging_v2.monitoredResourceDescriptors.html">monitoredResourceDescriptors()</a></code>
 </p>
diff --git a/docs/dyn/logging_v2.monitoredResourceDescriptors.html b/docs/dyn/logging_v2.monitoredResourceDescriptors.html
index 8b8c22ed8fa..3b54b9bb896 100644
--- a/docs/dyn/logging_v2.monitoredResourceDescriptors.html
+++ b/docs/dyn/logging_v2.monitoredResourceDescriptors.html
@@ -76,23 +76,18 @@ <h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list">list(pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists the monitored resource descriptors used by Stackdriver Logging.</p>
+<p class="firstline">Lists the descriptors for monitored resource types used by Stackdriver Logging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="list">list(pageSize=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists the monitored resource descriptors used by Stackdriver Logging.
+  <pre>Lists the descriptors for monitored resource types used by Stackdriver Logging.
 
 Args:
-  pageSize: integer, Optional. The maximum number of results to return from this request.
-Non-positive values are ignored.  The presence of `nextPageToken` in the
-response indicates that more results might be available.
-  pageToken: string, Optional. If present, then retrieve the next batch of results from the
-preceding call to this method.  `pageToken` must be the value of
-`nextPageToken` from the previous response.  The values of other method
-parameters should be identical to those in the previous call.
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -102,43 +97,20 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # Result returned from ListMonitoredResourceDescriptors.
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call this
-        # method again using the value of `nextPageToken` as `pageToken`.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
     "resourceDescriptors": [ # A list of resource descriptors.
-      { # An object that describes the schema of a MonitoredResource object using a
-          # type name and a set of labels.  For example, the monitored resource
-          # descriptor for Google Compute Engine VM instances has a type of
-          # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
-          # `"zone"` to identify particular VM instances.
-          #
-          # Different APIs can support different monitored resource types. APIs generally
-          # provide a `list` method that returns the monitored resource descriptors used
-          # by the API.
-        "type": "A String", # Required. The monitored resource type. For example, the type
-            # `"cloudsql_database"` represents databases in Google Cloud SQL.
-            # The maximum length of this value is 256 characters.
-        "labels": [ # Required. A set of labels used to describe instances of this monitored
-            # resource type. For example, an individual Google Cloud SQL database is
-            # identified by values for the labels `"database_id"` and `"zone"`.
+      { # An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of "gce_instance" and specifies the use of the labels "instance_id" and "zone" to identify particular VM instances.Different APIs can support different monitored resource types. APIs generally provide a list method that returns the monitored resource descriptors used by the API.
+        "type": "A String", # Required. The monitored resource type. For example, the type "cloudsql_database" represents databases in Google Cloud SQL. The maximum length of this value is 256 characters.
+        "labels": [ # Required. A set of labels used to describe instances of this monitored resource type. For example, an individual Google Cloud SQL database is identified by values for the labels "database_id" and "zone".
           { # A description of a label.
             "valueType": "A String", # The type of data that can be assigned to the label.
             "description": "A String", # A human-readable description for the label.
             "key": "A String", # The label key.
           },
         ],
-        "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
-            # displayed in user interfaces. It should be a Title Cased Noun Phrase,
-            # without any article or other determiners. For example,
-            # `"Google Cloud SQL Database"`.
-        "description": "A String", # Optional. A detailed description of the monitored resource type that might
-            # be used in documentation.
-        "name": "A String", # Optional. The resource name of the monitored resource descriptor:
-            # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
-            # {type} is the value of the `type` field in this object and
-            # {project_id} is a project ID that provides API-specific context for
-            # accessing the type.  APIs that do not use project information can use the
-            # resource name format `"monitoredResourceDescriptors/{type}"`.
+        "displayName": "A String", # Optional. A concise name for the monitored resource type that might be displayed in user interfaces. It should be a Title Cased Noun Phrase, without any article or other determiners. For example, "Google Cloud SQL Database".
+        "description": "A String", # Optional. A detailed description of the monitored resource type that might be used in documentation.
+        "name": "A String", # Optional. The resource name of the monitored resource descriptor: "projects/{project_id}/monitoredResourceDescriptors/{type}" where {type} is the value of the type field in this object and {project_id} is a project ID that provides API-specific context for accessing the type. APIs that do not use project information can use the resource name format "monitoredResourceDescriptors/{type}".
       },
     ],
   }</pre>
diff --git a/docs/dyn/logging_v2.organizations.logs.html b/docs/dyn/logging_v2.organizations.logs.html
index bfe24d2ba12..323c113f077 100644
--- a/docs/dyn/logging_v2.organizations.logs.html
+++ b/docs/dyn/logging_v2.organizations.logs.html
@@ -76,16 +76,23 @@ <h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#delete">delete(logName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a log and all its log entries.</p>
+<p class="firstline">Deletes all the log entries in a log. The log reappears if it receives new entries.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists the logs in projects or organizations. Only logs that have entries are listed.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="delete">delete(logName=None, x__xgafv=None)</code>
-  <pre>Deletes a log and all its log entries.
-The log will reappear if it receives new entries.
+  <pre>Deletes all the log entries in a log. The log reappears if it receives new entries.
 
 Args:
-  logName: string, Required. The resource name of the log to delete.  Example:
-`"projects/my-project/logs/syslog"`. (required)
+  logName: string, Required. The resource name of the log to delete:
+"projects/[PROJECT_ID]/logs/[LOG_ID]"
+"organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+[LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog", "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -94,16 +101,53 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists the logs in projects or organizations. Only logs that have entries are listed.
+
+Args:
+  parent: string, Required. The resource name that owns the logs:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListLogs.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
+    "logNames": [ # A list of log names. For example, "projects/my-project/syslog" or "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
+      "A String",
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.organizations.sinks.html b/docs/dyn/logging_v2.organizations.sinks.html
index 9a8f7584373..ad06cec0c49 100644
--- a/docs/dyn/logging_v2.organizations.sinks.html
+++ b/docs/dyn/logging_v2.organizations.sinks.html
@@ -75,77 +75,52 @@
 <h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.organizations.html">organizations</a> . <a href="logging_v2.organizations.sinks.html">sinks</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#create">create(parent=None, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a sink.</p>
+  <code><a href="#create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(sinkName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a sink.</p>
+<p class="firstline">Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.</p>
 <p class="toc_element">
   <code><a href="#get">get(sinkName=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets a sink.</p>
 <p class="toc_element">
-  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+  <code><a href="#list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
 <p class="firstline">Lists sinks.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#update">update(sinkName=None, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates or creates a sink.</p>
+  <code><a href="#update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(parent=None, body, x__xgafv=None)</code>
-  <pre>Creates a sink.
+    <code class="details" id="create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.
 
 Args:
-  parent: string, Required. The resource in which to create the sink.
-Example: `"projects/my-project-id"`.
-The new sink must be provided in the request. (required)
+  parent: string, Required. The resource in which to create the sink:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+Examples: "projects/my-logging-project", "organizations/123456789". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a sink used to export log entries outside of Stackdriver Logging.
-    "endTime": "A String", # Optional. Time at which this sink expires.
-    "name": "A String", # Required. The client-assigned sink identifier, unique within the
-        # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-        # limited to 1000 characters and can include only the following characters:
-        # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-        # of the name is 100 characters.
-    "destination": "A String", # Required. The export destination. See
-        # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-        # Examples:
-        # 
-        #     "storage.googleapis.com/my-gcs-bucket"
-        #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-        #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-    "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Only log entries matching the filter are exported. The filter
-        # must be consistent with the log entry format specified by the
-        # `outputVersionFormat` parameter, regardless of the format of the
-        # log entry that was originally written to Stackdriver Logging.
-        # Example filter (V2 format):
-        # 
-        #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-    "startTime": "A String", # Optional. Time range for which this sink is active.
-        # Logs are exported only if start_time <= entry.timestamp < end_time
-        # Both start_time and end_time may be omitted to specify
-        # (half) infinite ranges. The start_time must be less than the end_time.
-    "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-        # entries.  This version does not have to correspond to the version of the
-        # log entry that was written to Stackdriver Logging. If omitted, the
-        # v2 format is used.
-    "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-        # access.  This may be a service account or a group.
-        # Examples (Do not assume these specific values):
-        #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-        #    "group:cloud-logs@google.com"
-        # 
-        #   For GCS destinations, the role "roles/owner" is required on the bucket
-        #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-        #     required on the topic
-        #   For BigQuery, the role "roles/editor" is required on the dataset
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
   }
 
+  uniqueWriterIdentity: boolean, Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then the value returned as writer_identity is cloud-logs@google.com, the same identity used before the addition of writer identities to this API. The sink's destination must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -154,58 +129,31 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(sinkName=None, x__xgafv=None)</code>
-  <pre>Deletes a sink.
+  <pre>Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to delete, including the parent
-resource and the sink identifier.  Example:
-`"projects/my-project-id/sinks/my-sink-id"`.  It is an error if the sink
-does not exist. (required)
+  sinkName: string, Required. The full resource name of the sink to delete, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+It is an error if the sink does not exist. Example: "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does not exist. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -214,15 +162,11 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
@@ -231,8 +175,10 @@ <h3>Method Details</h3>
   <pre>Gets a sink.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to return.
-Example: `"projects/my-project-id/sinks/my-sink-id"`. (required)
+  sinkName: string, Required. The parent resource name of the sink:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -241,116 +187,54 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+    <code class="details" id="list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</code>
   <pre>Lists sinks.
 
 Args:
-  parent: string, Required. The cloud resource containing the sinks.
-Example: `"projects/my-logging-project"`. (required)
-  pageToken: string, Optional. If present, then retrieve the next batch of results from the
-preceding call to this method.  `pageToken` must be the value of
-`nextPageToken` from the previous response.  The values of other method
-parameters should be identical to those in the previous call.
+  parent: string, Required. The parent resource whose sinks are to be listed. Examples: "projects/my-logging-project", "organizations/123456789". (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
-  pageSize: integer, Optional. The maximum number of results to return from this request.
-Non-positive values are ignored.  The presence of `nextPageToken` in the
-response indicates that more results might be available.
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
 
 Returns:
   An object of the form:
 
-    { # Result returned from `ListSinks`.
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call the same
-        # method again using the value of `nextPageToken` as `pageToken`.
+    { # Result returned from ListSinks.
+    "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
     "sinks": [ # A list of sinks.
-      { # Describes a sink used to export log entries outside of Stackdriver Logging.
-          "endTime": "A String", # Optional. Time at which this sink expires.
-          "name": "A String", # Required. The client-assigned sink identifier, unique within the
-              # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-              # limited to 1000 characters and can include only the following characters:
-              # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-              # of the name is 100 characters.
-          "destination": "A String", # Required. The export destination. See
-              # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-              # Examples:
-              #
-              #     "storage.googleapis.com/my-gcs-bucket"
-              #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-              #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-          "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-              # Only log entries matching the filter are exported. The filter
-              # must be consistent with the log entry format specified by the
-              # `outputVersionFormat` parameter, regardless of the format of the
-              # log entry that was originally written to Stackdriver Logging.
-              # Example filter (V2 format):
-              #
-              #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-          "startTime": "A String", # Optional. Time range for which this sink is active.
-              # Logs are exported only if start_time <= entry.timestamp < end_time
-              # Both start_time and end_time may be omitted to specify
-              # (half) infinite ranges. The start_time must be less than the end_time.
-          "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-              # entries.  This version does not have to correspond to the version of the
-              # log entry that was written to Stackdriver Logging. If omitted, the
-              # v2 format is used.
-          "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-              # access.  This may be a service account or a group.
-              # Examples (Do not assume these specific values):
-              #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-              #    "group:cloud-logs@google.com"
-              #
-              #   For GCS destinations, the role "roles/owner" is required on the bucket
-              #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-              #     required on the topic
-              #   For BigQuery, the role "roles/editor" is required on the dataset
+      { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+          "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+          "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+          "destination": "A String", # Required. The export destination:
+              # "storage.googleapis.com/[GCS_BUCKET]"
+              # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+              # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+              # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+          "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+              # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+          "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+          "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+          "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
         },
     ],
   }</pre>
@@ -371,58 +255,36 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(sinkName=None, body, x__xgafv=None)</code>
-  <pre>Updates or creates a sink.
+    <code class="details" id="update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to update, including the parent
-resource and the sink identifier.  If the sink does not exist, this method
-creates the sink.  Example: `"projects/my-project-id/sinks/my-sink-id"`. (required)
+  sinkName: string, Required. The full resource name of the sink to update, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a sink used to export log entries outside of Stackdriver Logging.
-    "endTime": "A String", # Optional. Time at which this sink expires.
-    "name": "A String", # Required. The client-assigned sink identifier, unique within the
-        # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-        # limited to 1000 characters and can include only the following characters:
-        # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-        # of the name is 100 characters.
-    "destination": "A String", # Required. The export destination. See
-        # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-        # Examples:
-        # 
-        #     "storage.googleapis.com/my-gcs-bucket"
-        #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-        #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-    "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Only log entries matching the filter are exported. The filter
-        # must be consistent with the log entry format specified by the
-        # `outputVersionFormat` parameter, regardless of the format of the
-        # log entry that was originally written to Stackdriver Logging.
-        # Example filter (V2 format):
-        # 
-        #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-    "startTime": "A String", # Optional. Time range for which this sink is active.
-        # Logs are exported only if start_time <= entry.timestamp < end_time
-        # Both start_time and end_time may be omitted to specify
-        # (half) infinite ranges. The start_time must be less than the end_time.
-    "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-        # entries.  This version does not have to correspond to the version of the
-        # log entry that was written to Stackdriver Logging. If omitted, the
-        # v2 format is used.
-    "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-        # access.  This may be a service account or a group.
-        # Examples (Do not assume these specific values):
-        #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-        #    "group:cloud-logs@google.com"
-        # 
-        #   For GCS destinations, the role "roles/owner" is required on the bucket
-        #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-        #     required on the topic
-        #   For BigQuery, the role "roles/editor" is required on the dataset
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
   }
 
+  uniqueWriterIdentity: boolean, Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both the old and new values of this field:
+If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity.
+If the old value was false and the new value is true, then writer_identity is changed to a unique service account.
+It is an error if the old value was true and the new value is false.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -431,46 +293,19 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
diff --git a/docs/dyn/logging_v2.projects.logs.html b/docs/dyn/logging_v2.projects.logs.html
index 061b09d15cd..1e1af12ddf7 100644
--- a/docs/dyn/logging_v2.projects.logs.html
+++ b/docs/dyn/logging_v2.projects.logs.html
@@ -76,16 +76,23 @@ <h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#delete">delete(logName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a log and all its log entries.</p>
+<p class="firstline">Deletes all the log entries in a log. The log reappears if it receives new entries.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists the logs in projects or organizations. Only logs that have entries are listed.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="delete">delete(logName=None, x__xgafv=None)</code>
-  <pre>Deletes a log and all its log entries.
-The log will reappear if it receives new entries.
+  <pre>Deletes all the log entries in a log. The log reappears if it receives new entries.
 
 Args:
-  logName: string, Required. The resource name of the log to delete.  Example:
-`"projects/my-project/logs/syslog"`. (required)
+  logName: string, Required. The resource name of the log to delete:
+"projects/[PROJECT_ID]/logs/[LOG_ID]"
+"organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+[LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog", "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -94,16 +101,53 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists the logs in projects or organizations. Only logs that have entries are listed.
+
+Args:
+  parent: string, Required. The resource name that owns the logs:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListLogs.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
+    "logNames": [ # A list of log names. For example, "projects/my-project/syslog" or "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
+      "A String",
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.projects.metrics.html b/docs/dyn/logging_v2.projects.metrics.html
index 7f2552b5611..2e6bcb65ae6 100644
--- a/docs/dyn/logging_v2.projects.metrics.html
+++ b/docs/dyn/logging_v2.projects.metrics.html
@@ -98,29 +98,19 @@ <h3>Method Details</h3>
   <pre>Creates a logs-based metric.
 
 Args:
-  parent: string, The resource name of the project in which to create the metric.
-Example: `"projects/my-project-id"`.
-
+  parent: string, The resource name of the project in which to create the metric:
+"projects/[PROJECT_ID]"
 The new metric must be provided in the request. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a logs-based metric.  The value of the metric is the
-      # number of log entries that match a logs filter.
-    "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-    "version": "A String", # Output only. The API version that created or updated this metric.
-        # The version also dictates the syntax of the filter expression. When a value
-        # for this field is missing, the default value of V2 should be assumed.
+{ # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+    "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+        # "resource.type=gae_app AND severity>=ERROR"
+        # The maximum length of the filter is 20000 characters.
+    "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
     "description": "A String", # Optional. A description of this metric, which is used in documentation.
-    "name": "A String", # Required. The client-assigned metric identifier. Example:
-        # `"severe_errors"`.  Metric identifiers are limited to 100
-        # characters and can include only the following characters: `A-Z`,
-        # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-        # forward-slash character (`/`) denotes a hierarchy of name pieces,
-        # and it cannot be the first character of the name.  The '%' character
-        # is used to URL encode unsafe and reserved characters and must be
-        # followed by two hexadecimal digits according to RFC 1738.
+    "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
   }
 
   x__xgafv: string, V1 error format.
@@ -131,22 +121,13 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a logs-based metric.  The value of the metric is the
-        # number of log entries that match a logs filter.
-      "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-      "version": "A String", # Output only. The API version that created or updated this metric.
-          # The version also dictates the syntax of the filter expression. When a value
-          # for this field is missing, the default value of V2 should be assumed.
+    { # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+      "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+          # "resource.type=gae_app AND severity>=ERROR"
+          # The maximum length of the filter is 20000 characters.
+      "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
       "description": "A String", # Optional. A description of this metric, which is used in documentation.
-      "name": "A String", # Required. The client-assigned metric identifier. Example:
-          # `"severe_errors"`.  Metric identifiers are limited to 100
-          # characters and can include only the following characters: `A-Z`,
-          # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-          # forward-slash character (`/`) denotes a hierarchy of name pieces,
-          # and it cannot be the first character of the name.  The '%' character
-          # is used to URL encode unsafe and reserved characters and must be
-          # followed by two hexadecimal digits according to RFC 1738.
+      "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
     }</pre>
 </div>
 
@@ -155,8 +136,9 @@ <h3>Method Details</h3>
   <pre>Deletes a logs-based metric.
 
 Args:
-  metricName: string, The resource name of the metric to delete.
-Example: `"projects/my-project-id/metrics/my-metric-id"`. (required)
+  metricName: string, The resource name of the metric to delete:
+"projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+ (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -165,15 +147,11 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
@@ -182,8 +160,9 @@ <h3>Method Details</h3>
   <pre>Gets a logs-based metric.
 
 Args:
-  metricName: string, The resource name of the desired metric.
-Example: `"projects/my-project-id/metrics/my-metric-id"`. (required)
+  metricName: string, The resource name of the desired metric:
+"projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+ (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -192,22 +171,13 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a logs-based metric.  The value of the metric is the
-        # number of log entries that match a logs filter.
-      "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-      "version": "A String", # Output only. The API version that created or updated this metric.
-          # The version also dictates the syntax of the filter expression. When a value
-          # for this field is missing, the default value of V2 should be assumed.
+    { # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+      "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+          # "resource.type=gae_app AND severity>=ERROR"
+          # The maximum length of the filter is 20000 characters.
+      "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
       "description": "A String", # Optional. A description of this metric, which is used in documentation.
-      "name": "A String", # Required. The client-assigned metric identifier. Example:
-          # `"severe_errors"`.  Metric identifiers are limited to 100
-          # characters and can include only the following characters: `A-Z`,
-          # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-          # forward-slash character (`/`) denotes a hierarchy of name pieces,
-          # and it cannot be the first character of the name.  The '%' character
-          # is used to URL encode unsafe and reserved characters and must be
-          # followed by two hexadecimal digits according to RFC 1738.
+      "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
     }</pre>
 </div>
 
@@ -216,46 +186,31 @@ <h3>Method Details</h3>
   <pre>Lists logs-based metrics.
 
 Args:
-  parent: string, Required. The resource name containing the metrics.
-Example: `"projects/my-project-id"`. (required)
-  pageToken: string, Optional. If present, then retrieve the next batch of results from the
-preceding call to this method.  `pageToken` must be the value of
-`nextPageToken` from the previous response.  The values of other method
-parameters should be identical to those in the previous call.
+  parent: string, Required. The name of the project containing the metrics:
+"projects/[PROJECT_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
-  pageSize: integer, Optional. The maximum number of results to return from this request.
-Non-positive values are ignored.  The presence of `nextPageToken` in the
-response indicates that more results might be available.
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
 
 Returns:
   An object of the form:
 
     { # Result returned from ListLogMetrics.
     "metrics": [ # A list of logs-based metrics.
-      { # Describes a logs-based metric.  The value of the metric is the
-            # number of log entries that match a logs filter.
-          "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-              # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-          "version": "A String", # Output only. The API version that created or updated this metric.
-              # The version also dictates the syntax of the filter expression. When a value
-              # for this field is missing, the default value of V2 should be assumed.
+      { # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+          "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+              # "resource.type=gae_app AND severity>=ERROR"
+              # The maximum length of the filter is 20000 characters.
+          "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
           "description": "A String", # Optional. A description of this metric, which is used in documentation.
-          "name": "A String", # Required. The client-assigned metric identifier. Example:
-              # `"severe_errors"`.  Metric identifiers are limited to 100
-              # characters and can include only the following characters: `A-Z`,
-              # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-              # forward-slash character (`/`) denotes a hierarchy of name pieces,
-              # and it cannot be the first character of the name.  The '%' character
-              # is used to URL encode unsafe and reserved characters and must be
-              # followed by two hexadecimal digits according to RFC 1738.
+          "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
         },
     ],
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call this
-        # method again using the value of `nextPageToken` as `pageToken`.
+    "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
   }</pre>
 </div>
 
@@ -278,31 +233,19 @@ <h3>Method Details</h3>
   <pre>Creates or updates a logs-based metric.
 
 Args:
-  metricName: string, The resource name of the metric to update.
-Example: `"projects/my-project-id/metrics/my-metric-id"`.
-
-The updated metric must be provided in the request and have the
-same identifier that is specified in `metricName`.
-If the metric does not exist, it is created. (required)
+  metricName: string, The resource name of the metric to update:
+"projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+The updated metric must be provided in the request and it's name field must be the same as [METRIC_ID] If the metric does not exist in [PROJECT_ID], then a new metric is created. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a logs-based metric.  The value of the metric is the
-      # number of log entries that match a logs filter.
-    "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-    "version": "A String", # Output only. The API version that created or updated this metric.
-        # The version also dictates the syntax of the filter expression. When a value
-        # for this field is missing, the default value of V2 should be assumed.
+{ # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+    "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+        # "resource.type=gae_app AND severity>=ERROR"
+        # The maximum length of the filter is 20000 characters.
+    "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
     "description": "A String", # Optional. A description of this metric, which is used in documentation.
-    "name": "A String", # Required. The client-assigned metric identifier. Example:
-        # `"severe_errors"`.  Metric identifiers are limited to 100
-        # characters and can include only the following characters: `A-Z`,
-        # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-        # forward-slash character (`/`) denotes a hierarchy of name pieces,
-        # and it cannot be the first character of the name.  The '%' character
-        # is used to URL encode unsafe and reserved characters and must be
-        # followed by two hexadecimal digits according to RFC 1738.
+    "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
   }
 
   x__xgafv: string, V1 error format.
@@ -313,22 +256,13 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a logs-based metric.  The value of the metric is the
-        # number of log entries that match a logs filter.
-      "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-      "version": "A String", # Output only. The API version that created or updated this metric.
-          # The version also dictates the syntax of the filter expression. When a value
-          # for this field is missing, the default value of V2 should be assumed.
+    { # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+      "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+          # "resource.type=gae_app AND severity>=ERROR"
+          # The maximum length of the filter is 20000 characters.
+      "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
       "description": "A String", # Optional. A description of this metric, which is used in documentation.
-      "name": "A String", # Required. The client-assigned metric identifier. Example:
-          # `"severe_errors"`.  Metric identifiers are limited to 100
-          # characters and can include only the following characters: `A-Z`,
-          # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-          # forward-slash character (`/`) denotes a hierarchy of name pieces,
-          # and it cannot be the first character of the name.  The '%' character
-          # is used to URL encode unsafe and reserved characters and must be
-          # followed by two hexadecimal digits according to RFC 1738.
+      "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
     }</pre>
 </div>
 
diff --git a/docs/dyn/logging_v2.projects.sinks.html b/docs/dyn/logging_v2.projects.sinks.html
index 2866ef94497..4019cc64b1d 100644
--- a/docs/dyn/logging_v2.projects.sinks.html
+++ b/docs/dyn/logging_v2.projects.sinks.html
@@ -75,77 +75,52 @@
 <h1><a href="logging_v2.html">Stackdriver Logging API</a> . <a href="logging_v2.projects.html">projects</a> . <a href="logging_v2.projects.sinks.html">sinks</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#create">create(parent=None, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a sink.</p>
+  <code><a href="#create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(sinkName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a sink.</p>
+<p class="firstline">Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.</p>
 <p class="toc_element">
   <code><a href="#get">get(sinkName=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets a sink.</p>
 <p class="toc_element">
-  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+  <code><a href="#list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
 <p class="firstline">Lists sinks.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#update">update(sinkName=None, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates or creates a sink.</p>
+  <code><a href="#update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(parent=None, body, x__xgafv=None)</code>
-  <pre>Creates a sink.
+    <code class="details" id="create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.
 
 Args:
-  parent: string, Required. The resource in which to create the sink.
-Example: `"projects/my-project-id"`.
-The new sink must be provided in the request. (required)
+  parent: string, Required. The resource in which to create the sink:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+Examples: "projects/my-logging-project", "organizations/123456789". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a sink used to export log entries outside of Stackdriver Logging.
-    "endTime": "A String", # Optional. Time at which this sink expires.
-    "name": "A String", # Required. The client-assigned sink identifier, unique within the
-        # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-        # limited to 1000 characters and can include only the following characters:
-        # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-        # of the name is 100 characters.
-    "destination": "A String", # Required. The export destination. See
-        # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-        # Examples:
-        # 
-        #     "storage.googleapis.com/my-gcs-bucket"
-        #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-        #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-    "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Only log entries matching the filter are exported. The filter
-        # must be consistent with the log entry format specified by the
-        # `outputVersionFormat` parameter, regardless of the format of the
-        # log entry that was originally written to Stackdriver Logging.
-        # Example filter (V2 format):
-        # 
-        #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-    "startTime": "A String", # Optional. Time range for which this sink is active.
-        # Logs are exported only if start_time <= entry.timestamp < end_time
-        # Both start_time and end_time may be omitted to specify
-        # (half) infinite ranges. The start_time must be less than the end_time.
-    "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-        # entries.  This version does not have to correspond to the version of the
-        # log entry that was written to Stackdriver Logging. If omitted, the
-        # v2 format is used.
-    "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-        # access.  This may be a service account or a group.
-        # Examples (Do not assume these specific values):
-        #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-        #    "group:cloud-logs@google.com"
-        # 
-        #   For GCS destinations, the role "roles/owner" is required on the bucket
-        #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-        #     required on the topic
-        #   For BigQuery, the role "roles/editor" is required on the dataset
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
   }
 
+  uniqueWriterIdentity: boolean, Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then the value returned as writer_identity is cloud-logs@google.com, the same identity used before the addition of writer identities to this API. The sink's destination must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -154,58 +129,31 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(sinkName=None, x__xgafv=None)</code>
-  <pre>Deletes a sink.
+  <pre>Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to delete, including the parent
-resource and the sink identifier.  Example:
-`"projects/my-project-id/sinks/my-sink-id"`.  It is an error if the sink
-does not exist. (required)
+  sinkName: string, Required. The full resource name of the sink to delete, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+It is an error if the sink does not exist. Example: "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does not exist. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -214,15 +162,11 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
@@ -231,8 +175,10 @@ <h3>Method Details</h3>
   <pre>Gets a sink.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to return.
-Example: `"projects/my-project-id/sinks/my-sink-id"`. (required)
+  sinkName: string, Required. The parent resource name of the sink:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -241,116 +187,54 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+    <code class="details" id="list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</code>
   <pre>Lists sinks.
 
 Args:
-  parent: string, Required. The cloud resource containing the sinks.
-Example: `"projects/my-logging-project"`. (required)
-  pageToken: string, Optional. If present, then retrieve the next batch of results from the
-preceding call to this method.  `pageToken` must be the value of
-`nextPageToken` from the previous response.  The values of other method
-parameters should be identical to those in the previous call.
+  parent: string, Required. The parent resource whose sinks are to be listed. Examples: "projects/my-logging-project", "organizations/123456789". (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
-  pageSize: integer, Optional. The maximum number of results to return from this request.
-Non-positive values are ignored.  The presence of `nextPageToken` in the
-response indicates that more results might be available.
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
 
 Returns:
   An object of the form:
 
-    { # Result returned from `ListSinks`.
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call the same
-        # method again using the value of `nextPageToken` as `pageToken`.
+    { # Result returned from ListSinks.
+    "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
     "sinks": [ # A list of sinks.
-      { # Describes a sink used to export log entries outside of Stackdriver Logging.
-          "endTime": "A String", # Optional. Time at which this sink expires.
-          "name": "A String", # Required. The client-assigned sink identifier, unique within the
-              # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-              # limited to 1000 characters and can include only the following characters:
-              # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-              # of the name is 100 characters.
-          "destination": "A String", # Required. The export destination. See
-              # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-              # Examples:
-              #
-              #     "storage.googleapis.com/my-gcs-bucket"
-              #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-              #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-          "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-              # Only log entries matching the filter are exported. The filter
-              # must be consistent with the log entry format specified by the
-              # `outputVersionFormat` parameter, regardless of the format of the
-              # log entry that was originally written to Stackdriver Logging.
-              # Example filter (V2 format):
-              #
-              #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-          "startTime": "A String", # Optional. Time range for which this sink is active.
-              # Logs are exported only if start_time <= entry.timestamp < end_time
-              # Both start_time and end_time may be omitted to specify
-              # (half) infinite ranges. The start_time must be less than the end_time.
-          "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-              # entries.  This version does not have to correspond to the version of the
-              # log entry that was written to Stackdriver Logging. If omitted, the
-              # v2 format is used.
-          "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-              # access.  This may be a service account or a group.
-              # Examples (Do not assume these specific values):
-              #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-              #    "group:cloud-logs@google.com"
-              #
-              #   For GCS destinations, the role "roles/owner" is required on the bucket
-              #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-              #     required on the topic
-              #   For BigQuery, the role "roles/editor" is required on the dataset
+      { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+          "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+          "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+          "destination": "A String", # Required. The export destination:
+              # "storage.googleapis.com/[GCS_BUCKET]"
+              # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+              # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+              # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+          "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+              # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+          "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+          "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+          "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
         },
     ],
   }</pre>
@@ -371,58 +255,36 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(sinkName=None, body, x__xgafv=None)</code>
-  <pre>Updates or creates a sink.
+    <code class="details" id="update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to update, including the parent
-resource and the sink identifier.  If the sink does not exist, this method
-creates the sink.  Example: `"projects/my-project-id/sinks/my-sink-id"`. (required)
+  sinkName: string, Required. The full resource name of the sink to update, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a sink used to export log entries outside of Stackdriver Logging.
-    "endTime": "A String", # Optional. Time at which this sink expires.
-    "name": "A String", # Required. The client-assigned sink identifier, unique within the
-        # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-        # limited to 1000 characters and can include only the following characters:
-        # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-        # of the name is 100 characters.
-    "destination": "A String", # Required. The export destination. See
-        # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-        # Examples:
-        # 
-        #     "storage.googleapis.com/my-gcs-bucket"
-        #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-        #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-    "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Only log entries matching the filter are exported. The filter
-        # must be consistent with the log entry format specified by the
-        # `outputVersionFormat` parameter, regardless of the format of the
-        # log entry that was originally written to Stackdriver Logging.
-        # Example filter (V2 format):
-        # 
-        #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-    "startTime": "A String", # Optional. Time range for which this sink is active.
-        # Logs are exported only if start_time <= entry.timestamp < end_time
-        # Both start_time and end_time may be omitted to specify
-        # (half) infinite ranges. The start_time must be less than the end_time.
-    "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-        # entries.  This version does not have to correspond to the version of the
-        # log entry that was written to Stackdriver Logging. If omitted, the
-        # v2 format is used.
-    "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-        # access.  This may be a service account or a group.
-        # Examples (Do not assume these specific values):
-        #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-        #    "group:cloud-logs@google.com"
-        # 
-        #   For GCS destinations, the role "roles/owner" is required on the bucket
-        #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-        #     required on the topic
-        #   For BigQuery, the role "roles/editor" is required on the dataset
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
   }
 
+  uniqueWriterIdentity: boolean, Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both the old and new values of this field:
+If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity.
+If the old value was false and the new value is true, then writer_identity is changed to a unique service account.
+It is an error if the old value was true and the new value is false.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -431,46 +293,19 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
diff --git a/docs/dyn/logging_v2beta1.billingAccounts.logs.html b/docs/dyn/logging_v2beta1.billingAccounts.logs.html
index 9b2dc71abb6..3036096da40 100644
--- a/docs/dyn/logging_v2beta1.billingAccounts.logs.html
+++ b/docs/dyn/logging_v2beta1.billingAccounts.logs.html
@@ -76,16 +76,23 @@ <h1><a href="logging_v2beta1.html">Stackdriver Logging API</a> . <a href="loggin
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#delete">delete(logName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a log and all its log entries.</p>
+<p class="firstline">Deletes all the log entries in a log. The log reappears if it receives new entries.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists the logs in projects or organizations. Only logs that have entries are listed.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="delete">delete(logName=None, x__xgafv=None)</code>
-  <pre>Deletes a log and all its log entries.
-The log will reappear if it receives new entries.
+  <pre>Deletes all the log entries in a log. The log reappears if it receives new entries.
 
 Args:
-  logName: string, Required. The resource name of the log to delete.  Example:
-`"projects/my-project/logs/syslog"`. (required)
+  logName: string, Required. The resource name of the log to delete:
+"projects/[PROJECT_ID]/logs/[LOG_ID]"
+"organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+[LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog", "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -94,16 +101,53 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists the logs in projects or organizations. Only logs that have entries are listed.
+
+Args:
+  parent: string, Required. The resource name that owns the logs:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListLogs.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
+    "logNames": [ # A list of log names. For example, "projects/my-project/syslog" or "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
+      "A String",
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2beta1.entries.html b/docs/dyn/logging_v2beta1.entries.html
index 7edc1f3219d..6602c0da08e 100644
--- a/docs/dyn/logging_v2beta1.entries.html
+++ b/docs/dyn/logging_v2beta1.entries.html
@@ -76,48 +76,31 @@ <h1><a href="logging_v2beta1.html">Stackdriver Logging API</a> . <a href="loggin
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list">list(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists log entries.  Use this method to retrieve log entries from Cloud</p>
+<p class="firstline">Lists log entries. Use this method to retrieve log entries from Stackdriver Logging. For ways to export log entries, see Exporting Logs.</p>
 <p class="toc_element">
   <code><a href="#write">write(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Writes log entries to Stackdriver Logging.  All log entries are</p>
+<p class="firstline">Writes log entries to Stackdriver Logging. All log entries are written by this method.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="list">list(body, x__xgafv=None)</code>
-  <pre>Lists log entries.  Use this method to retrieve log entries from Cloud
-Logging.  For ways to export log entries, see
-[Exporting Logs](/logging/docs/export).
+  <pre>Lists log entries. Use this method to retrieve log entries from Stackdriver Logging. For ways to export log entries, see Exporting Logs.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # The parameters to `ListLogEntries`.
-    "orderBy": "A String", # Optional. How the results should be sorted.  Presently, the only permitted
-        # values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
-        # option returns entries in order of increasing values of
-        # `LogEntry.timestamp` (oldest first), and the second option returns entries
-        # in order of decreasing timestamps (newest first).  Entries with equal
-        # timestamps are returned in order of `LogEntry.insertId`.
-    "resourceNames": [ # Required. One or more cloud resources from which to retrieve log entries.
-        # Example: `"projects/my-project-1A"`, `"projects/1234567890"`.  Projects
-        # listed in `projectIds` are added to this list.
+{ # The parameters to ListLogEntries.
+    "orderBy": "A String", # Optional. How the results should be sorted. Presently, the only permitted values are "timestamp asc" (default) and "timestamp desc". The first option returns entries in order of increasing values of LogEntry.timestamp (oldest first), and the second option returns entries in order of decreasing timestamps (newest first). Entries with equal timestamps are returned in order of LogEntry.insertId.
+    "resourceNames": [ # Required. Names of one or more resources from which to retrieve log entries:
+        # "projects/[PROJECT_ID]"
+        # "organizations/[ORGANIZATION_ID]"
+        # Projects listed in the project_ids field are added to this list.
       "A String",
     ],
-    "pageSize": 42, # Optional. The maximum number of results to return from this request.
-        # Non-positive values are ignored.  The presence of `nextPageToken` in the
-        # response indicates that more results might be available.
-    "filter": "A String", # Optional. A filter that chooses which log entries to return.  See [Advanced
-        # Logs Filters](/logging/docs/view/advanced_filters).  Only log entries that
-        # match the filter are returned.  An empty filter matches all log entries.
-    "pageToken": "A String", # Optional. If present, then retrieve the next batch of results from the
-        # preceding call to this method.  `pageToken` must be the value of
-        # `nextPageToken` from the previous response.  The values of other method
-        # parameters should be identical to those in the previous call.
-    "projectIds": [ # Deprecated. One or more project identifiers or project numbers from which
-        # to retrieve log entries.  Examples: `"my-project-1A"`, `"1234567890"`. If
-        # present, these project identifiers are converted to resource format and
-        # added to the list of resources in `resourceNames`. Callers should use
-        # `resourceNames` rather than this parameter.
+    "pageSize": 42, # Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+    "filter": "A String", # Optional. A filter that chooses which log entries to return. See Advanced Logs Filters. Only log entries that match the filter are returned. An empty filter matches all log entries in the resources listed in resource_names. Referencing a parent resource that is not listed in resource_names will cause the filter to return no results. The maximum length of the filter is 20000 characters.
+    "pageToken": "A String", # Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+    "projectIds": [ # Deprecated. Use resource_names instead. One or more project identifiers or project numbers from which to retrieve log entries. Example: "my-project-1A". If present, these project identifiers are converted to resource name format and added to the list of resources in resource_names.
       "A String",
     ],
   }
@@ -130,115 +113,64 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Result returned from `ListLogEntries`.
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call this
-        # method again using the value of `nextPageToken` as `pageToken`.
+    { # Result returned from ListLogEntries.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.If a value for next_page_token appears and the entries field is empty, it means that the search found no log entries so far but it did not have time to search all the possible log entries. Retry the method with this value for page_token to continue the search. Alternatively, consider speeding up the search by changing your filter to specify a single log name or resource type, or to narrow the time range of the search.
     "entries": [ # A list of log entries.
       { # An individual entry in a log.
-        "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
-            # log entry, if applicable.
-            # defined by the HTTP specification. Product-specific logging
-            # information MUST be defined in a separate message.
-          "status": 42, # The response code indicating the status of response.
-              # Examples: 200, 404.
-          "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
-              # being served from cache. This field is only meaningful if `cache_hit` is
-              # True.
-          "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
-          "latency": "A String", # The request processing latency on the server, from the time the request was
-              # received until the response was sent.
-          "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
-              # cache fill was attempted.
-          "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query
-              # portion of the URL that was requested.
-              # Example: `"http://example.com/some/info?color=red"`.
-          "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
-              # sent to.
+        "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message. # Optional. Information about the HTTP request associated with this log entry, if applicable.
+          "status": 42, # The response code indicating the status of response. Examples: 200, 404.
+          "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before being served from cache. This field is only meaningful if cache_hit is True.
+          "requestMethod": "A String", # The request method. Examples: "GET", "HEAD", "PUT", "POST".
+          "latency": "A String", # The request processing latency on the server, from the time the request was received until the response was sent.
+          "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.
+          "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query portion of the URL that was requested. Example: "http://example.com/some/info?color=red".
+          "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was sent to.
           "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
-          "cacheHit": True or False, # Whether or not an entity was served from cache
-              # (with or without validation).
-          "referer": "A String", # The referer URL of the request, as defined in
-              # [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
-          "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
-              # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
-          "userAgent": "A String", # The user agent sent by the client. Example:
-              # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
-          "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
-              # headers and the request body.
-          "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
-              # including the response headers and the response body.
+          "cacheHit": True or False, # Whether or not an entity was served from cache (with or without validation).
+          "referer": "A String", # The referer URL of the request, as defined in HTTP/1.1 Header Field Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+          "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP request. Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
+          "userAgent": "A String", # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".
+          "requestSize": "A String", # The size of the HTTP request message in bytes, including the request headers and the request body.
+          "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes, including the response headers and the response body.
         },
-        "resource": { # An object representing a resource that can be used for monitoring, logging, # Required. The monitored resource associated with this log entry.
-            # Example: a log entry that reports a database error would be
-            # associated with the monitored resource designating the particular
-            # database that reported the error.
-            # billing, or other purposes. Examples include virtual machine instances,
-            # databases, and storage devices such as disks. The `type` field identifies a
-            # MonitoredResourceDescriptor object that describes the resource's
-            # schema. Information in the `labels` field identifies the actual resource and
-            # its attributes according to the schema. For example, a particular Compute
-            # Engine VM instance could be represented by the following object, because the
-            # MonitoredResourceDescriptor for `"gce_instance"` has labels
-            # `"instance_id"` and `"zone"`:
-            #
-            #     { "type": "gce_instance",
-            #       "labels": { "instance_id": "12345678901234",
-            #                   "zone": "us-central1-a" }}
-          "labels": { # Required. Values for all of the labels listed in the associated monitored
-              # resource descriptor. For example, Cloud SQL databases use the labels
-              # `"database_id"` and `"zone"`.
+        "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # Required. The monitored resource associated with this log entry. Example: a log entry that reports a database error would be associated with the monitored resource designating the particular database that reported the error.
+            # { "type": "gce_instance",
+            #   "labels": { "instance_id": "12345678901234",
+            #               "zone": "us-central1-a" }}
+          "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
             "a_key": "A String",
           },
-          "type": "A String", # Required. The monitored resource type. This field must match
-              # the `type` field of a MonitoredResourceDescriptor object. For
-              # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+          "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
         },
-        "severity": "A String", # Optional. The severity of the log entry. The default value is
-            # `LogSeverity.DEFAULT`.
         "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
-        "timestamp": "A String", # Optional. The time the event described by the log entry occurred.  If
-            # omitted, Stackdriver Logging will use the time the log entry is received.
-        "labels": { # Optional. A set of user-defined (key, value) data that provides additional
-            # information about the log entry.
+        "trace": "A String", # Optional. Resource name of the trace associated with the log entry, if any. If it contains a relative resource name, the name is assumed to be relative to //tracing.googleapis.com. Example: projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824
+        "timestamp": "A String", # Optional. The time the event described by the log entry occurred. If omitted, Stackdriver Logging will use the time the log entry is received.
+        "labels": { # Optional. A set of user-defined (key, value) data that provides additional information about the log entry.
           "a_key": "A String",
         },
-        "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this
-            # field, the logging service considers other log entries in the
-            # same project with the same ID as duplicates which can be removed.  If
-            # omitted, Stackdriver Logging will generate a unique ID for this
-            # log entry.
-        "jsonPayload": { # The log entry payload, represented as a structure that
-            # is expressed as a JSON object.
+        "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this field, the logging service considers other log entries in the same project with the same ID as duplicates which can be removed. If omitted, Stackdriver Logging will generate a unique ID for this log entry.
+        "jsonPayload": { # The log entry payload, represented as a structure that is expressed as a JSON object.
           "a_key": "", # Properties of the object.
         },
-        "logName": "A String", # Required. The resource name of the log to which this log entry
-            # belongs. The format of the name is
-            # `"projects/<project-id>/logs/<log-id>"`.  Examples:
-            # `"projects/my-projectid/logs/syslog"`,
-            # `"projects/my-projectid/logs/library.googleapis.com%2Fbook_log"`.
-            #
-            # The log ID part of resource name must be less than 512 characters
-            # long and can only include the following characters: upper and
-            # lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
-            # characters: forward-slash, underscore, hyphen, and period.
-            # Forward-slash (`/`) characters in the log ID must be URL-encoded.
-        "protoPayload": { # The log entry payload, represented as a protocol buffer.  Some
-            # Google Cloud Platform services use this field for their log
-            # entry payloads.
+        "logName": "A String", # Required. The resource name of the log to which this log entry belongs:
+            # "projects/[PROJECT_ID]/logs/[LOG_ID]"
+            # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+            # [LOG_ID] must be URL-encoded within log_name. Example: "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must be less than 512 characters long and can only include the following characters: upper and lower case alphanumeric characters, forward-slash, underscore, hyphen, and period.For backward compatibility, if log_name begins with a forward-slash, such as /projects/..., then the log entry is ingested as usual but the forward-slash is removed. Listing the log entry will not show the leading slash and filtering for a log name with a leading slash will never return any results.
+        "protoPayload": { # The log entry payload, represented as a protocol buffer. Some Google Cloud Platform services use this field for their log entry payloads.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
-            # applicable.
-            # a log entry is associated.
+        "operation": { # Additional information about a potentially long-running operation with which a log entry is associated. # Optional. Information about an operation associated with the log entry, if applicable.
           "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
-          "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
-              # same identifier are assumed to be part of the same operation.
-          "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
-              # `id` and `producer` must be globally unique.  Examples for `producer`:
-              # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+          "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the same identifier are assumed to be part of the same operation.
+          "producer": "A String", # Optional. An arbitrary producer identifier. The combination of id and producer must be globally unique. Examples for producer: "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".
           "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
         },
+        "sourceLocation": { # Additional information about the source code location that produced the log entry. # Optional. Source code location information associated with the log entry, if any.
+          "function": "A String", # Optional. Human-readable name of the function or method being invoked, with optional context such as the class or package name. This information may be used in contexts such as the logs viewer, where a file and line number are less meaningful. The format can vary by language. For example: qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).
+          "line": "A String", # Optional. Line within the source file. 1-based; 0 indicates no line number available.
+          "file": "A String", # Optional. Source file name. Depending on the runtime environment, this might be a simple name or a fully-qualified name.
+        },
+        "severity": "A String", # Optional. The severity of the log entry. The default value is LogSeverity.DEFAULT.
       },
     ],
   }</pre>
@@ -246,171 +178,90 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="write">write(body, x__xgafv=None)</code>
-  <pre>Writes log entries to Stackdriver Logging.  All log entries are
-written by this method.
+  <pre>Writes log entries to Stackdriver Logging. All log entries are written by this method.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # The parameters to WriteLogEntries.
-    "resource": { # An object representing a resource that can be used for monitoring, logging, # Optional. A default monitored resource object that is assigned to all log
-        # entries in `entries` that do not specify a value for `resource`. Example:
-        # 
-        #     { "type": "gce_instance",
-        #       "labels": {
-        #         "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
-        # 
+    "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # Optional. A default monitored resource object that is assigned to all log entries in entries that do not specify a value for resource. Example:
+        # { "type": "gce_instance",
+        #   "labels": {
+        #     "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
         # See LogEntry.
-        # billing, or other purposes. Examples include virtual machine instances,
-        # databases, and storage devices such as disks. The `type` field identifies a
-        # MonitoredResourceDescriptor object that describes the resource's
-        # schema. Information in the `labels` field identifies the actual resource and
-        # its attributes according to the schema. For example, a particular Compute
-        # Engine VM instance could be represented by the following object, because the
-        # MonitoredResourceDescriptor for `"gce_instance"` has labels
-        # `"instance_id"` and `"zone"`:
-        #
-        #     { "type": "gce_instance",
-        #       "labels": { "instance_id": "12345678901234",
-        #                   "zone": "us-central1-a" }}
-      "labels": { # Required. Values for all of the labels listed in the associated monitored
-          # resource descriptor. For example, Cloud SQL databases use the labels
-          # `"database_id"` and `"zone"`.
+        # { "type": "gce_instance",
+        #   "labels": { "instance_id": "12345678901234",
+        #               "zone": "us-central1-a" }}
+      "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
         "a_key": "A String",
       },
-      "type": "A String", # Required. The monitored resource type. This field must match
-          # the `type` field of a MonitoredResourceDescriptor object. For
-          # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+      "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
     },
-    "partialSuccess": True or False, # Optional. Whether valid entries should be written even if some other
-        # entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
-        # entry is not written, the response status will be the error associated
-        # with one of the failed entries and include error details in the form of
-        # WriteLogEntriesPartialErrors.
-    "labels": { # Optional. Default labels that are added to the `labels` field of all log
-        # entries in `entries`. If a log entry already has a label with the same key
-        # as a label in this parameter, then the log entry's label is not changed.
-        # See LogEntry.
+    "partialSuccess": True or False, # Optional. Whether valid entries should be written even if some other entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any entry is not written, the response status will be the error associated with one of the failed entries and include error details in the form of WriteLogEntriesPartialErrors.
+    "labels": { # Optional. Default labels that are added to the labels field of all log entries in entries. If a log entry already has a label with the same key as a label in this parameter, then the log entry's label is not changed. See LogEntry.
       "a_key": "A String",
     },
-    "logName": "A String", # Optional. A default log resource name that is assigned to all log entries
-        # in `entries` that do not specify a value for `log_name`.  Example:
-        # `"projects/my-project/logs/syslog"`.  See
-        # LogEntry.
-    "entries": [ # Required. The log entries to write. Values supplied for the fields
-        # `log_name`, `resource`, and `labels` in this `entries.write` request are
-        # added to those log entries that do not provide their own values for the
-        # fields.
-        # 
-        # To improve throughput and to avoid exceeding the
-        # [quota limit](/logging/quota-policy) for calls to `entries.write`,
-        # you should write multiple log entries at once rather than
-        # calling this method for each individual log entry.
+    "logName": "A String", # Optional. A default log resource name that is assigned to all log entries in entries that do not specify a value for log_name:
+        # "projects/[PROJECT_ID]/logs/[LOG_ID]"
+        # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+        # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog" or "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry.
+    "entries": [ # Required. The log entries to write. Values supplied for the fields log_name, resource, and labels in this entries.write request are added to those log entries that do not provide their own values for the fields.To improve throughput and to avoid exceeding the quota limit for calls to entries.write, you should write multiple log entries at once rather than calling this method for each individual log entry.
       { # An individual entry in a log.
-        "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
-            # log entry, if applicable.
-            # defined by the HTTP specification. Product-specific logging
-            # information MUST be defined in a separate message.
-          "status": 42, # The response code indicating the status of response.
-              # Examples: 200, 404.
-          "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
-              # being served from cache. This field is only meaningful if `cache_hit` is
-              # True.
-          "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
-          "latency": "A String", # The request processing latency on the server, from the time the request was
-              # received until the response was sent.
-          "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
-              # cache fill was attempted.
-          "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query
-              # portion of the URL that was requested.
-              # Example: `"http://example.com/some/info?color=red"`.
-          "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
-              # sent to.
+        "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message. # Optional. Information about the HTTP request associated with this log entry, if applicable.
+          "status": 42, # The response code indicating the status of response. Examples: 200, 404.
+          "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before being served from cache. This field is only meaningful if cache_hit is True.
+          "requestMethod": "A String", # The request method. Examples: "GET", "HEAD", "PUT", "POST".
+          "latency": "A String", # The request processing latency on the server, from the time the request was received until the response was sent.
+          "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.
+          "requestUrl": "A String", # The scheme (http, https), the host name, the path and the query portion of the URL that was requested. Example: "http://example.com/some/info?color=red".
+          "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was sent to.
           "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
-          "cacheHit": True or False, # Whether or not an entity was served from cache
-              # (with or without validation).
-          "referer": "A String", # The referer URL of the request, as defined in
-              # [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
-          "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
-              # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
-          "userAgent": "A String", # The user agent sent by the client. Example:
-              # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
-          "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
-              # headers and the request body.
-          "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
-              # including the response headers and the response body.
+          "cacheHit": True or False, # Whether or not an entity was served from cache (with or without validation).
+          "referer": "A String", # The referer URL of the request, as defined in HTTP/1.1 Header Field Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+          "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP request. Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
+          "userAgent": "A String", # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".
+          "requestSize": "A String", # The size of the HTTP request message in bytes, including the request headers and the request body.
+          "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes, including the response headers and the response body.
         },
-        "resource": { # An object representing a resource that can be used for monitoring, logging, # Required. The monitored resource associated with this log entry.
-            # Example: a log entry that reports a database error would be
-            # associated with the monitored resource designating the particular
-            # database that reported the error.
-            # billing, or other purposes. Examples include virtual machine instances,
-            # databases, and storage devices such as disks. The `type` field identifies a
-            # MonitoredResourceDescriptor object that describes the resource's
-            # schema. Information in the `labels` field identifies the actual resource and
-            # its attributes according to the schema. For example, a particular Compute
-            # Engine VM instance could be represented by the following object, because the
-            # MonitoredResourceDescriptor for `"gce_instance"` has labels
-            # `"instance_id"` and `"zone"`:
-            #
-            #     { "type": "gce_instance",
-            #       "labels": { "instance_id": "12345678901234",
-            #                   "zone": "us-central1-a" }}
-          "labels": { # Required. Values for all of the labels listed in the associated monitored
-              # resource descriptor. For example, Cloud SQL databases use the labels
-              # `"database_id"` and `"zone"`.
+        "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # Required. The monitored resource associated with this log entry. Example: a log entry that reports a database error would be associated with the monitored resource designating the particular database that reported the error.
+            # { "type": "gce_instance",
+            #   "labels": { "instance_id": "12345678901234",
+            #               "zone": "us-central1-a" }}
+          "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
             "a_key": "A String",
           },
-          "type": "A String", # Required. The monitored resource type. This field must match
-              # the `type` field of a MonitoredResourceDescriptor object. For
-              # example, the type of a Cloud SQL database is `"cloudsql_database"`.
+          "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
         },
-        "severity": "A String", # Optional. The severity of the log entry. The default value is
-            # `LogSeverity.DEFAULT`.
         "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
-        "timestamp": "A String", # Optional. The time the event described by the log entry occurred.  If
-            # omitted, Stackdriver Logging will use the time the log entry is received.
-        "labels": { # Optional. A set of user-defined (key, value) data that provides additional
-            # information about the log entry.
+        "trace": "A String", # Optional. Resource name of the trace associated with the log entry, if any. If it contains a relative resource name, the name is assumed to be relative to //tracing.googleapis.com. Example: projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824
+        "timestamp": "A String", # Optional. The time the event described by the log entry occurred. If omitted, Stackdriver Logging will use the time the log entry is received.
+        "labels": { # Optional. A set of user-defined (key, value) data that provides additional information about the log entry.
           "a_key": "A String",
         },
-        "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this
-            # field, the logging service considers other log entries in the
-            # same project with the same ID as duplicates which can be removed.  If
-            # omitted, Stackdriver Logging will generate a unique ID for this
-            # log entry.
-        "jsonPayload": { # The log entry payload, represented as a structure that
-            # is expressed as a JSON object.
+        "insertId": "A String", # Optional. A unique ID for the log entry. If you provide this field, the logging service considers other log entries in the same project with the same ID as duplicates which can be removed. If omitted, Stackdriver Logging will generate a unique ID for this log entry.
+        "jsonPayload": { # The log entry payload, represented as a structure that is expressed as a JSON object.
           "a_key": "", # Properties of the object.
         },
-        "logName": "A String", # Required. The resource name of the log to which this log entry
-            # belongs. The format of the name is
-            # `"projects/<project-id>/logs/<log-id>"`.  Examples:
-            # `"projects/my-projectid/logs/syslog"`,
-            # `"projects/my-projectid/logs/library.googleapis.com%2Fbook_log"`.
-            #
-            # The log ID part of resource name must be less than 512 characters
-            # long and can only include the following characters: upper and
-            # lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
-            # characters: forward-slash, underscore, hyphen, and period.
-            # Forward-slash (`/`) characters in the log ID must be URL-encoded.
-        "protoPayload": { # The log entry payload, represented as a protocol buffer.  Some
-            # Google Cloud Platform services use this field for their log
-            # entry payloads.
+        "logName": "A String", # Required. The resource name of the log to which this log entry belongs:
+            # "projects/[PROJECT_ID]/logs/[LOG_ID]"
+            # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+            # [LOG_ID] must be URL-encoded within log_name. Example: "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must be less than 512 characters long and can only include the following characters: upper and lower case alphanumeric characters, forward-slash, underscore, hyphen, and period.For backward compatibility, if log_name begins with a forward-slash, such as /projects/..., then the log entry is ingested as usual but the forward-slash is removed. Listing the log entry will not show the leading slash and filtering for a log name with a leading slash will never return any results.
+        "protoPayload": { # The log entry payload, represented as a protocol buffer. Some Google Cloud Platform services use this field for their log entry payloads.
           "a_key": "", # Properties of the object. Contains field @type with type URL.
         },
-        "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
-            # applicable.
-            # a log entry is associated.
+        "operation": { # Additional information about a potentially long-running operation with which a log entry is associated. # Optional. Information about an operation associated with the log entry, if applicable.
           "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
-          "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
-              # same identifier are assumed to be part of the same operation.
-          "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
-              # `id` and `producer` must be globally unique.  Examples for `producer`:
-              # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+          "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the same identifier are assumed to be part of the same operation.
+          "producer": "A String", # Optional. An arbitrary producer identifier. The combination of id and producer must be globally unique. Examples for producer: "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".
           "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
         },
+        "sourceLocation": { # Additional information about the source code location that produced the log entry. # Optional. Source code location information associated with the log entry, if any.
+          "function": "A String", # Optional. Human-readable name of the function or method being invoked, with optional context such as the class or package name. This information may be used in contexts such as the logs viewer, where a file and line number are less meaningful. The format can vary by language. For example: qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).
+          "line": "A String", # Optional. Line within the source file. 1-based; 0 indicates no line number available.
+          "file": "A String", # Optional. Source file name. Depending on the runtime environment, this might be a simple name or a fully-qualified name.
+        },
+        "severity": "A String", # Optional. The severity of the log entry. The default value is LogSeverity.DEFAULT.
       },
     ],
   }
@@ -423,8 +274,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Result returned from WriteLogEntries.
-      # empty
+    { # Result returned from WriteLogEntries. empty
   }</pre>
 </div>
 
diff --git a/docs/dyn/logging_v2beta1.monitoredResourceDescriptors.html b/docs/dyn/logging_v2beta1.monitoredResourceDescriptors.html
index 5ed27312970..b5ce7bddf9e 100644
--- a/docs/dyn/logging_v2beta1.monitoredResourceDescriptors.html
+++ b/docs/dyn/logging_v2beta1.monitoredResourceDescriptors.html
@@ -76,23 +76,18 @@ <h1><a href="logging_v2beta1.html">Stackdriver Logging API</a> . <a href="loggin
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list">list(pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists the monitored resource descriptors used by Stackdriver Logging.</p>
+<p class="firstline">Lists the descriptors for monitored resource types used by Stackdriver Logging.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="list">list(pageSize=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists the monitored resource descriptors used by Stackdriver Logging.
+  <pre>Lists the descriptors for monitored resource types used by Stackdriver Logging.
 
 Args:
-  pageSize: integer, Optional. The maximum number of results to return from this request.
-Non-positive values are ignored.  The presence of `nextPageToken` in the
-response indicates that more results might be available.
-  pageToken: string, Optional. If present, then retrieve the next batch of results from the
-preceding call to this method.  `pageToken` must be the value of
-`nextPageToken` from the previous response.  The values of other method
-parameters should be identical to those in the previous call.
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -102,43 +97,20 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # Result returned from ListMonitoredResourceDescriptors.
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call this
-        # method again using the value of `nextPageToken` as `pageToken`.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
     "resourceDescriptors": [ # A list of resource descriptors.
-      { # An object that describes the schema of a MonitoredResource object using a
-          # type name and a set of labels.  For example, the monitored resource
-          # descriptor for Google Compute Engine VM instances has a type of
-          # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
-          # `"zone"` to identify particular VM instances.
-          #
-          # Different APIs can support different monitored resource types. APIs generally
-          # provide a `list` method that returns the monitored resource descriptors used
-          # by the API.
-        "type": "A String", # Required. The monitored resource type. For example, the type
-            # `"cloudsql_database"` represents databases in Google Cloud SQL.
-            # The maximum length of this value is 256 characters.
-        "labels": [ # Required. A set of labels used to describe instances of this monitored
-            # resource type. For example, an individual Google Cloud SQL database is
-            # identified by values for the labels `"database_id"` and `"zone"`.
+      { # An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of "gce_instance" and specifies the use of the labels "instance_id" and "zone" to identify particular VM instances.Different APIs can support different monitored resource types. APIs generally provide a list method that returns the monitored resource descriptors used by the API.
+        "type": "A String", # Required. The monitored resource type. For example, the type "cloudsql_database" represents databases in Google Cloud SQL. The maximum length of this value is 256 characters.
+        "labels": [ # Required. A set of labels used to describe instances of this monitored resource type. For example, an individual Google Cloud SQL database is identified by values for the labels "database_id" and "zone".
           { # A description of a label.
             "valueType": "A String", # The type of data that can be assigned to the label.
             "description": "A String", # A human-readable description for the label.
             "key": "A String", # The label key.
           },
         ],
-        "displayName": "A String", # Optional. A concise name for the monitored resource type that might be
-            # displayed in user interfaces. It should be a Title Cased Noun Phrase,
-            # without any article or other determiners. For example,
-            # `"Google Cloud SQL Database"`.
-        "description": "A String", # Optional. A detailed description of the monitored resource type that might
-            # be used in documentation.
-        "name": "A String", # Optional. The resource name of the monitored resource descriptor:
-            # `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
-            # {type} is the value of the `type` field in this object and
-            # {project_id} is a project ID that provides API-specific context for
-            # accessing the type.  APIs that do not use project information can use the
-            # resource name format `"monitoredResourceDescriptors/{type}"`.
+        "displayName": "A String", # Optional. A concise name for the monitored resource type that might be displayed in user interfaces. It should be a Title Cased Noun Phrase, without any article or other determiners. For example, "Google Cloud SQL Database".
+        "description": "A String", # Optional. A detailed description of the monitored resource type that might be used in documentation.
+        "name": "A String", # Optional. The resource name of the monitored resource descriptor: "projects/{project_id}/monitoredResourceDescriptors/{type}" where {type} is the value of the type field in this object and {project_id} is a project ID that provides API-specific context for accessing the type. APIs that do not use project information can use the resource name format "monitoredResourceDescriptors/{type}".
       },
     ],
   }</pre>
diff --git a/docs/dyn/logging_v2beta1.organizations.logs.html b/docs/dyn/logging_v2beta1.organizations.logs.html
index 4ae14c5460b..ed86da33003 100644
--- a/docs/dyn/logging_v2beta1.organizations.logs.html
+++ b/docs/dyn/logging_v2beta1.organizations.logs.html
@@ -76,16 +76,23 @@ <h1><a href="logging_v2beta1.html">Stackdriver Logging API</a> . <a href="loggin
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#delete">delete(logName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a log and all its log entries.</p>
+<p class="firstline">Deletes all the log entries in a log. The log reappears if it receives new entries.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists the logs in projects or organizations. Only logs that have entries are listed.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="delete">delete(logName=None, x__xgafv=None)</code>
-  <pre>Deletes a log and all its log entries.
-The log will reappear if it receives new entries.
+  <pre>Deletes all the log entries in a log. The log reappears if it receives new entries.
 
 Args:
-  logName: string, Required. The resource name of the log to delete.  Example:
-`"projects/my-project/logs/syslog"`. (required)
+  logName: string, Required. The resource name of the log to delete:
+"projects/[PROJECT_ID]/logs/[LOG_ID]"
+"organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+[LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog", "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -94,16 +101,53 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists the logs in projects or organizations. Only logs that have entries are listed.
+
+Args:
+  parent: string, Required. The resource name that owns the logs:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListLogs.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
+    "logNames": [ # A list of log names. For example, "projects/my-project/syslog" or "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
+      "A String",
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2beta1.projects.logs.html b/docs/dyn/logging_v2beta1.projects.logs.html
index 7894475427c..f9571c83662 100644
--- a/docs/dyn/logging_v2beta1.projects.logs.html
+++ b/docs/dyn/logging_v2beta1.projects.logs.html
@@ -76,16 +76,23 @@ <h1><a href="logging_v2beta1.html">Stackdriver Logging API</a> . <a href="loggin
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#delete">delete(logName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a log and all its log entries.</p>
+<p class="firstline">Deletes all the log entries in a log. The log reappears if it receives new entries.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists the logs in projects or organizations. Only logs that have entries are listed.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="delete">delete(logName=None, x__xgafv=None)</code>
-  <pre>Deletes a log and all its log entries.
-The log will reappear if it receives new entries.
+  <pre>Deletes all the log entries in a log. The log reappears if it receives new entries.
 
 Args:
-  logName: string, Required. The resource name of the log to delete.  Example:
-`"projects/my-project/logs/syslog"`. (required)
+  logName: string, Required. The resource name of the log to delete:
+"projects/[PROJECT_ID]/logs/[LOG_ID]"
+"organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+[LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog", "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". For more information about log names, see LogEntry. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -94,16 +101,53 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists the logs in projects or organizations. Only logs that have entries are listed.
+
+Args:
+  parent: string, Required. The resource name that owns the logs:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+
+Returns:
+  An object of the form:
+
+    { # Result returned from ListLogs.
+    "nextPageToken": "A String", # If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
+    "logNames": [ # A list of log names. For example, "projects/my-project/syslog" or "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
+      "A String",
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/logging_v2beta1.projects.metrics.html b/docs/dyn/logging_v2beta1.projects.metrics.html
index 6b4ae6cbf68..7bd636d0a0a 100644
--- a/docs/dyn/logging_v2beta1.projects.metrics.html
+++ b/docs/dyn/logging_v2beta1.projects.metrics.html
@@ -98,29 +98,19 @@ <h3>Method Details</h3>
   <pre>Creates a logs-based metric.
 
 Args:
-  parent: string, The resource name of the project in which to create the metric.
-Example: `"projects/my-project-id"`.
-
+  parent: string, The resource name of the project in which to create the metric:
+"projects/[PROJECT_ID]"
 The new metric must be provided in the request. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a logs-based metric.  The value of the metric is the
-      # number of log entries that match a logs filter.
-    "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-    "version": "A String", # Output only. The API version that created or updated this metric.
-        # The version also dictates the syntax of the filter expression. When a value
-        # for this field is missing, the default value of V2 should be assumed.
+{ # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+    "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+        # "resource.type=gae_app AND severity>=ERROR"
+        # The maximum length of the filter is 20000 characters.
+    "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
     "description": "A String", # Optional. A description of this metric, which is used in documentation.
-    "name": "A String", # Required. The client-assigned metric identifier. Example:
-        # `"severe_errors"`.  Metric identifiers are limited to 100
-        # characters and can include only the following characters: `A-Z`,
-        # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-        # forward-slash character (`/`) denotes a hierarchy of name pieces,
-        # and it cannot be the first character of the name.  The '%' character
-        # is used to URL encode unsafe and reserved characters and must be
-        # followed by two hexadecimal digits according to RFC 1738.
+    "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
   }
 
   x__xgafv: string, V1 error format.
@@ -131,22 +121,13 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a logs-based metric.  The value of the metric is the
-        # number of log entries that match a logs filter.
-      "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-      "version": "A String", # Output only. The API version that created or updated this metric.
-          # The version also dictates the syntax of the filter expression. When a value
-          # for this field is missing, the default value of V2 should be assumed.
+    { # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+      "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+          # "resource.type=gae_app AND severity>=ERROR"
+          # The maximum length of the filter is 20000 characters.
+      "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
       "description": "A String", # Optional. A description of this metric, which is used in documentation.
-      "name": "A String", # Required. The client-assigned metric identifier. Example:
-          # `"severe_errors"`.  Metric identifiers are limited to 100
-          # characters and can include only the following characters: `A-Z`,
-          # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-          # forward-slash character (`/`) denotes a hierarchy of name pieces,
-          # and it cannot be the first character of the name.  The '%' character
-          # is used to URL encode unsafe and reserved characters and must be
-          # followed by two hexadecimal digits according to RFC 1738.
+      "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
     }</pre>
 </div>
 
@@ -155,8 +136,9 @@ <h3>Method Details</h3>
   <pre>Deletes a logs-based metric.
 
 Args:
-  metricName: string, The resource name of the metric to delete.
-Example: `"projects/my-project-id/metrics/my-metric-id"`. (required)
+  metricName: string, The resource name of the metric to delete:
+"projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+ (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -165,15 +147,11 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
@@ -182,8 +160,9 @@ <h3>Method Details</h3>
   <pre>Gets a logs-based metric.
 
 Args:
-  metricName: string, The resource name of the desired metric.
-Example: `"projects/my-project-id/metrics/my-metric-id"`. (required)
+  metricName: string, The resource name of the desired metric:
+"projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+ (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -192,22 +171,13 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a logs-based metric.  The value of the metric is the
-        # number of log entries that match a logs filter.
-      "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-      "version": "A String", # Output only. The API version that created or updated this metric.
-          # The version also dictates the syntax of the filter expression. When a value
-          # for this field is missing, the default value of V2 should be assumed.
+    { # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+      "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+          # "resource.type=gae_app AND severity>=ERROR"
+          # The maximum length of the filter is 20000 characters.
+      "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
       "description": "A String", # Optional. A description of this metric, which is used in documentation.
-      "name": "A String", # Required. The client-assigned metric identifier. Example:
-          # `"severe_errors"`.  Metric identifiers are limited to 100
-          # characters and can include only the following characters: `A-Z`,
-          # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-          # forward-slash character (`/`) denotes a hierarchy of name pieces,
-          # and it cannot be the first character of the name.  The '%' character
-          # is used to URL encode unsafe and reserved characters and must be
-          # followed by two hexadecimal digits according to RFC 1738.
+      "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
     }</pre>
 </div>
 
@@ -216,46 +186,31 @@ <h3>Method Details</h3>
   <pre>Lists logs-based metrics.
 
 Args:
-  parent: string, Required. The resource name containing the metrics.
-Example: `"projects/my-project-id"`. (required)
-  pageToken: string, Optional. If present, then retrieve the next batch of results from the
-preceding call to this method.  `pageToken` must be the value of
-`nextPageToken` from the previous response.  The values of other method
-parameters should be identical to those in the previous call.
+  parent: string, Required. The name of the project containing the metrics:
+"projects/[PROJECT_ID]"
+ (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
-  pageSize: integer, Optional. The maximum number of results to return from this request.
-Non-positive values are ignored.  The presence of `nextPageToken` in the
-response indicates that more results might be available.
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
 
 Returns:
   An object of the form:
 
     { # Result returned from ListLogMetrics.
     "metrics": [ # A list of logs-based metrics.
-      { # Describes a logs-based metric.  The value of the metric is the
-            # number of log entries that match a logs filter.
-          "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-              # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-          "version": "A String", # Output only. The API version that created or updated this metric.
-              # The version also dictates the syntax of the filter expression. When a value
-              # for this field is missing, the default value of V2 should be assumed.
+      { # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+          "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+              # "resource.type=gae_app AND severity>=ERROR"
+              # The maximum length of the filter is 20000 characters.
+          "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
           "description": "A String", # Optional. A description of this metric, which is used in documentation.
-          "name": "A String", # Required. The client-assigned metric identifier. Example:
-              # `"severe_errors"`.  Metric identifiers are limited to 100
-              # characters and can include only the following characters: `A-Z`,
-              # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-              # forward-slash character (`/`) denotes a hierarchy of name pieces,
-              # and it cannot be the first character of the name.  The '%' character
-              # is used to URL encode unsafe and reserved characters and must be
-              # followed by two hexadecimal digits according to RFC 1738.
+          "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
         },
     ],
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call this
-        # method again using the value of `nextPageToken` as `pageToken`.
+    "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.
   }</pre>
 </div>
 
@@ -278,31 +233,19 @@ <h3>Method Details</h3>
   <pre>Creates or updates a logs-based metric.
 
 Args:
-  metricName: string, The resource name of the metric to update.
-Example: `"projects/my-project-id/metrics/my-metric-id"`.
-
-The updated metric must be provided in the request and have the
-same identifier that is specified in `metricName`.
-If the metric does not exist, it is created. (required)
+  metricName: string, The resource name of the metric to update:
+"projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+The updated metric must be provided in the request and it's name field must be the same as [METRIC_ID] If the metric does not exist in [PROJECT_ID], then a new metric is created. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a logs-based metric.  The value of the metric is the
-      # number of log entries that match a logs filter.
-    "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-    "version": "A String", # Output only. The API version that created or updated this metric.
-        # The version also dictates the syntax of the filter expression. When a value
-        # for this field is missing, the default value of V2 should be assumed.
+{ # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+    "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+        # "resource.type=gae_app AND severity>=ERROR"
+        # The maximum length of the filter is 20000 characters.
+    "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
     "description": "A String", # Optional. A description of this metric, which is used in documentation.
-    "name": "A String", # Required. The client-assigned metric identifier. Example:
-        # `"severe_errors"`.  Metric identifiers are limited to 100
-        # characters and can include only the following characters: `A-Z`,
-        # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-        # forward-slash character (`/`) denotes a hierarchy of name pieces,
-        # and it cannot be the first character of the name.  The '%' character
-        # is used to URL encode unsafe and reserved characters and must be
-        # followed by two hexadecimal digits according to RFC 1738.
+    "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
   }
 
   x__xgafv: string, V1 error format.
@@ -313,22 +256,13 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a logs-based metric.  The value of the metric is the
-        # number of log entries that match a logs filter.
-      "filter": "A String", # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Example: `"resource.type=gae_app AND severity>=ERROR"`.
-      "version": "A String", # Output only. The API version that created or updated this metric.
-          # The version also dictates the syntax of the filter expression. When a value
-          # for this field is missing, the default value of V2 should be assumed.
+    { # Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
+      "filter": "A String", # Required. An advanced logs filter which is used to match log entries. Example:
+          # "resource.type=gae_app AND severity>=ERROR"
+          # The maximum length of the filter is 20000 characters.
+      "version": "A String", # Output only. The API version that created or updated this metric. The version also dictates the syntax of the filter expression. When a value for this field is missing, the default value of V2 should be assumed.
       "description": "A String", # Optional. A description of this metric, which is used in documentation.
-      "name": "A String", # Required. The client-assigned metric identifier. Example:
-          # `"severe_errors"`.  Metric identifiers are limited to 100
-          # characters and can include only the following characters: `A-Z`,
-          # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.  The
-          # forward-slash character (`/`) denotes a hierarchy of name pieces,
-          # and it cannot be the first character of the name.  The '%' character
-          # is used to URL encode unsafe and reserved characters and must be
-          # followed by two hexadecimal digits according to RFC 1738.
+      "name": "A String", # Required. The client-assigned metric identifier. Examples: "error_count", "nginx/requests".Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy of name pieces, and it cannot be the first character of the name.The metric identifier in this field must not be URL-encoded (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric identifier appears as the [METRIC_ID] part of a metric_name API parameter, then the metric identifier must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
     }</pre>
 </div>
 
diff --git a/docs/dyn/logging_v2beta1.projects.sinks.html b/docs/dyn/logging_v2beta1.projects.sinks.html
index d3136c9a423..40d56244646 100644
--- a/docs/dyn/logging_v2beta1.projects.sinks.html
+++ b/docs/dyn/logging_v2beta1.projects.sinks.html
@@ -75,77 +75,52 @@
 <h1><a href="logging_v2beta1.html">Stackdriver Logging API</a> . <a href="logging_v2beta1.projects.html">projects</a> . <a href="logging_v2beta1.projects.sinks.html">sinks</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#create">create(parent=None, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a sink.</p>
+  <code><a href="#create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(sinkName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a sink.</p>
+<p class="firstline">Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.</p>
 <p class="toc_element">
   <code><a href="#get">get(sinkName=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets a sink.</p>
 <p class="toc_element">
-  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+  <code><a href="#list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
 <p class="firstline">Lists sinks.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#update">update(sinkName=None, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates or creates a sink.</p>
+  <code><a href="#update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(parent=None, body, x__xgafv=None)</code>
-  <pre>Creates a sink.
+    <code class="details" id="create">create(parent=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.
 
 Args:
-  parent: string, Required. The resource in which to create the sink.
-Example: `"projects/my-project-id"`.
-The new sink must be provided in the request. (required)
+  parent: string, Required. The resource in which to create the sink:
+"projects/[PROJECT_ID]"
+"organizations/[ORGANIZATION_ID]"
+Examples: "projects/my-logging-project", "organizations/123456789". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a sink used to export log entries outside of Stackdriver Logging.
-    "endTime": "A String", # Optional. Time at which this sink expires.
-    "name": "A String", # Required. The client-assigned sink identifier, unique within the
-        # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-        # limited to 1000 characters and can include only the following characters:
-        # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-        # of the name is 100 characters.
-    "destination": "A String", # Required. The export destination. See
-        # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-        # Examples:
-        # 
-        #     "storage.googleapis.com/my-gcs-bucket"
-        #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-        #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-    "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Only log entries matching the filter are exported. The filter
-        # must be consistent with the log entry format specified by the
-        # `outputVersionFormat` parameter, regardless of the format of the
-        # log entry that was originally written to Stackdriver Logging.
-        # Example filter (V2 format):
-        # 
-        #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-    "startTime": "A String", # Optional. Time range for which this sink is active.
-        # Logs are exported only if start_time <= entry.timestamp < end_time
-        # Both start_time and end_time may be omitted to specify
-        # (half) infinite ranges. The start_time must be less than the end_time.
-    "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-        # entries.  This version does not have to correspond to the version of the
-        # log entry that was written to Stackdriver Logging. If omitted, the
-        # v2 format is used.
-    "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-        # access.  This may be a service account or a group.
-        # Examples (Do not assume these specific values):
-        #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-        #    "group:cloud-logs@google.com"
-        # 
-        #   For GCS destinations, the role "roles/owner" is required on the bucket
-        #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-        #     required on the topic
-        #   For BigQuery, the role "roles/editor" is required on the dataset
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
   }
 
+  uniqueWriterIdentity: boolean, Optional. Determines the kind of IAM identity returned as writer_identity in the new sink. If this value is omitted or set to false, and if the sink's parent is a project, then the value returned as writer_identity is cloud-logs@google.com, the same identity used before the addition of writer identities to this API. The sink's destination must be in the same project as the sink itself.If this field is set to true, or if the sink is owned by a non-project resource such as an organization, then the value of writer_identity will be a unique service account used only for exports from the new sink. For more information, see writer_identity in LogSink.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -154,58 +129,31 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(sinkName=None, x__xgafv=None)</code>
-  <pre>Deletes a sink.
+  <pre>Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to delete, including the parent
-resource and the sink identifier.  Example:
-`"projects/my-project-id/sinks/my-sink-id"`.  It is an error if the sink
-does not exist. (required)
+  sinkName: string, Required. The full resource name of the sink to delete, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+It is an error if the sink does not exist. Example: "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does not exist. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -214,15 +162,11 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
+      # service Foo {
+      #   rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # }
+      # The JSON representation for Empty is empty JSON object {}.
   }</pre>
 </div>
 
@@ -231,8 +175,10 @@ <h3>Method Details</h3>
   <pre>Gets a sink.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to return.
-Example: `"projects/my-project-id/sinks/my-sink-id"`. (required)
+  sinkName: string, Required. The parent resource name of the sink:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -241,116 +187,54 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+    <code class="details" id="list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</code>
   <pre>Lists sinks.
 
 Args:
-  parent: string, Required. The cloud resource containing the sinks.
-Example: `"projects/my-logging-project"`. (required)
-  pageToken: string, Optional. If present, then retrieve the next batch of results from the
-preceding call to this method.  `pageToken` must be the value of
-`nextPageToken` from the previous response.  The values of other method
-parameters should be identical to those in the previous call.
+  parent: string, Required. The parent resource whose sinks are to be listed. Examples: "projects/my-logging-project", "organizations/123456789". (required)
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
-  pageSize: integer, Optional. The maximum number of results to return from this request.
-Non-positive values are ignored.  The presence of `nextPageToken` in the
-response indicates that more results might be available.
+  pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
 
 Returns:
   An object of the form:
 
-    { # Result returned from `ListSinks`.
-    "nextPageToken": "A String", # If there might be more results than appear in this response, then
-        # `nextPageToken` is included.  To get the next set of results, call the same
-        # method again using the value of `nextPageToken` as `pageToken`.
+    { # Result returned from ListSinks.
+    "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
     "sinks": [ # A list of sinks.
-      { # Describes a sink used to export log entries outside of Stackdriver Logging.
-          "endTime": "A String", # Optional. Time at which this sink expires.
-          "name": "A String", # Required. The client-assigned sink identifier, unique within the
-              # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-              # limited to 1000 characters and can include only the following characters:
-              # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-              # of the name is 100 characters.
-          "destination": "A String", # Required. The export destination. See
-              # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-              # Examples:
-              #
-              #     "storage.googleapis.com/my-gcs-bucket"
-              #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-              #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-          "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-              # Only log entries matching the filter are exported. The filter
-              # must be consistent with the log entry format specified by the
-              # `outputVersionFormat` parameter, regardless of the format of the
-              # log entry that was originally written to Stackdriver Logging.
-              # Example filter (V2 format):
-              #
-              #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-          "startTime": "A String", # Optional. Time range for which this sink is active.
-              # Logs are exported only if start_time <= entry.timestamp < end_time
-              # Both start_time and end_time may be omitted to specify
-              # (half) infinite ranges. The start_time must be less than the end_time.
-          "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-              # entries.  This version does not have to correspond to the version of the
-              # log entry that was written to Stackdriver Logging. If omitted, the
-              # v2 format is used.
-          "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-              # access.  This may be a service account or a group.
-              # Examples (Do not assume these specific values):
-              #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-              #    "group:cloud-logs@google.com"
-              #
-              #   For GCS destinations, the role "roles/owner" is required on the bucket
-              #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-              #     required on the topic
-              #   For BigQuery, the role "roles/editor" is required on the dataset
+      { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+          "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+          "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+          "destination": "A String", # Required. The export destination:
+              # "storage.googleapis.com/[GCS_BUCKET]"
+              # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+              # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+              # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+          "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+              # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+          "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+          "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+          "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
         },
     ],
   }</pre>
@@ -371,58 +255,36 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(sinkName=None, body, x__xgafv=None)</code>
-  <pre>Updates or creates a sink.
+    <code class="details" id="update">update(sinkName=None, body, uniqueWriterIdentity=None, x__xgafv=None)</code>
+  <pre>Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.
 
 Args:
-  sinkName: string, Required. The resource name of the sink to update, including the parent
-resource and the sink identifier.  If the sink does not exist, this method
-creates the sink.  Example: `"projects/my-project-id/sinks/my-sink-id"`. (required)
+  sinkName: string, Required. The full resource name of the sink to update, including the parent resource and the sink identifier:
+"projects/[PROJECT_ID]/sinks/[SINK_ID]"
+"organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+Example: "projects/my-project-id/sinks/my-sink-id". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Describes a sink used to export log entries outside of Stackdriver Logging.
-    "endTime": "A String", # Optional. Time at which this sink expires.
-    "name": "A String", # Required. The client-assigned sink identifier, unique within the
-        # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-        # limited to 1000 characters and can include only the following characters:
-        # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-        # of the name is 100 characters.
-    "destination": "A String", # Required. The export destination. See
-        # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-        # Examples:
-        # 
-        #     "storage.googleapis.com/my-gcs-bucket"
-        #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-        #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-    "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-        # Only log entries matching the filter are exported. The filter
-        # must be consistent with the log entry format specified by the
-        # `outputVersionFormat` parameter, regardless of the format of the
-        # log entry that was originally written to Stackdriver Logging.
-        # Example filter (V2 format):
-        # 
-        #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-    "startTime": "A String", # Optional. Time range for which this sink is active.
-        # Logs are exported only if start_time <= entry.timestamp < end_time
-        # Both start_time and end_time may be omitted to specify
-        # (half) infinite ranges. The start_time must be less than the end_time.
-    "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-        # entries.  This version does not have to correspond to the version of the
-        # log entry that was written to Stackdriver Logging. If omitted, the
-        # v2 format is used.
-    "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-        # access.  This may be a service account or a group.
-        # Examples (Do not assume these specific values):
-        #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-        #    "group:cloud-logs@google.com"
-        # 
-        #   For GCS destinations, the role "roles/owner" is required on the bucket
-        #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-        #     required on the topic
-        #   For BigQuery, the role "roles/editor" is required on the dataset
+{ # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+    "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+    "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+    "destination": "A String", # Required. The export destination:
+        # "storage.googleapis.com/[GCS_BUCKET]"
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+        # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+    "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+        # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+    "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+    "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+    "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
   }
 
+  uniqueWriterIdentity: boolean, Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both the old and new values of this field:
+If the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity.
+If the old value was false and the new value is true, then writer_identity is changed to a unique service account.
+It is an error if the old value was true and the new value is false.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -431,46 +293,19 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Describes a sink used to export log entries outside of Stackdriver Logging.
-      "endTime": "A String", # Optional. Time at which this sink expires.
-      "name": "A String", # Required. The client-assigned sink identifier, unique within the
-          # project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-          # limited to 1000 characters and can include only the following characters:
-          # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-          # of the name is 100 characters.
-      "destination": "A String", # Required. The export destination. See
-          # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-          # Examples:
-          #
-          #     "storage.googleapis.com/my-gcs-bucket"
-          #     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-          #     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
-      "filter": "A String", # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-          # Only log entries matching the filter are exported. The filter
-          # must be consistent with the log entry format specified by the
-          # `outputVersionFormat` parameter, regardless of the format of the
-          # log entry that was originally written to Stackdriver Logging.
-          # Example filter (V2 format):
-          #
-          #     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
-      "startTime": "A String", # Optional. Time range for which this sink is active.
-          # Logs are exported only if start_time <= entry.timestamp < end_time
-          # Both start_time and end_time may be omitted to specify
-          # (half) infinite ranges. The start_time must be less than the end_time.
-      "outputVersionFormat": "A String", # Optional. The log entry version to use for this sink's exported log
-          # entries.  This version does not have to correspond to the version of the
-          # log entry that was written to Stackdriver Logging. If omitted, the
-          # v2 format is used.
-      "writerIdentity": "A String", # Output only. The IAM identity to which the destination needs to grant write
-          # access.  This may be a service account or a group.
-          # Examples (Do not assume these specific values):
-          #    "serviceAccount:cloud-logs@system.gserviceaccount.com"
-          #    "group:cloud-logs@google.com"
-          #
-          #   For GCS destinations, the role "roles/owner" is required on the bucket
-          #   For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
-          #     required on the topic
-          #   For BigQuery, the role "roles/editor" is required on the dataset
+    { # Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project or organization.
+      "endTime": "A String", # Optional. The time at which this sink will stop exporting log entries. Log entries are exported only if their timestamp is earlier than the end time. If this field is not supplied, there is no end time. If both a start time and an end time are provided, then the end time must be later than the start time.
+      "name": "A String", # Required. The client-assigned sink identifier, unique within the project. Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.
+      "destination": "A String", # Required. The export destination:
+          # "storage.googleapis.com/[GCS_BUCKET]"
+          # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+          # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+          # The sink's writer_identity, set when the sink is created, must have permission to write to the destination or else the log entries are not exported. For more information, see Exporting Logs With Sinks.
+      "filter": "A String", # Optional. An advanced logs filter. The only exported log entries are those that are in the resource owning the sink and that match the filter. The filter must use the log entry format specified by the output_version_format parameter. For example, in the v2 format:
+          # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+      "startTime": "A String", # Optional. The time at which this sink will begin exporting log entries. Log entries are exported only if their timestamp is not earlier than the start time. The default value of this field is the time the sink is created or updated.
+      "outputVersionFormat": "A String", # Optional. The log entry format to use for this sink's exported log entries. The v2 format is used by default. The v1 format is deprecated and should be used only as part of a migration effort to v2. See Migration to the v2 API.
+      "writerIdentity": "A String", # Output only. An IAM identity&mdash;a service account or group&mdash;under which Stackdriver Logging writes the exported log entries to the sink's destination. This field is set by sinks.create and sinks.update, based on the setting of unique_writer_identity in those methods.Until you grant this identity write-access to the destination, log entry exports from this sink will fail. For more information, see Granting access for a resource. Consult the destination service's documentation to determine the appropriate IAM roles to assign to the identity.
     }</pre>
 </div>
 
diff --git a/docs/dyn/manufacturers_v1.accounts.html b/docs/dyn/manufacturers_v1.accounts.html
new file mode 100644
index 00000000000..7a790bf9b3a
--- /dev/null
+++ b/docs/dyn/manufacturers_v1.accounts.html
@@ -0,0 +1,82 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="manufacturers_v1.html">Manufacturer Center API</a> . <a href="manufacturers_v1.accounts.html">accounts</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="manufacturers_v1.accounts.products.html">products()</a></code>
+</p>
+<p class="firstline">Returns the products Resource.</p>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/manufacturers_v1.accounts.products.html b/docs/dyn/manufacturers_v1.accounts.products.html
new file mode 100644
index 00000000000..240c393b4ee
--- /dev/null
+++ b/docs/dyn/manufacturers_v1.accounts.products.html
@@ -0,0 +1,404 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="manufacturers_v1.html">Manufacturer Center API</a> . <a href="manufacturers_v1.accounts.html">accounts</a> . <a href="manufacturers_v1.accounts.products.html">products</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(parent=None, name=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the product from a Manufacturer Center account, including product</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+<p class="firstline">Lists all the products in a Manufacturer Center account.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(parent=None, name=None, x__xgafv=None)</code>
+  <pre>Gets the product from a Manufacturer Center account, including product
+issues.
+
+Args:
+  parent: string, Parent ID in the format `accounts/{account_id}`.
+
+`account_id` - The ID of the Manufacturer Center account. (required)
+  name: string, Name in the format `{target_country}:{content_language}:{product_id}`.
+
+`target_country`   - The target country of the product as a CLDR territory
+                     code (for example, US).
+
+`content_language` - The content language of the product as a two-letter
+                     ISO 639-1 language code (for example, en).
+
+`product_id`     -   The ID of the product. For more information, see
+                     https://support.google.com/manufacturers/answer/6124116#id. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Product data.
+    "targetCountry": "A String", # The target country of the product as a CLDR territory code (for example,
+        # US).
+        # @OutputOnly
+    "manuallyDeletedAttributes": [ # Names of the attributes of the product deleted manually via the
+        # Manufacturer Center UI.
+        # @OutputOnly
+      "A String",
+    ],
+    "parent": "A String", # Parent ID in the format `accounts/{account_id}`.
+        #
+        # `account_id` - The ID of the Manufacturer Center account.
+        # @OutputOnly
+    "contentLanguage": "A String", # The content language of the product as a two-letter ISO 639-1 language code
+        # (for example, en).
+        # @OutputOnly
+    "name": "A String", # Name in the format `{target_country}:{content_language}:{product_id}`.
+        #
+        # `target_country`   - The target country of the product as a CLDR territory
+        #                      code (for example, US).
+        #
+        # `content_language` - The content language of the product as a two-letter
+        #                      ISO 639-1 language code (for example, en).
+        #
+        # `product_id`     -   The ID of the product. For more information, see
+        #                      https://support.google.com/manufacturers/answer/6124116#id.
+        # @OutputOnly
+    "manuallyProvidedAttributes": { # Attributes of the product. For more information, see # Attributes of the product provided manually via the Manufacturer Center UI.
+        # @OutputOnly
+        # https://support.google.com/manufacturers/answer/6124116.
+      "productLine": "A String", # The name of the group of products related to the product. For more
+          # information, see
+          # https://support.google.com/manufacturers/answer/6124116#productline.
+      "title": "A String", # The title of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#title.
+      "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
+          # see https://support.google.com/manufacturers/answer/6124116#mpn.
+      "brand": "A String", # The brand name of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#brand.
+      "productName": "A String", # The canonical name of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#productname.
+      "productPageUrl": "A String", # The URL of the manufacturer's detail page of the product. For more
+          # information, see
+          # https://support.google.com/manufacturers/answer/6124116#productpage.
+      "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
+          # see https://support.google.com/manufacturers/answer/6124116#gtin.
+        "A String",
+      ],
+      "productType": [ # The manufacturer's category of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#producttype.
+        "A String",
+      ],
+    },
+    "finalAttributes": { # Attributes of the product. For more information, see # Final attributes of the product. The final attributes are obtained by
+        # overriding the uploaded attributes with the manually provided and deleted
+        # attributes. Google systems only process, evaluate, review, and/or use final
+        # attributes.
+        # @OutputOnly
+        # https://support.google.com/manufacturers/answer/6124116.
+      "productLine": "A String", # The name of the group of products related to the product. For more
+          # information, see
+          # https://support.google.com/manufacturers/answer/6124116#productline.
+      "title": "A String", # The title of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#title.
+      "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
+          # see https://support.google.com/manufacturers/answer/6124116#mpn.
+      "brand": "A String", # The brand name of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#brand.
+      "productName": "A String", # The canonical name of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#productname.
+      "productPageUrl": "A String", # The URL of the manufacturer's detail page of the product. For more
+          # information, see
+          # https://support.google.com/manufacturers/answer/6124116#productpage.
+      "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
+          # see https://support.google.com/manufacturers/answer/6124116#gtin.
+        "A String",
+      ],
+      "productType": [ # The manufacturer's category of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#producttype.
+        "A String",
+      ],
+    },
+    "uploadedAttributes": { # Attributes of the product. For more information, see # Attributes of the product uploaded via the Manufacturer Center API or via
+        # feeds.
+        # https://support.google.com/manufacturers/answer/6124116.
+      "productLine": "A String", # The name of the group of products related to the product. For more
+          # information, see
+          # https://support.google.com/manufacturers/answer/6124116#productline.
+      "title": "A String", # The title of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#title.
+      "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
+          # see https://support.google.com/manufacturers/answer/6124116#mpn.
+      "brand": "A String", # The brand name of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#brand.
+      "productName": "A String", # The canonical name of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#productname.
+      "productPageUrl": "A String", # The URL of the manufacturer's detail page of the product. For more
+          # information, see
+          # https://support.google.com/manufacturers/answer/6124116#productpage.
+      "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
+          # see https://support.google.com/manufacturers/answer/6124116#gtin.
+        "A String",
+      ],
+      "productType": [ # The manufacturer's category of the product. For more information, see
+          # https://support.google.com/manufacturers/answer/6124116#producttype.
+        "A String",
+      ],
+    },
+    "issues": [ # A server-generated list of issues associated with the product.
+        # @OutputOnly
+      { # Product issue.
+        "attribute": "A String", # If present, the attribute that triggered the issue. For more information
+            # about attributes, see
+            # https://support.google.com/manufacturers/answer/6124116.
+        "type": "A String", # The server-generated type of the issue, for example,
+            # “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
+        "severity": "A String", # The severity of the issue.
+        "description": "A String", # Description of the issue.
+      },
+    ],
+    "productId": "A String", # The ID of the product. For more information, see
+        # https://support.google.com/manufacturers/answer/6124116#id.
+        # @OutputOnly
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</code>
+  <pre>Lists all the products in a Manufacturer Center account.
+
+Args:
+  parent: string, Parent ID in the format `accounts/{account_id}`.
+
+`account_id` - The ID of the Manufacturer Center account. (required)
+  pageToken: string, The token returned by the previous request.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  pageSize: integer, Maximum number of product statuses to return in the response, used for
+paging.
+
+Returns:
+  An object of the form:
+
+    {
+    "nextPageToken": "A String", # The token for the retrieval of the next page of product statuses.
+    "products": [ # List of the products.
+      { # Product data.
+        "targetCountry": "A String", # The target country of the product as a CLDR territory code (for example,
+            # US).
+            # @OutputOnly
+        "manuallyDeletedAttributes": [ # Names of the attributes of the product deleted manually via the
+            # Manufacturer Center UI.
+            # @OutputOnly
+          "A String",
+        ],
+        "parent": "A String", # Parent ID in the format `accounts/{account_id}`.
+            #
+            # `account_id` - The ID of the Manufacturer Center account.
+            # @OutputOnly
+        "contentLanguage": "A String", # The content language of the product as a two-letter ISO 639-1 language code
+            # (for example, en).
+            # @OutputOnly
+        "name": "A String", # Name in the format `{target_country}:{content_language}:{product_id}`.
+            #
+            # `target_country`   - The target country of the product as a CLDR territory
+            #                      code (for example, US).
+            #
+            # `content_language` - The content language of the product as a two-letter
+            #                      ISO 639-1 language code (for example, en).
+            #
+            # `product_id`     -   The ID of the product. For more information, see
+            #                      https://support.google.com/manufacturers/answer/6124116#id.
+            # @OutputOnly
+        "manuallyProvidedAttributes": { # Attributes of the product. For more information, see # Attributes of the product provided manually via the Manufacturer Center UI.
+            # @OutputOnly
+            # https://support.google.com/manufacturers/answer/6124116.
+          "productLine": "A String", # The name of the group of products related to the product. For more
+              # information, see
+              # https://support.google.com/manufacturers/answer/6124116#productline.
+          "title": "A String", # The title of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#title.
+          "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
+              # see https://support.google.com/manufacturers/answer/6124116#mpn.
+          "brand": "A String", # The brand name of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#brand.
+          "productName": "A String", # The canonical name of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#productname.
+          "productPageUrl": "A String", # The URL of the manufacturer's detail page of the product. For more
+              # information, see
+              # https://support.google.com/manufacturers/answer/6124116#productpage.
+          "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
+              # see https://support.google.com/manufacturers/answer/6124116#gtin.
+            "A String",
+          ],
+          "productType": [ # The manufacturer's category of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#producttype.
+            "A String",
+          ],
+        },
+        "finalAttributes": { # Attributes of the product. For more information, see # Final attributes of the product. The final attributes are obtained by
+            # overriding the uploaded attributes with the manually provided and deleted
+            # attributes. Google systems only process, evaluate, review, and/or use final
+            # attributes.
+            # @OutputOnly
+            # https://support.google.com/manufacturers/answer/6124116.
+          "productLine": "A String", # The name of the group of products related to the product. For more
+              # information, see
+              # https://support.google.com/manufacturers/answer/6124116#productline.
+          "title": "A String", # The title of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#title.
+          "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
+              # see https://support.google.com/manufacturers/answer/6124116#mpn.
+          "brand": "A String", # The brand name of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#brand.
+          "productName": "A String", # The canonical name of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#productname.
+          "productPageUrl": "A String", # The URL of the manufacturer's detail page of the product. For more
+              # information, see
+              # https://support.google.com/manufacturers/answer/6124116#productpage.
+          "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
+              # see https://support.google.com/manufacturers/answer/6124116#gtin.
+            "A String",
+          ],
+          "productType": [ # The manufacturer's category of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#producttype.
+            "A String",
+          ],
+        },
+        "uploadedAttributes": { # Attributes of the product. For more information, see # Attributes of the product uploaded via the Manufacturer Center API or via
+            # feeds.
+            # https://support.google.com/manufacturers/answer/6124116.
+          "productLine": "A String", # The name of the group of products related to the product. For more
+              # information, see
+              # https://support.google.com/manufacturers/answer/6124116#productline.
+          "title": "A String", # The title of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#title.
+          "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
+              # see https://support.google.com/manufacturers/answer/6124116#mpn.
+          "brand": "A String", # The brand name of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#brand.
+          "productName": "A String", # The canonical name of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#productname.
+          "productPageUrl": "A String", # The URL of the manufacturer's detail page of the product. For more
+              # information, see
+              # https://support.google.com/manufacturers/answer/6124116#productpage.
+          "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
+              # see https://support.google.com/manufacturers/answer/6124116#gtin.
+            "A String",
+          ],
+          "productType": [ # The manufacturer's category of the product. For more information, see
+              # https://support.google.com/manufacturers/answer/6124116#producttype.
+            "A String",
+          ],
+        },
+        "issues": [ # A server-generated list of issues associated with the product.
+            # @OutputOnly
+          { # Product issue.
+            "attribute": "A String", # If present, the attribute that triggered the issue. For more information
+                # about attributes, see
+                # https://support.google.com/manufacturers/answer/6124116.
+            "type": "A String", # The server-generated type of the issue, for example,
+                # “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
+            "severity": "A String", # The severity of the issue.
+            "description": "A String", # Description of the issue.
+          },
+        ],
+        "productId": "A String", # The ID of the product. For more information, see
+            # https://support.google.com/manufacturers/answer/6124116#id.
+            # @OutputOnly
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/manufacturers_v1.html b/docs/dyn/manufacturers_v1.html
new file mode 100644
index 00000000000..2bbef4a550a
--- /dev/null
+++ b/docs/dyn/manufacturers_v1.html
@@ -0,0 +1,103 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="manufacturers_v1.html">Manufacturer Center API</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="manufacturers_v1.accounts.html">accounts()</a></code>
+</p>
+<p class="firstline">Returns the accounts Resource.</p>
+
+<p class="toc_element">
+  <code><a href="#new_batch_http_request">new_batch_http_request()</a></code></p>
+<p class="firstline">Create a BatchHttpRequest object based on the discovery document.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="new_batch_http_request">new_batch_http_request()</code>
+  <pre>Create a BatchHttpRequest object based on the discovery document.
+
+        Args:
+          callback: callable, A callback to be called for each response, of the
+            form callback(id, response, exception). The first parameter is the
+            request id, and the second is the deserialized response object. The
+            third is an apiclient.errors.HttpError exception object if an HTTP
+            error occurred while processing the request, or None if no error
+            occurred.
+
+        Returns:
+          A BatchHttpRequest object based on the discovery document.
+        </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/mirror_v1.timeline.attachments.html b/docs/dyn/mirror_v1.timeline.attachments.html
index 468446525bf..2d26d509f2a 100644
--- a/docs/dyn/mirror_v1.timeline.attachments.html
+++ b/docs/dyn/mirror_v1.timeline.attachments.html
@@ -84,7 +84,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get_media">get_media(itemId, attachmentId)</a></code></p>
 <p class="firstline">Retrieves an attachment on a timeline item by item ID and attachment ID.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(itemId, media_body=None)</a></code></p>
+  <code><a href="#insert">insert(itemId, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Adds a new attachment to a timeline item.</p>
 <p class="toc_element">
   <code><a href="#list">list(itemId)</a></code></p>
@@ -134,12 +134,13 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(itemId, media_body=None)</code>
+    <code class="details" id="insert">insert(itemId, media_body=None, media_mime_type=None)</code>
   <pre>Adds a new attachment to a timeline item.
 
 Args:
   itemId: string, The ID of the timeline item the attachment belongs to. (required)
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/mirror_v1.timeline.html b/docs/dyn/mirror_v1.timeline.html
index eaa7d343d3e..159f5fad596 100644
--- a/docs/dyn/mirror_v1.timeline.html
+++ b/docs/dyn/mirror_v1.timeline.html
@@ -86,7 +86,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(id)</a></code></p>
 <p class="firstline">Gets a single timeline item by ID.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(body=None, media_body=None)</a></code></p>
+  <code><a href="#insert">insert(body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Inserts a new item into the timeline.</p>
 <p class="toc_element">
   <code><a href="#list">list(orderBy=None, includeDeleted=None, pageToken=None, maxResults=None, pinnedOnly=None, sourceItemId=None, bundleId=None)</a></code></p>
@@ -98,7 +98,7 @@ <h2>Instance Methods</h2>
   <code><a href="#patch">patch(id, body)</a></code></p>
 <p class="firstline">Updates a timeline item in place. This method supports patch semantics.</p>
 <p class="toc_element">
-  <code><a href="#update">update(id, body=None, media_body=None)</a></code></p>
+  <code><a href="#update">update(id, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Updates a timeline item in place.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -297,7 +297,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(body=None, media_body=None)</code>
+    <code class="details" id="insert">insert(body=None, media_body=None, media_mime_type=None)</code>
   <pre>Inserts a new item into the timeline.
 
 Args:
@@ -480,6 +480,7 @@ <h3>Method Details</h3>
   }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
@@ -1240,7 +1241,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(id, body=None, media_body=None)</code>
+    <code class="details" id="update">update(id, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Updates a timeline item in place.
 
 Args:
@@ -1424,6 +1425,7 @@ <h3>Method Details</h3>
   }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/ml_v1beta1.projects.jobs.html b/docs/dyn/ml_v1beta1.projects.jobs.html
index 3882bfda997..35a941e878a 100644
--- a/docs/dyn/ml_v1beta1.projects.jobs.html
+++ b/docs/dyn/ml_v1beta1.projects.jobs.html
@@ -137,7 +137,7 @@ <h3>Method Details</h3>
 
 { # Represents a training or prediction job.
     "trainingOutput": { # Represents results of a training job. # The current training job result.
-      "completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
+      "consumedMLUnits": 3.14, # The amount of ML units consumed by the job.
       "trials": [ # Results for individual Hyperparameter trials.
         { # Represents the result of a single hyperparameter tuning trial from a
             # training job. The TrainingOutput object that is returned on successful
@@ -159,6 +159,7 @@ <h3>Method Details</h3>
           },
         },
       ],
+      "completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
     },
     "startTime": "A String", # Output only. When the job processing was started.
     "errorMessage": "A String", # Output only. The details of a failure or a cancellation.
@@ -326,7 +327,7 @@ <h3>Method Details</h3>
 
     { # Represents a training or prediction job.
       "trainingOutput": { # Represents results of a training job. # The current training job result.
-        "completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
+        "consumedMLUnits": 3.14, # The amount of ML units consumed by the job.
         "trials": [ # Results for individual Hyperparameter trials.
           { # Represents the result of a single hyperparameter tuning trial from a
               # training job. The TrainingOutput object that is returned on successful
@@ -348,6 +349,7 @@ <h3>Method Details</h3>
             },
           },
         ],
+        "completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
       },
       "startTime": "A String", # Output only. When the job processing was started.
       "errorMessage": "A String", # Output only. The details of a failure or a cancellation.
@@ -524,7 +526,7 @@ <h3>Method Details</h3>
 
     { # Represents a training or prediction job.
       "trainingOutput": { # Represents results of a training job. # The current training job result.
-        "completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
+        "consumedMLUnits": 3.14, # The amount of ML units consumed by the job.
         "trials": [ # Results for individual Hyperparameter trials.
           { # Represents the result of a single hyperparameter tuning trial from a
               # training job. The TrainingOutput object that is returned on successful
@@ -546,6 +548,7 @@ <h3>Method Details</h3>
             },
           },
         ],
+        "completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
       },
       "startTime": "A String", # Output only. When the job processing was started.
       "errorMessage": "A String", # Output only. The details of a failure or a cancellation.
@@ -736,7 +739,7 @@ <h3>Method Details</h3>
     "jobs": [ # The list of jobs.
       { # Represents a training or prediction job.
           "trainingOutput": { # Represents results of a training job. # The current training job result.
-            "completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
+            "consumedMLUnits": 3.14, # The amount of ML units consumed by the job.
             "trials": [ # Results for individual Hyperparameter trials.
               { # Represents the result of a single hyperparameter tuning trial from a
                   # training job. The TrainingOutput object that is returned on successful
@@ -758,6 +761,7 @@ <h3>Method Details</h3>
                 },
               },
             ],
+            "completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
           },
           "startTime": "A String", # Output only. When the job processing was started.
           "errorMessage": "A String", # Output only. The details of a failure or a cancellation.
diff --git a/docs/dyn/monitoring_v3.projects.collectdTimeSeries.html b/docs/dyn/monitoring_v3.projects.collectdTimeSeries.html
index 635ece396da..b2eccbbda8a 100644
--- a/docs/dyn/monitoring_v3.projects.collectdTimeSeries.html
+++ b/docs/dyn/monitoring_v3.projects.collectdTimeSeries.html
@@ -83,37 +83,37 @@ <h3>Method Details</h3>
   <pre>Stackdriver Monitoring Agent only: Creates a new time series.<aside class="caution">This method is only for use by the Stackdriver Monitoring Agent. Use projects.timeSeries.create instead.</aside>
 
 Args:
-  name: string, The project in which to create the time series. The format is &quot;projects/PROJECT_ID_OR_NUMBER&quot;. (required)
+  name: string, The project in which to create the time series. The format is "projects/PROJECT_ID_OR_NUMBER". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # The CreateCollectdTimeSeries request.
     "collectdPayloads": [ # The collectd payloads representing the time series data. You must not include more than a single point for each time series, so no two payloads can have the same values for all of the fields plugin, plugin_instance, type, and type_instance.
       { # A collection of data points sent from a collectd-based plugin. See the collectd documentation for more information.
-        "plugin": "A String", # The name of the plugin. Example: &quot;disk&quot;.
-        "typeInstance": "A String", # The measurement type instance. Example: &quot;used&quot;.
+        "plugin": "A String", # The name of the plugin. Example: "disk".
+        "typeInstance": "A String", # The measurement type instance. Example: "used".
         "values": [ # The measured values during this time interval. Each value must have a different dataSourceName.
           { # A single data point from a collectd-based plugin.
             "dataSourceType": "A String", # The type of measurement.
-            "dataSourceName": "A String", # The data source for the collectd value. For example there are two data sources for network measurements: &quot;rx&quot; and &quot;tx&quot;.
+            "dataSourceName": "A String", # The data source for the collectd value. For example there are two data sources for network measurements: "rx" and "tx".
             "value": { # A single strongly-typed value. # The measurement value.
               "distributionValue": { # Distribution contains summary statistics for a population of values and, optionally, a histogram representing the distribution of those values across a specified set of histogram buckets.The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values.The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by specifying parameters for a method of computing them (buckets of fixed width or buckets of exponentially increasing width).Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the mean and sum_of_squared_deviation fields meaningless. # A distribution value.
                 "count": "A String", # The number of values in the population. Must be non-negative.
                 "bucketCounts": [ # If bucket_options is given, then the sum of the values in bucket_counts must equal the value in count. If bucket_options is not given, no bucket_counts fields may be given.Bucket counts are given in order under the numbering scheme described above (the underflow bucket has number 0; the finite buckets, if any, have numbers 1 through N-2; the overflow bucket has number N-1).The size of bucket_counts must be no greater than N as defined in bucket_options.Any suffix of trailing zero bucket_count fields may be omitted.
                   "A String",
                 ],
-                "bucketOptions": { # A Distribution may optionally contain a histogram of the values in the population. The histogram is given in bucket_counts as counts of values that fall into one of a sequence of non-overlapping buckets. The sequence of buckets is described by bucket_options.A bucket specifies an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket is strictly greater than the lower bound.The sequence of N buckets for a Distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i &gt; 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.BucketOptions describes bucket boundaries in one of three ways. Two describe the boundaries by giving parameters for a formula to generate boundaries and one gives the bucket boundaries explicitly.If bucket_options is not given, then no bucket_counts may be given. # Defines the histogram bucket boundaries.
-                  "exponentialBuckets": { # Specify a sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): scale * (growth_factor ^ i).  Lower bound (1 &lt;= i &lt; N): scale * (growth_factor ^ (i - 1)). # The exponential buckets.
+                "bucketOptions": { # A Distribution may optionally contain a histogram of the values in the population. The histogram is given in bucket_counts as counts of values that fall into one of a sequence of non-overlapping buckets. The sequence of buckets is described by bucket_options.A bucket specifies an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket is strictly greater than the lower bound.The sequence of N buckets for a Distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.BucketOptions describes bucket boundaries in one of three ways. Two describe the boundaries by giving parameters for a formula to generate boundaries and one gives the bucket boundaries explicitly.If bucket_options is not given, then no bucket_counts may be given. # Defines the histogram bucket boundaries.
+                  "exponentialBuckets": { # Specify a sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).  Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)). # The exponential buckets.
                     "scale": 3.14, # Must be greater than 0.
                     "growthFactor": 3.14, # Must be greater than 1.
                     "numFiniteBuckets": 42, # Must be greater than 0.
                   },
-                  "linearBuckets": { # Specify a sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): offset + (width * i).  Lower bound (1 &lt;= i &lt; N): offset + (width * (i - 1)). # The linear bucket.
+                  "linearBuckets": { # Specify a sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): offset + (width * i).  Lower bound (1 <= i < N): offset + (width * (i - 1)). # The linear bucket.
                     "width": 3.14, # Must be greater than 0.
                     "numFiniteBuckets": 42, # Must be greater than 0.
                     "offset": 3.14, # Lower bound of the first bucket.
                   },
-                  "explicitBuckets": { # A set of buckets with arbitrary widths.Defines size(bounds) + 1 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): boundsi  Lower bound (1 &lt;= i &lt; N); boundsi - 1There must be at least one element in bounds. If bounds has only one element, there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets. # The explicit buckets.
+                  "explicitBuckets": { # A set of buckets with arbitrary widths.Defines size(bounds) + 1 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): boundsi  Lower bound (1 <= i < N); boundsi - 1There must be at least one element in bounds. If bounds has only one element, there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets. # The explicit buckets.
                     "bounds": [ # The values must be monotonically increasing.
                       3.14,
                     ],
@@ -137,27 +137,27 @@ <h3>Method Details</h3>
         ],
         "startTime": "A String", # The start time of the interval.
         "endTime": "A String", # The end time of the interval.
-        "type": "A String", # The measurement type. Example: &quot;memory&quot;.
-        "pluginInstance": "A String", # The instance name of the plugin Example: &quot;hdcl&quot;.
-        "metadata": { # The measurement metadata. Example: &quot;process_id&quot; -&gt; 12345
+        "type": "A String", # The measurement type. Example: "memory".
+        "pluginInstance": "A String", # The instance name of the plugin Example: "hdcl".
+        "metadata": { # The measurement metadata. Example: "process_id" -> 12345
           "a_key": { # A single strongly-typed value.
             "distributionValue": { # Distribution contains summary statistics for a population of values and, optionally, a histogram representing the distribution of those values across a specified set of histogram buckets.The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values.The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by specifying parameters for a method of computing them (buckets of fixed width or buckets of exponentially increasing width).Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the mean and sum_of_squared_deviation fields meaningless. # A distribution value.
               "count": "A String", # The number of values in the population. Must be non-negative.
               "bucketCounts": [ # If bucket_options is given, then the sum of the values in bucket_counts must equal the value in count. If bucket_options is not given, no bucket_counts fields may be given.Bucket counts are given in order under the numbering scheme described above (the underflow bucket has number 0; the finite buckets, if any, have numbers 1 through N-2; the overflow bucket has number N-1).The size of bucket_counts must be no greater than N as defined in bucket_options.Any suffix of trailing zero bucket_count fields may be omitted.
                 "A String",
               ],
-              "bucketOptions": { # A Distribution may optionally contain a histogram of the values in the population. The histogram is given in bucket_counts as counts of values that fall into one of a sequence of non-overlapping buckets. The sequence of buckets is described by bucket_options.A bucket specifies an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket is strictly greater than the lower bound.The sequence of N buckets for a Distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i &gt; 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.BucketOptions describes bucket boundaries in one of three ways. Two describe the boundaries by giving parameters for a formula to generate boundaries and one gives the bucket boundaries explicitly.If bucket_options is not given, then no bucket_counts may be given. # Defines the histogram bucket boundaries.
-                "exponentialBuckets": { # Specify a sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): scale * (growth_factor ^ i).  Lower bound (1 &lt;= i &lt; N): scale * (growth_factor ^ (i - 1)). # The exponential buckets.
+              "bucketOptions": { # A Distribution may optionally contain a histogram of the values in the population. The histogram is given in bucket_counts as counts of values that fall into one of a sequence of non-overlapping buckets. The sequence of buckets is described by bucket_options.A bucket specifies an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket is strictly greater than the lower bound.The sequence of N buckets for a Distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.BucketOptions describes bucket boundaries in one of three ways. Two describe the boundaries by giving parameters for a formula to generate boundaries and one gives the bucket boundaries explicitly.If bucket_options is not given, then no bucket_counts may be given. # Defines the histogram bucket boundaries.
+                "exponentialBuckets": { # Specify a sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).  Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)). # The exponential buckets.
                   "scale": 3.14, # Must be greater than 0.
                   "growthFactor": 3.14, # Must be greater than 1.
                   "numFiniteBuckets": 42, # Must be greater than 0.
                 },
-                "linearBuckets": { # Specify a sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): offset + (width * i).  Lower bound (1 &lt;= i &lt; N): offset + (width * (i - 1)). # The linear bucket.
+                "linearBuckets": { # Specify a sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): offset + (width * i).  Lower bound (1 <= i < N): offset + (width * (i - 1)). # The linear bucket.
                   "width": 3.14, # Must be greater than 0.
                   "numFiniteBuckets": 42, # Must be greater than 0.
                   "offset": 3.14, # Lower bound of the first bucket.
                 },
-                "explicitBuckets": { # A set of buckets with arbitrary widths.Defines size(bounds) + 1 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): boundsi  Lower bound (1 &lt;= i &lt; N); boundsi - 1There must be at least one element in bounds. If bounds has only one element, there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets. # The explicit buckets.
+                "explicitBuckets": { # A set of buckets with arbitrary widths.Defines size(bounds) + 1 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): boundsi  Lower bound (1 <= i < N); boundsi - 1There must be at least one element in bounds. If bounds has only one element, there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets. # The explicit buckets.
                   "bounds": [ # The values must be monotonically increasing.
                     3.14,
                   ],
@@ -180,16 +180,16 @@ <h3>Method Details</h3>
         },
       },
     ],
-    "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for &quot;gce_instance&quot; has labels &quot;instance_id&quot; and &quot;zone&quot;: # The monitored resource associated with the time series.
-        # { &quot;type&quot;: &quot;gce_instance&quot;,
-        #   &quot;labels&quot;: { &quot;instance_id&quot;: &quot;12345678901234&quot;,
-        #               &quot;zone&quot;: &quot;us-central1-a&quot; }}
-      "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels &quot;database_id&quot; and &quot;zone&quot;.
+    "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # The monitored resource associated with the time series.
+        # { "type": "gce_instance",
+        #   "labels": { "instance_id": "12345678901234",
+        #               "zone": "us-central1-a" }}
+      "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
         "a_key": "A String",
       },
-      "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is &quot;cloudsql_database&quot;.
+      "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
     },
-    "collectdVersion": "A String", # The version of collectd that collected the data. Example: &quot;5.3.0-192.el6&quot;.
+    "collectdVersion": "A String", # The version of collectd that collected the data. Example: "5.3.0-192.el6".
   }
 
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/monitoring_v3.projects.groups.html b/docs/dyn/monitoring_v3.projects.groups.html
index 1e8481b053e..4cb2ea3892b 100644
--- a/docs/dyn/monitoring_v3.projects.groups.html
+++ b/docs/dyn/monitoring_v3.projects.groups.html
@@ -103,15 +103,15 @@ <h3>Method Details</h3>
   <pre>Creates a new group.
 
 Args:
-  name: string, The project in which to create the group. The format is &quot;projects/{project_id_or_number}&quot;. (required)
+  name: string, The project in which to create the group. The format is "projects/{project_id_or_number}". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: &quot;environment&quot; and &quot;role&quot;. A parent group has a filter, environment=&quot;production&quot;. A child of that parent group has a filter, role=&quot;transcoder&quot;. The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
+{ # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: "environment" and "role". A parent group has a filter, environment="production". A child of that parent group has a filter, role="transcoder". The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
     "filter": "A String", # The filter used to determine which monitored resources belong to this group.
-    "parentName": "A String", # The name of the group's parent, if it has one. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. For groups with no parent, parentName is the empty string, &quot;&quot;.
+    "parentName": "A String", # The name of the group's parent, if it has one. The format is "projects/{project_id_or_number}/groups/{group_id}". For groups with no parent, parentName is the empty string, "".
     "displayName": "A String", # A user-assigned name for this group, used only for display purposes.
-    "name": "A String", # Output only. The name of this group. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
+    "name": "A String", # Output only. The name of this group. The format is "projects/{project_id_or_number}/groups/{group_id}". When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
     "isCluster": True or False, # If true, the members of this group are considered to be a cluster. The system can perform additional analysis on groups that are clusters.
   }
 
@@ -124,11 +124,11 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: &quot;environment&quot; and &quot;role&quot;. A parent group has a filter, environment=&quot;production&quot;. A child of that parent group has a filter, role=&quot;transcoder&quot;. The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
+    { # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: "environment" and "role". A parent group has a filter, environment="production". A child of that parent group has a filter, role="transcoder". The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
       "filter": "A String", # The filter used to determine which monitored resources belong to this group.
-      "parentName": "A String", # The name of the group's parent, if it has one. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. For groups with no parent, parentName is the empty string, &quot;&quot;.
+      "parentName": "A String", # The name of the group's parent, if it has one. The format is "projects/{project_id_or_number}/groups/{group_id}". For groups with no parent, parentName is the empty string, "".
       "displayName": "A String", # A user-assigned name for this group, used only for display purposes.
-      "name": "A String", # Output only. The name of this group. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
+      "name": "A String", # Output only. The name of this group. The format is "projects/{project_id_or_number}/groups/{group_id}". When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
       "isCluster": True or False, # If true, the members of this group are considered to be a cluster. The system can perform additional analysis on groups that are clusters.
     }</pre>
 </div>
@@ -138,7 +138,7 @@ <h3>Method Details</h3>
   <pre>Deletes an existing group.
 
 Args:
-  name: string, The group to delete. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. (required)
+  name: string, The group to delete. The format is "projects/{project_id_or_number}/groups/{group_id}". (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -160,7 +160,7 @@ <h3>Method Details</h3>
   <pre>Gets a single group.
 
 Args:
-  name: string, The group to retrieve. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. (required)
+  name: string, The group to retrieve. The format is "projects/{project_id_or_number}/groups/{group_id}". (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -169,11 +169,11 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: &quot;environment&quot; and &quot;role&quot;. A parent group has a filter, environment=&quot;production&quot;. A child of that parent group has a filter, role=&quot;transcoder&quot;. The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
+    { # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: "environment" and "role". A parent group has a filter, environment="production". A child of that parent group has a filter, role="transcoder". The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
       "filter": "A String", # The filter used to determine which monitored resources belong to this group.
-      "parentName": "A String", # The name of the group's parent, if it has one. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. For groups with no parent, parentName is the empty string, &quot;&quot;.
+      "parentName": "A String", # The name of the group's parent, if it has one. The format is "projects/{project_id_or_number}/groups/{group_id}". For groups with no parent, parentName is the empty string, "".
       "displayName": "A String", # A user-assigned name for this group, used only for display purposes.
-      "name": "A String", # Output only. The name of this group. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
+      "name": "A String", # Output only. The name of this group. The format is "projects/{project_id_or_number}/groups/{group_id}". When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
       "isCluster": True or False, # If true, the members of this group are considered to be a cluster. The system can perform additional analysis on groups that are clusters.
     }</pre>
 </div>
@@ -183,16 +183,16 @@ <h3>Method Details</h3>
   <pre>Lists the existing groups.
 
 Args:
-  name: string, The project whose groups are to be listed. The format is &quot;projects/{project_id_or_number}&quot;. (required)
-  ancestorsOfGroup: string, A group name: &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. Returns groups that are ancestors of the specified group. The groups are returned in order, starting with the immediate parent and ending with the most distant ancestor. If the specified group has no immediate parent, the results are empty.
-  descendantsOfGroup: string, A group name: &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. Returns the descendants of the specified group. This is a superset of the results returned by the childrenOfGroup filter, and includes children-of-children, and so forth.
+  name: string, The project whose groups are to be listed. The format is "projects/{project_id_or_number}". (required)
+  ancestorsOfGroup: string, A group name: "projects/{project_id_or_number}/groups/{group_id}". Returns groups that are ancestors of the specified group. The groups are returned in order, starting with the immediate parent and ending with the most distant ancestor. If the specified group has no immediate parent, the results are empty.
+  descendantsOfGroup: string, A group name: "projects/{project_id_or_number}/groups/{group_id}". Returns the descendants of the specified group. This is a superset of the results returned by the childrenOfGroup filter, and includes children-of-children, and so forth.
   pageSize: integer, A positive number that is the maximum number of results to return.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
   pageToken: string, If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.
-  childrenOfGroup: string, A group name: &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. Returns groups whose parentName field contains the group name. If no groups have this parent, the results are empty.
+  childrenOfGroup: string, A group name: "projects/{project_id_or_number}/groups/{group_id}". Returns groups whose parentName field contains the group name. If no groups have this parent, the results are empty.
 
 Returns:
   An object of the form:
@@ -200,11 +200,11 @@ <h3>Method Details</h3>
     { # The ListGroups response.
     "nextPageToken": "A String", # If there are more results than have been returned, then this field is set to a non-empty value. To see the additional results, use that value as pageToken in the next call to this method.
     "group": [ # The groups that match the specified filters.
-      { # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: &quot;environment&quot; and &quot;role&quot;. A parent group has a filter, environment=&quot;production&quot;. A child of that parent group has a filter, role=&quot;transcoder&quot;. The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
+      { # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: "environment" and "role". A parent group has a filter, environment="production". A child of that parent group has a filter, role="transcoder". The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
           "filter": "A String", # The filter used to determine which monitored resources belong to this group.
-          "parentName": "A String", # The name of the group's parent, if it has one. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. For groups with no parent, parentName is the empty string, &quot;&quot;.
+          "parentName": "A String", # The name of the group's parent, if it has one. The format is "projects/{project_id_or_number}/groups/{group_id}". For groups with no parent, parentName is the empty string, "".
           "displayName": "A String", # A user-assigned name for this group, used only for display purposes.
-          "name": "A String", # Output only. The name of this group. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
+          "name": "A String", # Output only. The name of this group. The format is "projects/{project_id_or_number}/groups/{group_id}". When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
           "isCluster": True or False, # If true, the members of this group are considered to be a cluster. The system can perform additional analysis on groups that are clusters.
         },
     ],
@@ -230,15 +230,15 @@ <h3>Method Details</h3>
   <pre>Updates an existing group. You can change any group attributes except name.
 
 Args:
-  name: string, Output only. The name of this group. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically. (required)
+  name: string, Output only. The name of this group. The format is "projects/{project_id_or_number}/groups/{group_id}". When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: &quot;environment&quot; and &quot;role&quot;. A parent group has a filter, environment=&quot;production&quot;. A child of that parent group has a filter, role=&quot;transcoder&quot;. The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
+{ # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: "environment" and "role". A parent group has a filter, environment="production". A child of that parent group has a filter, role="transcoder". The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
     "filter": "A String", # The filter used to determine which monitored resources belong to this group.
-    "parentName": "A String", # The name of the group's parent, if it has one. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. For groups with no parent, parentName is the empty string, &quot;&quot;.
+    "parentName": "A String", # The name of the group's parent, if it has one. The format is "projects/{project_id_or_number}/groups/{group_id}". For groups with no parent, parentName is the empty string, "".
     "displayName": "A String", # A user-assigned name for this group, used only for display purposes.
-    "name": "A String", # Output only. The name of this group. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
+    "name": "A String", # Output only. The name of this group. The format is "projects/{project_id_or_number}/groups/{group_id}". When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
     "isCluster": True or False, # If true, the members of this group are considered to be a cluster. The system can perform additional analysis on groups that are clusters.
   }
 
@@ -251,11 +251,11 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: &quot;environment&quot; and &quot;role&quot;. A parent group has a filter, environment=&quot;production&quot;. A child of that parent group has a filter, role=&quot;transcoder&quot;. The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
+    { # The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group. Groups can contain any number of monitored resources, and each monitored resource can be a member of any number of groups.Groups can be nested in parent-child hierarchies. The parentName field identifies an optional parent for each group. If a group has a parent, then the only monitored resources available to be matched by the group's filter are the resources contained in the parent group. In other words, a group contains the monitored resources that match its filter and the filters of all the group's ancestors. A group without a parent can contain any monitored resource.For example, consider an infrastructure running a set of instances with two user-defined tags: "environment" and "role". A parent group has a filter, environment="production". A child of that parent group has a filter, role="transcoder". The parent group contains all instances in the production environment, regardless of their roles. The child group contains instances that have the transcoder role and are in the production environment.The monitored resources contained in a group can change at any moment, depending on what resources exist and what filters are associated with the group and its ancestors.
       "filter": "A String", # The filter used to determine which monitored resources belong to this group.
-      "parentName": "A String", # The name of the group's parent, if it has one. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. For groups with no parent, parentName is the empty string, &quot;&quot;.
+      "parentName": "A String", # The name of the group's parent, if it has one. The format is "projects/{project_id_or_number}/groups/{group_id}". For groups with no parent, parentName is the empty string, "".
       "displayName": "A String", # A user-assigned name for this group, used only for display purposes.
-      "name": "A String", # Output only. The name of this group. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
+      "name": "A String", # Output only. The name of this group. The format is "projects/{project_id_or_number}/groups/{group_id}". When creating a group, this field is ignored and a new name is created consisting of the project specified in the call to CreateGroup and a unique {group_id} that is generated automatically.
       "isCluster": True or False, # If true, the members of this group are considered to be a cluster. The system can perform additional analysis on groups that are clusters.
     }</pre>
 </div>
diff --git a/docs/dyn/monitoring_v3.projects.groups.members.html b/docs/dyn/monitoring_v3.projects.groups.members.html
index 75bc86a3564..7e0d27459cb 100644
--- a/docs/dyn/monitoring_v3.projects.groups.members.html
+++ b/docs/dyn/monitoring_v3.projects.groups.members.html
@@ -86,7 +86,7 @@ <h3>Method Details</h3>
   <pre>Lists the monitored resources that are members of a group.
 
 Args:
-  name: string, The group whose members are listed. The format is &quot;projects/{project_id_or_number}/groups/{group_id}&quot;. (required)
+  name: string, The group whose members are listed. The format is "projects/{project_id_or_number}/groups/{group_id}". (required)
   pageSize: integer, A positive number that is the maximum number of results to return.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -94,8 +94,8 @@ <h3>Method Details</h3>
       2 - v2 error format
   pageToken: string, If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.
   interval_endTime: string, Required. The end of the time interval.
-  filter: string, An optional list filter (/monitoring/api/learn_more#filtering) describing the members to be returned. The filter may reference the type, labels, and metadata of monitored resources that comprise the group. For example, to return only resources representing Compute Engine VM instances, use this filter:
-resource.type = &quot;gce_instance&quot;
+  filter: string, An optional list filter describing the members to be returned. The filter may reference the type, labels, and metadata of monitored resources that comprise the group. For example, to return only resources representing Compute Engine VM instances, use this filter:
+resource.type = "gce_instance"
 
   interval_startTime: string, Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.
 
@@ -106,14 +106,14 @@ <h3>Method Details</h3>
     "nextPageToken": "A String", # If there are more results than have been returned, then this field is set to a non-empty value. To see the additional results, use that value as pageToken in the next call to this method.
     "totalSize": 42, # The total number of elements matching this request.
     "members": [ # A set of monitored resources in the group.
-      { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for &quot;gce_instance&quot; has labels &quot;instance_id&quot; and &quot;zone&quot;:
-          # { &quot;type&quot;: &quot;gce_instance&quot;,
-          #   &quot;labels&quot;: { &quot;instance_id&quot;: &quot;12345678901234&quot;,
-          #               &quot;zone&quot;: &quot;us-central1-a&quot; }}
-        "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels &quot;database_id&quot; and &quot;zone&quot;.
+      { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone":
+          # { "type": "gce_instance",
+          #   "labels": { "instance_id": "12345678901234",
+          #               "zone": "us-central1-a" }}
+        "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
           "a_key": "A String",
         },
-        "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is &quot;cloudsql_database&quot;.
+        "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
       },
     ],
   }</pre>
diff --git a/docs/dyn/monitoring_v3.projects.metricDescriptors.html b/docs/dyn/monitoring_v3.projects.metricDescriptors.html
index 77f812adf37..5575b54a53b 100644
--- a/docs/dyn/monitoring_v3.projects.metricDescriptors.html
+++ b/docs/dyn/monitoring_v3.projects.metricDescriptors.html
@@ -76,10 +76,10 @@ <h1><a href="monitoring_v3.html">Stackdriver Monitoring API</a> . <a href="monit
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#create">create(name, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a new metric descriptor. User-created metric descriptors define custom metrics (/monitoring/custom-metrics).</p>
+<p class="firstline">Creates a new metric descriptor. User-created metric descriptors define custom metrics.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a metric descriptor. Only user-created custom metrics (/monitoring/custom-metrics) can be deleted.</p>
+<p class="firstline">Deletes a metric descriptor. Only user-created custom metrics can be deleted.</p>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets a single metric descriptor. This method does not require a Stackdriver account.</p>
@@ -92,30 +92,28 @@ <h2>Instance Methods</h2>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(name, body, x__xgafv=None)</code>
-  <pre>Creates a new metric descriptor. User-created metric descriptors define custom metrics (/monitoring/custom-metrics).
+  <pre>Creates a new metric descriptor. User-created metric descriptors define custom metrics.
 
 Args:
-  name: string, The project on which to execute the request. The format is &quot;projects/{project_id_or_number}&quot;. (required)
+  name: string, The project on which to execute the request. The format is "projects/{project_id_or_number}". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # Defines a metric type and its schema.
+{ # Defines a metric type and its schema. Once a metric descriptor is created, deleting or altering it stops data collection and makes the metric type's existing data unusable.
     "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces. Use sentence case without an ending period, for example "Request count".
     "description": "A String", # A detailed description of the metric, which can be used in documentation.
     "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc. Some combinations of metric_kind and value_type might not be supported.
     "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
-    "labels": [ # The set of labels that can be used to describe a specific instance of this metric type. For example, the compute.googleapis.com/instance/network/received_bytes_count metric type has a label, loadbalanced, that specifies whether the traffic was received through a load balanced IP address.
+    "labels": [ # The set of labels that can be used to describe a specific instance of this metric type. For example, the appengine.googleapis.com/http/server/response_latencies metric type has a label for the HTTP response code, response_code, so you can look at latencies for successful responses or just for responses that failed.
       { # A description of a label.
         "valueType": "A String", # The type of data that can be assigned to the label.
         "description": "A String", # A human-readable description for the label.
         "key": "A String", # The label key.
       },
     ],
-    "type": "A String", # The metric type including a DNS name prefix, for example &quot;compute.googleapis.com/instance/cpu/utilization&quot;. Metric types should use a natural hierarchical grouping such as the following:
-        # compute.googleapis.com/instance/cpu/utilization
-        # compute.googleapis.com/instance/disk/read_ops_count
-        # compute.googleapis.com/instance/network/received_bytes_count
-        # Note that if the metric type changes, the monitoring data will be discontinued, and anything depends on it will break, such as monitoring dashboards, alerting rules and quota limits. Therefore, once a metric has been published, its type should be immutable.
+    "type": "A String", # The metric type, including its DNS name prefix. The type is not URL-encoded. All user-defined custom metric types have the DNS name custom.googleapis.com. Metric types should use a natural hierarchical grouping. For example:
+        # "custom.googleapis.com/invoice/paid/amount"
+        # "appengine.googleapis.com/http/server/response_latencies"
     "unit": "A String", # The unit in which the metric value is reported. It is only applicable if the value_type is INT64, DOUBLE, or DISTRIBUTION. The supported units are a subset of The Unified Code for Units of Measure (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT)
         # bit bit
         # By byte
@@ -145,20 +143,19 @@ <h3>Method Details</h3>
         # Ti tebi (2**40)GrammarThe grammar includes the dimensionless unit 1, such as 1/s.The grammar also includes these connectors:
         # / division (as an infix operator, e.g. 1/s).
         # . multiplication (as an infix operator, e.g. GBy.d)The grammar for a unit is as follows:
-        # Expression = Component { &quot;.&quot; Component } { &quot;/&quot; Component } ;
+        # Expression = Component { "." Component } { "/" Component } ;
         # 
         # Component = [ PREFIX ] UNIT [ Annotation ]
         #           | Annotation
-        #           | &quot;1&quot;
+        #           | "1"
         #           ;
         # 
-        # Annotation = &quot;{&quot; NAME &quot;}&quot; ;
+        # Annotation = "{" NAME "}" ;
         # Notes:
         # Annotation is just a comment if it follows a UNIT and is  equivalent to 1 if it is used alone. For examples,  {requests}/s == 1/s, By{transmitted}/s == By/s.
         # NAME is a sequence of non-blank printable ASCII characters not  containing '{' or '}'.
-    "name": "A String", # Resource name. The format of the name may vary between different implementations. For examples:
-        # projects/{project_id}/metricDescriptors/{type=**}
-        # metricDescriptors/{type=**}
+    "name": "A String", # The resource name of the metric descriptor. Depending on the implementation, the name typically includes: (1) the parent resource name that defines the scope of the metric type or of its data; and (2) the metric's URL-encoded type, which also appears in the type field of this descriptor. For example, following is the resource name of a custom metric within the GCP project my-project-id:
+        # "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
   }
 
   x__xgafv: string, V1 error format.
@@ -169,23 +166,21 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Defines a metric type and its schema.
+    { # Defines a metric type and its schema. Once a metric descriptor is created, deleting or altering it stops data collection and makes the metric type's existing data unusable.
       "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces. Use sentence case without an ending period, for example "Request count".
       "description": "A String", # A detailed description of the metric, which can be used in documentation.
       "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc. Some combinations of metric_kind and value_type might not be supported.
       "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
-      "labels": [ # The set of labels that can be used to describe a specific instance of this metric type. For example, the compute.googleapis.com/instance/network/received_bytes_count metric type has a label, loadbalanced, that specifies whether the traffic was received through a load balanced IP address.
+      "labels": [ # The set of labels that can be used to describe a specific instance of this metric type. For example, the appengine.googleapis.com/http/server/response_latencies metric type has a label for the HTTP response code, response_code, so you can look at latencies for successful responses or just for responses that failed.
         { # A description of a label.
           "valueType": "A String", # The type of data that can be assigned to the label.
           "description": "A String", # A human-readable description for the label.
           "key": "A String", # The label key.
         },
       ],
-      "type": "A String", # The metric type including a DNS name prefix, for example &quot;compute.googleapis.com/instance/cpu/utilization&quot;. Metric types should use a natural hierarchical grouping such as the following:
-          # compute.googleapis.com/instance/cpu/utilization
-          # compute.googleapis.com/instance/disk/read_ops_count
-          # compute.googleapis.com/instance/network/received_bytes_count
-          # Note that if the metric type changes, the monitoring data will be discontinued, and anything depends on it will break, such as monitoring dashboards, alerting rules and quota limits. Therefore, once a metric has been published, its type should be immutable.
+      "type": "A String", # The metric type, including its DNS name prefix. The type is not URL-encoded. All user-defined custom metric types have the DNS name custom.googleapis.com. Metric types should use a natural hierarchical grouping. For example:
+          # "custom.googleapis.com/invoice/paid/amount"
+          # "appengine.googleapis.com/http/server/response_latencies"
       "unit": "A String", # The unit in which the metric value is reported. It is only applicable if the value_type is INT64, DOUBLE, or DISTRIBUTION. The supported units are a subset of The Unified Code for Units of Measure (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT)
           # bit bit
           # By byte
@@ -215,29 +210,28 @@ <h3>Method Details</h3>
           # Ti tebi (2**40)GrammarThe grammar includes the dimensionless unit 1, such as 1/s.The grammar also includes these connectors:
           # / division (as an infix operator, e.g. 1/s).
           # . multiplication (as an infix operator, e.g. GBy.d)The grammar for a unit is as follows:
-          # Expression = Component { &quot;.&quot; Component } { &quot;/&quot; Component } ;
+          # Expression = Component { "." Component } { "/" Component } ;
           #
           # Component = [ PREFIX ] UNIT [ Annotation ]
           #           | Annotation
-          #           | &quot;1&quot;
+          #           | "1"
           #           ;
           #
-          # Annotation = &quot;{&quot; NAME &quot;}&quot; ;
+          # Annotation = "{" NAME "}" ;
           # Notes:
           # Annotation is just a comment if it follows a UNIT and is  equivalent to 1 if it is used alone. For examples,  {requests}/s == 1/s, By{transmitted}/s == By/s.
           # NAME is a sequence of non-blank printable ASCII characters not  containing '{' or '}'.
-      "name": "A String", # Resource name. The format of the name may vary between different implementations. For examples:
-          # projects/{project_id}/metricDescriptors/{type=**}
-          # metricDescriptors/{type=**}
+      "name": "A String", # The resource name of the metric descriptor. Depending on the implementation, the name typically includes: (1) the parent resource name that defines the scope of the metric type or of its data; and (2) the metric's URL-encoded type, which also appears in the type field of this descriptor. For example, following is the resource name of a custom metric within the GCP project my-project-id:
+          # "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(name, x__xgafv=None)</code>
-  <pre>Deletes a metric descriptor. Only user-created custom metrics (/monitoring/custom-metrics) can be deleted.
+  <pre>Deletes a metric descriptor. Only user-created custom metrics can be deleted.
 
 Args:
-  name: string, The metric descriptor on which to execute the request. The format is &quot;projects/{project_id_or_number}/metricDescriptors/{metric_id}&quot;. An example of {metric_id} is: &quot;custom.googleapis.com/my_test_metric&quot;. (required)
+  name: string, The metric descriptor on which to execute the request. The format is "projects/{project_id_or_number}/metricDescriptors/{metric_id}". An example of {metric_id} is: "custom.googleapis.com/my_test_metric". (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -259,7 +253,7 @@ <h3>Method Details</h3>
   <pre>Gets a single metric descriptor. This method does not require a Stackdriver account.
 
 Args:
-  name: string, The metric descriptor on which to execute the request. The format is &quot;projects/{project_id_or_number}/metricDescriptors/{metric_id}&quot;. An example value of {metric_id} is &quot;compute.googleapis.com/instance/disk/read_bytes_count&quot;. (required)
+  name: string, The metric descriptor on which to execute the request. The format is "projects/{project_id_or_number}/metricDescriptors/{metric_id}". An example value of {metric_id} is "compute.googleapis.com/instance/disk/read_bytes_count". (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -268,23 +262,21 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Defines a metric type and its schema.
+    { # Defines a metric type and its schema. Once a metric descriptor is created, deleting or altering it stops data collection and makes the metric type's existing data unusable.
       "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces. Use sentence case without an ending period, for example "Request count".
       "description": "A String", # A detailed description of the metric, which can be used in documentation.
       "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc. Some combinations of metric_kind and value_type might not be supported.
       "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
-      "labels": [ # The set of labels that can be used to describe a specific instance of this metric type. For example, the compute.googleapis.com/instance/network/received_bytes_count metric type has a label, loadbalanced, that specifies whether the traffic was received through a load balanced IP address.
+      "labels": [ # The set of labels that can be used to describe a specific instance of this metric type. For example, the appengine.googleapis.com/http/server/response_latencies metric type has a label for the HTTP response code, response_code, so you can look at latencies for successful responses or just for responses that failed.
         { # A description of a label.
           "valueType": "A String", # The type of data that can be assigned to the label.
           "description": "A String", # A human-readable description for the label.
           "key": "A String", # The label key.
         },
       ],
-      "type": "A String", # The metric type including a DNS name prefix, for example &quot;compute.googleapis.com/instance/cpu/utilization&quot;. Metric types should use a natural hierarchical grouping such as the following:
-          # compute.googleapis.com/instance/cpu/utilization
-          # compute.googleapis.com/instance/disk/read_ops_count
-          # compute.googleapis.com/instance/network/received_bytes_count
-          # Note that if the metric type changes, the monitoring data will be discontinued, and anything depends on it will break, such as monitoring dashboards, alerting rules and quota limits. Therefore, once a metric has been published, its type should be immutable.
+      "type": "A String", # The metric type, including its DNS name prefix. The type is not URL-encoded. All user-defined custom metric types have the DNS name custom.googleapis.com. Metric types should use a natural hierarchical grouping. For example:
+          # "custom.googleapis.com/invoice/paid/amount"
+          # "appengine.googleapis.com/http/server/response_latencies"
       "unit": "A String", # The unit in which the metric value is reported. It is only applicable if the value_type is INT64, DOUBLE, or DISTRIBUTION. The supported units are a subset of The Unified Code for Units of Measure (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT)
           # bit bit
           # By byte
@@ -314,20 +306,19 @@ <h3>Method Details</h3>
           # Ti tebi (2**40)GrammarThe grammar includes the dimensionless unit 1, such as 1/s.The grammar also includes these connectors:
           # / division (as an infix operator, e.g. 1/s).
           # . multiplication (as an infix operator, e.g. GBy.d)The grammar for a unit is as follows:
-          # Expression = Component { &quot;.&quot; Component } { &quot;/&quot; Component } ;
+          # Expression = Component { "." Component } { "/" Component } ;
           #
           # Component = [ PREFIX ] UNIT [ Annotation ]
           #           | Annotation
-          #           | &quot;1&quot;
+          #           | "1"
           #           ;
           #
-          # Annotation = &quot;{&quot; NAME &quot;}&quot; ;
+          # Annotation = "{" NAME "}" ;
           # Notes:
           # Annotation is just a comment if it follows a UNIT and is  equivalent to 1 if it is used alone. For examples,  {requests}/s == 1/s, By{transmitted}/s == By/s.
           # NAME is a sequence of non-blank printable ASCII characters not  containing '{' or '}'.
-      "name": "A String", # Resource name. The format of the name may vary between different implementations. For examples:
-          # projects/{project_id}/metricDescriptors/{type=**}
-          # metricDescriptors/{type=**}
+      "name": "A String", # The resource name of the metric descriptor. Depending on the implementation, the name typically includes: (1) the parent resource name that defines the scope of the metric type or of its data; and (2) the metric's URL-encoded type, which also appears in the type field of this descriptor. For example, following is the resource name of a custom metric within the GCP project my-project-id:
+          # "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
     }</pre>
 </div>
 
@@ -336,10 +327,10 @@ <h3>Method Details</h3>
   <pre>Lists metric descriptors that match a filter. This method does not require a Stackdriver account.
 
 Args:
-  name: string, The project on which to execute the request. The format is &quot;projects/{project_id_or_number}&quot;. (required)
+  name: string, The project on which to execute the request. The format is "projects/{project_id_or_number}". (required)
   pageSize: integer, A positive number that is the maximum number of results to return.
-  filter: string, If this field is empty, all custom and system-defined metric descriptors are returned. Otherwise, the filter (/monitoring/api/v3/filters) specifies which metric descriptors are to be returned. For example, the following filter matches all custom metrics (/monitoring/custom-metrics):
-metric.type = starts_with(&quot;custom.googleapis.com/&quot;)
+  filter: string, If this field is empty, all custom and system-defined metric descriptors are returned. Otherwise, the filter specifies which metric descriptors are to be returned. For example, the following filter matches all custom metrics:
+metric.type = starts_with("custom.googleapis.com/")
 
   pageToken: string, If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.
   x__xgafv: string, V1 error format.
@@ -353,23 +344,21 @@ <h3>Method Details</h3>
     { # The ListMetricDescriptors response.
     "nextPageToken": "A String", # If there are more results than have been returned, then this field is set to a non-empty value. To see the additional results, use that value as pageToken in the next call to this method.
     "metricDescriptors": [ # The metric descriptors that are available to the project and that match the value of filter, if present.
-      { # Defines a metric type and its schema.
+      { # Defines a metric type and its schema. Once a metric descriptor is created, deleting or altering it stops data collection and makes the metric type's existing data unusable.
           "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces. Use sentence case without an ending period, for example "Request count".
           "description": "A String", # A detailed description of the metric, which can be used in documentation.
           "metricKind": "A String", # Whether the metric records instantaneous values, changes to a value, etc. Some combinations of metric_kind and value_type might not be supported.
           "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
-          "labels": [ # The set of labels that can be used to describe a specific instance of this metric type. For example, the compute.googleapis.com/instance/network/received_bytes_count metric type has a label, loadbalanced, that specifies whether the traffic was received through a load balanced IP address.
+          "labels": [ # The set of labels that can be used to describe a specific instance of this metric type. For example, the appengine.googleapis.com/http/server/response_latencies metric type has a label for the HTTP response code, response_code, so you can look at latencies for successful responses or just for responses that failed.
             { # A description of a label.
               "valueType": "A String", # The type of data that can be assigned to the label.
               "description": "A String", # A human-readable description for the label.
               "key": "A String", # The label key.
             },
           ],
-          "type": "A String", # The metric type including a DNS name prefix, for example &quot;compute.googleapis.com/instance/cpu/utilization&quot;. Metric types should use a natural hierarchical grouping such as the following:
-              # compute.googleapis.com/instance/cpu/utilization
-              # compute.googleapis.com/instance/disk/read_ops_count
-              # compute.googleapis.com/instance/network/received_bytes_count
-              # Note that if the metric type changes, the monitoring data will be discontinued, and anything depends on it will break, such as monitoring dashboards, alerting rules and quota limits. Therefore, once a metric has been published, its type should be immutable.
+          "type": "A String", # The metric type, including its DNS name prefix. The type is not URL-encoded. All user-defined custom metric types have the DNS name custom.googleapis.com. Metric types should use a natural hierarchical grouping. For example:
+              # "custom.googleapis.com/invoice/paid/amount"
+              # "appengine.googleapis.com/http/server/response_latencies"
           "unit": "A String", # The unit in which the metric value is reported. It is only applicable if the value_type is INT64, DOUBLE, or DISTRIBUTION. The supported units are a subset of The Unified Code for Units of Measure (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT)
               # bit bit
               # By byte
@@ -399,20 +388,19 @@ <h3>Method Details</h3>
               # Ti tebi (2**40)GrammarThe grammar includes the dimensionless unit 1, such as 1/s.The grammar also includes these connectors:
               # / division (as an infix operator, e.g. 1/s).
               # . multiplication (as an infix operator, e.g. GBy.d)The grammar for a unit is as follows:
-              # Expression = Component { &quot;.&quot; Component } { &quot;/&quot; Component } ;
+              # Expression = Component { "." Component } { "/" Component } ;
               #
               # Component = [ PREFIX ] UNIT [ Annotation ]
               #           | Annotation
-              #           | &quot;1&quot;
+              #           | "1"
               #           ;
               #
-              # Annotation = &quot;{&quot; NAME &quot;}&quot; ;
+              # Annotation = "{" NAME "}" ;
               # Notes:
               # Annotation is just a comment if it follows a UNIT and is  equivalent to 1 if it is used alone. For examples,  {requests}/s == 1/s, By{transmitted}/s == By/s.
               # NAME is a sequence of non-blank printable ASCII characters not  containing '{' or '}'.
-          "name": "A String", # Resource name. The format of the name may vary between different implementations. For examples:
-              # projects/{project_id}/metricDescriptors/{type=**}
-              # metricDescriptors/{type=**}
+          "name": "A String", # The resource name of the metric descriptor. Depending on the implementation, the name typically includes: (1) the parent resource name that defines the scope of the metric type or of its data; and (2) the metric's URL-encoded type, which also appears in the type field of this descriptor. For example, following is the resource name of a custom metric within the GCP project my-project-id:
+              # "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
         },
     ],
   }</pre>
diff --git a/docs/dyn/monitoring_v3.projects.monitoredResourceDescriptors.html b/docs/dyn/monitoring_v3.projects.monitoredResourceDescriptors.html
index 6779a79953d..b2020d14292 100644
--- a/docs/dyn/monitoring_v3.projects.monitoredResourceDescriptors.html
+++ b/docs/dyn/monitoring_v3.projects.monitoredResourceDescriptors.html
@@ -89,7 +89,7 @@ <h3>Method Details</h3>
   <pre>Gets a single monitored resource descriptor. This method does not require a Stackdriver account.
 
 Args:
-  name: string, The monitored resource descriptor to get. The format is &quot;projects/{project_id_or_number}/monitoredResourceDescriptors/{resource_type}&quot;. The {resource_type} is a predefined type, such as cloudsql_database. (required)
+  name: string, The monitored resource descriptor to get. The format is "projects/{project_id_or_number}/monitoredResourceDescriptors/{resource_type}". The {resource_type} is a predefined type, such as cloudsql_database. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -98,18 +98,18 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of &quot;gce_instance&quot; and specifies the use of the labels &quot;instance_id&quot; and &quot;zone&quot; to identify particular VM instances.Different APIs can support different monitored resource types. APIs generally provide a list method that returns the monitored resource descriptors used by the API.
-    "type": "A String", # Required. The monitored resource type. For example, the type &quot;cloudsql_database&quot; represents databases in Google Cloud SQL. The maximum length of this value is 256 characters.
-    "labels": [ # Required. A set of labels used to describe instances of this monitored resource type. For example, an individual Google Cloud SQL database is identified by values for the labels &quot;database_id&quot; and &quot;zone&quot;.
+    { # An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of "gce_instance" and specifies the use of the labels "instance_id" and "zone" to identify particular VM instances.Different APIs can support different monitored resource types. APIs generally provide a list method that returns the monitored resource descriptors used by the API.
+    "type": "A String", # Required. The monitored resource type. For example, the type "cloudsql_database" represents databases in Google Cloud SQL. The maximum length of this value is 256 characters.
+    "labels": [ # Required. A set of labels used to describe instances of this monitored resource type. For example, an individual Google Cloud SQL database is identified by values for the labels "database_id" and "zone".
       { # A description of a label.
         "valueType": "A String", # The type of data that can be assigned to the label.
         "description": "A String", # A human-readable description for the label.
         "key": "A String", # The label key.
       },
     ],
-    "displayName": "A String", # Optional. A concise name for the monitored resource type that might be displayed in user interfaces. It should be a Title Cased Noun Phrase, without any article or other determiners. For example, &quot;Google Cloud SQL Database&quot;.
+    "displayName": "A String", # Optional. A concise name for the monitored resource type that might be displayed in user interfaces. It should be a Title Cased Noun Phrase, without any article or other determiners. For example, "Google Cloud SQL Database".
     "description": "A String", # Optional. A detailed description of the monitored resource type that might be used in documentation.
-    "name": "A String", # Optional. The resource name of the monitored resource descriptor: &quot;projects/{project_id}/monitoredResourceDescriptors/{type}&quot; where {type} is the value of the type field in this object and {project_id} is a project ID that provides API-specific context for accessing the type. APIs that do not use project information can use the resource name format &quot;monitoredResourceDescriptors/{type}&quot;.
+    "name": "A String", # Optional. The resource name of the monitored resource descriptor: "projects/{project_id}/monitoredResourceDescriptors/{type}" where {type} is the value of the type field in this object and {project_id} is a project ID that provides API-specific context for accessing the type. APIs that do not use project information can use the resource name format "monitoredResourceDescriptors/{type}".
   }</pre>
 </div>
 
@@ -118,10 +118,10 @@ <h3>Method Details</h3>
   <pre>Lists monitored resource descriptors that match a filter. This method does not require a Stackdriver account.
 
 Args:
-  name: string, The project on which to execute the request. The format is &quot;projects/{project_id_or_number}&quot;. (required)
+  name: string, The project on which to execute the request. The format is "projects/{project_id_or_number}". (required)
   pageSize: integer, A positive number that is the maximum number of results to return.
-  filter: string, An optional filter (/monitoring/api/v3/filters) describing the descriptors to be returned. The filter can reference the descriptor's type and labels. For example, the following filter returns only Google Compute Engine descriptors that have an id label:
-resource.type = starts_with(&quot;gce_&quot;) AND resource.label:id
+  filter: string, An optional filter describing the descriptors to be returned. The filter can reference the descriptor's type and labels. For example, the following filter returns only Google Compute Engine descriptors that have an id label:
+resource.type = starts_with("gce_") AND resource.label:id
 
   pageToken: string, If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.
   x__xgafv: string, V1 error format.
@@ -135,18 +135,18 @@ <h3>Method Details</h3>
     { # The ListMonitoredResourcDescriptors response.
     "nextPageToken": "A String", # If there are more results than have been returned, then this field is set to a non-empty value. To see the additional results, use that value as pageToken in the next call to this method.
     "resourceDescriptors": [ # The monitored resource descriptors that are available to this project and that match filter, if present.
-      { # An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of &quot;gce_instance&quot; and specifies the use of the labels &quot;instance_id&quot; and &quot;zone&quot; to identify particular VM instances.Different APIs can support different monitored resource types. APIs generally provide a list method that returns the monitored resource descriptors used by the API.
-        "type": "A String", # Required. The monitored resource type. For example, the type &quot;cloudsql_database&quot; represents databases in Google Cloud SQL. The maximum length of this value is 256 characters.
-        "labels": [ # Required. A set of labels used to describe instances of this monitored resource type. For example, an individual Google Cloud SQL database is identified by values for the labels &quot;database_id&quot; and &quot;zone&quot;.
+      { # An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of "gce_instance" and specifies the use of the labels "instance_id" and "zone" to identify particular VM instances.Different APIs can support different monitored resource types. APIs generally provide a list method that returns the monitored resource descriptors used by the API.
+        "type": "A String", # Required. The monitored resource type. For example, the type "cloudsql_database" represents databases in Google Cloud SQL. The maximum length of this value is 256 characters.
+        "labels": [ # Required. A set of labels used to describe instances of this monitored resource type. For example, an individual Google Cloud SQL database is identified by values for the labels "database_id" and "zone".
           { # A description of a label.
             "valueType": "A String", # The type of data that can be assigned to the label.
             "description": "A String", # A human-readable description for the label.
             "key": "A String", # The label key.
           },
         ],
-        "displayName": "A String", # Optional. A concise name for the monitored resource type that might be displayed in user interfaces. It should be a Title Cased Noun Phrase, without any article or other determiners. For example, &quot;Google Cloud SQL Database&quot;.
+        "displayName": "A String", # Optional. A concise name for the monitored resource type that might be displayed in user interfaces. It should be a Title Cased Noun Phrase, without any article or other determiners. For example, "Google Cloud SQL Database".
         "description": "A String", # Optional. A detailed description of the monitored resource type that might be used in documentation.
-        "name": "A String", # Optional. The resource name of the monitored resource descriptor: &quot;projects/{project_id}/monitoredResourceDescriptors/{type}&quot; where {type} is the value of the type field in this object and {project_id} is a project ID that provides API-specific context for accessing the type. APIs that do not use project information can use the resource name format &quot;monitoredResourceDescriptors/{type}&quot;.
+        "name": "A String", # Optional. The resource name of the monitored resource descriptor: "projects/{project_id}/monitoredResourceDescriptors/{type}" where {type} is the value of the type field in this object and {project_id} is a project ID that provides API-specific context for accessing the type. APIs that do not use project information can use the resource name format "monitoredResourceDescriptors/{type}".
       },
     ],
   }</pre>
diff --git a/docs/dyn/monitoring_v3.projects.timeSeries.html b/docs/dyn/monitoring_v3.projects.timeSeries.html
index db01ac0f465..2479bb825f6 100644
--- a/docs/dyn/monitoring_v3.projects.timeSeries.html
+++ b/docs/dyn/monitoring_v3.projects.timeSeries.html
@@ -89,7 +89,7 @@ <h3>Method Details</h3>
   <pre>Creates or adds data to one or more time series. The response is empty if all time series in the request were written. If any time series could not be written, a corresponding failure message is included in the error response.
 
 Args:
-  name: string, The project on which to execute the request. The format is &quot;projects/{project_id_or_number}&quot;. (required)
+  name: string, The project on which to execute the request. The format is "projects/{project_id_or_number}". (required)
   body: object, The request body. (required)
     The object takes the form of:
 
@@ -97,11 +97,11 @@ <h3>Method Details</h3>
     "timeSeries": [ # The new data to be added to a list of time series. Adds at most one data point to each of several time series. The new data point must be more recent than any other point in its time series. Each TimeSeries value must fully specify a unique time series by supplying all label values for the metric and the monitored resource.
       { # A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.
         "metricKind": "A String", # The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series.When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either GAUGE (the default) or CUMULATIVE.
-        "metric": { # A specific metric identified by specifying values for all of the labels of a MetricDescriptor. # The associated metric. A fully-specified metric used to identify the time series.
-          "labels": { # The set of labels that uniquely identify a metric. To specify a metric, all labels enumerated in the MetricDescriptor must be assigned values.
+        "metric": { # A specific metric, identified by specifying values for all of the labels of a MetricDescriptor. # The associated metric. A fully-specified metric used to identify the time series.
+          "labels": { # The set of label values that uniquely identify this metric. All labels listed in the MetricDescriptor must be assigned values.
             "a_key": "A String",
           },
-          "type": "A String", # An existing metric type, see google.api.MetricDescriptor. For example, compute.googleapis.com/instance/cpu/usage_time.
+          "type": "A String", # An existing metric type, see google.api.MetricDescriptor. For example, custom.googleapis.com/invoice/paid/amount.
         },
         "points": [ # The data points of this time series. When listing time series, the order of the points is specified by the list method.When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be BOOL, INT64, DOUBLE, or DISTRIBUTION.
           { # A single data point in a time series.
@@ -115,18 +115,18 @@ <h3>Method Details</h3>
                 "bucketCounts": [ # If bucket_options is given, then the sum of the values in bucket_counts must equal the value in count. If bucket_options is not given, no bucket_counts fields may be given.Bucket counts are given in order under the numbering scheme described above (the underflow bucket has number 0; the finite buckets, if any, have numbers 1 through N-2; the overflow bucket has number N-1).The size of bucket_counts must be no greater than N as defined in bucket_options.Any suffix of trailing zero bucket_count fields may be omitted.
                   "A String",
                 ],
-                "bucketOptions": { # A Distribution may optionally contain a histogram of the values in the population. The histogram is given in bucket_counts as counts of values that fall into one of a sequence of non-overlapping buckets. The sequence of buckets is described by bucket_options.A bucket specifies an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket is strictly greater than the lower bound.The sequence of N buckets for a Distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i &gt; 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.BucketOptions describes bucket boundaries in one of three ways. Two describe the boundaries by giving parameters for a formula to generate boundaries and one gives the bucket boundaries explicitly.If bucket_options is not given, then no bucket_counts may be given. # Defines the histogram bucket boundaries.
-                  "exponentialBuckets": { # Specify a sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): scale * (growth_factor ^ i).  Lower bound (1 &lt;= i &lt; N): scale * (growth_factor ^ (i - 1)). # The exponential buckets.
+                "bucketOptions": { # A Distribution may optionally contain a histogram of the values in the population. The histogram is given in bucket_counts as counts of values that fall into one of a sequence of non-overlapping buckets. The sequence of buckets is described by bucket_options.A bucket specifies an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket is strictly greater than the lower bound.The sequence of N buckets for a Distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.BucketOptions describes bucket boundaries in one of three ways. Two describe the boundaries by giving parameters for a formula to generate boundaries and one gives the bucket boundaries explicitly.If bucket_options is not given, then no bucket_counts may be given. # Defines the histogram bucket boundaries.
+                  "exponentialBuckets": { # Specify a sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).  Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)). # The exponential buckets.
                     "scale": 3.14, # Must be greater than 0.
                     "growthFactor": 3.14, # Must be greater than 1.
                     "numFiniteBuckets": 42, # Must be greater than 0.
                   },
-                  "linearBuckets": { # Specify a sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): offset + (width * i).  Lower bound (1 &lt;= i &lt; N): offset + (width * (i - 1)). # The linear bucket.
+                  "linearBuckets": { # Specify a sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): offset + (width * i).  Lower bound (1 <= i < N): offset + (width * (i - 1)). # The linear bucket.
                     "width": 3.14, # Must be greater than 0.
                     "numFiniteBuckets": 42, # Must be greater than 0.
                     "offset": 3.14, # Lower bound of the first bucket.
                   },
-                  "explicitBuckets": { # A set of buckets with arbitrary widths.Defines size(bounds) + 1 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): boundsi  Lower bound (1 &lt;= i &lt; N); boundsi - 1There must be at least one element in bounds. If bounds has only one element, there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets. # The explicit buckets.
+                  "explicitBuckets": { # A set of buckets with arbitrary widths.Defines size(bounds) + 1 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): boundsi  Lower bound (1 <= i < N); boundsi - 1There must be at least one element in bounds. If bounds has only one element, there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets. # The explicit buckets.
                     "bounds": [ # The values must be monotonically increasing.
                       3.14,
                     ],
@@ -148,14 +148,14 @@ <h3>Method Details</h3>
             },
           },
         ],
-        "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for &quot;gce_instance&quot; has labels &quot;instance_id&quot; and &quot;zone&quot;: # The associated resource. A fully-specified monitored resource used to identify the time series.
-            # { &quot;type&quot;: &quot;gce_instance&quot;,
-            #   &quot;labels&quot;: { &quot;instance_id&quot;: &quot;12345678901234&quot;,
-            #               &quot;zone&quot;: &quot;us-central1-a&quot; }}
-          "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels &quot;database_id&quot; and &quot;zone&quot;.
+        "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # The associated resource. A fully-specified monitored resource used to identify the time series.
+            # { "type": "gce_instance",
+            #   "labels": { "instance_id": "12345678901234",
+            #               "zone": "us-central1-a" }}
+          "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
             "a_key": "A String",
           },
-          "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is &quot;cloudsql_database&quot;.
+          "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
         },
         "valueType": "A String", # The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series.When creating a time series, this field is optional. If present, it must be the same as the type of the data in the points field.
       },
@@ -192,13 +192,13 @@ <h3>Method Details</h3>
       2 - v2 error format
   aggregation_alignmentPeriod: string, The alignment period for per-time series alignment. If present, alignmentPeriod must be at least 60 seconds. After per-time series alignment, each time series will contain data points only on the period boundaries. If perSeriesAligner is not specified or equals ALIGN_NONE, then this field is ignored. If perSeriesAligner is specified and does not equal ALIGN_NONE, then this field must be defined; otherwise an error is returned.
   pageToken: string, If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.
-  aggregation_groupByFields: string, The set of fields to preserve when crossSeriesReducer is specified. The groupByFields determine how the time series are partitioned into subsets prior to applying the aggregation function. Each subset contains time series that have the same value for each of the grouping fields. Each individual time series is a member of exactly one subset. The crossSeriesReducer is applied to each subset of time series. Fields not specified in groupByFields are aggregated away. If groupByFields is not specified, the time series are aggregated into a single output time series. If crossSeriesReducer is not defined, this field is ignored. (repeated)
+  aggregation_groupByFields: string, The set of fields to preserve when crossSeriesReducer is specified. The groupByFields determine how the time series are partitioned into subsets prior to applying the aggregation function. Each subset contains time series that have the same value for each of the grouping fields. Each individual time series is a member of exactly one subset. The crossSeriesReducer is applied to each subset of time series. It is not possible to reduce across different resource types, so this field implicitly contains resource.type. Fields not specified in groupByFields are aggregated away. If groupByFields is not specified and all the time series have the same resource type, then the time series are aggregated into a single output time series. If crossSeriesReducer is not defined, this field is ignored. (repeated)
   aggregation_perSeriesAligner: string, The approach to be used to align individual time series. Not all alignment functions may be applied to all time series, depending on the metric type and value type of the original time series. Alignment may change the metric type or the value type of the time series.Time series data must be aligned in order to perform cross-time series reduction. If crossSeriesReducer is specified, then perSeriesAligner must be specified and not equal ALIGN_NONE and alignmentPeriod must be specified; otherwise, an error is returned.
   interval_endTime: string, Required. The end of the time interval.
   aggregation_crossSeriesReducer: string, The approach to be used to combine time series. Not all reducer functions may be applied to all time series, depending on the metric type and the value type of the original time series. Reduction may change the metric type of value type of the time series.Time series data must be aligned in order to perform cross-time series reduction. If crossSeriesReducer is specified, then perSeriesAligner must be specified and not equal ALIGN_NONE and alignmentPeriod must be specified; otherwise, an error is returned.
-  filter: string, A monitoring filter (/monitoring/api/v3/filters) that specifies which time series should be returned. The filter must specify a single metric type, and can additionally specify metric labels and other information. For example:
-metric.type = &quot;compute.googleapis.com/instance/cpu/usage_time&quot; AND
-    metric.label.instance_name = &quot;my-instance-name&quot;
+  filter: string, A monitoring filter that specifies which time series should be returned. The filter must specify a single metric type, and can additionally specify metric labels and other information. For example:
+metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
+    metric.label.instance_name = "my-instance-name"
 
   interval_startTime: string, Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.
   view: string, Specifies which information is returned about the time series.
@@ -211,11 +211,11 @@ <h3>Method Details</h3>
     "timeSeries": [ # One or more time series that match the filter included in the request.
       { # A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.
         "metricKind": "A String", # The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series.When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either GAUGE (the default) or CUMULATIVE.
-        "metric": { # A specific metric identified by specifying values for all of the labels of a MetricDescriptor. # The associated metric. A fully-specified metric used to identify the time series.
-          "labels": { # The set of labels that uniquely identify a metric. To specify a metric, all labels enumerated in the MetricDescriptor must be assigned values.
+        "metric": { # A specific metric, identified by specifying values for all of the labels of a MetricDescriptor. # The associated metric. A fully-specified metric used to identify the time series.
+          "labels": { # The set of label values that uniquely identify this metric. All labels listed in the MetricDescriptor must be assigned values.
             "a_key": "A String",
           },
-          "type": "A String", # An existing metric type, see google.api.MetricDescriptor. For example, compute.googleapis.com/instance/cpu/usage_time.
+          "type": "A String", # An existing metric type, see google.api.MetricDescriptor. For example, custom.googleapis.com/invoice/paid/amount.
         },
         "points": [ # The data points of this time series. When listing time series, the order of the points is specified by the list method.When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be BOOL, INT64, DOUBLE, or DISTRIBUTION.
           { # A single data point in a time series.
@@ -229,18 +229,18 @@ <h3>Method Details</h3>
                 "bucketCounts": [ # If bucket_options is given, then the sum of the values in bucket_counts must equal the value in count. If bucket_options is not given, no bucket_counts fields may be given.Bucket counts are given in order under the numbering scheme described above (the underflow bucket has number 0; the finite buckets, if any, have numbers 1 through N-2; the overflow bucket has number N-1).The size of bucket_counts must be no greater than N as defined in bucket_options.Any suffix of trailing zero bucket_count fields may be omitted.
                   "A String",
                 ],
-                "bucketOptions": { # A Distribution may optionally contain a histogram of the values in the population. The histogram is given in bucket_counts as counts of values that fall into one of a sequence of non-overlapping buckets. The sequence of buckets is described by bucket_options.A bucket specifies an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket is strictly greater than the lower bound.The sequence of N buckets for a Distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i &gt; 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.BucketOptions describes bucket boundaries in one of three ways. Two describe the boundaries by giving parameters for a formula to generate boundaries and one gives the bucket boundaries explicitly.If bucket_options is not given, then no bucket_counts may be given. # Defines the histogram bucket boundaries.
-                  "exponentialBuckets": { # Specify a sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): scale * (growth_factor ^ i).  Lower bound (1 &lt;= i &lt; N): scale * (growth_factor ^ (i - 1)). # The exponential buckets.
+                "bucketOptions": { # A Distribution may optionally contain a histogram of the values in the population. The histogram is given in bucket_counts as counts of values that fall into one of a sequence of non-overlapping buckets. The sequence of buckets is described by bucket_options.A bucket specifies an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket is strictly greater than the lower bound.The sequence of N buckets for a Distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.BucketOptions describes bucket boundaries in one of three ways. Two describe the boundaries by giving parameters for a formula to generate boundaries and one gives the bucket boundaries explicitly.If bucket_options is not given, then no bucket_counts may be given. # Defines the histogram bucket boundaries.
+                  "exponentialBuckets": { # Specify a sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).  Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)). # The exponential buckets.
                     "scale": 3.14, # Must be greater than 0.
                     "growthFactor": 3.14, # Must be greater than 1.
                     "numFiniteBuckets": 42, # Must be greater than 0.
                   },
-                  "linearBuckets": { # Specify a sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): offset + (width * i).  Lower bound (1 &lt;= i &lt; N): offset + (width * (i - 1)). # The linear bucket.
+                  "linearBuckets": { # Specify a sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket.Defines num_finite_buckets + 2 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): offset + (width * i).  Lower bound (1 <= i < N): offset + (width * (i - 1)). # The linear bucket.
                     "width": 3.14, # Must be greater than 0.
                     "numFiniteBuckets": 42, # Must be greater than 0.
                     "offset": 3.14, # Lower bound of the first bucket.
                   },
-                  "explicitBuckets": { # A set of buckets with arbitrary widths.Defines size(bounds) + 1 (= N) buckets with these boundaries for bucket i:Upper bound (0 &lt;= i &lt; N-1): boundsi  Lower bound (1 &lt;= i &lt; N); boundsi - 1There must be at least one element in bounds. If bounds has only one element, there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets. # The explicit buckets.
+                  "explicitBuckets": { # A set of buckets with arbitrary widths.Defines size(bounds) + 1 (= N) buckets with these boundaries for bucket i:Upper bound (0 <= i < N-1): boundsi  Lower bound (1 <= i < N); boundsi - 1There must be at least one element in bounds. If bounds has only one element, there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets. # The explicit buckets.
                     "bounds": [ # The values must be monotonically increasing.
                       3.14,
                     ],
@@ -262,14 +262,14 @@ <h3>Method Details</h3>
             },
           },
         ],
-        "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for &quot;gce_instance&quot; has labels &quot;instance_id&quot; and &quot;zone&quot;: # The associated resource. A fully-specified monitored resource used to identify the time series.
-            # { &quot;type&quot;: &quot;gce_instance&quot;,
-            #   &quot;labels&quot;: { &quot;instance_id&quot;: &quot;12345678901234&quot;,
-            #               &quot;zone&quot;: &quot;us-central1-a&quot; }}
-          "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels &quot;database_id&quot; and &quot;zone&quot;.
+        "resource": { # An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone": # The associated resource. A fully-specified monitored resource used to identify the time series.
+            # { "type": "gce_instance",
+            #   "labels": { "instance_id": "12345678901234",
+            #               "zone": "us-central1-a" }}
+          "labels": { # Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels "database_id" and "zone".
             "a_key": "A String",
           },
-          "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is &quot;cloudsql_database&quot;.
+          "type": "A String", # Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is "cloudsql_database".
         },
         "valueType": "A String", # The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series.When creating a time series, this field is optional. If present, it must be the same as the type of the data in the points field.
       },
diff --git a/docs/dyn/plusDomains_v1.media.html b/docs/dyn/plusDomains_v1.media.html
index 36fdbbbf633..061602722aa 100644
--- a/docs/dyn/plusDomains_v1.media.html
+++ b/docs/dyn/plusDomains_v1.media.html
@@ -75,11 +75,11 @@
 <h1><a href="plusDomains_v1.html">Google+ Domains API</a> . <a href="plusDomains_v1.media.html">media</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#insert">insert(userId, collection, body=None, media_body=None)</a></code></p>
+  <code><a href="#insert">insert(userId, collection, body=None, media_body=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Add a new media item to an album. The current upload size limitations are 36MB for a photo and 1GB for a video. Uploads do not count against quota if photos are less than 2048 pixels on their longest side or videos are less than 15 minutes in length.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="insert">insert(userId, collection, body=None, media_body=None)</code>
+    <code class="details" id="insert">insert(userId, collection, body=None, media_body=None, media_mime_type=None)</code>
   <pre>Add a new media item to an album. The current upload size limitations are 36MB for a photo and 1GB for a video. Uploads do not count against quota if photos are less than 2048 pixels on their longest side or videos are less than 15 minutes in length.
 
 Args:
@@ -133,6 +133,7 @@ <h3>Method Details</h3>
   }
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/pubsub_v1.projects.snapshots.html b/docs/dyn/pubsub_v1.projects.snapshots.html
index 32dbf2ce363..b872bebd337 100644
--- a/docs/dyn/pubsub_v1.projects.snapshots.html
+++ b/docs/dyn/pubsub_v1.projects.snapshots.html
@@ -75,105 +75,324 @@
 <h1><a href="pubsub_v1.html">Google Cloud Pub/Sub API</a> . <a href="pubsub_v1.projects.html">projects</a> . <a href="pubsub_v1.projects.snapshots.html">snapshots</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.</p>
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the access control policy for a resource.</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy.</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the access control policy on the specified resource. Replaces any</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, x__xgafv=None)</code>
-  <pre>Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</code>
+  <pre>Gets the access control policy for a resource.
+Returns an empty policy if the resource exists and does not have a policy
+set.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the access control policy on the specified resource. Replaces any existing policy.
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the access control policy on the specified resource. Replaces any
+existing policy.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
   <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
diff --git a/docs/dyn/pubsub_v1.projects.subscriptions.html b/docs/dyn/pubsub_v1.projects.subscriptions.html
index 9bb150b7cf9..50eb3260b9d 100644
--- a/docs/dyn/pubsub_v1.projects.subscriptions.html
+++ b/docs/dyn/pubsub_v1.projects.subscriptions.html
@@ -75,195 +75,530 @@
 <h1><a href="pubsub_v1.html">Google Cloud Pub/Sub API</a> . <a href="pubsub_v1.projects.html">projects</a> . <a href="pubsub_v1.projects.subscriptions.html">subscriptions</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#acknowledge">acknowledge(subscription, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Acknowledges the messages associated with the `ack_ids` in the `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages from the subscription. Acknowledging a message whose ack deadline has expired may succeed, but such a message may be redelivered later. Acknowledging a message more than once will not result in an error.</p>
+  <code><a href="#acknowledge">acknowledge(subscription=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Acknowledges the messages associated with the `ack_ids` in the</p>
 <p class="toc_element">
-  <code><a href="#create">create(name, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a subscription to a given topic. If the subscription already exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns `NOT_FOUND`. If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic. Note that for REST API requests, you must specify a name.</p>
+  <code><a href="#create">create(name=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a subscription to a given topic.</p>
 <p class="toc_element">
-  <code><a href="#delete">delete(subscription, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes an existing subscription. All messages retained in the subscription are immediately dropped. Calls to `Pull` after deletion will return `NOT_FOUND`. After a subscription is deleted, a new one may be created with the same name, but the new one has no association with the old subscription or its topic unless the same topic is specified.</p>
+  <code><a href="#delete">delete(subscription=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Deletes an existing subscription. All messages retained in the subscription</p>
 <p class="toc_element">
-  <code><a href="#get">get(subscription, x__xgafv=None)</a></code></p>
+  <code><a href="#get">get(subscription=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the configuration details of a subscription.</p>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.</p>
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the access control policy for a resource.</p>
 <p class="toc_element">
-  <code><a href="#list">list(project, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(project=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists matching subscriptions.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#modifyAckDeadline">modifyAckDeadline(subscription, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Modifies the ack deadline for a specific message. This method is useful to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted. Note that this does not modify the subscription-level `ackDeadlineSeconds` used for subsequent messages.</p>
+  <code><a href="#modifyAckDeadline">modifyAckDeadline(subscription=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Modifies the ack deadline for a specific message. This method is useful</p>
 <p class="toc_element">
-  <code><a href="#modifyPushConfig">modifyPushConfig(subscription, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Modifies the `PushConfig` for a specified subscription. This may be used to change a push subscription to a pull one (signified by an empty `PushConfig`) or vice versa, or change the endpoint URL and other attributes of a push subscription. Messages will accumulate for delivery continuously through the call regardless of changes to the `PushConfig`.</p>
+  <code><a href="#modifyPushConfig">modifyPushConfig(subscription=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Modifies the `PushConfig` for a specified subscription.</p>
 <p class="toc_element">
-  <code><a href="#pull">pull(subscription, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Pulls messages from the server. Returns an empty list if there are no messages available in the backlog. The server may return `UNAVAILABLE` if there are too many concurrent pull requests pending for the given subscription.</p>
+  <code><a href="#pull">pull(subscription=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Pulls messages from the server. Returns an empty list if there are no</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy.</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the access control policy on the specified resource. Replaces any</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="acknowledge">acknowledge(subscription, body, x__xgafv=None)</code>
-  <pre>Acknowledges the messages associated with the `ack_ids` in the `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages from the subscription. Acknowledging a message whose ack deadline has expired may succeed, but such a message may be redelivered later. Acknowledging a message more than once will not result in an error.
+    <code class="details" id="acknowledge">acknowledge(subscription=None, body, x__xgafv=None)</code>
+  <pre>Acknowledges the messages associated with the `ack_ids` in the
+`AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages
+from the subscription.
+
+Acknowledging a message whose ack deadline has expired may succeed,
+but such a message may be redelivered later. Acknowledging a message more
+than once will not result in an error.
 
 Args:
-  subscription: string, The subscription whose message is being acknowledged. (required)
+  subscription: string, The subscription whose message is being acknowledged.
+Format is `projects/{project}/subscriptions/{sub}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the Acknowledge method.
-    "ackIds": [ # The acknowledgment ID for the messages being acknowledged that was returned by the Pub/Sub system in the `Pull` response. Must not be empty.
+    "ackIds": [ # The acknowledgment ID for the messages being acknowledged that was returned
+        # by the Pub/Sub system in the `Pull` response. Must not be empty.
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="create">create(name, body, x__xgafv=None)</code>
-  <pre>Creates a subscription to a given topic. If the subscription already exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns `NOT_FOUND`. If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic. Note that for REST API requests, you must specify a name.
+    <code class="details" id="create">create(name=None, body, x__xgafv=None)</code>
+  <pre>Creates a subscription to a given topic.
+If the subscription already exists, returns `ALREADY_EXISTS`.
+If the corresponding topic doesn't exist, returns `NOT_FOUND`.
+
+If the name is not provided in the request, the server will assign a random
+name for this subscription on the same project as the topic, conforming
+to the
+[resource name format](https://cloud.google.com/pubsub/docs/overview#names).
+The generated name is populated in the returned Subscription object.
+Note that for REST API requests, you must specify a name in the request.
 
 Args:
-  name: string, The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`. (required)
+  name: string, The name of the subscription. It must have the format
+`"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+start with a letter, and contain only letters (`[A-Za-z]`), numbers
+(`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+in length, and it must not start with `"goog"`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # A subscription resource.
-  "topic": "A String", # The name of the topic from which this subscription is receiving messages. The value of this field will be `_deleted-topic_` if the topic has been deleted.
-  "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.
-  "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods.
-    "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+  "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+      # Format is `projects/{project}/topics/{topic}`.
+      # The value of this field will be `_deleted-topic_` if the topic has been
+      # deleted.
+  "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+      # before the subscriber should acknowledge the message. After message
+      # delivery but before the ack deadline expires and before the message is
+      # acknowledged, it is an outstanding message and will not be delivered
+      # again during that time (on a best-effort basis).
+      # 
+      # For pull subscriptions, this value is used as the initial value for the ack
+      # deadline. To override this value for a given message, call
+      # `ModifyAckDeadline` with the corresponding `ack_id` if using
+      # pull.
+      # The minimum custom deadline you can specify is 10 seconds.
+      # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+      # If this parameter is 0, a default value of 10 seconds is used.
+      # 
+      # For push delivery, this value is also used to set the request timeout for
+      # the call to the push endpoint.
+      # 
+      # If the subscriber never acknowledges the message, the Pub/Sub
+      # system will eventually redeliver the message.
+  "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+      # used to configure it. An empty `pushConfig` signifies that the subscriber
+      # will pull and ack messages using API methods.
+    "attributes": { # Endpoint configuration attributes.
+        #
+        # Every endpoint has a set of API supported attributes that can be used to
+        # control different aspects of the message delivery.
+        #
+        # The currently supported attribute is `x-goog-version`, which you can
+        # use to change the format of the push message. This attribute
+        # indicates the version of the data expected by the endpoint. This
+        # controls the shape of the envelope (i.e. its fields and metadata).
+        # The endpoint version is based on the version of the Pub/Sub
+        # API.
+        #
+        # If not present during the `CreateSubscription` call, it will default to
+        # the version of the API used to make such call. If not present during a
+        # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+        # calls will always return a valid version, even if the subscription was
+        # created without this attribute.
+        #
+        # The possible values for this attribute are:
+        #
+        # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+        # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
       "a_key": "A String",
     },
-    "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+    "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+        # For example, a Webhook endpoint might use "https://example.com/push".
   },
-  "name": "A String", # The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+  "name": "A String", # The name of the subscription. It must have the format
+      # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+      # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+      # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+      # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+      # in length, and it must not start with `"goog"`.
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A subscription resource.
-    "topic": "A String", # The name of the topic from which this subscription is receiving messages. The value of this field will be `_deleted-topic_` if the topic has been deleted.
-    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.
-    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods.
-      "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+    "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+        # Format is `projects/{project}/topics/{topic}`.
+        # The value of this field will be `_deleted-topic_` if the topic has been
+        # deleted.
+    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+        # before the subscriber should acknowledge the message. After message
+        # delivery but before the ack deadline expires and before the message is
+        # acknowledged, it is an outstanding message and will not be delivered
+        # again during that time (on a best-effort basis).
+        #
+        # For pull subscriptions, this value is used as the initial value for the ack
+        # deadline. To override this value for a given message, call
+        # `ModifyAckDeadline` with the corresponding `ack_id` if using
+        # pull.
+        # The minimum custom deadline you can specify is 10 seconds.
+        # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+        # If this parameter is 0, a default value of 10 seconds is used.
+        #
+        # For push delivery, this value is also used to set the request timeout for
+        # the call to the push endpoint.
+        #
+        # If the subscriber never acknowledges the message, the Pub/Sub
+        # system will eventually redeliver the message.
+    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+        # used to configure it. An empty `pushConfig` signifies that the subscriber
+        # will pull and ack messages using API methods.
+      "attributes": { # Endpoint configuration attributes.
+          #
+          # Every endpoint has a set of API supported attributes that can be used to
+          # control different aspects of the message delivery.
+          #
+          # The currently supported attribute is `x-goog-version`, which you can
+          # use to change the format of the push message. This attribute
+          # indicates the version of the data expected by the endpoint. This
+          # controls the shape of the envelope (i.e. its fields and metadata).
+          # The endpoint version is based on the version of the Pub/Sub
+          # API.
+          #
+          # If not present during the `CreateSubscription` call, it will default to
+          # the version of the API used to make such call. If not present during a
+          # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+          # calls will always return a valid version, even if the subscription was
+          # created without this attribute.
+          #
+          # The possible values for this attribute are:
+          #
+          # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+          # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
         "a_key": "A String",
       },
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
-    "name": "A String", # The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+    "name": "A String", # The name of the subscription. It must have the format
+        # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+        # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+        # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+        # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+        # in length, and it must not start with `"goog"`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="delete">delete(subscription, x__xgafv=None)</code>
-  <pre>Deletes an existing subscription. All messages retained in the subscription are immediately dropped. Calls to `Pull` after deletion will return `NOT_FOUND`. After a subscription is deleted, a new one may be created with the same name, but the new one has no association with the old subscription or its topic unless the same topic is specified.
+    <code class="details" id="delete">delete(subscription=None, x__xgafv=None)</code>
+  <pre>Deletes an existing subscription. All messages retained in the subscription
+are immediately dropped. Calls to `Pull` after deletion will return
+`NOT_FOUND`. After a subscription is deleted, a new one may be created with
+the same name, but the new one has no association with the old
+subscription or its topic unless the same topic is specified.
 
 Args:
-  subscription: string, The subscription to delete. (required)
+  subscription: string, The subscription to delete.
+Format is `projects/{project}/subscriptions/{sub}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="get">get(subscription, x__xgafv=None)</code>
+    <code class="details" id="get">get(subscription=None, x__xgafv=None)</code>
   <pre>Gets the configuration details of a subscription.
 
 Args:
-  subscription: string, The name of the subscription to get. (required)
+  subscription: string, The name of the subscription to get.
+Format is `projects/{project}/subscriptions/{sub}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A subscription resource.
-    "topic": "A String", # The name of the topic from which this subscription is receiving messages. The value of this field will be `_deleted-topic_` if the topic has been deleted.
-    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.
-    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods.
-      "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+    "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+        # Format is `projects/{project}/topics/{topic}`.
+        # The value of this field will be `_deleted-topic_` if the topic has been
+        # deleted.
+    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+        # before the subscriber should acknowledge the message. After message
+        # delivery but before the ack deadline expires and before the message is
+        # acknowledged, it is an outstanding message and will not be delivered
+        # again during that time (on a best-effort basis).
+        #
+        # For pull subscriptions, this value is used as the initial value for the ack
+        # deadline. To override this value for a given message, call
+        # `ModifyAckDeadline` with the corresponding `ack_id` if using
+        # pull.
+        # The minimum custom deadline you can specify is 10 seconds.
+        # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+        # If this parameter is 0, a default value of 10 seconds is used.
+        #
+        # For push delivery, this value is also used to set the request timeout for
+        # the call to the push endpoint.
+        #
+        # If the subscriber never acknowledges the message, the Pub/Sub
+        # system will eventually redeliver the message.
+    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+        # used to configure it. An empty `pushConfig` signifies that the subscriber
+        # will pull and ack messages using API methods.
+      "attributes": { # Endpoint configuration attributes.
+          #
+          # Every endpoint has a set of API supported attributes that can be used to
+          # control different aspects of the message delivery.
+          #
+          # The currently supported attribute is `x-goog-version`, which you can
+          # use to change the format of the push message. This attribute
+          # indicates the version of the data expected by the endpoint. This
+          # controls the shape of the envelope (i.e. its fields and metadata).
+          # The endpoint version is based on the version of the Pub/Sub
+          # API.
+          #
+          # If not present during the `CreateSubscription` call, it will default to
+          # the version of the API used to make such call. If not present during a
+          # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+          # calls will always return a valid version, even if the subscription was
+          # created without this attribute.
+          #
+          # The possible values for this attribute are:
+          #
+          # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+          # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
         "a_key": "A String",
       },
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
-    "name": "A String", # The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+    "name": "A String", # The name of the subscription. It must have the format
+        # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+        # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+        # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+        # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+        # in length, and it must not start with `"goog"`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, x__xgafv=None)</code>
-  <pre>Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</code>
+  <pre>Gets the access control policy for a resource.
+Returns an empty policy if the resource exists and does not have a policy
+set.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(project, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(project=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
   <pre>Lists matching subscriptions.
 
 Args:
-  project: string, The name of the cloud project that subscriptions belong to. (required)
+  project: string, The name of the cloud project that subscriptions belong to.
+Format is `projects/{project}`. (required)
   pageSize: integer, Maximum number of subscriptions to return.
-  pageToken: string, The value returned by the last `ListSubscriptionsResponse`; indicates that this is a continuation of a prior `ListSubscriptions` call, and that the system should return the next page of data.
+  pageToken: string, The value returned by the last `ListSubscriptionsResponse`; indicates that
+this is a continuation of a prior `ListSubscriptions` call, and that the
+system should return the next page of data.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `ListSubscriptions` method.
-    "nextPageToken": "A String", # If not empty, indicates that there may be more subscriptions that match the request; this value should be passed in a new `ListSubscriptionsRequest` to get more subscriptions.
+    "nextPageToken": "A String", # If not empty, indicates that there may be more subscriptions that match
+        # the request; this value should be passed in a new
+        # `ListSubscriptionsRequest` to get more subscriptions.
     "subscriptions": [ # The subscriptions that match the request.
       { # A subscription resource.
-        "topic": "A String", # The name of the topic from which this subscription is receiving messages. The value of this field will be `_deleted-topic_` if the topic has been deleted.
-        "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.
-        "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods.
-          "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+        "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+            # Format is `projects/{project}/topics/{topic}`.
+            # The value of this field will be `_deleted-topic_` if the topic has been
+            # deleted.
+        "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+            # before the subscriber should acknowledge the message. After message
+            # delivery but before the ack deadline expires and before the message is
+            # acknowledged, it is an outstanding message and will not be delivered
+            # again during that time (on a best-effort basis).
+            #
+            # For pull subscriptions, this value is used as the initial value for the ack
+            # deadline. To override this value for a given message, call
+            # `ModifyAckDeadline` with the corresponding `ack_id` if using
+            # pull.
+            # The minimum custom deadline you can specify is 10 seconds.
+            # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+            # If this parameter is 0, a default value of 10 seconds is used.
+            #
+            # For push delivery, this value is also used to set the request timeout for
+            # the call to the push endpoint.
+            #
+            # If the subscriber never acknowledges the message, the Pub/Sub
+            # system will eventually redeliver the message.
+        "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+            # used to configure it. An empty `pushConfig` signifies that the subscriber
+            # will pull and ack messages using API methods.
+          "attributes": { # Endpoint configuration attributes.
+              #
+              # Every endpoint has a set of API supported attributes that can be used to
+              # control different aspects of the message delivery.
+              #
+              # The currently supported attribute is `x-goog-version`, which you can
+              # use to change the format of the push message. This attribute
+              # indicates the version of the data expected by the endpoint. This
+              # controls the shape of the envelope (i.e. its fields and metadata).
+              # The endpoint version is based on the version of the Pub/Sub
+              # API.
+              #
+              # If not present during the `CreateSubscription` call, it will default to
+              # the version of the API used to make such call. If not present during a
+              # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+              # calls will always return a valid version, even if the subscription was
+              # created without this attribute.
+              #
+              # The possible values for this attribute are:
+              #
+              # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+              # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
             "a_key": "A String",
           },
-          "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+          "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+              # For example, a Webhook endpoint might use "https://example.com/push".
         },
-        "name": "A String", # The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+        "name": "A String", # The name of the subscription. It must have the format
+            # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+            # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+            # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+            # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+            # in length, and it must not start with `"goog"`.
       },
     ],
   }</pre>
@@ -284,87 +619,175 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="modifyAckDeadline">modifyAckDeadline(subscription, body, x__xgafv=None)</code>
-  <pre>Modifies the ack deadline for a specific message. This method is useful to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted. Note that this does not modify the subscription-level `ackDeadlineSeconds` used for subsequent messages.
+    <code class="details" id="modifyAckDeadline">modifyAckDeadline(subscription=None, body, x__xgafv=None)</code>
+  <pre>Modifies the ack deadline for a specific message. This method is useful
+to indicate that more time is needed to process a message by the
+subscriber, or to make the message available for redelivery if the
+processing was interrupted. Note that this does not modify the
+subscription-level `ackDeadlineSeconds` used for subsequent messages.
 
 Args:
-  subscription: string, The name of the subscription. (required)
+  subscription: string, The name of the subscription.
+Format is `projects/{project}/subscriptions/{sub}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the ModifyAckDeadline method.
-    "ackDeadlineSeconds": 42, # The new ack deadline with respect to the time this request was sent to the Pub/Sub system. Must be >= 0. For example, if the value is 10, the new ack deadline will expire 10 seconds after the `ModifyAckDeadline` call was made. Specifying zero may immediately make the message available for another pull request.
+    "ackDeadlineSeconds": 42, # The new ack deadline with respect to the time this request was sent to
+        # the Pub/Sub system. For example, if the value is 10, the new
+        # ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
+        # was made. Specifying zero may immediately make the message available for
+        # another pull request.
+        # The minimum deadline you can specify is 0 seconds.
+        # The maximum deadline you can specify is 600 seconds (10 minutes).
     "ackIds": [ # List of acknowledgment IDs.
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="modifyPushConfig">modifyPushConfig(subscription, body, x__xgafv=None)</code>
-  <pre>Modifies the `PushConfig` for a specified subscription. This may be used to change a push subscription to a pull one (signified by an empty `PushConfig`) or vice versa, or change the endpoint URL and other attributes of a push subscription. Messages will accumulate for delivery continuously through the call regardless of changes to the `PushConfig`.
+    <code class="details" id="modifyPushConfig">modifyPushConfig(subscription=None, body, x__xgafv=None)</code>
+  <pre>Modifies the `PushConfig` for a specified subscription.
+
+This may be used to change a push subscription to a pull one (signified by
+an empty `PushConfig`) or vice versa, or change the endpoint URL and other
+attributes of a push subscription. Messages will accumulate for delivery
+continuously through the call regardless of changes to the `PushConfig`.
 
 Args:
-  subscription: string, The name of the subscription. (required)
+  subscription: string, The name of the subscription.
+Format is `projects/{project}/subscriptions/{sub}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the ModifyPushConfig method.
-    "pushConfig": { # Configuration for a push delivery endpoint. # The push configuration for future deliveries. An empty `pushConfig` indicates that the Pub/Sub system should stop pushing messages from the given subscription and allow messages to be pulled and acknowledged - effectively pausing the subscription if `Pull` is not called.
-      "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+    "pushConfig": { # Configuration for a push delivery endpoint. # The push configuration for future deliveries.
+        # 
+        # An empty `pushConfig` indicates that the Pub/Sub system should
+        # stop pushing messages from the given subscription and allow
+        # messages to be pulled and acknowledged - effectively pausing
+        # the subscription if `Pull` is not called.
+      "attributes": { # Endpoint configuration attributes.
+          #
+          # Every endpoint has a set of API supported attributes that can be used to
+          # control different aspects of the message delivery.
+          #
+          # The currently supported attribute is `x-goog-version`, which you can
+          # use to change the format of the push message. This attribute
+          # indicates the version of the data expected by the endpoint. This
+          # controls the shape of the envelope (i.e. its fields and metadata).
+          # The endpoint version is based on the version of the Pub/Sub
+          # API.
+          #
+          # If not present during the `CreateSubscription` call, it will default to
+          # the version of the API used to make such call. If not present during a
+          # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+          # calls will always return a valid version, even if the subscription was
+          # created without this attribute.
+          #
+          # The possible values for this attribute are:
+          #
+          # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+          # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
         "a_key": "A String",
       },
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="pull">pull(subscription, body, x__xgafv=None)</code>
-  <pre>Pulls messages from the server. Returns an empty list if there are no messages available in the backlog. The server may return `UNAVAILABLE` if there are too many concurrent pull requests pending for the given subscription.
+    <code class="details" id="pull">pull(subscription=None, body, x__xgafv=None)</code>
+  <pre>Pulls messages from the server. Returns an empty list if there are no
+messages available in the backlog. The server may return `UNAVAILABLE` if
+there are too many concurrent pull requests pending for the given
+subscription.
 
 Args:
-  subscription: string, The subscription from which messages should be pulled. (required)
+  subscription: string, The subscription from which messages should be pulled.
+Format is `projects/{project}/subscriptions/{sub}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the `Pull` method.
-    "returnImmediately": True or False, # If this is specified as true the system will respond immediately even if it is not able to return a message in the `Pull` response. Otherwise the system is allowed to wait until at least one message is available rather than returning no messages. The client may cancel the request if it does not wish to wait any longer for the response.
-    "maxMessages": 42, # The maximum number of messages returned for this request. The Pub/Sub system may return fewer than the number specified.
+    "returnImmediately": True or False, # If this field set to true, the system will respond immediately even if
+        # it there are no messages available to return in the `Pull` response.
+        # Otherwise, the system may wait (for a bounded amount of time) until at
+        # least one message is available, rather than returning no messages. The
+        # client may cancel the request if it does not wish to wait any longer for
+        # the response.
+    "maxMessages": 42, # The maximum number of messages returned for this request. The Pub/Sub
+        # system may return fewer than the number specified.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `Pull` method.
-    "receivedMessages": [ # Received Pub/Sub messages. The Pub/Sub system will return zero messages if there are no more available in the backlog. The Pub/Sub system may return fewer than the `maxMessages` requested even if there are more messages available in the backlog.
+    "receivedMessages": [ # Received Pub/Sub messages. The Pub/Sub system will return zero messages if
+        # there are no more available in the backlog. The Pub/Sub system may return
+        # fewer than the `maxMessages` requested even if there are more messages
+        # available in the backlog.
       { # A message and its corresponding acknowledgment ID.
         "ackId": "A String", # This ID can be used to acknowledge the received message.
-        "message": { # A message data and its attributes. The message payload must not be empty; it must contain either a non-empty data field, or at least one attribute. # The message.
+        "message": { # A message data and its attributes. The message payload must not be empty; # The message.
+            # it must contain either a non-empty data field, or at least one attribute.
           "attributes": { # Optional attributes for this message.
             "a_key": "A String",
           },
-          "data": "A String", # The message payload. For JSON requests, the value of this field must be [base64-encoded](https://tools.ietf.org/html/rfc4648).
-          "publishTime": "A String", # The time at which the message was published, populated by the server when it receives the `Publish` call. It must not be populated by the publisher in a `Publish` call.
-          "messageId": "A String", # ID of this message, assigned by the server when the message is published. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a `PubsubMessage` via a `Pull` call or a push delivery. It must not be populated by the publisher in a `Publish` call.
+          "data": "A String", # The message payload.
+          "publishTime": "A String", # The time at which the message was published, populated by the server when
+              # it receives the `Publish` call. It must not be populated by the
+              # publisher in a `Publish` call.
+          "messageId": "A String", # ID of this message, assigned by the server when the message is published.
+              # Guaranteed to be unique within the topic. This value may be read by a
+              # subscriber that receives a `PubsubMessage` via a `Pull` call or a push
+              # delivery. It must not be populated by the publisher in a `Publish` call.
         },
       },
     ],
@@ -372,70 +795,218 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the access control policy on the specified resource. Replaces any existing policy.
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the access control policy on the specified resource. Replaces any
+existing policy.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
   <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
diff --git a/docs/dyn/pubsub_v1.projects.topics.html b/docs/dyn/pubsub_v1.projects.topics.html
index 0d960fae3c2..026d91b0af2 100644
--- a/docs/dyn/pubsub_v1.projects.topics.html
+++ b/docs/dyn/pubsub_v1.projects.topics.html
@@ -80,130 +80,256 @@ <h2>Instance Methods</h2>
 <p class="firstline">Returns the subscriptions Resource.</p>
 
 <p class="toc_element">
-  <code><a href="#create">create(name, body, x__xgafv=None)</a></code></p>
+  <code><a href="#create">create(name=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Creates the given topic with the given name.</p>
 <p class="toc_element">
-  <code><a href="#delete">delete(topic, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes the topic with the given name. Returns `NOT_FOUND` if the topic does not exist. After a topic is deleted, a new topic may be created with the same name; this is an entirely new topic with none of the old configuration or subscriptions. Existing subscriptions to this topic are not deleted, but their `topic` field is set to `_deleted-topic_`.</p>
+  <code><a href="#delete">delete(topic=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Deletes the topic with the given name. Returns `NOT_FOUND` if the topic</p>
 <p class="toc_element">
-  <code><a href="#get">get(topic, x__xgafv=None)</a></code></p>
+  <code><a href="#get">get(topic=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the configuration of a topic.</p>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.</p>
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the access control policy for a resource.</p>
 <p class="toc_element">
-  <code><a href="#list">list(project, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(project=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists matching topics.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#publish">publish(topic, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic does not exist. The message payload must not be empty; it must contain either a non-empty data field, or at least one attribute.</p>
+  <code><a href="#publish">publish(topic=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy.</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the access control policy on the specified resource. Replaces any</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(name, body, x__xgafv=None)</code>
+    <code class="details" id="create">create(name=None, body, x__xgafv=None)</code>
   <pre>Creates the given topic with the given name.
 
 Args:
-  name: string, The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`. (required)
+  name: string, The name of the topic. It must have the format
+`"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+signs (`%`). It must be between 3 and 255 characters in length, and it
+must not start with `"goog"`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # A topic resource.
-  "name": "A String", # The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+  "name": "A String", # The name of the topic. It must have the format
+      # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+      # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+      # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+      # signs (`%`). It must be between 3 and 255 characters in length, and it
+      # must not start with `"goog"`.
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A topic resource.
-    "name": "A String", # The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+    "name": "A String", # The name of the topic. It must have the format
+        # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+        # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+        # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+        # signs (`%`). It must be between 3 and 255 characters in length, and it
+        # must not start with `"goog"`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="delete">delete(topic, x__xgafv=None)</code>
-  <pre>Deletes the topic with the given name. Returns `NOT_FOUND` if the topic does not exist. After a topic is deleted, a new topic may be created with the same name; this is an entirely new topic with none of the old configuration or subscriptions. Existing subscriptions to this topic are not deleted, but their `topic` field is set to `_deleted-topic_`.
+    <code class="details" id="delete">delete(topic=None, x__xgafv=None)</code>
+  <pre>Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
+does not exist. After a topic is deleted, a new topic may be created with
+the same name; this is an entirely new topic with none of the old
+configuration or subscriptions. Existing subscriptions to this topic are
+not deleted, but their `topic` field is set to `_deleted-topic_`.
 
 Args:
-  topic: string, Name of the topic to delete. (required)
+  topic: string, Name of the topic to delete.
+Format is `projects/{project}/topics/{topic}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="get">get(topic, x__xgafv=None)</code>
+    <code class="details" id="get">get(topic=None, x__xgafv=None)</code>
   <pre>Gets the configuration of a topic.
 
 Args:
-  topic: string, The name of the topic to get. (required)
+  topic: string, The name of the topic to get.
+Format is `projects/{project}/topics/{topic}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A topic resource.
-    "name": "A String", # The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+    "name": "A String", # The name of the topic. It must have the format
+        # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+        # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+        # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+        # signs (`%`). It must be between 3 and 255 characters in length, and it
+        # must not start with `"goog"`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, x__xgafv=None)</code>
-  <pre>Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</code>
+  <pre>Gets the access control policy for a resource.
+Returns an empty policy if the resource exists and does not have a policy
+set.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(project, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(project=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
   <pre>Lists matching topics.
 
 Args:
-  project: string, The name of the cloud project that topics belong to. (required)
+  project: string, The name of the cloud project that topics belong to.
+Format is `projects/{project}`. (required)
   pageSize: integer, Maximum number of topics to return.
-  pageToken: string, The value returned by the last `ListTopicsResponse`; indicates that this is a continuation of a prior `ListTopics` call, and that the system should return the next page of data.
+  pageToken: string, The value returned by the last `ListTopicsResponse`; indicates that this is
+a continuation of a prior `ListTopics` call, and that the system should
+return the next page of data.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `ListTopics` method.
-    "nextPageToken": "A String", # If not empty, indicates that there may be more topics that match the request; this value should be passed in a new `ListTopicsRequest`.
+    "nextPageToken": "A String", # If not empty, indicates that there may be more topics that match the
+        # request; this value should be passed in a new `ListTopicsRequest`.
     "topics": [ # The resulting topics.
       { # A topic resource.
-        "name": "A String", # The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+        "name": "A String", # The name of the topic. It must have the format
+            # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+            # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+            # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+            # signs (`%`). It must be between 3 and 255 characters in length, and it
+            # must not start with `"goog"`.
       },
     ],
   }</pre>
@@ -224,104 +350,266 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="publish">publish(topic, body, x__xgafv=None)</code>
-  <pre>Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic does not exist. The message payload must not be empty; it must contain either a non-empty data field, or at least one attribute.
+    <code class="details" id="publish">publish(topic=None, body, x__xgafv=None)</code>
+  <pre>Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
+does not exist. The message payload must not be empty; it must contain
+ either a non-empty data field, or at least one attribute.
 
 Args:
-  topic: string, The messages in the request will be published on this topic. (required)
+  topic: string, The messages in the request will be published on this topic.
+Format is `projects/{project}/topics/{topic}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the Publish method.
     "messages": [ # The messages to publish.
-      { # A message data and its attributes. The message payload must not be empty; it must contain either a non-empty data field, or at least one attribute.
+      { # A message data and its attributes. The message payload must not be empty;
+          # it must contain either a non-empty data field, or at least one attribute.
         "attributes": { # Optional attributes for this message.
           "a_key": "A String",
         },
-        "data": "A String", # The message payload. For JSON requests, the value of this field must be [base64-encoded](https://tools.ietf.org/html/rfc4648).
-        "publishTime": "A String", # The time at which the message was published, populated by the server when it receives the `Publish` call. It must not be populated by the publisher in a `Publish` call.
-        "messageId": "A String", # ID of this message, assigned by the server when the message is published. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a `PubsubMessage` via a `Pull` call or a push delivery. It must not be populated by the publisher in a `Publish` call.
+        "data": "A String", # The message payload.
+        "publishTime": "A String", # The time at which the message was published, populated by the server when
+            # it receives the `Publish` call. It must not be populated by the
+            # publisher in a `Publish` call.
+        "messageId": "A String", # ID of this message, assigned by the server when the message is published.
+            # Guaranteed to be unique within the topic. This value may be read by a
+            # subscriber that receives a `PubsubMessage` via a `Pull` call or a push
+            # delivery. It must not be populated by the publisher in a `Publish` call.
       },
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `Publish` method.
-    "messageIds": [ # The server-assigned ID of each published message, in the same order as the messages in the request. IDs are guaranteed to be unique within the topic.
+    "messageIds": [ # The server-assigned ID of each published message, in the same order as
+        # the messages in the request. IDs are guaranteed to be unique within
+        # the topic.
       "A String",
     ],
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the access control policy on the specified resource. Replaces any existing policy.
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the access control policy on the specified resource. Replaces any
+existing policy.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
   <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
diff --git a/docs/dyn/pubsub_v1.projects.topics.subscriptions.html b/docs/dyn/pubsub_v1.projects.topics.subscriptions.html
index 02b2b2f6c7d..c89540cf930 100644
--- a/docs/dyn/pubsub_v1.projects.topics.subscriptions.html
+++ b/docs/dyn/pubsub_v1.projects.topics.subscriptions.html
@@ -75,27 +75,35 @@
 <h1><a href="pubsub_v1.html">Google Cloud Pub/Sub API</a> . <a href="pubsub_v1.projects.html">projects</a> . <a href="pubsub_v1.projects.topics.html">topics</a> . <a href="pubsub_v1.projects.topics.subscriptions.html">subscriptions</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#list">list(topic, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(topic=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists the name of the subscriptions for this topic.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="list">list(topic, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(topic=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
   <pre>Lists the name of the subscriptions for this topic.
 
 Args:
-  topic: string, The name of the topic that subscriptions are attached to. (required)
+  topic: string, The name of the topic that subscriptions are attached to.
+Format is `projects/{project}/topics/{topic}`. (required)
   pageSize: integer, Maximum number of subscription names to return.
-  pageToken: string, The value returned by the last `ListTopicSubscriptionsResponse`; indicates that this is a continuation of a prior `ListTopicSubscriptions` call, and that the system should return the next page of data.
+  pageToken: string, The value returned by the last `ListTopicSubscriptionsResponse`; indicates
+that this is a continuation of a prior `ListTopicSubscriptions` call, and
+that the system should return the next page of data.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `ListTopicSubscriptions` method.
-    "nextPageToken": "A String", # If not empty, indicates that there may be more subscriptions that match the request; this value should be passed in a new `ListTopicSubscriptionsRequest` to get more subscriptions.
+    "nextPageToken": "A String", # If not empty, indicates that there may be more subscriptions that match
+        # the request; this value should be passed in a new
+        # `ListTopicSubscriptionsRequest` to get more subscriptions.
     "subscriptions": [ # The names of the subscriptions that match the request.
       "A String",
     ],
diff --git a/docs/dyn/pubsub_v1beta1a.subscriptions.html b/docs/dyn/pubsub_v1beta1a.subscriptions.html
index cdd1712f45c..92a10ca820e 100644
--- a/docs/dyn/pubsub_v1beta1a.subscriptions.html
+++ b/docs/dyn/pubsub_v1beta1a.subscriptions.html
@@ -76,13 +76,13 @@ <h1><a href="pubsub_v1beta1a.html">Google Cloud Pub/Sub API</a> . <a href="pubsu
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#acknowledge">acknowledge(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Acknowledges a particular received message: the Pub/Sub system can remove the given message from the subscription. Acknowledging a message whose Ack deadline has expired may succeed, but the message could have been already redelivered. Acknowledging a message more than once will not result in an error. This is only used for messages received via pull.</p>
+<p class="firstline">Acknowledges a particular received message: the Pub/Sub system can remove</p>
 <p class="toc_element">
   <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a subscription on a given topic for a given subscriber. If the subscription already exists, returns ALREADY_EXISTS. If the corresponding topic doesn't exist, returns NOT_FOUND. If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic.</p>
+<p class="firstline">Creates a subscription on a given topic for a given subscriber.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(subscription, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes an existing subscription. All pending messages in the subscription are immediately dropped. Calls to Pull after deletion will return NOT_FOUND.</p>
+<p class="firstline">Deletes an existing subscription. All pending messages in the subscription</p>
 <p class="toc_element">
   <code><a href="#get">get(subscription, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the configuration details of a subscription.</p>
@@ -97,41 +97,67 @@ <h2>Instance Methods</h2>
 <p class="firstline">Modifies the Ack deadline for a message received from a pull request.</p>
 <p class="toc_element">
   <code><a href="#modifyPushConfig">modifyPushConfig(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Modifies the PushConfig for a specified subscription. This method can be used to suspend the flow of messages to an endpoint by clearing the PushConfig field in the request. Messages will be accumulated for delivery even if no push configuration is defined or while the configuration is modified.</p>
+<p class="firstline">Modifies the <code>PushConfig</code> for a specified subscription.</p>
 <p class="toc_element">
   <code><a href="#pull">pull(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Pulls a single message from the server. If return_immediately is true, and no messages are available in the subscription, this method returns FAILED_PRECONDITION. The system is free to return an UNAVAILABLE error if no messages are available in a reasonable amount of time (to reduce system load).</p>
+<p class="firstline">Pulls a single message from the server.</p>
 <p class="toc_element">
   <code><a href="#pullBatch">pullBatch(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Pulls messages from the server. Returns an empty list if there are no messages available in the backlog. The system is free to return UNAVAILABLE if there are too many pull requests outstanding for the given subscription.</p>
+<p class="firstline">Pulls messages from the server. Returns an empty list if there are no</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="acknowledge">acknowledge(body, x__xgafv=None)</code>
-  <pre>Acknowledges a particular received message: the Pub/Sub system can remove the given message from the subscription. Acknowledging a message whose Ack deadline has expired may succeed, but the message could have been already redelivered. Acknowledging a message more than once will not result in an error. This is only used for messages received via pull.
+  <pre>Acknowledges a particular received message: the Pub/Sub system can remove
+the given message from the subscription. Acknowledging a message whose
+Ack deadline has expired may succeed, but the message could have been
+already redelivered. Acknowledging a message more than once will not
+result in an error. This is only used for messages received via pull.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the Acknowledge method.
-    "ackId": [ # The acknowledgment ID for the message being acknowledged. This was returned by the Pub/Sub system in the Pull response.
+    "ackId": [ # The acknowledgment ID for the message being acknowledged. This was
+        # returned by the Pub/Sub system in the Pull response.
       "A String",
     ],
     "subscription": "A String", # The subscription whose message is being acknowledged.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # An empty message that you can re-use to avoid defining duplicated empty messages in your project. A typical example is to use it as argument or the return value of a service API. For instance: service Foo { rpc Bar (proto2.Empty) returns (proto2.Empty) { }; }; BEGIN GOOGLE-INTERNAL The difference between this one and net/rpc/empty-message.proto is that 1) The generated message here is in proto2 C++ API. 2) The proto2.Empty has minimum dependencies (no message_set or net/rpc dependencies) END GOOGLE-INTERNAL
+    { # An empty message that you can re-use to avoid defining duplicated empty
+      # messages in your project. A typical example is to use it as argument or the
+      # return value of a service API. For instance:
+      #
+      #   service Foo {
+      #     rpc Bar (proto2.Empty) returns (proto2.Empty) { };
+      #   };
+      #
+      # BEGIN GOOGLE-INTERNAL
+      # The difference between this one and net/rpc/empty-message.proto is that
+      # 1) The generated message here is in proto2 C++ API.
+      # 2) The proto2.Empty has minimum dependencies
+      #    (no message_set or net/rpc dependencies)
+      # END GOOGLE-INTERNAL
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="create">create(body, x__xgafv=None)</code>
-  <pre>Creates a subscription on a given topic for a given subscriber. If the subscription already exists, returns ALREADY_EXISTS. If the corresponding topic doesn't exist, returns NOT_FOUND. If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic.
+  <pre>Creates a subscription on a given topic for a given subscriber.
+If the subscription already exists, returns ALREADY_EXISTS.
+If the corresponding topic doesn't exist, returns NOT_FOUND.
+
+If the name is not provided in the request, the server will assign a random
+name for this subscription on the same project as the topic.
 
 Args:
   body: object, The request body. (required)
@@ -139,23 +165,66 @@ <h3>Method Details</h3>
 
 { # A subscription resource.
   "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-  "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a subscriber receives a message before the subscriber should acknowledge or Nack the message. If the Ack deadline for a message passes without an Ack or a Nack, the Pub/Sub system will eventually redeliver the message. If a subscriber acknowledges after the deadline, the Pub/Sub system may accept the Ack, but it is possible that the message has been already delivered again. Multiple Acks to the message are allowed and will succeed. For push delivery, this value is used to set the request timeout for the call to the push endpoint. For pull delivery, this value is used as the initial value for the Ack deadline. It may be overridden for each message using its corresponding ack_id with ModifyAckDeadline. While a message is outstanding (i.e. it has been delivered to a pull subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub system will not deliver that message to another pull subscriber (on a best-effort basis).
-  "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it.
-    "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+  "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
+      # subscriber receives a message before the subscriber should acknowledge or
+      # Nack the message. If the Ack deadline for a message passes without an
+      # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
+      # If a subscriber acknowledges after the deadline, the Pub/Sub system may
+      # accept the Ack, but it is possible that the message has been already
+      # delivered again. Multiple Acks to the message are allowed and will
+      # succeed.
+      # 
+      # For push delivery, this value is used to set the request timeout for
+      # the call to the push endpoint.
+      # 
+      # For pull delivery, this value is used as the initial value for the Ack
+      # deadline. It may be overridden for each message using its corresponding
+      # ack_id with <code>ModifyAckDeadline</code>.
+      # While a message is outstanding (i.e. it has been delivered to a pull
+      # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
+      # system will not deliver that message to another pull subscriber
+      # (on a best-effort basis).
+  "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+      # used to configure it.
+    "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+        # For example, a Webhook endpoint might use "https://example.com/push".
   },
   "name": "A String", # Name of the subscription.
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A subscription resource.
     "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-    "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a subscriber receives a message before the subscriber should acknowledge or Nack the message. If the Ack deadline for a message passes without an Ack or a Nack, the Pub/Sub system will eventually redeliver the message. If a subscriber acknowledges after the deadline, the Pub/Sub system may accept the Ack, but it is possible that the message has been already delivered again. Multiple Acks to the message are allowed and will succeed. For push delivery, this value is used to set the request timeout for the call to the push endpoint. For pull delivery, this value is used as the initial value for the Ack deadline. It may be overridden for each message using its corresponding ack_id with ModifyAckDeadline. While a message is outstanding (i.e. it has been delivered to a pull subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub system will not deliver that message to another pull subscriber (on a best-effort basis).
-    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it.
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+    "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
+        # subscriber receives a message before the subscriber should acknowledge or
+        # Nack the message. If the Ack deadline for a message passes without an
+        # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
+        # If a subscriber acknowledges after the deadline, the Pub/Sub system may
+        # accept the Ack, but it is possible that the message has been already
+        # delivered again. Multiple Acks to the message are allowed and will
+        # succeed.
+        #
+        # For push delivery, this value is used to set the request timeout for
+        # the call to the push endpoint.
+        #
+        # For pull delivery, this value is used as the initial value for the Ack
+        # deadline. It may be overridden for each message using its corresponding
+        # ack_id with <code>ModifyAckDeadline</code>.
+        # While a message is outstanding (i.e. it has been delivered to a pull
+        # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
+        # system will not deliver that message to another pull subscriber
+        # (on a best-effort basis).
+    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+        # used to configure it.
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
     "name": "A String", # Name of the subscription.
   }</pre>
@@ -163,16 +232,34 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="delete">delete(subscription, x__xgafv=None)</code>
-  <pre>Deletes an existing subscription. All pending messages in the subscription are immediately dropped. Calls to Pull after deletion will return NOT_FOUND.
+  <pre>Deletes an existing subscription. All pending messages in the subscription
+are immediately dropped. Calls to Pull after deletion will return
+NOT_FOUND.
 
 Args:
   subscription: string, The subscription to delete. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # An empty message that you can re-use to avoid defining duplicated empty messages in your project. A typical example is to use it as argument or the return value of a service API. For instance: service Foo { rpc Bar (proto2.Empty) returns (proto2.Empty) { }; }; BEGIN GOOGLE-INTERNAL The difference between this one and net/rpc/empty-message.proto is that 1) The generated message here is in proto2 C++ API. 2) The proto2.Empty has minimum dependencies (no message_set or net/rpc dependencies) END GOOGLE-INTERNAL
+    { # An empty message that you can re-use to avoid defining duplicated empty
+      # messages in your project. A typical example is to use it as argument or the
+      # return value of a service API. For instance:
+      #
+      #   service Foo {
+      #     rpc Bar (proto2.Empty) returns (proto2.Empty) { };
+      #   };
+      #
+      # BEGIN GOOGLE-INTERNAL
+      # The difference between this one and net/rpc/empty-message.proto is that
+      # 1) The generated message here is in proto2 C++ API.
+      # 2) The proto2.Empty has minimum dependencies
+      #    (no message_set or net/rpc dependencies)
+      # END GOOGLE-INTERNAL
   }</pre>
 </div>
 
@@ -183,15 +270,38 @@ <h3>Method Details</h3>
 Args:
   subscription: string, The name of the subscription to get. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A subscription resource.
     "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-    "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a subscriber receives a message before the subscriber should acknowledge or Nack the message. If the Ack deadline for a message passes without an Ack or a Nack, the Pub/Sub system will eventually redeliver the message. If a subscriber acknowledges after the deadline, the Pub/Sub system may accept the Ack, but it is possible that the message has been already delivered again. Multiple Acks to the message are allowed and will succeed. For push delivery, this value is used to set the request timeout for the call to the push endpoint. For pull delivery, this value is used as the initial value for the Ack deadline. It may be overridden for each message using its corresponding ack_id with ModifyAckDeadline. While a message is outstanding (i.e. it has been delivered to a pull subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub system will not deliver that message to another pull subscriber (on a best-effort basis).
-    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it.
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+    "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
+        # subscriber receives a message before the subscriber should acknowledge or
+        # Nack the message. If the Ack deadline for a message passes without an
+        # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
+        # If a subscriber acknowledges after the deadline, the Pub/Sub system may
+        # accept the Ack, but it is possible that the message has been already
+        # delivered again. Multiple Acks to the message are allowed and will
+        # succeed.
+        #
+        # For push delivery, this value is used to set the request timeout for
+        # the call to the push endpoint.
+        #
+        # For pull delivery, this value is used as the initial value for the Ack
+        # deadline. It may be overridden for each message using its corresponding
+        # ack_id with <code>ModifyAckDeadline</code>.
+        # While a message is outstanding (i.e. it has been delivered to a pull
+        # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
+        # system will not deliver that message to another pull subscriber
+        # (on a best-effort basis).
+    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+        # used to configure it.
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
     "name": "A String", # Name of the subscription.
   }</pre>
@@ -203,21 +313,47 @@ <h3>Method Details</h3>
 
 Args:
   maxResults: integer, Maximum number of subscriptions to return.
-  pageToken: string, The value obtained in the last ListSubscriptionsResponse for continuation.
+  pageToken: string, The value obtained in the last <code>ListSubscriptionsResponse</code>
+for continuation.
   query: string, A valid label query expression.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the ListSubscriptions method.
-    "nextPageToken": "A String", # If not empty, indicates that there are more subscriptions that match the request and this value should be passed to the next ListSubscriptionsRequest to continue.
+    "nextPageToken": "A String", # If not empty, indicates that there are more subscriptions that match the
+        # request and this value should be passed to the next
+        # <code>ListSubscriptionsRequest</code> to continue.
     "subscription": [ # The subscriptions that match the request.
       { # A subscription resource.
         "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-        "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a subscriber receives a message before the subscriber should acknowledge or Nack the message. If the Ack deadline for a message passes without an Ack or a Nack, the Pub/Sub system will eventually redeliver the message. If a subscriber acknowledges after the deadline, the Pub/Sub system may accept the Ack, but it is possible that the message has been already delivered again. Multiple Acks to the message are allowed and will succeed. For push delivery, this value is used to set the request timeout for the call to the push endpoint. For pull delivery, this value is used as the initial value for the Ack deadline. It may be overridden for each message using its corresponding ack_id with ModifyAckDeadline. While a message is outstanding (i.e. it has been delivered to a pull subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub system will not deliver that message to another pull subscriber (on a best-effort basis).
-        "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it.
-          "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+        "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
+            # subscriber receives a message before the subscriber should acknowledge or
+            # Nack the message. If the Ack deadline for a message passes without an
+            # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
+            # If a subscriber acknowledges after the deadline, the Pub/Sub system may
+            # accept the Ack, but it is possible that the message has been already
+            # delivered again. Multiple Acks to the message are allowed and will
+            # succeed.
+            #
+            # For push delivery, this value is used to set the request timeout for
+            # the call to the push endpoint.
+            #
+            # For pull delivery, this value is used as the initial value for the Ack
+            # deadline. It may be overridden for each message using its corresponding
+            # ack_id with <code>ModifyAckDeadline</code>.
+            # While a message is outstanding (i.e. it has been delivered to a pull
+            # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
+            # system will not deliver that message to another pull subscriber
+            # (on a best-effort basis).
+        "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+            # used to configure it.
+          "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+              # For example, a Webhook endpoint might use "https://example.com/push".
         },
         "name": "A String", # Name of the subscription.
       },
@@ -248,82 +384,163 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Request for the ModifyAckDeadline method.
-    "ackDeadlineSeconds": 42, # The new ack deadline with respect to the time this request was sent to the Pub/Sub system. Must be >= 0. For example, if the value is 10, the new ack deadline will expire 10 seconds after the ModifyAckDeadline call was made. Specifying zero may immediately make the message available for another pull request.
-    "ackId": "A String", # The acknowledgment ID. Either this or ack_ids must be populated, not both.
-    "ackIds": [ # List of acknowledgment IDs. Either this field or ack_id should be populated, not both.
+    "ackDeadlineSeconds": 42, # The new ack deadline with respect to the time this request was sent to the
+        # Pub/Sub system. Must be >= 0. For example, if the value is 10, the new ack
+        # deadline will expire 10 seconds after the ModifyAckDeadline call was made.
+        # Specifying zero may immediately make the message available for another pull
+        # request.
+    "ackId": "A String", # The acknowledgment ID. Either this or ack_ids must be populated,
+        # not both.
+    "ackIds": [ # List of acknowledgment IDs. Either this field or ack_id
+        # should be populated, not both.
       "A String",
     ],
-    "subscription": "A String", # Next Index: 5 The name of the subscription from which messages are being pulled.
+    "subscription": "A String", # Next Index: 5
+        # The name of the subscription from which messages are being pulled.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # An empty message that you can re-use to avoid defining duplicated empty messages in your project. A typical example is to use it as argument or the return value of a service API. For instance: service Foo { rpc Bar (proto2.Empty) returns (proto2.Empty) { }; }; BEGIN GOOGLE-INTERNAL The difference between this one and net/rpc/empty-message.proto is that 1) The generated message here is in proto2 C++ API. 2) The proto2.Empty has minimum dependencies (no message_set or net/rpc dependencies) END GOOGLE-INTERNAL
+    { # An empty message that you can re-use to avoid defining duplicated empty
+      # messages in your project. A typical example is to use it as argument or the
+      # return value of a service API. For instance:
+      #
+      #   service Foo {
+      #     rpc Bar (proto2.Empty) returns (proto2.Empty) { };
+      #   };
+      #
+      # BEGIN GOOGLE-INTERNAL
+      # The difference between this one and net/rpc/empty-message.proto is that
+      # 1) The generated message here is in proto2 C++ API.
+      # 2) The proto2.Empty has minimum dependencies
+      #    (no message_set or net/rpc dependencies)
+      # END GOOGLE-INTERNAL
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="modifyPushConfig">modifyPushConfig(body, x__xgafv=None)</code>
-  <pre>Modifies the PushConfig for a specified subscription. This method can be used to suspend the flow of messages to an endpoint by clearing the PushConfig field in the request. Messages will be accumulated for delivery even if no push configuration is defined or while the configuration is modified.
+  <pre>Modifies the <code>PushConfig</code> for a specified subscription.
+This method can be used to suspend the flow of messages to an endpoint
+by clearing the <code>PushConfig</code> field in the request. Messages
+will be accumulated for delivery even if no push configuration is
+defined or while the configuration is modified.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the ModifyPushConfig method.
-    "pushConfig": { # Configuration for a push delivery endpoint. # An empty push_config indicates that the Pub/Sub system should pause pushing messages from the given subscription.
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+    "pushConfig": { # Configuration for a push delivery endpoint. # An empty <code>push_config</code> indicates that the Pub/Sub system should
+        # pause pushing messages from the given subscription.
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
     "subscription": "A String", # The name of the subscription.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # An empty message that you can re-use to avoid defining duplicated empty messages in your project. A typical example is to use it as argument or the return value of a service API. For instance: service Foo { rpc Bar (proto2.Empty) returns (proto2.Empty) { }; }; BEGIN GOOGLE-INTERNAL The difference between this one and net/rpc/empty-message.proto is that 1) The generated message here is in proto2 C++ API. 2) The proto2.Empty has minimum dependencies (no message_set or net/rpc dependencies) END GOOGLE-INTERNAL
+    { # An empty message that you can re-use to avoid defining duplicated empty
+      # messages in your project. A typical example is to use it as argument or the
+      # return value of a service API. For instance:
+      #
+      #   service Foo {
+      #     rpc Bar (proto2.Empty) returns (proto2.Empty) { };
+      #   };
+      #
+      # BEGIN GOOGLE-INTERNAL
+      # The difference between this one and net/rpc/empty-message.proto is that
+      # 1) The generated message here is in proto2 C++ API.
+      # 2) The proto2.Empty has minimum dependencies
+      #    (no message_set or net/rpc dependencies)
+      # END GOOGLE-INTERNAL
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="pull">pull(body, x__xgafv=None)</code>
-  <pre>Pulls a single message from the server. If return_immediately is true, and no messages are available in the subscription, this method returns FAILED_PRECONDITION. The system is free to return an UNAVAILABLE error if no messages are available in a reasonable amount of time (to reduce system load).
+  <pre>Pulls a single message from the server.
+If return_immediately is true, and no messages are available in the
+subscription, this method returns FAILED_PRECONDITION. The system is free
+to return an UNAVAILABLE error if no messages are available in a
+reasonable amount of time (to reduce system load).
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the Pull method.
-    "returnImmediately": True or False, # If this is specified as true the system will respond immediately even if it is not able to return a message in the Pull response. Otherwise the system is allowed to wait until at least one message is available rather than returning FAILED_PRECONDITION. The client may cancel the request if it does not wish to wait any longer for the response.
+    "returnImmediately": True or False, # If this is specified as true the system will respond immediately even if
+        # it is not able to return a message in the Pull response. Otherwise the
+        # system is allowed to wait until at least one message is available rather
+        # than returning FAILED_PRECONDITION. The client may cancel the request if
+        # it does not wish to wait any longer for the response.
     "subscription": "A String", # The subscription from which a message should be pulled.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Either a PubsubMessage or a truncation event. One of these two must be populated.
+    { # Either a <code>PubsubMessage</code> or a truncation event. One of these two
+      # must be populated.
     "pubsubEvent": { # An event indicating a received message or truncation event. # A pubsub message or truncation event.
-      "deleted": True or False, # Indicates that this subscription has been deleted. (Note that pull subscribers will always receive NOT_FOUND in response in their pull request on the subscription, rather than seeing this boolean.)
+      "deleted": True or False, # Indicates that this subscription has been deleted. (Note that pull
+          # subscribers will always receive NOT_FOUND in response in their pull
+          # request on the subscription, rather than seeing this boolean.)
       "message": { # A message data and its labels. # A received message.
-        "messageId": "A String", # ID of this message assigned by the server at publication time. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a PubsubMessage via a Pull call or a push delivery. It must not be populated by a publisher in a Publish call.
-        "data": "A String", # The message payload.
-        "publishTime": "A String", # The time at which the message was published. The time is milliseconds since the UNIX epoch.
-        "label": [ # Optional list of labels for this message. Keys in this collection must be unique.
+        "label": [ # Optional list of labels for this message. Keys in this collection must
+            # be unique.
           { # A key-value pair applied to a given object.
             "numValue": "A String", # An integer value.
             "strValue": "A String", # A string value.
-            "key": "A String", # The key of a label is a syntactically valid URL (as per RFC 1738) with the "scheme" and initial slashes omitted and with the additional restrictions noted below. Each key should be globally unique. The "host" portion is called the "namespace" and is not necessarily resolvable to a network endpoint. Instead, the namespace indicates what system or entity defines the semantics of the label. Namespaces do not restrict the set of objects to which a label may be associated. Keys are defined by the following grammar: key = hostname "/" kpath kpath = ksegment *[ "/" ksegment ] ksegment = alphadigit | *[ alphadigit | "-" | "_" | "." ] where "hostname" and "alphadigit" are defined as in RFC 1738. Example key: spanner.google.com/universe
+            "key": "A String", # The key of a label is a syntactically valid URL (as per RFC 1738) with
+                # the "scheme" and initial slashes omitted and with the additional
+                # restrictions noted below.  Each key should be globally unique.  The
+                # "host" portion is called the "namespace" and is not necessarily
+                # resolvable to a network endpoint.  Instead, the namespace indicates what
+                # system or entity defines the semantics of the label.  Namespaces do not
+                # restrict the set of objects to which a label may be associated.
+                #
+                # Keys are defined by the following grammar:
+                #
+                #   key          = hostname "/" kpath
+                #   kpath        = ksegment *[ "/" ksegment ]
+                #   ksegment     = alphadigit | *[ alphadigit | "-" | "_" | "." ]
+                #
+                # where "hostname" and "alphadigit" are defined as in RFC 1738.
+                #
+                # Example key:
+                #   spanner.google.com/universe
           },
         ],
+        "data": "A String", # The message payload.
+        "publishTime": "A String", # The time at which the message was published.
+            # The time is milliseconds since the UNIX epoch.
+        "messageId": "A String", # ID of this message assigned by the server at publication time. Guaranteed
+            # to be unique within the topic. This value may be read by a subscriber
+            # that receives a PubsubMessage via a Pull call or a push delivery. It must
+            # not be populated by a publisher in a Publish call.
       },
-      "truncated": True or False, # Indicates that this subscription has been truncated.
       "subscription": "A String", # The subscription that received the event.
+      "truncated": True or False, # Indicates that this subscription has been truncated.
     },
     "ackId": "A String", # This ID must be used to acknowledge the received event or message.
   }</pre>
@@ -331,42 +548,80 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="pullBatch">pullBatch(body, x__xgafv=None)</code>
-  <pre>Pulls messages from the server. Returns an empty list if there are no messages available in the backlog. The system is free to return UNAVAILABLE if there are too many pull requests outstanding for the given subscription.
+  <pre>Pulls messages from the server. Returns an empty list if there are no
+messages available in the backlog. The system is free to return UNAVAILABLE
+if there are too many pull requests outstanding for the given subscription.
 
 Args:
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request for the PullBatch method.
-    "maxEvents": 42, # The maximum number of PubsubEvents returned for this request. The Pub/Sub system may return fewer than the number of events specified.
-    "returnImmediately": True or False, # If this is specified as true the system will respond immediately even if it is not able to return a message in the Pull response. Otherwise the system is allowed to wait until at least one message is available rather than returning no messages. The client may cancel the request if it does not wish to wait any longer for the response.
+    "maxEvents": 42, # The maximum number of PubsubEvents returned for this request. The Pub/Sub
+        # system may return fewer than the number of events specified.
+    "returnImmediately": True or False, # If this is specified as true the system will respond immediately even if
+        # it is not able to return a message in the Pull response. Otherwise the
+        # system is allowed to wait until at least one message is available rather
+        # than returning no messages. The client may cancel the request if it does
+        # not wish to wait any longer for the response.
     "subscription": "A String", # The subscription from which messages should be pulled.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the PullBatch method.
-    "pullResponses": [ # Received Pub/Sub messages or status events. The Pub/Sub system will return zero messages if there are no more messages available in the backlog. The Pub/Sub system may return fewer than the max_events requested even if there are more messages available in the backlog.
-      { # Either a PubsubMessage or a truncation event. One of these two must be populated.
+    "pullResponses": [ # Received Pub/Sub messages or status events. The Pub/Sub system will return
+        # zero messages if there are no more messages available in the backlog. The
+        # Pub/Sub system may return fewer than the max_events requested even if
+        # there are more messages available in the backlog.
+      { # Either a <code>PubsubMessage</code> or a truncation event. One of these two
+          # must be populated.
         "pubsubEvent": { # An event indicating a received message or truncation event. # A pubsub message or truncation event.
-          "deleted": True or False, # Indicates that this subscription has been deleted. (Note that pull subscribers will always receive NOT_FOUND in response in their pull request on the subscription, rather than seeing this boolean.)
+          "deleted": True or False, # Indicates that this subscription has been deleted. (Note that pull
+              # subscribers will always receive NOT_FOUND in response in their pull
+              # request on the subscription, rather than seeing this boolean.)
           "message": { # A message data and its labels. # A received message.
-            "messageId": "A String", # ID of this message assigned by the server at publication time. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a PubsubMessage via a Pull call or a push delivery. It must not be populated by a publisher in a Publish call.
-            "data": "A String", # The message payload.
-            "publishTime": "A String", # The time at which the message was published. The time is milliseconds since the UNIX epoch.
-            "label": [ # Optional list of labels for this message. Keys in this collection must be unique.
+            "label": [ # Optional list of labels for this message. Keys in this collection must
+                # be unique.
               { # A key-value pair applied to a given object.
                 "numValue": "A String", # An integer value.
                 "strValue": "A String", # A string value.
-                "key": "A String", # The key of a label is a syntactically valid URL (as per RFC 1738) with the "scheme" and initial slashes omitted and with the additional restrictions noted below. Each key should be globally unique. The "host" portion is called the "namespace" and is not necessarily resolvable to a network endpoint. Instead, the namespace indicates what system or entity defines the semantics of the label. Namespaces do not restrict the set of objects to which a label may be associated. Keys are defined by the following grammar: key = hostname "/" kpath kpath = ksegment *[ "/" ksegment ] ksegment = alphadigit | *[ alphadigit | "-" | "_" | "." ] where "hostname" and "alphadigit" are defined as in RFC 1738. Example key: spanner.google.com/universe
+                "key": "A String", # The key of a label is a syntactically valid URL (as per RFC 1738) with
+                    # the "scheme" and initial slashes omitted and with the additional
+                    # restrictions noted below.  Each key should be globally unique.  The
+                    # "host" portion is called the "namespace" and is not necessarily
+                    # resolvable to a network endpoint.  Instead, the namespace indicates what
+                    # system or entity defines the semantics of the label.  Namespaces do not
+                    # restrict the set of objects to which a label may be associated.
+                    #
+                    # Keys are defined by the following grammar:
+                    #
+                    #   key          = hostname "/" kpath
+                    #   kpath        = ksegment *[ "/" ksegment ]
+                    #   ksegment     = alphadigit | *[ alphadigit | "-" | "_" | "." ]
+                    #
+                    # where "hostname" and "alphadigit" are defined as in RFC 1738.
+                    #
+                    # Example key:
+                    #   spanner.google.com/universe
               },
             ],
+            "data": "A String", # The message payload.
+            "publishTime": "A String", # The time at which the message was published.
+                # The time is milliseconds since the UNIX epoch.
+            "messageId": "A String", # ID of this message assigned by the server at publication time. Guaranteed
+                # to be unique within the topic. This value may be read by a subscriber
+                # that receives a PubsubMessage via a Pull call or a push delivery. It must
+                # not be populated by a publisher in a Publish call.
           },
-          "truncated": True or False, # Indicates that this subscription has been truncated.
           "subscription": "A String", # The subscription that received the event.
+          "truncated": True or False, # Indicates that this subscription has been truncated.
         },
         "ackId": "A String", # This ID must be used to acknowledge the received event or message.
       },
diff --git a/docs/dyn/pubsub_v1beta1a.topics.html b/docs/dyn/pubsub_v1beta1a.topics.html
index 17132a634ca..a46385ced64 100644
--- a/docs/dyn/pubsub_v1beta1a.topics.html
+++ b/docs/dyn/pubsub_v1beta1a.topics.html
@@ -79,10 +79,10 @@ <h2>Instance Methods</h2>
 <p class="firstline">Creates the given topic with the given name.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(topic, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes the topic with the given name. Returns NOT_FOUND if the topic does not exist. After a topic is deleted, a new topic may be created with the same name.</p>
+<p class="firstline">Deletes the topic with the given name. Returns NOT_FOUND if the topic does</p>
 <p class="toc_element">
   <code><a href="#get">get(topic, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the configuration of a topic. Since the topic only has the name attribute, this method is only useful to check the existence of a topic. If other attributes are added in the future, they will be returned here.</p>
+<p class="firstline">Gets the configuration of a topic. Since the topic only has the name</p>
 <p class="toc_element">
   <code><a href="#list">list(maxResults=None, pageToken=None, query=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists matching topics.</p>
@@ -91,10 +91,10 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#publish">publish(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Adds a message to the topic. Returns NOT_FOUND if the topic does not exist.</p>
+<p class="firstline">Adds a message to the topic.  Returns NOT_FOUND if the topic does not</p>
 <p class="toc_element">
   <code><a href="#publishBatch">publishBatch(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Adds one or more messages to the topic. Returns NOT_FOUND if the topic does not exist.</p>
+<p class="firstline">Adds one or more messages to the topic. Returns NOT_FOUND if the topic does</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(body, x__xgafv=None)</code>
@@ -109,6 +109,9 @@ <h3>Method Details</h3>
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
@@ -120,26 +123,49 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="delete">delete(topic, x__xgafv=None)</code>
-  <pre>Deletes the topic with the given name. Returns NOT_FOUND if the topic does not exist. After a topic is deleted, a new topic may be created with the same name.
+  <pre>Deletes the topic with the given name. Returns NOT_FOUND if the topic does
+not exist. After a topic is deleted, a new topic may be created with the
+same name.
 
 Args:
   topic: string, Name of the topic to delete. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # An empty message that you can re-use to avoid defining duplicated empty messages in your project. A typical example is to use it as argument or the return value of a service API. For instance: service Foo { rpc Bar (proto2.Empty) returns (proto2.Empty) { }; }; BEGIN GOOGLE-INTERNAL The difference between this one and net/rpc/empty-message.proto is that 1) The generated message here is in proto2 C++ API. 2) The proto2.Empty has minimum dependencies (no message_set or net/rpc dependencies) END GOOGLE-INTERNAL
+    { # An empty message that you can re-use to avoid defining duplicated empty
+      # messages in your project. A typical example is to use it as argument or the
+      # return value of a service API. For instance:
+      #
+      #   service Foo {
+      #     rpc Bar (proto2.Empty) returns (proto2.Empty) { };
+      #   };
+      #
+      # BEGIN GOOGLE-INTERNAL
+      # The difference between this one and net/rpc/empty-message.proto is that
+      # 1) The generated message here is in proto2 C++ API.
+      # 2) The proto2.Empty has minimum dependencies
+      #    (no message_set or net/rpc dependencies)
+      # END GOOGLE-INTERNAL
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="get">get(topic, x__xgafv=None)</code>
-  <pre>Gets the configuration of a topic. Since the topic only has the name attribute, this method is only useful to check the existence of a topic. If other attributes are added in the future, they will be returned here.
+  <pre>Gets the configuration of a topic. Since the topic only has the name
+attribute, this method is only useful to check the existence of a topic.
+If other attributes are added in the future, they will be returned here.
 
 Args:
   topic: string, The name of the topic to get. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
@@ -155,9 +181,13 @@ <h3>Method Details</h3>
 
 Args:
   maxResults: integer, Maximum number of topics to return.
-  pageToken: string, The value obtained in the last ListTopicsResponse for continuation.
+  pageToken: string, The value obtained in the last <code>ListTopicsResponse</code>
+for continuation.
   query: string, A valid label query expression.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
@@ -168,7 +198,9 @@ <h3>Method Details</h3>
         "name": "A String", # Name of the topic.
       },
     ],
-    "nextPageToken": "A String", # If not empty, indicates that there are more topics that match the request, and this value should be passed to the next ListTopicsRequest to continue.
+    "nextPageToken": "A String", # If not empty, indicates that there are more topics that match the request,
+        # and this value should be passed to the next <code>ListTopicsRequest</code>
+        # to continue.
   }</pre>
 </div>
 
@@ -188,7 +220,8 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="publish">publish(body, x__xgafv=None)</code>
-  <pre>Adds a message to the topic. Returns NOT_FOUND if the topic does not exist.
+  <pre>Adds a message to the topic.  Returns NOT_FOUND if the topic does not
+exist.
 
 Args:
   body: object, The request body. (required)
@@ -197,31 +230,70 @@ <h3>Method Details</h3>
 { # Request for the Publish method.
     "topic": "A String", # The message in the request will be published on this topic.
     "message": { # A message data and its labels. # The message to publish.
-      "messageId": "A String", # ID of this message assigned by the server at publication time. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a PubsubMessage via a Pull call or a push delivery. It must not be populated by a publisher in a Publish call.
-      "data": "A String", # The message payload.
-      "publishTime": "A String", # The time at which the message was published. The time is milliseconds since the UNIX epoch.
-      "label": [ # Optional list of labels for this message. Keys in this collection must be unique.
+      "label": [ # Optional list of labels for this message. Keys in this collection must
+          # be unique.
         { # A key-value pair applied to a given object.
           "numValue": "A String", # An integer value.
           "strValue": "A String", # A string value.
-          "key": "A String", # The key of a label is a syntactically valid URL (as per RFC 1738) with the "scheme" and initial slashes omitted and with the additional restrictions noted below. Each key should be globally unique. The "host" portion is called the "namespace" and is not necessarily resolvable to a network endpoint. Instead, the namespace indicates what system or entity defines the semantics of the label. Namespaces do not restrict the set of objects to which a label may be associated. Keys are defined by the following grammar: key = hostname "/" kpath kpath = ksegment *[ "/" ksegment ] ksegment = alphadigit | *[ alphadigit | "-" | "_" | "." ] where "hostname" and "alphadigit" are defined as in RFC 1738. Example key: spanner.google.com/universe
+          "key": "A String", # The key of a label is a syntactically valid URL (as per RFC 1738) with
+              # the "scheme" and initial slashes omitted and with the additional
+              # restrictions noted below.  Each key should be globally unique.  The
+              # "host" portion is called the "namespace" and is not necessarily
+              # resolvable to a network endpoint.  Instead, the namespace indicates what
+              # system or entity defines the semantics of the label.  Namespaces do not
+              # restrict the set of objects to which a label may be associated.
+              #
+              # Keys are defined by the following grammar:
+              #
+              #   key          = hostname "/" kpath
+              #   kpath        = ksegment *[ "/" ksegment ]
+              #   ksegment     = alphadigit | *[ alphadigit | "-" | "_" | "." ]
+              #
+              # where "hostname" and "alphadigit" are defined as in RFC 1738.
+              #
+              # Example key:
+              #   spanner.google.com/universe
         },
       ],
+      "data": "A String", # The message payload.
+      "publishTime": "A String", # The time at which the message was published.
+          # The time is milliseconds since the UNIX epoch.
+      "messageId": "A String", # ID of this message assigned by the server at publication time. Guaranteed
+          # to be unique within the topic. This value may be read by a subscriber
+          # that receives a PubsubMessage via a Pull call or a push delivery. It must
+          # not be populated by a publisher in a Publish call.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # An empty message that you can re-use to avoid defining duplicated empty messages in your project. A typical example is to use it as argument or the return value of a service API. For instance: service Foo { rpc Bar (proto2.Empty) returns (proto2.Empty) { }; }; BEGIN GOOGLE-INTERNAL The difference between this one and net/rpc/empty-message.proto is that 1) The generated message here is in proto2 C++ API. 2) The proto2.Empty has minimum dependencies (no message_set or net/rpc dependencies) END GOOGLE-INTERNAL
+    { # An empty message that you can re-use to avoid defining duplicated empty
+      # messages in your project. A typical example is to use it as argument or the
+      # return value of a service API. For instance:
+      #
+      #   service Foo {
+      #     rpc Bar (proto2.Empty) returns (proto2.Empty) { };
+      #   };
+      #
+      # BEGIN GOOGLE-INTERNAL
+      # The difference between this one and net/rpc/empty-message.proto is that
+      # 1) The generated message here is in proto2 C++ API.
+      # 2) The proto2.Empty has minimum dependencies
+      #    (no message_set or net/rpc dependencies)
+      # END GOOGLE-INTERNAL
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="publishBatch">publishBatch(body, x__xgafv=None)</code>
-  <pre>Adds one or more messages to the topic. Returns NOT_FOUND if the topic does not exist.
+  <pre>Adds one or more messages to the topic. Returns NOT_FOUND if the topic does
+not exist.
 
 Args:
   body: object, The request body. (required)
@@ -231,27 +303,54 @@ <h3>Method Details</h3>
     "topic": "A String", # The messages in the request will be published on this topic.
     "messages": [ # The messages to publish.
       { # A message data and its labels.
-        "messageId": "A String", # ID of this message assigned by the server at publication time. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a PubsubMessage via a Pull call or a push delivery. It must not be populated by a publisher in a Publish call.
-        "data": "A String", # The message payload.
-        "publishTime": "A String", # The time at which the message was published. The time is milliseconds since the UNIX epoch.
-        "label": [ # Optional list of labels for this message. Keys in this collection must be unique.
+        "label": [ # Optional list of labels for this message. Keys in this collection must
+            # be unique.
           { # A key-value pair applied to a given object.
             "numValue": "A String", # An integer value.
             "strValue": "A String", # A string value.
-            "key": "A String", # The key of a label is a syntactically valid URL (as per RFC 1738) with the "scheme" and initial slashes omitted and with the additional restrictions noted below. Each key should be globally unique. The "host" portion is called the "namespace" and is not necessarily resolvable to a network endpoint. Instead, the namespace indicates what system or entity defines the semantics of the label. Namespaces do not restrict the set of objects to which a label may be associated. Keys are defined by the following grammar: key = hostname "/" kpath kpath = ksegment *[ "/" ksegment ] ksegment = alphadigit | *[ alphadigit | "-" | "_" | "." ] where "hostname" and "alphadigit" are defined as in RFC 1738. Example key: spanner.google.com/universe
+            "key": "A String", # The key of a label is a syntactically valid URL (as per RFC 1738) with
+                # the "scheme" and initial slashes omitted and with the additional
+                # restrictions noted below.  Each key should be globally unique.  The
+                # "host" portion is called the "namespace" and is not necessarily
+                # resolvable to a network endpoint.  Instead, the namespace indicates what
+                # system or entity defines the semantics of the label.  Namespaces do not
+                # restrict the set of objects to which a label may be associated.
+                #
+                # Keys are defined by the following grammar:
+                #
+                #   key          = hostname "/" kpath
+                #   kpath        = ksegment *[ "/" ksegment ]
+                #   ksegment     = alphadigit | *[ alphadigit | "-" | "_" | "." ]
+                #
+                # where "hostname" and "alphadigit" are defined as in RFC 1738.
+                #
+                # Example key:
+                #   spanner.google.com/universe
           },
         ],
+        "data": "A String", # The message payload.
+        "publishTime": "A String", # The time at which the message was published.
+            # The time is milliseconds since the UNIX epoch.
+        "messageId": "A String", # ID of this message assigned by the server at publication time. Guaranteed
+            # to be unique within the topic. This value may be read by a subscriber
+            # that receives a PubsubMessage via a Pull call or a push delivery. It must
+            # not be populated by a publisher in a Publish call.
       },
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the PublishBatch method.
-    "messageIds": [ # The server-assigned ID of each published message, in the same order as the messages in the request. IDs are guaranteed to be unique within the topic.
+    "messageIds": [ # The server-assigned ID of each published message, in the same order as
+        # the messages in the request. IDs are guaranteed to be unique within
+        # the topic.
       "A String",
     ],
   }</pre>
diff --git a/docs/dyn/pubsub_v1beta2.projects.subscriptions.html b/docs/dyn/pubsub_v1beta2.projects.subscriptions.html
index 84a4678b1e4..1b34bc400e3 100644
--- a/docs/dyn/pubsub_v1beta2.projects.subscriptions.html
+++ b/docs/dyn/pubsub_v1beta2.projects.subscriptions.html
@@ -76,19 +76,19 @@ <h1><a href="pubsub_v1beta2.html">Google Cloud Pub/Sub API</a> . <a href="pubsub
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#acknowledge">acknowledge(subscription, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Acknowledges the messages associated with the `ack_ids` in the `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages from the subscription. Acknowledging a message whose ack deadline has expired may succeed, but such a message may be redelivered later. Acknowledging a message more than once will not result in an error.</p>
+<p class="firstline">Acknowledges the messages associated with the `ack_ids` in the</p>
 <p class="toc_element">
-  <code><a href="#create">create(name, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a subscription to a given topic. If the subscription already exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns `NOT_FOUND`. If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic. Note that for REST API requests, you must specify a name.</p>
+  <code><a href="#create">create(name=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a subscription to a given topic.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(subscription, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes an existing subscription. All pending messages in the subscription are immediately dropped. Calls to `Pull` after deletion will return `NOT_FOUND`. After a subscription is deleted, a new one may be created with the same name, but the new one has no association with the old subscription, or its topic unless the same topic is specified.</p>
+<p class="firstline">Deletes an existing subscription. All pending messages in the subscription</p>
 <p class="toc_element">
   <code><a href="#get">get(subscription, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the configuration details of a subscription.</p>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.</p>
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the access control policy for a resource.</p>
 <p class="toc_element">
   <code><a href="#list">list(project, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists matching subscriptions.</p>
@@ -97,23 +97,29 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#modifyAckDeadline">modifyAckDeadline(subscription, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Modifies the ack deadline for a specific message. This method is useful to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted. Note that this does not modify the subscription-level `ackDeadlineSeconds` used for subsequent messages.</p>
+<p class="firstline">Modifies the ack deadline for a specific message. This method is useful</p>
 <p class="toc_element">
   <code><a href="#modifyPushConfig">modifyPushConfig(subscription, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Modifies the `PushConfig` for a specified subscription. This may be used to change a push subscription to a pull one (signified by an empty `PushConfig`) or vice versa, or change the endpoint URL and other attributes of a push subscription. Messages will accumulate for delivery continuously through the call regardless of changes to the `PushConfig`.</p>
+<p class="firstline">Modifies the `PushConfig` for a specified subscription.</p>
 <p class="toc_element">
   <code><a href="#pull">pull(subscription, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Pulls messages from the server. Returns an empty list if there are no messages available in the backlog. The server may return `UNAVAILABLE` if there are too many concurrent pull requests pending for the given subscription.</p>
+<p class="firstline">Pulls messages from the server. Returns an empty list if there are no</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy.</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the access control policy on the specified resource. Replaces any</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="acknowledge">acknowledge(subscription, body, x__xgafv=None)</code>
-  <pre>Acknowledges the messages associated with the `ack_ids` in the `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages from the subscription. Acknowledging a message whose ack deadline has expired may succeed, but such a message may be redelivered later. Acknowledging a message more than once will not result in an error.
+  <pre>Acknowledges the messages associated with the `ack_ids` in the
+`AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages
+from the subscription.
+
+Acknowledging a message whose ack deadline has expired may succeed,
+but such a message may be redelivered later. Acknowledging a message more
+than once will not result in an error.
 
 Args:
   subscription: string, The subscription whose message is being acknowledged. (required)
@@ -121,71 +127,208 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Request for the Acknowledge method.
-    "ackIds": [ # The acknowledgment ID for the messages being acknowledged that was returned by the Pub/Sub system in the `Pull` response. Must not be empty.
+    "ackIds": [ # The acknowledgment ID for the messages being acknowledged that was returned
+        # by the Pub/Sub system in the `Pull` response. Must not be empty.
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="create">create(name, body, x__xgafv=None)</code>
-  <pre>Creates a subscription to a given topic. If the subscription already exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns `NOT_FOUND`. If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic. Note that for REST API requests, you must specify a name.
+    <code class="details" id="create">create(name=None, body, x__xgafv=None)</code>
+  <pre>Creates a subscription to a given topic.
+If the subscription already exists, returns `ALREADY_EXISTS`.
+If the corresponding topic doesn't exist, returns `NOT_FOUND`.
+
+If the name is not provided in the request, the server will assign a random
+name for this subscription on the same project as the topic. Note that
+for REST API requests, you must specify a name.
 
 Args:
-  name: string, The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`. (required)
+  name: string, The name of the subscription. It must have the format
+`"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+start with a letter, and contain only letters (`[A-Za-z]`), numbers
+(`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+in length, and it must not start with `"goog"`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # A subscription resource.
-  "topic": "A String", # The name of the topic from which this subscription is receiving messages. The value of this field will be `_deleted-topic_` if the topic has been deleted.
-  "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.
-  "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods.
-    "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+  "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+      # The value of this field will be `_deleted-topic_` if the topic has been
+      # deleted.
+  "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+      # before the subscriber should acknowledge the message. After message
+      # delivery but before the ack deadline expires and before the message is
+      # acknowledged, it is an outstanding message and will not be delivered
+      # again during that time (on a best-effort basis).
+      # 
+      # For pull subscriptions, this value is used as the initial value for the ack
+      # deadline. To override this value for a given message, call
+      # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
+      # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+      # 
+      # For push delivery, this value is also used to set the request timeout for
+      # the call to the push endpoint.
+      # 
+      # If the subscriber never acknowledges the message, the Pub/Sub
+      # system will eventually redeliver the message.
+      # 
+      # If this parameter is 0, a default value of 10 seconds is used.
+  "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+      # used to configure it. An empty `pushConfig` signifies that the subscriber
+      # will pull and ack messages using API methods.
+    "attributes": { # Endpoint configuration attributes.
+        #
+        # Every endpoint has a set of API supported attributes that can be used to
+        # control different aspects of the message delivery.
+        #
+        # The currently supported attribute is `x-goog-version`, which you can
+        # use to change the format of the push message. This attribute
+        # indicates the version of the data expected by the endpoint. This
+        # controls the shape of the envelope (i.e. its fields and metadata).
+        # The endpoint version is based on the version of the Pub/Sub
+        # API.
+        #
+        # If not present during the `CreateSubscription` call, it will default to
+        # the version of the API used to make such call. If not present during a
+        # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+        # calls will always return a valid version, even if the subscription was
+        # created without this attribute.
+        #
+        # The possible values for this attribute are:
+        #
+        # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+        # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
       "a_key": "A String",
     },
-    "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+    "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+        # For example, a Webhook endpoint might use "https://example.com/push".
   },
-  "name": "A String", # The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+  "name": "A String", # The name of the subscription. It must have the format
+      # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+      # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+      # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+      # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+      # in length, and it must not start with `"goog"`.
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A subscription resource.
-    "topic": "A String", # The name of the topic from which this subscription is receiving messages. The value of this field will be `_deleted-topic_` if the topic has been deleted.
-    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.
-    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods.
-      "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+    "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+        # The value of this field will be `_deleted-topic_` if the topic has been
+        # deleted.
+    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+        # before the subscriber should acknowledge the message. After message
+        # delivery but before the ack deadline expires and before the message is
+        # acknowledged, it is an outstanding message and will not be delivered
+        # again during that time (on a best-effort basis).
+        #
+        # For pull subscriptions, this value is used as the initial value for the ack
+        # deadline. To override this value for a given message, call
+        # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
+        # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+        #
+        # For push delivery, this value is also used to set the request timeout for
+        # the call to the push endpoint.
+        #
+        # If the subscriber never acknowledges the message, the Pub/Sub
+        # system will eventually redeliver the message.
+        #
+        # If this parameter is 0, a default value of 10 seconds is used.
+    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+        # used to configure it. An empty `pushConfig` signifies that the subscriber
+        # will pull and ack messages using API methods.
+      "attributes": { # Endpoint configuration attributes.
+          #
+          # Every endpoint has a set of API supported attributes that can be used to
+          # control different aspects of the message delivery.
+          #
+          # The currently supported attribute is `x-goog-version`, which you can
+          # use to change the format of the push message. This attribute
+          # indicates the version of the data expected by the endpoint. This
+          # controls the shape of the envelope (i.e. its fields and metadata).
+          # The endpoint version is based on the version of the Pub/Sub
+          # API.
+          #
+          # If not present during the `CreateSubscription` call, it will default to
+          # the version of the API used to make such call. If not present during a
+          # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+          # calls will always return a valid version, even if the subscription was
+          # created without this attribute.
+          #
+          # The possible values for this attribute are:
+          #
+          # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+          # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
         "a_key": "A String",
       },
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
-    "name": "A String", # The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+    "name": "A String", # The name of the subscription. It must have the format
+        # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+        # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+        # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+        # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+        # in length, and it must not start with `"goog"`.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(subscription, x__xgafv=None)</code>
-  <pre>Deletes an existing subscription. All pending messages in the subscription are immediately dropped. Calls to `Pull` after deletion will return `NOT_FOUND`. After a subscription is deleted, a new one may be created with the same name, but the new one has no association with the old subscription, or its topic unless the same topic is specified.
+  <pre>Deletes an existing subscription. All pending messages in the subscription
+are immediately dropped. Calls to `Pull` after deletion will return
+`NOT_FOUND`. After a subscription is deleted, a new one may be created with
+the same name, but the new one has no association with the old
+subscription, or its topic unless the same topic is specified.
 
 Args:
   subscription: string, The subscription to delete. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
@@ -196,45 +339,167 @@ <h3>Method Details</h3>
 Args:
   subscription: string, The name of the subscription to get. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A subscription resource.
-    "topic": "A String", # The name of the topic from which this subscription is receiving messages. The value of this field will be `_deleted-topic_` if the topic has been deleted.
-    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.
-    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods.
-      "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+    "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+        # The value of this field will be `_deleted-topic_` if the topic has been
+        # deleted.
+    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+        # before the subscriber should acknowledge the message. After message
+        # delivery but before the ack deadline expires and before the message is
+        # acknowledged, it is an outstanding message and will not be delivered
+        # again during that time (on a best-effort basis).
+        #
+        # For pull subscriptions, this value is used as the initial value for the ack
+        # deadline. To override this value for a given message, call
+        # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
+        # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+        #
+        # For push delivery, this value is also used to set the request timeout for
+        # the call to the push endpoint.
+        #
+        # If the subscriber never acknowledges the message, the Pub/Sub
+        # system will eventually redeliver the message.
+        #
+        # If this parameter is 0, a default value of 10 seconds is used.
+    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+        # used to configure it. An empty `pushConfig` signifies that the subscriber
+        # will pull and ack messages using API methods.
+      "attributes": { # Endpoint configuration attributes.
+          #
+          # Every endpoint has a set of API supported attributes that can be used to
+          # control different aspects of the message delivery.
+          #
+          # The currently supported attribute is `x-goog-version`, which you can
+          # use to change the format of the push message. This attribute
+          # indicates the version of the data expected by the endpoint. This
+          # controls the shape of the envelope (i.e. its fields and metadata).
+          # The endpoint version is based on the version of the Pub/Sub
+          # API.
+          #
+          # If not present during the `CreateSubscription` call, it will default to
+          # the version of the API used to make such call. If not present during a
+          # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+          # calls will always return a valid version, even if the subscription was
+          # created without this attribute.
+          #
+          # The possible values for this attribute are:
+          #
+          # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+          # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
         "a_key": "A String",
       },
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
-    "name": "A String", # The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+    "name": "A String", # The name of the subscription. It must have the format
+        # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+        # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+        # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+        # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+        # in length, and it must not start with `"goog"`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, x__xgafv=None)</code>
-  <pre>Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</code>
+  <pre>Gets the access control policy for a resource.
+Returns an empty policy if the resource exists and does not have a policy
+set.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
@@ -245,25 +510,80 @@ <h3>Method Details</h3>
 Args:
   project: string, The name of the cloud project that subscriptions belong to. (required)
   pageSize: integer, Maximum number of subscriptions to return.
-  pageToken: string, The value returned by the last `ListSubscriptionsResponse`; indicates that this is a continuation of a prior `ListSubscriptions` call, and that the system should return the next page of data.
+  pageToken: string, The value returned by the last `ListSubscriptionsResponse`; indicates that
+this is a continuation of a prior `ListSubscriptions` call, and that the
+system should return the next page of data.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `ListSubscriptions` method.
-    "nextPageToken": "A String", # If not empty, indicates that there may be more subscriptions that match the request; this value should be passed in a new `ListSubscriptionsRequest` to get more subscriptions.
+    "nextPageToken": "A String", # If not empty, indicates that there may be more subscriptions that match
+        # the request; this value should be passed in a new
+        # `ListSubscriptionsRequest` to get more subscriptions.
     "subscriptions": [ # The subscriptions that match the request.
       { # A subscription resource.
-        "topic": "A String", # The name of the topic from which this subscription is receiving messages. The value of this field will be `_deleted-topic_` if the topic has been deleted.
-        "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.
-        "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods.
-          "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+        "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+            # The value of this field will be `_deleted-topic_` if the topic has been
+            # deleted.
+        "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+            # before the subscriber should acknowledge the message. After message
+            # delivery but before the ack deadline expires and before the message is
+            # acknowledged, it is an outstanding message and will not be delivered
+            # again during that time (on a best-effort basis).
+            #
+            # For pull subscriptions, this value is used as the initial value for the ack
+            # deadline. To override this value for a given message, call
+            # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
+            # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+            #
+            # For push delivery, this value is also used to set the request timeout for
+            # the call to the push endpoint.
+            #
+            # If the subscriber never acknowledges the message, the Pub/Sub
+            # system will eventually redeliver the message.
+            #
+            # If this parameter is 0, a default value of 10 seconds is used.
+        "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+            # used to configure it. An empty `pushConfig` signifies that the subscriber
+            # will pull and ack messages using API methods.
+          "attributes": { # Endpoint configuration attributes.
+              #
+              # Every endpoint has a set of API supported attributes that can be used to
+              # control different aspects of the message delivery.
+              #
+              # The currently supported attribute is `x-goog-version`, which you can
+              # use to change the format of the push message. This attribute
+              # indicates the version of the data expected by the endpoint. This
+              # controls the shape of the envelope (i.e. its fields and metadata).
+              # The endpoint version is based on the version of the Pub/Sub
+              # API.
+              #
+              # If not present during the `CreateSubscription` call, it will default to
+              # the version of the API used to make such call. If not present during a
+              # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+              # calls will always return a valid version, even if the subscription was
+              # created without this attribute.
+              #
+              # The possible values for this attribute are:
+              #
+              # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+              # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
             "a_key": "A String",
           },
-          "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+          "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+              # For example, a Webhook endpoint might use "https://example.com/push".
         },
-        "name": "A String", # The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+        "name": "A String", # The name of the subscription. It must have the format
+            # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+            # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+            # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+            # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+            # in length, and it must not start with `"goog"`.
       },
     ],
   }</pre>
@@ -285,7 +605,11 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="modifyAckDeadline">modifyAckDeadline(subscription, body, x__xgafv=None)</code>
-  <pre>Modifies the ack deadline for a specific message. This method is useful to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted. Note that this does not modify the subscription-level `ackDeadlineSeconds` used for subsequent messages.
+  <pre>Modifies the ack deadline for a specific message. This method is useful
+to indicate that more time is needed to process a message by the
+subscriber, or to make the message available for redelivery if the
+processing was interrupted. Note that this does not modify the
+subscription-level `ackDeadlineSeconds` used for subsequent messages.
 
 Args:
   subscription: string, The name of the subscription. (required)
@@ -293,25 +617,46 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Request for the ModifyAckDeadline method.
-    "ackDeadlineSeconds": 42, # The new ack deadline with respect to the time this request was sent to the Pub/Sub system. Must be >= 0. For example, if the value is 10, the new ack deadline will expire 10 seconds after the `ModifyAckDeadline` call was made. Specifying zero may immediately make the message available for another pull request.
-    "ackId": "A String", # The acknowledgment ID. Either this or ack_ids must be populated, but not both.
+    "ackDeadlineSeconds": 42, # The new ack deadline with respect to the time this request was sent to
+        # the Pub/Sub system. Must be >= 0. For example, if the value is 10, the new
+        # ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
+        # was made. Specifying zero may immediately make the message available for
+        # another pull request.
+    "ackId": "A String", # The acknowledgment ID. Either this or ack_ids must be populated, but not
+        # both.
     "ackIds": [ # List of acknowledgment IDs.
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="modifyPushConfig">modifyPushConfig(subscription, body, x__xgafv=None)</code>
-  <pre>Modifies the `PushConfig` for a specified subscription. This may be used to change a push subscription to a pull one (signified by an empty `PushConfig`) or vice versa, or change the endpoint URL and other attributes of a push subscription. Messages will accumulate for delivery continuously through the call regardless of changes to the `PushConfig`.
+  <pre>Modifies the `PushConfig` for a specified subscription.
+
+This may be used to change a push subscription to a pull one (signified by
+an empty `PushConfig`) or vice versa, or change the endpoint URL and other
+attributes of a push subscription. Messages will accumulate for delivery
+continuously through the call regardless of changes to the `PushConfig`.
 
 Args:
   subscription: string, The name of the subscription. (required)
@@ -319,26 +664,67 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Request for the ModifyPushConfig method.
-    "pushConfig": { # Configuration for a push delivery endpoint. # The push configuration for future deliveries. An empty `pushConfig` indicates that the Pub/Sub system should stop pushing messages from the given subscription and allow messages to be pulled and acknowledged - effectively pausing the subscription if `Pull` is not called.
-      "attributes": { # Endpoint configuration attributes. Every endpoint has a set of API supported attributes that can be used to control different aspects of the message delivery. The currently supported attribute is `x-goog-version`, which you can use to change the format of the push message. This attribute indicates the version of the data expected by the endpoint. This controls the shape of the envelope (i.e. its fields and metadata). The endpoint version is based on the version of the Pub/Sub API. If not present during the `CreateSubscription` call, it will default to the version of the API used to make such call. If not present during a `ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls will always return a valid version, even if the subscription was created without this attribute. The possible values for this attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+    "pushConfig": { # Configuration for a push delivery endpoint. # The push configuration for future deliveries.
+        # 
+        # An empty `pushConfig` indicates that the Pub/Sub system should
+        # stop pushing messages from the given subscription and allow
+        # messages to be pulled and acknowledged - effectively pausing
+        # the subscription if `Pull` is not called.
+      "attributes": { # Endpoint configuration attributes.
+          #
+          # Every endpoint has a set of API supported attributes that can be used to
+          # control different aspects of the message delivery.
+          #
+          # The currently supported attribute is `x-goog-version`, which you can
+          # use to change the format of the push message. This attribute
+          # indicates the version of the data expected by the endpoint. This
+          # controls the shape of the envelope (i.e. its fields and metadata).
+          # The endpoint version is based on the version of the Pub/Sub
+          # API.
+          #
+          # If not present during the `CreateSubscription` call, it will default to
+          # the version of the API used to make such call. If not present during a
+          # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+          # calls will always return a valid version, even if the subscription was
+          # created without this attribute.
+          #
+          # The possible values for this attribute are:
+          #
+          # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+          # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
         "a_key": "A String",
       },
-      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed. For example, a Webhook endpoint might use "https://example.com/push".
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="pull">pull(subscription, body, x__xgafv=None)</code>
-  <pre>Pulls messages from the server. Returns an empty list if there are no messages available in the backlog. The server may return `UNAVAILABLE` if there are too many concurrent pull requests pending for the given subscription.
+  <pre>Pulls messages from the server. Returns an empty list if there are no
+messages available in the backlog. The server may return `UNAVAILABLE` if
+there are too many concurrent pull requests pending for the given
+subscription.
 
 Args:
   subscription: string, The subscription from which messages should be pulled. (required)
@@ -346,26 +732,44 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # Request for the `Pull` method.
-    "returnImmediately": True or False, # If this is specified as true the system will respond immediately even if it is not able to return a message in the `Pull` response. Otherwise the system is allowed to wait until at least one message is available rather than returning no messages. The client may cancel the request if it does not wish to wait any longer for the response.
-    "maxMessages": 42, # The maximum number of messages returned for this request. The Pub/Sub system may return fewer than the number specified.
+    "returnImmediately": True or False, # If this is specified as true the system will respond immediately even if
+        # it is not able to return a message in the `Pull` response. Otherwise the
+        # system is allowed to wait until at least one message is available rather
+        # than returning no messages. The client may cancel the request if it does
+        # not wish to wait any longer for the response.
+    "maxMessages": 42, # The maximum number of messages returned for this request. The Pub/Sub
+        # system may return fewer than the number specified.
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `Pull` method.
-    "receivedMessages": [ # Received Pub/Sub messages. The Pub/Sub system will return zero messages if there are no more available in the backlog. The Pub/Sub system may return fewer than the `maxMessages` requested even if there are more messages available in the backlog.
+    "receivedMessages": [ # Received Pub/Sub messages. The Pub/Sub system will return zero messages if
+        # there are no more available in the backlog. The Pub/Sub system may return
+        # fewer than the `maxMessages` requested even if there are more messages
+        # available in the backlog.
       { # A message and its corresponding acknowledgment ID.
         "ackId": "A String", # This ID can be used to acknowledge the received message.
-        "message": { # A message data and its attributes. The message payload must not be empty; it must contain either a non-empty data field, or at least one attribute. # The message.
+        "message": { # A message data and its attributes. The message payload must not be empty; # The message.
+            # it must contain either a non-empty data field, or at least one attribute.
           "attributes": { # Optional attributes for this message.
             "a_key": "A String",
           },
-          "data": "A String", # The message payload. For JSON requests, the value of this field must be [base64-encoded](https://tools.ietf.org/html/rfc4648).
-          "publishTime": "A String", # The time at which the message was published, populated by the server when it receives the `Publish` call. It must not be populated by the publisher in a `Publish` call.
-          "messageId": "A String", # ID of this message, assigned by the server when the message is published. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a `PubsubMessage` via a `Pull` call or a push delivery. It must not be populated by the publisher in a `Publish` call.
+          "data": "A String", # The message payload. For JSON requests, the value of this field must be
+              # [base64-encoded](https://tools.ietf.org/html/rfc4648).
+          "publishTime": "A String", # The time at which the message was published, populated by the server when
+              # it receives the `Publish` call. It must not be populated by the
+              # publisher in a `Publish` call.
+          "messageId": "A String", # ID of this message, assigned by the server when the message is published.
+              # Guaranteed to be unique within the topic. This value may be read by a
+              # subscriber that receives a `PubsubMessage` via a `Pull` call or a push
+              # delivery. It must not be populated by the publisher in a `Publish` call.
         },
       },
     ],
@@ -373,70 +777,218 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the access control policy on the specified resource. Replaces any existing policy.
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the access control policy on the specified resource. Replaces any
+existing policy.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
   <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
diff --git a/docs/dyn/pubsub_v1beta2.projects.topics.html b/docs/dyn/pubsub_v1beta2.projects.topics.html
index ace8c6b6732..9898eaa91b6 100644
--- a/docs/dyn/pubsub_v1beta2.projects.topics.html
+++ b/docs/dyn/pubsub_v1beta2.projects.topics.html
@@ -80,17 +80,17 @@ <h2>Instance Methods</h2>
 <p class="firstline">Returns the subscriptions Resource.</p>
 
 <p class="toc_element">
-  <code><a href="#create">create(name, body, x__xgafv=None)</a></code></p>
+  <code><a href="#create">create(name=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Creates the given topic with the given name.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(topic, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes the topic with the given name. Returns `NOT_FOUND` if the topic does not exist. After a topic is deleted, a new topic may be created with the same name; this is an entirely new topic with none of the old configuration or subscriptions. Existing subscriptions to this topic are not deleted, but their `topic` field is set to `_deleted-topic_`.</p>
+<p class="firstline">Deletes the topic with the given name. Returns `NOT_FOUND` if the topic</p>
 <p class="toc_element">
   <code><a href="#get">get(topic, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the configuration of a topic.</p>
 <p class="toc_element">
-  <code><a href="#getIamPolicy">getIamPolicy(resource, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.</p>
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the access control policy for a resource.</p>
 <p class="toc_element">
   <code><a href="#list">list(project, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists matching topics.</p>
@@ -99,49 +99,82 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#publish">publish(topic, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic does not exist. The message payload must not be empty; it must contain either a non-empty data field, or at least one attribute.</p>
+<p class="firstline">Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic</p>
 <p class="toc_element">
-  <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Sets the access control policy on the specified resource. Replaces any existing policy.</p>
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the access control policy on the specified resource. Replaces any</p>
 <p class="toc_element">
-  <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(name, body, x__xgafv=None)</code>
+    <code class="details" id="create">create(name=None, body, x__xgafv=None)</code>
   <pre>Creates the given topic with the given name.
 
 Args:
-  name: string, The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`. (required)
+  name: string, The name of the topic. It must have the format
+`"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+signs (`%`). It must be between 3 and 255 characters in length, and it
+must not start with `"goog"`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # A topic resource.
-  "name": "A String", # The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+  "name": "A String", # The name of the topic. It must have the format
+      # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+      # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+      # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+      # signs (`%`). It must be between 3 and 255 characters in length, and it
+      # must not start with `"goog"`.
 }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A topic resource.
-    "name": "A String", # The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+    "name": "A String", # The name of the topic. It must have the format
+        # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+        # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+        # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+        # signs (`%`). It must be between 3 and 255 characters in length, and it
+        # must not start with `"goog"`.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(topic, x__xgafv=None)</code>
-  <pre>Deletes the topic with the given name. Returns `NOT_FOUND` if the topic does not exist. After a topic is deleted, a new topic may be created with the same name; this is an entirely new topic with none of the old configuration or subscriptions. Existing subscriptions to this topic are not deleted, but their `topic` field is set to `_deleted-topic_`.
+  <pre>Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
+does not exist. After a topic is deleted, a new topic may be created with
+the same name; this is an entirely new topic with none of the old
+configuration or subscriptions. Existing subscriptions to this topic are
+not deleted, but their `topic` field is set to `_deleted-topic_`.
 
 Args:
   topic: string, Name of the topic to delete. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
@@ -152,37 +185,116 @@ <h3>Method Details</h3>
 Args:
   topic: string, The name of the topic to get. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # A topic resource.
-    "name": "A String", # The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+    "name": "A String", # The name of the topic. It must have the format
+        # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+        # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+        # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+        # signs (`%`). It must be between 3 and 255 characters in length, and it
+        # must not start with `"goog"`.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="getIamPolicy">getIamPolicy(resource, x__xgafv=None)</code>
-  <pre>Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</code>
+  <pre>Gets the access control policy for a resource.
+Returns an empty policy if the resource exists and does not have a policy
+set.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
@@ -193,17 +305,28 @@ <h3>Method Details</h3>
 Args:
   project: string, The name of the cloud project that topics belong to. (required)
   pageSize: integer, Maximum number of topics to return.
-  pageToken: string, The value returned by the last `ListTopicsResponse`; indicates that this is a continuation of a prior `ListTopics` call, and that the system should return the next page of data.
+  pageToken: string, The value returned by the last `ListTopicsResponse`; indicates that this is
+a continuation of a prior `ListTopics` call, and that the system should
+return the next page of data.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `ListTopics` method.
-    "nextPageToken": "A String", # If not empty, indicates that there may be more topics that match the request; this value should be passed in a new `ListTopicsRequest`.
+    "nextPageToken": "A String", # If not empty, indicates that there may be more topics that match the
+        # request; this value should be passed in a new `ListTopicsRequest`.
     "topics": [ # The resulting topics.
       { # A topic resource.
-        "name": "A String", # The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
+        "name": "A String", # The name of the topic. It must have the format
+            # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+            # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+            # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
+            # signs (`%`). It must be between 3 and 255 characters in length, and it
+            # must not start with `"goog"`.
       },
     ],
   }</pre>
@@ -225,7 +348,9 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="publish">publish(topic, body, x__xgafv=None)</code>
-  <pre>Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic does not exist. The message payload must not be empty; it must contain either a non-empty data field, or at least one attribute.
+  <pre>Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
+does not exist. The message payload must not be empty; it must contain
+ either a non-empty data field, or at least one attribute.
 
 Args:
   topic: string, The messages in the request will be published on this topic. (required)
@@ -234,94 +359,254 @@ <h3>Method Details</h3>
 
 { # Request for the Publish method.
     "messages": [ # The messages to publish.
-      { # A message data and its attributes. The message payload must not be empty; it must contain either a non-empty data field, or at least one attribute.
+      { # A message data and its attributes. The message payload must not be empty;
+          # it must contain either a non-empty data field, or at least one attribute.
         "attributes": { # Optional attributes for this message.
           "a_key": "A String",
         },
-        "data": "A String", # The message payload. For JSON requests, the value of this field must be [base64-encoded](https://tools.ietf.org/html/rfc4648).
-        "publishTime": "A String", # The time at which the message was published, populated by the server when it receives the `Publish` call. It must not be populated by the publisher in a `Publish` call.
-        "messageId": "A String", # ID of this message, assigned by the server when the message is published. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a `PubsubMessage` via a `Pull` call or a push delivery. It must not be populated by the publisher in a `Publish` call.
+        "data": "A String", # The message payload. For JSON requests, the value of this field must be
+            # [base64-encoded](https://tools.ietf.org/html/rfc4648).
+        "publishTime": "A String", # The time at which the message was published, populated by the server when
+            # it receives the `Publish` call. It must not be populated by the
+            # publisher in a `Publish` call.
+        "messageId": "A String", # ID of this message, assigned by the server when the message is published.
+            # Guaranteed to be unique within the topic. This value may be read by a
+            # subscriber that receives a `PubsubMessage` via a `Pull` call or a push
+            # delivery. It must not be populated by the publisher in a `Publish` call.
       },
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `Publish` method.
-    "messageIds": [ # The server-assigned ID of each published message, in the same order as the messages in the request. IDs are guaranteed to be unique within the topic.
+    "messageIds": [ # The server-assigned ID of each published message, in the same order as
+        # the messages in the request. IDs are guaranteed to be unique within
+        # the topic.
       "A String",
     ],
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
-  <pre>Sets the access control policy on the specified resource. Replaces any existing policy.
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the access control policy on the specified resource. Replaces any
+existing policy.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `SetIamPolicy` method.
-    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
-      "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
         { # Associates `members` with a `role`.
-          "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-          "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
             "A String",
           ],
         },
       ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
       "version": 42, # Version of the `Policy`. The default version is 0.
-      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
     },
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
-    { # Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM. **Example** { "bindings": [ { "role": "roles/owner", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role": "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).
-    "bindings": [ # Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
       { # Associates `members` with a `role`.
-        "role": "A String", # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required
-        "members": [ # Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
           "A String",
         ],
       },
     ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
     "version": 42, # Version of the `Policy`. The default version is 0.
-    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.
   }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
   <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
 
 Args:
-  resource: string, REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`. (required)
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
 { # Request message for `TestIamPermissions` method.
-    "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       "A String",
     ],
   }
 
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response message for `TestIamPermissions` method.
-    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
       "A String",
     ],
   }</pre>
diff --git a/docs/dyn/pubsub_v1beta2.projects.topics.subscriptions.html b/docs/dyn/pubsub_v1beta2.projects.topics.subscriptions.html
index 1bb1547e9d1..4fa96832045 100644
--- a/docs/dyn/pubsub_v1beta2.projects.topics.subscriptions.html
+++ b/docs/dyn/pubsub_v1beta2.projects.topics.subscriptions.html
@@ -88,14 +88,21 @@ <h3>Method Details</h3>
 Args:
   topic: string, The name of the topic that subscriptions are attached to. (required)
   pageSize: integer, Maximum number of subscription names to return.
-  pageToken: string, The value returned by the last `ListTopicSubscriptionsResponse`; indicates that this is a continuation of a prior `ListTopicSubscriptions` call, and that the system should return the next page of data.
+  pageToken: string, The value returned by the last `ListTopicSubscriptionsResponse`; indicates
+that this is a continuation of a prior `ListTopicSubscriptions` call, and
+that the system should return the next page of data.
   x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
 Returns:
   An object of the form:
 
     { # Response for the `ListTopicSubscriptions` method.
-    "nextPageToken": "A String", # If not empty, indicates that there may be more subscriptions that match the request; this value should be passed in a new `ListTopicSubscriptionsRequest` to get more subscriptions.
+    "nextPageToken": "A String", # If not empty, indicates that there may be more subscriptions that match
+        # the request; this value should be passed in a new
+        # `ListTopicSubscriptionsRequest` to get more subscriptions.
     "subscriptions": [ # The names of the subscriptions that match the request.
       "A String",
     ],
diff --git a/docs/dyn/runtimeconfig_v1beta1.projects.configs.html b/docs/dyn/runtimeconfig_v1beta1.projects.configs.html
index b25b8e3bfe5..d0dec11b5d2 100644
--- a/docs/dyn/runtimeconfig_v1beta1.projects.configs.html
+++ b/docs/dyn/runtimeconfig_v1beta1.projects.configs.html
@@ -98,12 +98,21 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#get">get(name=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets information about a RuntimeConfig resource.</p>
+<p class="toc_element">
+  <code><a href="#getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the access control policy for a resource.</p>
 <p class="toc_element">
   <code><a href="#list">list(parent=None, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
 <p class="firstline">Lists all the RuntimeConfig resources within project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the access control policy on the specified resource. Replaces any</p>
+<p class="toc_element">
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <p class="toc_element">
   <code><a href="#update">update(name=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Updates a RuntimeConfig resource. The configuration must exist beforehand.</p>
@@ -120,55 +129,56 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig
+    # service. A RuntimeConfig resource consists of metadata and a hierarchy of
+    # variables.
+  "description": "A String", # An optional description of the RuntimeConfig object.
+  "name": "A String", # The resource name of a runtime config. The name must have the format:
+      # 
+      #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
+      # 
+      # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
+      # arbitrary name that matches RFC 1035 segment specification. The length of
+      # `[CONFIG_NAME]` must be less than 64 bytes.
+      # 
+      # You pick the RuntimeConfig resource name, but the server will validate that
+      # the name adheres to this format. After you create the resource, you cannot
+      # change the resource's name.
+}
+
+  requestId: string, An optional but recommended unique <code>request_id</code>. If the server
+receives two <code>create()</code> requests  with the same
+<code>request_id</code>, then the second request will be ignored and the
+first resource created and stored in the backend is returned.
+Empty <code>request_id</code> fields are ignored.
+
+It is responsibility of the client to ensure uniqueness of the
+<code>request_id</code> strings.
+
+<code>request_id</code> strings are limited to 64 characters.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig
       # service. A RuntimeConfig resource consists of metadata and a hierarchy of
       # variables.
     "description": "A String", # An optional description of the RuntimeConfig object.
-        # The length of the description must be less than 256 bytes.
     "name": "A String", # The resource name of a runtime config. The name must have the format:
-        # 
+        #
         #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
-        # 
+        #
         # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
         # arbitrary name that matches RFC 1035 segment specification. The length of
         # `[CONFIG_NAME]` must be less than 64 bytes.
-        # 
+        #
         # You pick the RuntimeConfig resource name, but the server will validate that
         # the name adheres to this format. After you create the resource, you cannot
         # change the resource's name.
-  }
-
-  requestId: string, An optional unique request_id. If server receives two Create requests with
-the same request_id then second request will be ignored and the resource
-stored in the backend will be returned. Empty request_id fields are
-ignored.
-It is responsibility of the client to ensure uniqueness of the request_id
-strings.
-The strings are limited to 64 characters.
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig
-        # service. A RuntimeConfig resource consists of metadata and a hierarchy of
-        # variables.
-      "description": "A String", # An optional description of the RuntimeConfig object.
-          # The length of the description must be less than 256 bytes.
-      "name": "A String", # The resource name of a runtime config. The name must have the format:
-          #
-          #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
-          #
-          # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
-          # arbitrary name that matches RFC 1035 segment specification. The length of
-          # `[CONFIG_NAME]` must be less than 64 bytes.
-          #
-          # You pick the RuntimeConfig resource name, but the server will validate that
-          # the name adheres to this format. After you create the resource, you cannot
-          # change the resource's name.
-    }</pre>
+  }</pre>
 </div>
 
 <div class="method">
@@ -216,22 +226,117 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig
-        # service. A RuntimeConfig resource consists of metadata and a hierarchy of
-        # variables.
-      "description": "A String", # An optional description of the RuntimeConfig object.
-          # The length of the description must be less than 256 bytes.
-      "name": "A String", # The resource name of a runtime config. The name must have the format:
-          #
-          #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
-          #
-          # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
-          # arbitrary name that matches RFC 1035 segment specification. The length of
-          # `[CONFIG_NAME]` must be less than 64 bytes.
-          #
-          # You pick the RuntimeConfig resource name, but the server will validate that
-          # the name adheres to this format. After you create the resource, you cannot
-          # change the resource's name.
-    }</pre>
+      # service. A RuntimeConfig resource consists of metadata and a hierarchy of
+      # variables.
+    "description": "A String", # An optional description of the RuntimeConfig object.
+    "name": "A String", # The resource name of a runtime config. The name must have the format:
+        #
+        #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
+        #
+        # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
+        # arbitrary name that matches RFC 1035 segment specification. The length of
+        # `[CONFIG_NAME]` must be less than 64 bytes.
+        #
+        # You pick the RuntimeConfig resource name, but the server will validate that
+        # the name adheres to this format. After you create the resource, you cannot
+        # change the resource's name.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="getIamPolicy">getIamPolicy(resource=None, x__xgafv=None)</code>
+  <pre>Gets the access control policy for a resource.
+Returns an empty policy if the resource exists and does not have a policy
+set.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
+      { # Associates `members` with a `role`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
+          "A String",
+        ],
+      },
+    ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
+    "version": 42, # Version of the `Policy`. The default version is 0.
+  }</pre>
 </div>
 
 <div class="method">
@@ -263,22 +368,21 @@ <h3>Method Details</h3>
     "configs": [ # A list of the configurations in the project. The order of returned
         # objects is arbitrary; that is, it is not ordered in any particular way.
       { # A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig
-            # service. A RuntimeConfig resource consists of metadata and a hierarchy of
-            # variables.
-          "description": "A String", # An optional description of the RuntimeConfig object.
-              # The length of the description must be less than 256 bytes.
-          "name": "A String", # The resource name of a runtime config. The name must have the format:
-              #
-              #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
-              #
-              # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
-              # arbitrary name that matches RFC 1035 segment specification. The length of
-              # `[CONFIG_NAME]` must be less than 64 bytes.
-              #
-              # You pick the RuntimeConfig resource name, but the server will validate that
-              # the name adheres to this format. After you create the resource, you cannot
-              # change the resource's name.
-        },
+          # service. A RuntimeConfig resource consists of metadata and a hierarchy of
+          # variables.
+        "description": "A String", # An optional description of the RuntimeConfig object.
+        "name": "A String", # The resource name of a runtime config. The name must have the format:
+            #
+            #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
+            #
+            # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
+            # arbitrary name that matches RFC 1035 segment specification. The length of
+            # `[CONFIG_NAME]` must be less than 64 bytes.
+            #
+            # You pick the RuntimeConfig resource name, but the server will validate that
+            # the name adheres to this format. After you create the resource, you cannot
+            # change the resource's name.
+      },
     ],
   }</pre>
 </div>
@@ -297,6 +401,224 @@ <h3>Method Details</h3>
     </pre>
 </div>
 
+<div class="method">
+    <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+  <pre>Sets the access control policy on the specified resource. Replaces any
+existing policy.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being specified.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Request message for `SetIamPolicy` method.
+    "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
+        # the policy is limited to a few 10s of KB. An empty policy is a
+        # valid policy but certain Cloud Platform services (such as Projects)
+        # might reject them.
+        # specify access control policies for Cloud Platform resources.
+        #
+        #
+        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # `members` to a `role`, where the members can be user accounts, Google groups,
+        # Google domains, and service accounts. A `role` is a named list of permissions
+        # defined by IAM.
+        #
+        # **Example**
+        #
+        #     {
+        #       "bindings": [
+        #         {
+        #           "role": "roles/owner",
+        #           "members": [
+        #             "user:mike@example.com",
+        #             "group:admins@example.com",
+        #             "domain:google.com",
+        #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        #           ]
+        #         },
+        #         {
+        #           "role": "roles/viewer",
+        #           "members": ["user:sean@example.com"]
+        #         }
+        #       ]
+        #     }
+        #
+        # For a description of IAM and its features, see the
+        # [IAM developer's guide](https://cloud.google.com/iam).
+      "bindings": [ # Associates a list of `members` to a `role`.
+          # Multiple `bindings` must not be specified for the same `role`.
+          # `bindings` with no members will result in an error.
+        { # Associates `members` with a `role`.
+          "role": "A String", # Role that is assigned to `members`.
+              # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+              # Required
+          "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+              # `members` can have the following values:
+              #
+              # * `allUsers`: A special identifier that represents anyone who is
+              #    on the internet; with or without a Google account.
+              #
+              # * `allAuthenticatedUsers`: A special identifier that represents anyone
+              #    who is authenticated with a Google account or a service account.
+              #
+              # * `user:{emailid}`: An email address that represents a specific Google
+              #    account. For example, `alice@gmail.com` or `joe@example.com`.
+              #
+              #
+              # * `serviceAccount:{emailid}`: An email address that represents a service
+              #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+              #
+              # * `group:{emailid}`: An email address that represents a Google group.
+              #    For example, `admins@example.com`.
+              #
+              # * `domain:{domain}`: A Google Apps domain name that represents all the
+              #    users of that domain. For example, `google.com` or `example.com`.
+              #
+            "A String",
+          ],
+        },
+      ],
+      "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+          # prevent simultaneous updates of a policy from overwriting each other.
+          # It is strongly suggested that systems make use of the `etag` in the
+          # read-modify-write cycle to perform policy updates in order to avoid race
+          # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+          # systems are expected to put that etag in the request to `setIamPolicy` to
+          # ensure that their change will be applied to the same version of the policy.
+          #
+          # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+          # policy is overwritten blindly.
+      "version": 42, # Version of the `Policy`. The default version is 0.
+    },
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Defines an Identity and Access Management (IAM) policy. It is used to
+      # specify access control policies for Cloud Platform resources.
+      #
+      #
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
+      # defined by IAM.
+      #
+      # **Example**
+      #
+      #     {
+      #       "bindings": [
+      #         {
+      #           "role": "roles/owner",
+      #           "members": [
+      #             "user:mike@example.com",
+      #             "group:admins@example.com",
+      #             "domain:google.com",
+      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #           ]
+      #         },
+      #         {
+      #           "role": "roles/viewer",
+      #           "members": ["user:sean@example.com"]
+      #         }
+      #       ]
+      #     }
+      #
+      # For a description of IAM and its features, see the
+      # [IAM developer's guide](https://cloud.google.com/iam).
+    "bindings": [ # Associates a list of `members` to a `role`.
+        # Multiple `bindings` must not be specified for the same `role`.
+        # `bindings` with no members will result in an error.
+      { # Associates `members` with a `role`.
+        "role": "A String", # Role that is assigned to `members`.
+            # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+            # Required
+        "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+            # `members` can have the following values:
+            #
+            # * `allUsers`: A special identifier that represents anyone who is
+            #    on the internet; with or without a Google account.
+            #
+            # * `allAuthenticatedUsers`: A special identifier that represents anyone
+            #    who is authenticated with a Google account or a service account.
+            #
+            # * `user:{emailid}`: An email address that represents a specific Google
+            #    account. For example, `alice@gmail.com` or `joe@example.com`.
+            #
+            #
+            # * `serviceAccount:{emailid}`: An email address that represents a service
+            #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+            #
+            # * `group:{emailid}`: An email address that represents a Google group.
+            #    For example, `admins@example.com`.
+            #
+            # * `domain:{domain}`: A Google Apps domain name that represents all the
+            #    users of that domain. For example, `google.com` or `example.com`.
+            #
+          "A String",
+        ],
+      },
+    ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
+        # policy is overwritten blindly.
+    "version": 42, # Version of the `Policy`. The default version is 0.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
+  <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Request message for `TestIamPermissions` method.
+    "permissions": [ # The set of permissions to check for the `resource`. Permissions with
+        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # information see
+        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+      "A String",
+    ],
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for `TestIamPermissions` method.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
+      "A String",
+    ],
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="update">update(name=None, body, x__xgafv=None)</code>
   <pre>Updates a RuntimeConfig resource. The configuration must exist beforehand.
@@ -309,48 +631,46 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig
+    # service. A RuntimeConfig resource consists of metadata and a hierarchy of
+    # variables.
+  "description": "A String", # An optional description of the RuntimeConfig object.
+  "name": "A String", # The resource name of a runtime config. The name must have the format:
+      # 
+      #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
+      # 
+      # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
+      # arbitrary name that matches RFC 1035 segment specification. The length of
+      # `[CONFIG_NAME]` must be less than 64 bytes.
+      # 
+      # You pick the RuntimeConfig resource name, but the server will validate that
+      # the name adheres to this format. After you create the resource, you cannot
+      # change the resource's name.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig
       # service. A RuntimeConfig resource consists of metadata and a hierarchy of
       # variables.
     "description": "A String", # An optional description of the RuntimeConfig object.
-        # The length of the description must be less than 256 bytes.
     "name": "A String", # The resource name of a runtime config. The name must have the format:
-        # 
+        #
         #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
-        # 
+        #
         # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
         # arbitrary name that matches RFC 1035 segment specification. The length of
         # `[CONFIG_NAME]` must be less than 64 bytes.
-        # 
+        #
         # You pick the RuntimeConfig resource name, but the server will validate that
         # the name adheres to this format. After you create the resource, you cannot
         # change the resource's name.
-  }
-
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # A RuntimeConfig resource is the primary resource in the Cloud RuntimeConfig
-        # service. A RuntimeConfig resource consists of metadata and a hierarchy of
-        # variables.
-      "description": "A String", # An optional description of the RuntimeConfig object.
-          # The length of the description must be less than 256 bytes.
-      "name": "A String", # The resource name of a runtime config. The name must have the format:
-          #
-          #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]
-          #
-          # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
-          # arbitrary name that matches RFC 1035 segment specification. The length of
-          # `[CONFIG_NAME]` must be less than 64 bytes.
-          #
-          # You pick the RuntimeConfig resource name, but the server will validate that
-          # the name adheres to this format. After you create the resource, you cannot
-          # change the resource's name.
-    }</pre>
+  }</pre>
 </div>
 
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/runtimeconfig_v1beta1.projects.configs.operations.html b/docs/dyn/runtimeconfig_v1beta1.projects.configs.operations.html
index 3ce5357ffb1..4c62c597090 100644
--- a/docs/dyn/runtimeconfig_v1beta1.projects.configs.operations.html
+++ b/docs/dyn/runtimeconfig_v1beta1.projects.configs.operations.html
@@ -77,6 +77,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the latest state of a long-running operation.  Clients can use this</p>
+<p class="toc_element">
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, x__xgafv=None, permissions=None)</a></code></p>
+<p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="get">get(name, x__xgafv=None)</code>
@@ -184,4 +187,34 @@ <h3>Method Details</h3>
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, x__xgafv=None, permissions=None)</code>
+  <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  permissions: string, The set of permissions to check for the `resource`. Permissions with
+wildcards (such as '*' or 'storage.*') are not allowed. For more
+information see
+[IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Response message for `TestIamPermissions` method.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
+      "A String",
+    ],
+  }</pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/runtimeconfig_v1beta1.projects.configs.variables.html b/docs/dyn/runtimeconfig_v1beta1.projects.configs.variables.html
index 003e45557f3..b1837b94707 100644
--- a/docs/dyn/runtimeconfig_v1beta1.projects.configs.variables.html
+++ b/docs/dyn/runtimeconfig_v1beta1.projects.configs.variables.html
@@ -89,6 +89,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, x__xgafv=None, permissions=None)</a></code></p>
+<p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <p class="toc_element">
   <code><a href="#update">update(name=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Updates an existing variable with a new value.</p>
@@ -119,17 +122,16 @@ <h3>Method Details</h3>
     # `ports/serving_port` is a valid variable name. The variable value is an
     # opaque string and only leaf variables can have values (that is, variables
     # that do not have any child variables).
-  "text": "A String", # The textual value of the variable. The length of the value must be less
-      # than 4096 bytes. Empty values are also accepted.
-      # NB: Only one of value and string_value can be set at the same time.
+  "text": "A String", # The string value of the variable. The length of the value must be less
+      # than 4096 bytes. Empty values are also accepted. For example,
+      # <code>text: "my text value"</code>.
   "updateTime": "A String", # [Output Only] The time of the last variable update.
   "state": "A String", # [Ouput only] The current state of the variable. The variable state indicates
       # the outcome of the `variables().watch` call and is visible through the
       # `get` and `list` calls.
   "value": "A String", # The binary value of the variable. The length of the value must be less
       # than 4096 bytes. Empty values are also accepted. The value must be
-      # Base64 encoded.
-      # NB: Only one of value and string_value can be set at the same time.
+      # base64 encoded. Only one of `value` or `text` can be set.
   "name": "A String", # The name of the variable resource, in the format:
       # 
       #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
@@ -148,13 +150,16 @@ <h3>Method Details</h3>
       # Once you create a variable, you cannot change the variable name.
 }
 
-  requestId: string, An optional unique request_id. If server receives two Create requests with
-the same request_id then second request will be ignored and the resource
-stored in the backend will be returned. Empty request_id fields are
-ignored.
-It is responsibility of the client to ensure uniqueness of the request_id
-strings.
-The strings are limited to 64 characters.
+  requestId: string, An optional but recommended unique <code>request_id</code>. If the server
+receives two <code>create()</code> requests  with the same
+<code>request_id</code>, then the second request will be ignored and the
+first resource created and stored in the backend is returned.
+Empty <code>request_id</code> fields are ignored.
+
+It is responsibility of the client to ensure uniqueness of the
+<code>request_id</code> strings.
+
+<code>request_id</code> strings are limited to 64 characters.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -168,17 +173,16 @@ <h3>Method Details</h3>
       # `ports/serving_port` is a valid variable name. The variable value is an
       # opaque string and only leaf variables can have values (that is, variables
       # that do not have any child variables).
-    "text": "A String", # The textual value of the variable. The length of the value must be less
-        # than 4096 bytes. Empty values are also accepted.
-        # NB: Only one of value and string_value can be set at the same time.
+    "text": "A String", # The string value of the variable. The length of the value must be less
+        # than 4096 bytes. Empty values are also accepted. For example,
+        # <code>text: "my text value"</code>.
     "updateTime": "A String", # [Output Only] The time of the last variable update.
     "state": "A String", # [Ouput only] The current state of the variable. The variable state indicates
         # the outcome of the `variables().watch` call and is visible through the
         # `get` and `list` calls.
     "value": "A String", # The binary value of the variable. The length of the value must be less
         # than 4096 bytes. Empty values are also accepted. The value must be
-        # Base64 encoded.
-        # NB: Only one of value and string_value can be set at the same time.
+        # base64 encoded. Only one of `value` or `text` can be set.
     "name": "A String", # The name of the variable resource, in the format:
         #
         #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
@@ -254,17 +258,16 @@ <h3>Method Details</h3>
       # `ports/serving_port` is a valid variable name. The variable value is an
       # opaque string and only leaf variables can have values (that is, variables
       # that do not have any child variables).
-    "text": "A String", # The textual value of the variable. The length of the value must be less
-        # than 4096 bytes. Empty values are also accepted.
-        # NB: Only one of value and string_value can be set at the same time.
+    "text": "A String", # The string value of the variable. The length of the value must be less
+        # than 4096 bytes. Empty values are also accepted. For example,
+        # <code>text: "my text value"</code>.
     "updateTime": "A String", # [Output Only] The time of the last variable update.
     "state": "A String", # [Ouput only] The current state of the variable. The variable state indicates
         # the outcome of the `variables().watch` call and is visible through the
         # `get` and `list` calls.
     "value": "A String", # The binary value of the variable. The length of the value must be less
         # than 4096 bytes. Empty values are also accepted. The value must be
-        # Base64 encoded.
-        # NB: Only one of value and string_value can be set at the same time.
+        # base64 encoded. Only one of `value` or `text` can be set.
     "name": "A String", # The name of the variable resource, in the format:
         #
         #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
@@ -322,17 +325,16 @@ <h3>Method Details</h3>
           # `ports/serving_port` is a valid variable name. The variable value is an
           # opaque string and only leaf variables can have values (that is, variables
           # that do not have any child variables).
-        "text": "A String", # The textual value of the variable. The length of the value must be less
-            # than 4096 bytes. Empty values are also accepted.
-            # NB: Only one of value and string_value can be set at the same time.
+        "text": "A String", # The string value of the variable. The length of the value must be less
+            # than 4096 bytes. Empty values are also accepted. For example,
+            # <code>text: "my text value"</code>.
         "updateTime": "A String", # [Output Only] The time of the last variable update.
         "state": "A String", # [Ouput only] The current state of the variable. The variable state indicates
             # the outcome of the `variables().watch` call and is visible through the
             # `get` and `list` calls.
         "value": "A String", # The binary value of the variable. The length of the value must be less
             # than 4096 bytes. Empty values are also accepted. The value must be
-            # Base64 encoded.
-            # NB: Only one of value and string_value can be set at the same time.
+            # base64 encoded. Only one of `value` or `text` can be set.
         "name": "A String", # The name of the variable resource, in the format:
             #
             #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
@@ -368,6 +370,36 @@ <h3>Method Details</h3>
     </pre>
 </div>
 
+<div class="method">
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, x__xgafv=None, permissions=None)</code>
+  <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  permissions: string, The set of permissions to check for the `resource`. Permissions with
+wildcards (such as '*' or 'storage.*') are not allowed. For more
+information see
+[IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Response message for `TestIamPermissions` method.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
+      "A String",
+    ],
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="update">update(name=None, body, x__xgafv=None)</code>
   <pre>Updates an existing variable with a new value.
@@ -384,17 +416,16 @@ <h3>Method Details</h3>
     # `ports/serving_port` is a valid variable name. The variable value is an
     # opaque string and only leaf variables can have values (that is, variables
     # that do not have any child variables).
-  "text": "A String", # The textual value of the variable. The length of the value must be less
-      # than 4096 bytes. Empty values are also accepted.
-      # NB: Only one of value and string_value can be set at the same time.
+  "text": "A String", # The string value of the variable. The length of the value must be less
+      # than 4096 bytes. Empty values are also accepted. For example,
+      # <code>text: "my text value"</code>.
   "updateTime": "A String", # [Output Only] The time of the last variable update.
   "state": "A String", # [Ouput only] The current state of the variable. The variable state indicates
       # the outcome of the `variables().watch` call and is visible through the
       # `get` and `list` calls.
   "value": "A String", # The binary value of the variable. The length of the value must be less
       # than 4096 bytes. Empty values are also accepted. The value must be
-      # Base64 encoded.
-      # NB: Only one of value and string_value can be set at the same time.
+      # base64 encoded. Only one of `value` or `text` can be set.
   "name": "A String", # The name of the variable resource, in the format:
       # 
       #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
@@ -426,17 +457,16 @@ <h3>Method Details</h3>
       # `ports/serving_port` is a valid variable name. The variable value is an
       # opaque string and only leaf variables can have values (that is, variables
       # that do not have any child variables).
-    "text": "A String", # The textual value of the variable. The length of the value must be less
-        # than 4096 bytes. Empty values are also accepted.
-        # NB: Only one of value and string_value can be set at the same time.
+    "text": "A String", # The string value of the variable. The length of the value must be less
+        # than 4096 bytes. Empty values are also accepted. For example,
+        # <code>text: "my text value"</code>.
     "updateTime": "A String", # [Output Only] The time of the last variable update.
     "state": "A String", # [Ouput only] The current state of the variable. The variable state indicates
         # the outcome of the `variables().watch` call and is visible through the
         # `get` and `list` calls.
     "value": "A String", # The binary value of the variable. The length of the value must be less
         # than 4096 bytes. Empty values are also accepted. The value must be
-        # Base64 encoded.
-        # NB: Only one of value and string_value can be set at the same time.
+        # base64 encoded. Only one of `value` or `text` can be set.
     "name": "A String", # The name of the variable resource, in the format:
         #
         #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
@@ -501,17 +531,16 @@ <h3>Method Details</h3>
       # `ports/serving_port` is a valid variable name. The variable value is an
       # opaque string and only leaf variables can have values (that is, variables
       # that do not have any child variables).
-    "text": "A String", # The textual value of the variable. The length of the value must be less
-        # than 4096 bytes. Empty values are also accepted.
-        # NB: Only one of value and string_value can be set at the same time.
+    "text": "A String", # The string value of the variable. The length of the value must be less
+        # than 4096 bytes. Empty values are also accepted. For example,
+        # <code>text: "my text value"</code>.
     "updateTime": "A String", # [Output Only] The time of the last variable update.
     "state": "A String", # [Ouput only] The current state of the variable. The variable state indicates
         # the outcome of the `variables().watch` call and is visible through the
         # `get` and `list` calls.
     "value": "A String", # The binary value of the variable. The length of the value must be less
         # than 4096 bytes. Empty values are also accepted. The value must be
-        # Base64 encoded.
-        # NB: Only one of value and string_value can be set at the same time.
+        # base64 encoded. Only one of `value` or `text` can be set.
     "name": "A String", # The name of the variable resource, in the format:
         #
         #     projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]
diff --git a/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html b/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html
index 90e131b5413..01ec336a551 100644
--- a/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html
+++ b/docs/dyn/runtimeconfig_v1beta1.projects.configs.waiters.html
@@ -89,6 +89,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#testIamPermissions">testIamPermissions(resource=None, x__xgafv=None, permissions=None)</a></code></p>
+<p class="firstline">Returns permissions that a caller has on the specified resource.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="create">create(parent=None, body, requestId=None, x__xgafv=None)</code>
@@ -256,13 +259,16 @@ <h3>Method Details</h3>
         # waiter.
   }
 
-  requestId: string, An optional unique request_id. If server receives two Create requests with
-the same request_id then second request will be ignored and information
-stored in the backend will be returned. Empty request_id fields are
-ignored.
-It is responsibility of the client to ensure uniqueness of the request_id
-strings.
-The strings are limited to 64 characters.
+  requestId: string, An optional but recommended unique <code>request_id</code>. If the server
+receives two <code>create()</code> requests  with the same
+<code>request_id</code>, then the second request will be ignored and the
+first resource created and stored in the backend is returned.
+Empty <code>request_id</code> fields are ignored.
+
+It is responsibility of the client to ensure uniqueness of the
+<code>request_id</code> strings.
+
+<code>request_id</code> strings are limited to 64 characters.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -753,4 +759,34 @@ <h3>Method Details</h3>
     </pre>
 </div>
 
+<div class="method">
+    <code class="details" id="testIamPermissions">testIamPermissions(resource=None, x__xgafv=None, permissions=None)</code>
+  <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy detail is being requested.
+`resource` is usually specified as a path. For example, a Project
+resource is specified as `projects/{project}`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  permissions: string, The set of permissions to check for the `resource`. Permissions with
+wildcards (such as '*' or 'storage.*') are not allowed. For more
+information see
+[IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). (repeated)
+
+Returns:
+  An object of the form:
+
+    { # Response message for `TestIamPermissions` method.
+    "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # allowed.
+      "A String",
+    ],
+  }</pre>
+</div>
+
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/servicecontrol_v1.services.html b/docs/dyn/servicecontrol_v1.services.html
index 0fec2b98eba..c36709090ff 100644
--- a/docs/dyn/servicecontrol_v1.services.html
+++ b/docs/dyn/servicecontrol_v1.services.html
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Checks an operation with Google Service Control to decide whether</p>
 <p class="toc_element">
   <code><a href="#report">report(serviceName=None, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Reports operations to Google Service Control. It should be called</p>
+<p class="firstline">Reports operation results to Google Service Control, such as logs and</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="check">check(serviceName=None, body, x__xgafv=None)</code>
@@ -87,6 +87,12 @@ <h3>Method Details</h3>
 the given operation should proceed. It should be called before the
 operation is executed.
 
+If feasible, the client should cache the check results and reuse them for
+60 seconds. In case of server errors, the client can rely on the cached
+results for longer time.
+
+NOTE: the `CheckRequest` has the size limit of 1MB.
+
 This method requires the `servicemanagement.services.check` permission
 on the specified service. For more information, see
 [Google Cloud IAM](https://cloud.google.com/iam).
@@ -279,6 +285,11 @@ <h3>Method Details</h3>
           # and an idempotent id is desirable for deduplication purpose, UUID version 5
           # is recommended. See RFC 4122 for details.
     },
+    "serviceConfigId": "A String", # Specifies which version of service configuration should be used to process
+        # the request.
+        # 
+        # If unspecified or no matching version can be found, the
+        # latest one will be used.
   }
 
   x__xgafv: string, V1 error format.
@@ -309,8 +320,16 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="report">report(serviceName=None, body, x__xgafv=None)</code>
-  <pre>Reports operations to Google Service Control. It should be called
-after the operation is completed.
+  <pre>Reports operation results to Google Service Control, such as logs and
+metrics. It should be called after an operation is completed.
+
+If feasible, the client should aggregate reporting data for up to 5
+seconds to reduce API traffic. Limiting aggregation to 5 seconds is to
+reduce data loss during client crashes. Clients should carefully choose
+the aggregation time window to avoid data loss risk more than 0.01%
+for business and compliance reasons.
+
+NOTE: the `ReportRequest` has the size limit of 1MB.
 
 This method requires the `servicemanagement.services.report` permission
 on the specified service. For more information, see
@@ -515,6 +534,11 @@ <h3>Method Details</h3>
             # is recommended. See RFC 4122 for details.
       },
     ],
+    "serviceConfigId": "A String", # Specifies which version of service config should be used to process the
+        # request.
+        # 
+        # If unspecified or no matching version can be found, the
+        # latest one will be used.
   }
 
   x__xgafv: string, V1 error format.
@@ -538,8 +562,9 @@ <h3>Method Details</h3>
         #    `Operations` in the request succeeded. Each
         #    `Operation` that failed processing has a corresponding item
         #    in this list.
-        # 3. A failed RPC status indicates a complete failure where none of the
-        #    `Operations` in the request succeeded.
+        # 3. A failed RPC status indicates a general non-deterministic failure.
+        #    When this happens, it's impossible to know which of the
+        #    'Operations' in the request succeeded or failed.
       { # Represents the processing error of one `Operation` in the request.
         "status": { # The `Status` type defines a logical error model that is suitable for different # Details of the error when processing the `Operation`.
             # programming environments, including REST APIs and RPC APIs. It is used by
diff --git a/docs/dyn/servicemanagement_v1.services.configs.html b/docs/dyn/servicemanagement_v1.services.configs.html
index 68ed0ea35c9..752a76450b6 100644
--- a/docs/dyn/servicemanagement_v1.services.configs.html
+++ b/docs/dyn/servicemanagement_v1.services.configs.html
@@ -117,10 +117,15 @@ <h3>Method Details</h3>
     #     title: Google Calendar API
     #     apis:
     #     - name: google.calendar.v3.Calendar
-    #     backend:
+    #     authentication:
+    #       providers:
+    #       - id: google_calendar_auth
+    #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+    #         issuer: https://securetoken.google.com
     #       rules:
-    #       - selector: "google.calendar.v3.*"
-    #         address: calendar.example.com
+    #       - selector: "*"
+    #         requirements:
+    #           provider_id: google_calendar_auth
   "control": { # Selects and configures the service controller used by the service.  The # Configuration for the service control plane.
       # service controller handles features like abuse, quota, billing, logging,
       # monitoring, etc.
@@ -192,56 +197,6 @@ <h3>Method Details</h3>
           # slash, underscore, hyphen, period [/_-.].
     },
   ],
-  "analytics": { # Analytics configuration of the service. # WARNING: DO NOT USE UNTIL THIS MESSAGE IS REMOVED.
-      # 
-      # Analytics configuration.
-      #
-      # The example below shows how to configure monitored resources and metrics
-      # for analytics. In the example, a monitored resource and two metrics are
-      # defined. The `library.googleapis.com/book/returned_count` and
-      # `library.googleapis.com/book/overdue_count` metric are sent
-      # to the analytics.
-      #
-      #     monitored_resources:
-      #     - type: library.googleapis.com/branch
-      #       labels:
-      #       - key: /city
-      #         description: The city where the library branch is located in.
-      #       - key: /name
-      #         description: The name of the branch.
-      #     metrics:
-      #     - name: library.googleapis.com/book/returned_count
-      #       metric_kind: DELTA
-      #       value_type: INT64
-      #       labels:
-      #       - key: /customer_id
-      #     - name: library.googleapis.com/book/overdue_count
-      #       metric_kind: GAUGE
-      #       value_type: INT64
-      #       labels:
-      #       - key: /customer_id
-      #     analytics:
-      #       producer_destinations:
-      #       - monitored_resource: library.googleapis.com/branch
-      #         metrics:
-      #         - library.googleapis.com/book/returned_count
-      #         - library.googleapis.com/book/overdue_count
-    "producerDestinations": [ # Analytics configurations for sending metrics to the analytics backend.
-        # There can be multiple producer destinations, each one must have a
-        # different monitored resource type. A metric can be used in at most
-        # one producer destination.
-      { # Configuration of a specific analytics destination.
-        "monitoredResource": "A String", # The monitored resource type. The type must be defined in
-            # Service.monitored_resources section.
-        "metrics": [ # Names of the metrics to report to this analytics destination.
-            # Each name must be defined in Service.metrics section. Metrics
-            # with value type BOOL and STRING must be of GUAGE kind, metrics with
-            # value type INT64, DOUBLE and MONEY must be of DELTA kind.
-          "A String",
-        ],
-      },
-    ],
-  },
   "systemParameters": { # ### System parameter configuration # System parameter configuration.
       #
       # A system parameter is a special kind of parameter defined by the API
@@ -255,27 +210,26 @@ <h3>Method Details</h3>
         # config, default system parameters will be used. Default system parameters
         # and names is implementation-dependent.
         #
-        # Example: define api key and alt name for all methods
+        # Example: define api key for all methods
+        #
+        #     system_parameters
+        #       rules:
+        #         - selector: "*"
+        #           parameters:
+        #             - name: api_key
+        #               url_query_parameter: api_key
         #
-        # system_parameters
-        #   rules:
-        #     - selector: "*"
-        #       parameters:
-        #         - name: api_key
-        #           url_query_parameter: api_key
-        #         - name: alt
-        #           http_header: Response-Content-Type
         #
         # Example: define 2 api key names for a specific method.
         #
-        # system_parameters
-        #   rules:
-        #     - selector: "/ListShelves"
-        #       parameters:
-        #         - name: api_key
-        #           http_header: Api-Key1
-        #         - name: api_key
-        #           http_header: Api-Key2
+        #     system_parameters
+        #       rules:
+        #         - selector: "/ListShelves"
+        #           parameters:
+        #             - name: api_key
+        #               http_header: Api-Key1
+        #             - name: api_key
+        #               http_header: Api-Key2
         #
         # **NOTE:** All service configuration rules follow "last one wins" order.
       { # Define a system parameter rule mapping system parameter definitions to
@@ -290,8 +244,7 @@ <h3>Method Details</h3>
               # is implementation-dependent.
             "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
                 # sensitive.
-            "name": "A String", # Define the name of the parameter, such as "api_key", "alt", "callback",
-                # and etc. It is case sensitive.
+            "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
             "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
                 # insensitive.
           },
@@ -393,14 +346,14 @@ <h3>Method Details</h3>
       #
       #     name: calendar.googleapis.com
       #     authentication:
+      #       providers:
+      #       - id: google_calendar_auth
+      #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+      #         issuer: https://securetoken.google.com
       #       rules:
       #       - selector: "*"
-      #         oauth:
-      #           canonical_scopes: https://www.googleapis.com/auth/calendar
-      #
-      #       - selector: google.calendar.Delegate
-      #         oauth:
-      #           canonical_scopes: https://www.googleapis.com/auth/calendar.read
+      #         requirements:
+      #           provider_id: google_calendar_auth
     "rules": [ # A list of authentication rules that apply to individual API methods.
         #
         # **NOTE:** All service configuration rules follow "last one wins" order.
@@ -447,7 +400,10 @@ <h3>Method Details</h3>
                 # Example:
                 #
                 #     provider_id: bookstore_auth
-            "audiences": "A String", # The list of JWT
+            "audiences": "A String", # NOTE: This will be deprecated soon, once AuthProvider.audiences is
+                # implemented and accepted in all the runtime components.
+                #
+                # The list of JWT
                 # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
                 # that are allowed to access. A JWT containing any of these audiences will
                 # be accepted. When this setting is absent, only JWTs with audience
@@ -486,6 +442,19 @@ <h3>Method Details</h3>
             #  - can be inferred from the email domain of the issuer (e.g. a Google service account).
             #
             # Example: https://www.googleapis.com/oauth2/v1/certs
+        "audiences": "A String", # The list of JWT
+            # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
+            # that are allowed to access. A JWT containing any of these audiences will
+            # be accepted. When this setting is absent, only JWTs with audience
+            # "https://Service_name/API_name"
+            # will be accepted. For example, if no audiences are in the setting,
+            # LibraryService API will only accept JWTs with the following audience
+            # "https://library-example.googleapis.com/google.example.library.v1.LibraryService".
+            #
+            # Example:
+            #
+            #     audiences: bookstore_android.apps.googleusercontent.com,
+            #                bookstore_web.apps.googleusercontent.com
         "id": "A String", # The unique identifier of the auth provider. It will be referred to by
             # `AuthRequirement.provider_id`.
             #
@@ -535,6 +504,14 @@ <h3>Method Details</h3>
         "allowUnregisteredCalls": True or False, # True, if the method allows unregistered calls; false otherwise.
       },
     ],
+    "producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
+        # service producer.
+        #
+        # Google Service Management currently only supports
+        # [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification
+        # channel. To use Google Cloud Pub/Sub as the channel, this must be the name
+        # of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
+        # documented in https://cloud.google.com/pubsub/docs/overview.
     "requirements": [ # Requirements that must be satisfied before a consumer project can use the
         # service. Each requirement is of the form <service.name>/<requirement-id>;
         # for example 'serviceusage.googleapis.com/billing-enabled'.
@@ -566,23 +543,30 @@ <h3>Method Details</h3>
           # message, as in the example below which describes a REST GET
           # operation on a resource collection of messages:
           #
-          # ```proto
-          # service Messaging {
-          #   rpc GetMessage(GetMessageRequest) returns (Message) {
-          #     option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
-          #   }
-          # }
-          # message GetMessageRequest {
-          #   message SubMessage {
-          #     string subfield = 1;
-          #   }
-          #   string message_id = 1; // mapped to the URL
-          #   SubMessage sub = 2;    // `sub.subfield` is url-mapped
-          # }
-          # message Message {
-          #   string text = 1; // content of the resource
-          # }
-          # ```
+          #
+          #     service Messaging {
+          #       rpc GetMessage(GetMessageRequest) returns (Message) {
+          #         option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
+          #       }
+          #     }
+          #     message GetMessageRequest {
+          #       message SubMessage {
+          #         string subfield = 1;
+          #       }
+          #       string message_id = 1; // mapped to the URL
+          #       SubMessage sub = 2;    // `sub.subfield` is url-mapped
+          #     }
+          #     message Message {
+          #       string text = 1; // content of the resource
+          #     }
+          #
+          # The same http annotation can alternatively be expressed inside the
+          # `GRPC API Configuration` YAML file.
+          #
+          #     http:
+          #       rules:
+          #         - selector: <proto_package_name>.Messaging.GetMessage
+          #           get: /v1/messages/{message_id}/{sub.subfield}
           #
           # This definition enables an automatic, bidrectional mapping of HTTP
           # JSON to RPC. Example:
@@ -599,16 +583,16 @@ <h3>Method Details</h3>
           # pattern automatically become (optional) HTTP query
           # parameters. Assume the following definition of the request message:
           #
-          # ```proto
-          # message GetMessageRequest {
-          #   message SubMessage {
-          #     string subfield = 1;
-          #   }
-          #   string message_id = 1; // mapped to the URL
-          #   int64 revision = 2;    // becomes a parameter
-          #   SubMessage sub = 3;    // `sub.subfield` becomes a parameter
-          # }
-          # ```
+          #
+          #     message GetMessageRequest {
+          #       message SubMessage {
+          #         string subfield = 1;
+          #       }
+          #       string message_id = 1; // mapped to the URL
+          #       int64 revision = 2;    // becomes a parameter
+          #       SubMessage sub = 3;    // `sub.subfield` becomes a parameter
+          #     }
+          #
           #
           # This enables a HTTP JSON to RPC mapping as below:
           #
@@ -625,20 +609,20 @@ <h3>Method Details</h3>
           # specifies the mapping. Consider a REST update method on the
           # message resource collection:
           #
-          # ```proto
-          # service Messaging {
-          #   rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
-          #     option (google.api.http) = {
-          #       put: "/v1/messages/{message_id}"
-          #       body: "message"
-          #     };
-          #   }
-          # }
-          # message UpdateMessageRequest {
-          #   string message_id = 1; // mapped to the URL
-          #   Message message = 2;   // mapped to the body
-          # }
-          # ```
+          #
+          #     service Messaging {
+          #       rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
+          #         option (google.api.http) = {
+          #           put: "/v1/messages/{message_id}"
+          #           body: "message"
+          #         };
+          #       }
+          #     }
+          #     message UpdateMessageRequest {
+          #       string message_id = 1; // mapped to the URL
+          #       Message message = 2;   // mapped to the body
+          #     }
+          #
           #
           # The following HTTP JSON to RPC mapping is enabled, where the
           # representation of the JSON in the request body is determined by
@@ -653,20 +637,19 @@ <h3>Method Details</h3>
           # request body.  This enables the following alternative definition of
           # the update method:
           #
-          # ```proto
-          # service Messaging {
-          #   rpc UpdateMessage(Message) returns (Message) {
-          #     option (google.api.http) = {
-          #       put: "/v1/messages/{message_id}"
-          #       body: "*"
-          #     };
-          #   }
-          # }
-          # message Message {
-          #   string message_id = 1;
-          #   string text = 2;
-          # }
-          # ```
+          #     service Messaging {
+          #       rpc UpdateMessage(Message) returns (Message) {
+          #         option (google.api.http) = {
+          #           put: "/v1/messages/{message_id}"
+          #           body: "*"
+          #         };
+          #       }
+          #     }
+          #     message Message {
+          #       string message_id = 1;
+          #       string text = 2;
+          #     }
+          #
           #
           # The following HTTP JSON to RPC mapping is enabled:
           #
@@ -683,22 +666,21 @@ <h3>Method Details</h3>
           # It is possible to define multiple HTTP methods for one RPC by using
           # the `additional_bindings` option. Example:
           #
-          # ```proto
-          # service Messaging {
-          #   rpc GetMessage(GetMessageRequest) returns (Message) {
-          #     option (google.api.http) = {
-          #       get: "/v1/messages/{message_id}"
-          #       additional_bindings {
-          #         get: "/v1/users/{user_id}/messages/{message_id}"
+          #     service Messaging {
+          #       rpc GetMessage(GetMessageRequest) returns (Message) {
+          #         option (google.api.http) = {
+          #           get: "/v1/messages/{message_id}"
+          #           additional_bindings {
+          #             get: "/v1/users/{user_id}/messages/{message_id}"
+          #           }
+          #         };
           #       }
-          #     };
-          #   }
-          # }
-          # message GetMessageRequest {
-          #   string message_id = 1;
-          #   string user_id = 2;
-          # }
-          # ```
+          #     }
+          #     message GetMessageRequest {
+          #       string message_id = 1;
+          #       string user_id = 2;
+          #     }
+          #
           #
           # This enables the following two alternative HTTP JSON to RPC
           # mappings:
@@ -739,7 +721,7 @@ <h3>Method Details</h3>
           #
           # The syntax `**` matches zero or more path segments. It follows the semantics
           # of [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.3 Reserved
-          # Expansion.
+          # Expansion. NOTE: it must be the last segment in the path except the Verb.
           #
           # The syntax `LITERAL` matches literal text in the URL path.
           #
@@ -758,7 +740,7 @@ <h3>Method Details</h3>
         "body": "A String", # The name of the request field whose value is mapped to the HTTP body, or
             # `*` for mapping all fields not captured by the path pattern to the HTTP
             # body. NOTE: the referred field must not be a repeated field and must be
-            # present at the top-level of response message type.
+            # present at the top-level of request message type.
         "get": "A String", # Used for listing and getting information about resources.
         "mediaDownload": { # Do not use this. For media support, add instead # Do not use this. For media support, add instead
             # [][google.bytestream.RestByteStream] as an API to your
@@ -815,8 +797,14 @@ <h3>Method Details</h3>
           "options": [ # Any metadata attached to the method.
             { # A protocol buffer option, which can be attached to a message, field,
                 # enumeration, etc.
-              "name": "A String", # The option's name. For example, `"java_package"`.
-              "value": { # The option's value. For example, `"com.google.protobuf"`.
+              "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                  # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                  # For custom options, it should be the fully-qualified name. For example,
+                  # `"google.api.http"`.
+              "value": { # The option's value packed in an Any message. If the value is a primitive,
+                  # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                  # should be used. If the value is an enum, it should be stored as an int32
+                  # value using the google.protobuf.Int32Value type.
                 "a_key": "", # Properties of the object. Contains field @type with type URL.
               },
             },
@@ -936,8 +924,14 @@ <h3>Method Details</h3>
       "options": [ # Any metadata attached to the API.
         { # A protocol buffer option, which can be attached to a message, field,
             # enumeration, etc.
-          "name": "A String", # The option's name. For example, `"java_package"`.
-          "value": { # The option's value. For example, `"com.google.protobuf"`.
+          "name": "A String", # The option's name. For protobuf built-in options (options defined in
+              # descriptor.proto), this is the short name. For example, `"map_entry"`.
+              # For custom options, it should be the fully-qualified name. For example,
+              # `"google.api.http"`.
+          "value": { # The option's value packed in an Any message. If the value is a primitive,
+              # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+              # should be used. If the value is an enum, it should be stored as an int32
+              # value using the google.protobuf.Int32Value type.
             "a_key": "", # Properties of the object. Contains field @type with type URL.
           },
         },
@@ -1020,7 +1014,9 @@ <h3>Method Details</h3>
     ],
   },
   "metrics": [ # Defines the metrics used by this service.
-    { # Defines a metric type and its schema.
+    { # Defines a metric type and its schema. Once a metric descriptor is created,
+        # deleting or altering it stops data collection and makes the metric type's
+        # existing data unusable.
       "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
           # Use sentence case without an ending period, for example "Request count".
       "description": "A String", # A detailed description of the metric, which can be used in documentation.
@@ -1028,29 +1024,25 @@ <h3>Method Details</h3>
           # Some combinations of `metric_kind` and `value_type` might not be supported.
       "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
           # Some combinations of `metric_kind` and `value_type` might not be supported.
-      "labels": [ # The set of labels that can be used to describe a specific instance of this
-          # metric type. For example, the
-          # `compute.googleapis.com/instance/network/received_bytes_count` metric type
-          # has a label, `loadbalanced`, that specifies whether the traffic was
-          # received through a load balanced IP address.
+      "labels": [ # The set of labels that can be used to describe a specific
+          # instance of this metric type. For example, the
+          # `appengine.googleapis.com/http/server/response_latencies` metric
+          # type has a label for the HTTP response code, `response_code`, so
+          # you can look at latencies for successful responses or just
+          # for responses that failed.
         { # A description of a label.
           "valueType": "A String", # The type of data that can be assigned to the label.
           "description": "A String", # A human-readable description for the label.
           "key": "A String", # The label key.
         },
       ],
-      "type": "A String", # The metric type including a DNS name prefix, for example
-          # `"compute.googleapis.com/instance/cpu/utilization"`. Metric types
-          # should use a natural hierarchical grouping such as the following:
-          #
-          #     compute.googleapis.com/instance/cpu/utilization
-          #     compute.googleapis.com/instance/disk/read_ops_count
-          #     compute.googleapis.com/instance/network/received_bytes_count
+      "type": "A String", # The metric type, including its DNS name prefix. The type is not
+          # URL-encoded.  All user-defined metric types have the DNS name
+          # `custom.googleapis.com`.  Metric types should use a natural hierarchical
+          # grouping. For example:
           #
-          # Note that if the metric type changes, the monitoring data will be
-          # discontinued, and anything depends on it will break, such as monitoring
-          # dashboards, alerting rules and quota limits. Therefore, once a metric has
-          # been published, its type should be immutable.
+          #     "custom.googleapis.com/invoice/paid/amount"
+          #     "appengine.googleapis.com/http/server/response_latencies"
       "unit": "A String", # The unit in which the metric value is reported. It is only applicable
           # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
           # supported units are a subset of [The Unified Code for Units of
@@ -1115,11 +1107,14 @@ <h3>Method Details</h3>
           #    `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
           # * `NAME` is a sequence of non-blank printable ASCII characters not
           #    containing '{' or '}'.
-      "name": "A String", # Resource name. The format of the name may vary between different
-          # implementations. For examples:
+      "name": "A String", # The resource name of the metric descriptor. Depending on the
+          # implementation, the name typically includes: (1) the parent resource name
+          # that defines the scope of the metric type or of its data; and (2) the
+          # metric's URL-encoded type, which also appears in the `type` field of this
+          # descriptor. For example, following is the resource name of a custom
+          # metric within the GCP project 123456789:
           #
-          #     projects/{project_id}/metricDescriptors/{type=**}
-          #     metricDescriptors/{type=**}
+          #     "projects/123456789/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
     },
   ],
   "enums": [ # A list of all enum types included in this API service.  Enums
@@ -1141,8 +1136,14 @@ <h3>Method Details</h3>
           "options": [ # Protocol buffer options.
             { # A protocol buffer option, which can be attached to a message, field,
                 # enumeration, etc.
-              "name": "A String", # The option's name. For example, `"java_package"`.
-              "value": { # The option's value. For example, `"com.google.protobuf"`.
+              "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                  # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                  # For custom options, it should be the fully-qualified name. For example,
+                  # `"google.api.http"`.
+              "value": { # The option's value packed in an Any message. If the value is a primitive,
+                  # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                  # should be used. If the value is an enum, it should be stored as an int32
+                  # value using the google.protobuf.Int32Value type.
                 "a_key": "", # Properties of the object. Contains field @type with type URL.
               },
             },
@@ -1153,8 +1154,14 @@ <h3>Method Details</h3>
       "options": [ # Protocol buffer options.
         { # A protocol buffer option, which can be attached to a message, field,
             # enumeration, etc.
-          "name": "A String", # The option's name. For example, `"java_package"`.
-          "value": { # The option's value. For example, `"com.google.protobuf"`.
+          "name": "A String", # The option's name. For protobuf built-in options (options defined in
+              # descriptor.proto), this is the short name. For example, `"map_entry"`.
+              # For custom options, it should be the fully-qualified name. For example,
+              # `"google.api.http"`.
+          "value": { # The option's value packed in an Any message. If the value is a primitive,
+              # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+              # should be used. If the value is an enum, it should be stored as an int32
+              # value using the google.protobuf.Int32Value type.
             "a_key": "", # Properties of the object. Contains field @type with type URL.
           },
         },
@@ -1197,8 +1204,14 @@ <h3>Method Details</h3>
           "options": [ # The protocol buffer options.
             { # A protocol buffer option, which can be attached to a message, field,
                 # enumeration, etc.
-              "name": "A String", # The option's name. For example, `"java_package"`.
-              "value": { # The option's value. For example, `"com.google.protobuf"`.
+              "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                  # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                  # For custom options, it should be the fully-qualified name. For example,
+                  # `"google.api.http"`.
+              "value": { # The option's value packed in an Any message. If the value is a primitive,
+                  # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                  # should be used. If the value is an enum, it should be stored as an int32
+                  # value using the google.protobuf.Int32Value type.
                 "a_key": "", # Properties of the object. Contains field @type with type URL.
               },
             },
@@ -1209,8 +1222,14 @@ <h3>Method Details</h3>
       "options": [ # The protocol buffer options.
         { # A protocol buffer option, which can be attached to a message, field,
             # enumeration, etc.
-          "name": "A String", # The option's name. For example, `"java_package"`.
-          "value": { # The option's value. For example, `"com.google.protobuf"`.
+          "name": "A String", # The option's name. For protobuf built-in options (options defined in
+              # descriptor.proto), this is the short name. For example, `"map_entry"`.
+              # For custom options, it should be the fully-qualified name. For example,
+              # `"google.api.http"`.
+          "value": { # The option's value packed in an Any message. If the value is a primitive,
+              # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+              # should be used. If the value is an enum, it should be stored as an int32
+              # value using the google.protobuf.Int32Value type.
             "a_key": "", # Properties of the object. Contains field @type with type URL.
           },
         },
@@ -1426,8 +1445,14 @@ <h3>Method Details</h3>
           "options": [ # The protocol buffer options.
             { # A protocol buffer option, which can be attached to a message, field,
                 # enumeration, etc.
-              "name": "A String", # The option's name. For example, `"java_package"`.
-              "value": { # The option's value. For example, `"com.google.protobuf"`.
+              "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                  # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                  # For custom options, it should be the fully-qualified name. For example,
+                  # `"google.api.http"`.
+              "value": { # The option's value packed in an Any message. If the value is a primitive,
+                  # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                  # should be used. If the value is an enum, it should be stored as an int32
+                  # value using the google.protobuf.Int32Value type.
                 "a_key": "", # Properties of the object. Contains field @type with type URL.
               },
             },
@@ -1438,8 +1463,14 @@ <h3>Method Details</h3>
       "options": [ # The protocol buffer options.
         { # A protocol buffer option, which can be attached to a message, field,
             # enumeration, etc.
-          "name": "A String", # The option's name. For example, `"java_package"`.
-          "value": { # The option's value. For example, `"com.google.protobuf"`.
+          "name": "A String", # The option's name. For protobuf built-in options (options defined in
+              # descriptor.proto), this is the short name. For example, `"map_entry"`.
+              # For custom options, it should be the fully-qualified name. For example,
+              # `"google.api.http"`.
+          "value": { # The option's value packed in an Any message. If the value is a primitive,
+              # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+              # should be used. If the value is an enum, it should be stored as an int32
+              # value using the google.protobuf.Int32Value type.
             "a_key": "", # Properties of the object. Contains field @type with type URL.
           },
         },
@@ -1498,29 +1529,7 @@ <h3>Method Details</h3>
         #       # it to decide whether the subsequent cross-origin request is
         #       # allowed to proceed.
         #     - name: library-example.googleapis.com
-        #       apis: google.example.library.v1.Library
         #       allow_cors: true
-        #       # Below entry makes 'google.example.library.v1.Library'
-        #       # API be served from endpoint address
-        #       # google.example.library-example.v1.LibraryManager.
-        #     - name: library-manager.googleapis.com
-        #       apis: google.example.library.v1.LibraryManager
-        #       # BNS address for a borg job. Can specify a task by appending
-        #       # "/taskId" (e.g. "/0") to the job spec.
-        #
-        # Example OpenAPI extension for endpoint with allow_cors set to true:
-        #
-        #     {
-        #       "swagger": "2.0",
-        #       "info": {
-        #         "description": "A simple..."
-        #       },
-        #       "host": "MY_PROJECT_ID.appspot.com",
-        #       "x-google-endpoints": [{
-        #         "name": "MY_PROJECT_ID.appspot.com",
-        #         "allow_cors": "true"
-        #       }]
-        #     }
       "allowCors": True or False, # Allowing
           # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
           # cross-domain traffic, would allow the backends served from this endpoint to
@@ -1567,10 +1576,15 @@ <h3>Method Details</h3>
       #     title: Google Calendar API
       #     apis:
       #     - name: google.calendar.v3.Calendar
-      #     backend:
+      #     authentication:
+      #       providers:
+      #       - id: google_calendar_auth
+      #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+      #         issuer: https://securetoken.google.com
       #       rules:
-      #       - selector: "google.calendar.v3.*"
-      #         address: calendar.example.com
+      #       - selector: "*"
+      #         requirements:
+      #           provider_id: google_calendar_auth
     "control": { # Selects and configures the service controller used by the service.  The # Configuration for the service control plane.
         # service controller handles features like abuse, quota, billing, logging,
         # monitoring, etc.
@@ -1642,56 +1656,6 @@ <h3>Method Details</h3>
             # slash, underscore, hyphen, period [/_-.].
       },
     ],
-    "analytics": { # Analytics configuration of the service. # WARNING: DO NOT USE UNTIL THIS MESSAGE IS REMOVED.
-        #
-        # Analytics configuration.
-        #
-        # The example below shows how to configure monitored resources and metrics
-        # for analytics. In the example, a monitored resource and two metrics are
-        # defined. The `library.googleapis.com/book/returned_count` and
-        # `library.googleapis.com/book/overdue_count` metric are sent
-        # to the analytics.
-        #
-        #     monitored_resources:
-        #     - type: library.googleapis.com/branch
-        #       labels:
-        #       - key: /city
-        #         description: The city where the library branch is located in.
-        #       - key: /name
-        #         description: The name of the branch.
-        #     metrics:
-        #     - name: library.googleapis.com/book/returned_count
-        #       metric_kind: DELTA
-        #       value_type: INT64
-        #       labels:
-        #       - key: /customer_id
-        #     - name: library.googleapis.com/book/overdue_count
-        #       metric_kind: GAUGE
-        #       value_type: INT64
-        #       labels:
-        #       - key: /customer_id
-        #     analytics:
-        #       producer_destinations:
-        #       - monitored_resource: library.googleapis.com/branch
-        #         metrics:
-        #         - library.googleapis.com/book/returned_count
-        #         - library.googleapis.com/book/overdue_count
-      "producerDestinations": [ # Analytics configurations for sending metrics to the analytics backend.
-          # There can be multiple producer destinations, each one must have a
-          # different monitored resource type. A metric can be used in at most
-          # one producer destination.
-        { # Configuration of a specific analytics destination.
-          "monitoredResource": "A String", # The monitored resource type. The type must be defined in
-              # Service.monitored_resources section.
-          "metrics": [ # Names of the metrics to report to this analytics destination.
-              # Each name must be defined in Service.metrics section. Metrics
-              # with value type BOOL and STRING must be of GUAGE kind, metrics with
-              # value type INT64, DOUBLE and MONEY must be of DELTA kind.
-            "A String",
-          ],
-        },
-      ],
-    },
     "systemParameters": { # ### System parameter configuration # System parameter configuration.
         #
         # A system parameter is a special kind of parameter defined by the API
@@ -1705,27 +1669,26 @@ <h3>Method Details</h3>
           # config, default system parameters will be used. Default system parameters
           # and names is implementation-dependent.
           #
-          # Example: define api key and alt name for all methods
+          # Example: define api key for all methods
+          #
+          #     system_parameters
+          #       rules:
+          #         - selector: "*"
+          #           parameters:
+          #             - name: api_key
+          #               url_query_parameter: api_key
           #
-          # system_parameters
-          #   rules:
-          #     - selector: "*"
-          #       parameters:
-          #         - name: api_key
-          #           url_query_parameter: api_key
-          #         - name: alt
-          #           http_header: Response-Content-Type
           #
           # Example: define 2 api key names for a specific method.
           #
-          # system_parameters
-          #   rules:
-          #     - selector: "/ListShelves"
-          #       parameters:
-          #         - name: api_key
-          #           http_header: Api-Key1
-          #         - name: api_key
-          #           http_header: Api-Key2
+          #     system_parameters
+          #       rules:
+          #         - selector: "/ListShelves"
+          #           parameters:
+          #             - name: api_key
+          #               http_header: Api-Key1
+          #             - name: api_key
+          #               http_header: Api-Key2
           #
           # **NOTE:** All service configuration rules follow "last one wins" order.
         { # Define a system parameter rule mapping system parameter definitions to
@@ -1740,8 +1703,7 @@ <h3>Method Details</h3>
                 # is implementation-dependent.
               "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
                   # sensitive.
-              "name": "A String", # Define the name of the parameter, such as "api_key", "alt", "callback",
-                  # and etc. It is case sensitive.
+              "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
               "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
                   # insensitive.
             },
@@ -1843,14 +1805,14 @@ <h3>Method Details</h3>
         #
         #     name: calendar.googleapis.com
         #     authentication:
+        #       providers:
+        #       - id: google_calendar_auth
+        #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+        #         issuer: https://securetoken.google.com
         #       rules:
         #       - selector: "*"
-        #         oauth:
-        #           canonical_scopes: https://www.googleapis.com/auth/calendar
-        #
-        #       - selector: google.calendar.Delegate
-        #         oauth:
-        #           canonical_scopes: https://www.googleapis.com/auth/calendar.read
+        #         requirements:
+        #           provider_id: google_calendar_auth
       "rules": [ # A list of authentication rules that apply to individual API methods.
           #
           # **NOTE:** All service configuration rules follow "last one wins" order.
@@ -1897,7 +1859,10 @@ <h3>Method Details</h3>
                   # Example:
                   #
                   #     provider_id: bookstore_auth
-              "audiences": "A String", # The list of JWT
+              "audiences": "A String", # NOTE: This will be deprecated soon, once AuthProvider.audiences is
+                  # implemented and accepted in all the runtime components.
+                  #
+                  # The list of JWT
                   # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
                   # that are allowed to access. A JWT containing any of these audiences will
                   # be accepted. When this setting is absent, only JWTs with audience
@@ -1936,6 +1901,19 @@ <h3>Method Details</h3>
               #  - can be inferred from the email domain of the issuer (e.g. a Google service account).
               #
               # Example: https://www.googleapis.com/oauth2/v1/certs
+          "audiences": "A String", # The list of JWT
+              # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
+              # that are allowed to access. A JWT containing any of these audiences will
+              # be accepted. When this setting is absent, only JWTs with audience
+              # "https://Service_name/API_name"
+              # will be accepted. For example, if no audiences are in the setting,
+              # LibraryService API will only accept JWTs with the following audience
+              # "https://library-example.googleapis.com/google.example.library.v1.LibraryService".
+              #
+              # Example:
+              #
+              #     audiences: bookstore_android.apps.googleusercontent.com,
+              #                bookstore_web.apps.googleusercontent.com
           "id": "A String", # The unique identifier of the auth provider. It will be referred to by
               # `AuthRequirement.provider_id`.
               #
@@ -1985,6 +1963,14 @@ <h3>Method Details</h3>
           "allowUnregisteredCalls": True or False, # True, if the method allows unregistered calls; false otherwise.
         },
       ],
+      "producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
+          # service producer.
+          #
+          # Google Service Management currently only supports
+          # [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification
+          # channel. To use Google Cloud Pub/Sub as the channel, this must be the name
+          # of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
+          # documented in https://cloud.google.com/pubsub/docs/overview.
       "requirements": [ # Requirements that must be satisfied before a consumer project can use the
           # service. Each requirement is of the form <service.name>/<requirement-id>;
           # for example 'serviceusage.googleapis.com/billing-enabled'.
@@ -2016,23 +2002,30 @@ <h3>Method Details</h3>
             # message, as in the example below which describes a REST GET
             # operation on a resource collection of messages:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc GetMessage(GetMessageRequest) returns (Message) {
-            #     option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
-            #   }
-            # }
-            # message GetMessageRequest {
-            #   message SubMessage {
-            #     string subfield = 1;
-            #   }
-            #   string message_id = 1; // mapped to the URL
-            #   SubMessage sub = 2;    // `sub.subfield` is url-mapped
-            # }
-            # message Message {
-            #   string text = 1; // content of the resource
-            # }
-            # ```
+            #
+            #     service Messaging {
+            #       rpc GetMessage(GetMessageRequest) returns (Message) {
+            #         option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
+            #       }
+            #     }
+            #     message GetMessageRequest {
+            #       message SubMessage {
+            #         string subfield = 1;
+            #       }
+            #       string message_id = 1; // mapped to the URL
+            #       SubMessage sub = 2;    // `sub.subfield` is url-mapped
+            #     }
+            #     message Message {
+            #       string text = 1; // content of the resource
+            #     }
+            #
+            # The same http annotation can alternatively be expressed inside the
+            # `GRPC API Configuration` YAML file.
+            #
+            #     http:
+            #       rules:
+            #         - selector: <proto_package_name>.Messaging.GetMessage
+            #           get: /v1/messages/{message_id}/{sub.subfield}
             #
             # This definition enables an automatic, bidrectional mapping of HTTP
             # JSON to RPC. Example:
@@ -2049,16 +2042,16 @@ <h3>Method Details</h3>
             # pattern automatically become (optional) HTTP query
             # parameters. Assume the following definition of the request message:
             #
-            # ```proto
-            # message GetMessageRequest {
-            #   message SubMessage {
-            #     string subfield = 1;
-            #   }
-            #   string message_id = 1; // mapped to the URL
-            #   int64 revision = 2;    // becomes a parameter
-            #   SubMessage sub = 3;    // `sub.subfield` becomes a parameter
-            # }
-            # ```
+            #
+            #     message GetMessageRequest {
+            #       message SubMessage {
+            #         string subfield = 1;
+            #       }
+            #       string message_id = 1; // mapped to the URL
+            #       int64 revision = 2;    // becomes a parameter
+            #       SubMessage sub = 3;    // `sub.subfield` becomes a parameter
+            #     }
+            #
             #
             # This enables a HTTP JSON to RPC mapping as below:
             #
@@ -2075,20 +2068,20 @@ <h3>Method Details</h3>
             # specifies the mapping. Consider a REST update method on the
             # message resource collection:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
-            #     option (google.api.http) = {
-            #       put: "/v1/messages/{message_id}"
-            #       body: "message"
-            #     };
-            #   }
-            # }
-            # message UpdateMessageRequest {
-            #   string message_id = 1; // mapped to the URL
-            #   Message message = 2;   // mapped to the body
-            # }
-            # ```
+            #
+            #     service Messaging {
+            #       rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
+            #         option (google.api.http) = {
+            #           put: "/v1/messages/{message_id}"
+            #           body: "message"
+            #         };
+            #       }
+            #     }
+            #     message UpdateMessageRequest {
+            #       string message_id = 1; // mapped to the URL
+            #       Message message = 2;   // mapped to the body
+            #     }
+            #
             #
             # The following HTTP JSON to RPC mapping is enabled, where the
             # representation of the JSON in the request body is determined by
@@ -2103,20 +2096,19 @@ <h3>Method Details</h3>
             # request body.  This enables the following alternative definition of
             # the update method:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc UpdateMessage(Message) returns (Message) {
-            #     option (google.api.http) = {
-            #       put: "/v1/messages/{message_id}"
-            #       body: "*"
-            #     };
-            #   }
-            # }
-            # message Message {
-            #   string message_id = 1;
-            #   string text = 2;
-            # }
-            # ```
+            #     service Messaging {
+            #       rpc UpdateMessage(Message) returns (Message) {
+            #         option (google.api.http) = {
+            #           put: "/v1/messages/{message_id}"
+            #           body: "*"
+            #         };
+            #       }
+            #     }
+            #     message Message {
+            #       string message_id = 1;
+            #       string text = 2;
+            #     }
+            #
             #
             # The following HTTP JSON to RPC mapping is enabled:
             #
@@ -2133,22 +2125,21 @@ <h3>Method Details</h3>
             # It is possible to define multiple HTTP methods for one RPC by using
             # the `additional_bindings` option. Example:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc GetMessage(GetMessageRequest) returns (Message) {
-            #     option (google.api.http) = {
-            #       get: "/v1/messages/{message_id}"
-            #       additional_bindings {
-            #         get: "/v1/users/{user_id}/messages/{message_id}"
+            #     service Messaging {
+            #       rpc GetMessage(GetMessageRequest) returns (Message) {
+            #         option (google.api.http) = {
+            #           get: "/v1/messages/{message_id}"
+            #           additional_bindings {
+            #             get: "/v1/users/{user_id}/messages/{message_id}"
+            #           }
+            #         };
             #       }
-            #     };
-            #   }
-            # }
-            # message GetMessageRequest {
-            #   string message_id = 1;
-            #   string user_id = 2;
-            # }
-            # ```
+            #     }
+            #     message GetMessageRequest {
+            #       string message_id = 1;
+            #       string user_id = 2;
+            #     }
+            #
             #
             # This enables the following two alternative HTTP JSON to RPC
             # mappings:
@@ -2189,7 +2180,7 @@ <h3>Method Details</h3>
             #
             # The syntax `**` matches zero or more path segments. It follows the semantics
             # of [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.3 Reserved
-            # Expansion.
+            # Expansion. NOTE: it must be the last segment in the path except the Verb.
             #
             # The syntax `LITERAL` matches literal text in the URL path.
             #
@@ -2208,7 +2199,7 @@ <h3>Method Details</h3>
           "body": "A String", # The name of the request field whose value is mapped to the HTTP body, or
               # `*` for mapping all fields not captured by the path pattern to the HTTP
               # body. NOTE: the referred field must not be a repeated field and must be
-              # present at the top-level of response message type.
+              # present at the top-level of request message type.
           "get": "A String", # Used for listing and getting information about resources.
           "mediaDownload": { # Do not use this. For media support, add instead # Do not use this. For media support, add instead
               # [][google.bytestream.RestByteStream] as an API to your
@@ -2265,8 +2256,14 @@ <h3>Method Details</h3>
             "options": [ # Any metadata attached to the method.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -2386,8 +2383,14 @@ <h3>Method Details</h3>
         "options": [ # Any metadata attached to the API.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -2470,7 +2473,9 @@ <h3>Method Details</h3>
       ],
     },
     "metrics": [ # Defines the metrics used by this service.
-      { # Defines a metric type and its schema.
+      { # Defines a metric type and its schema. Once a metric descriptor is created,
+          # deleting or altering it stops data collection and makes the metric type's
+          # existing data unusable.
         "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
             # Use sentence case without an ending period, for example "Request count".
         "description": "A String", # A detailed description of the metric, which can be used in documentation.
@@ -2478,29 +2483,25 @@ <h3>Method Details</h3>
             # Some combinations of `metric_kind` and `value_type` might not be supported.
         "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
             # Some combinations of `metric_kind` and `value_type` might not be supported.
-        "labels": [ # The set of labels that can be used to describe a specific instance of this
-            # metric type. For example, the
-            # `compute.googleapis.com/instance/network/received_bytes_count` metric type
-            # has a label, `loadbalanced`, that specifies whether the traffic was
-            # received through a load balanced IP address.
+        "labels": [ # The set of labels that can be used to describe a specific
+            # instance of this metric type. For example, the
+            # `appengine.googleapis.com/http/server/response_latencies` metric
+            # type has a label for the HTTP response code, `response_code`, so
+            # you can look at latencies for successful responses or just
+            # for responses that failed.
           { # A description of a label.
             "valueType": "A String", # The type of data that can be assigned to the label.
             "description": "A String", # A human-readable description for the label.
             "key": "A String", # The label key.
           },
         ],
-        "type": "A String", # The metric type including a DNS name prefix, for example
-            # `"compute.googleapis.com/instance/cpu/utilization"`. Metric types
-            # should use a natural hierarchical grouping such as the following:
-            #
-            #     compute.googleapis.com/instance/cpu/utilization
-            #     compute.googleapis.com/instance/disk/read_ops_count
-            #     compute.googleapis.com/instance/network/received_bytes_count
-            #
-            # Note that if the metric type changes, the monitoring data will be
-            # discontinued, and anything depends on it will break, such as monitoring
-            # dashboards, alerting rules and quota limits. Therefore, once a metric has
-            # been published, its type should be immutable.
+        "type": "A String", # The metric type, including its DNS name prefix. The type is not
+            # URL-encoded.  All user-defined metric types have the DNS name
+            # `custom.googleapis.com`.  Metric types should use a natural hierarchical
+            # grouping. For example:
+            #
+            #     "custom.googleapis.com/invoice/paid/amount"
+            #     "appengine.googleapis.com/http/server/response_latencies"
         "unit": "A String", # The unit in which the metric value is reported. It is only applicable
             # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
             # supported units are a subset of [The Unified Code for Units of
@@ -2565,11 +2566,14 @@ <h3>Method Details</h3>
             #    `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
             # * `NAME` is a sequence of non-blank printable ASCII characters not
             #    containing '{' or '}'.
-        "name": "A String", # Resource name. The format of the name may vary between different
-            # implementations. For examples:
-            #
-            #     projects/{project_id}/metricDescriptors/{type=**}
-            #     metricDescriptors/{type=**}
+        "name": "A String", # The resource name of the metric descriptor. Depending on the
+            # implementation, the name typically includes: (1) the parent resource name
+            # that defines the scope of the metric type or of its data; and (2) the
+            # metric's URL-encoded type, which also appears in the `type` field of this
+            # descriptor. For example, following is the resource name of a custom
+            # metric within the GCP project 123456789:
+            #
+            #     "projects/123456789/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
       },
     ],
     "enums": [ # A list of all enum types included in this API service.  Enums
@@ -2591,8 +2595,14 @@ <h3>Method Details</h3>
             "options": [ # Protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -2603,8 +2613,14 @@ <h3>Method Details</h3>
         "options": [ # Protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -2647,8 +2663,14 @@ <h3>Method Details</h3>
             "options": [ # The protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -2659,8 +2681,14 @@ <h3>Method Details</h3>
         "options": [ # The protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -2876,8 +2904,14 @@ <h3>Method Details</h3>
             "options": [ # The protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -2888,8 +2922,14 @@ <h3>Method Details</h3>
         "options": [ # The protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -2948,29 +2988,7 @@ <h3>Method Details</h3>
           #       # it to decide whether the subsequent cross-origin request is
           #       # allowed to proceed.
           #     - name: library-example.googleapis.com
-          #       apis: google.example.library.v1.Library
           #       allow_cors: true
-          #       # Below entry makes 'google.example.library.v1.Library'
-          #       # API be served from endpoint address
-          #       # google.example.library-example.v1.LibraryManager.
-          #     - name: library-manager.googleapis.com
-          #       apis: google.example.library.v1.LibraryManager
-          #       # BNS address for a borg job. Can specify a task by appending
-          #       # "/taskId" (e.g. "/0") to the job spec.
-          #
-          # Example OpenAPI extension for endpoint with allow_cors set to true:
-          #
-          #     {
-          #       "swagger": "2.0",
-          #       "info": {
-          #         "description": "A simple..."
-          #       },
-          #       "host": "MY_PROJECT_ID.appspot.com",
-          #       "x-google-endpoints": [{
-          #         "name": "MY_PROJECT_ID.appspot.com",
-          #         "allow_cors": "true"
-          #       }]
-          #     }
         "allowCors": True or False, # Allowing
             # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
             # cross-domain traffic, would allow the backends served from this endpoint to
@@ -3003,7 +3021,7 @@ <h3>Method Details</h3>
 Args:
   serviceName: string, The name of the service.  See the [overview](/service-management/overview)
 for naming requirements.  For example: `example.googleapis.com`. (required)
-  configId: string, A parameter (required)
+  configId: string, The id of the service configuration resource. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -3026,10 +3044,15 @@ <h3>Method Details</h3>
       #     title: Google Calendar API
       #     apis:
       #     - name: google.calendar.v3.Calendar
-      #     backend:
+      #     authentication:
+      #       providers:
+      #       - id: google_calendar_auth
+      #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+      #         issuer: https://securetoken.google.com
       #       rules:
-      #       - selector: "google.calendar.v3.*"
-      #         address: calendar.example.com
+      #       - selector: "*"
+      #         requirements:
+      #           provider_id: google_calendar_auth
     "control": { # Selects and configures the service controller used by the service.  The # Configuration for the service control plane.
         # service controller handles features like abuse, quota, billing, logging,
         # monitoring, etc.
@@ -3101,56 +3124,6 @@ <h3>Method Details</h3>
             # slash, underscore, hyphen, period [/_-.].
       },
     ],
-    "analytics": { # Analytics configuration of the service. # WARNING: DO NOT USE UNTIL THIS MESSAGE IS REMOVED.
-        #
-        # Analytics configuration.
-        #
-        # The example below shows how to configure monitored resources and metrics
-        # for analytics. In the example, a monitored resource and two metrics are
-        # defined. The `library.googleapis.com/book/returned_count` and
-        # `library.googleapis.com/book/overdue_count` metric are sent
-        # to the analytics.
-        #
-        #     monitored_resources:
-        #     - type: library.googleapis.com/branch
-        #       labels:
-        #       - key: /city
-        #         description: The city where the library branch is located in.
-        #       - key: /name
-        #         description: The name of the branch.
-        #     metrics:
-        #     - name: library.googleapis.com/book/returned_count
-        #       metric_kind: DELTA
-        #       value_type: INT64
-        #       labels:
-        #       - key: /customer_id
-        #     - name: library.googleapis.com/book/overdue_count
-        #       metric_kind: GAUGE
-        #       value_type: INT64
-        #       labels:
-        #       - key: /customer_id
-        #     analytics:
-        #       producer_destinations:
-        #       - monitored_resource: library.googleapis.com/branch
-        #         metrics:
-        #         - library.googleapis.com/book/returned_count
-        #         - library.googleapis.com/book/overdue_count
-      "producerDestinations": [ # Analytics configurations for sending metrics to the analytics backend.
-          # There can be multiple producer destinations, each one must have a
-          # different monitored resource type. A metric can be used in at most
-          # one producer destination.
-        { # Configuration of a specific analytics destination.
-          "monitoredResource": "A String", # The monitored resource type. The type must be defined in
-              # Service.monitored_resources section.
-          "metrics": [ # Names of the metrics to report to this analytics destination.
-              # Each name must be defined in Service.metrics section. Metrics
-              # with value type BOOL and STRING must be of GUAGE kind, metrics with
-              # value type INT64, DOUBLE and MONEY must be of DELTA kind.
-            "A String",
-          ],
-        },
-      ],
-    },
     "systemParameters": { # ### System parameter configuration # System parameter configuration.
         #
         # A system parameter is a special kind of parameter defined by the API
@@ -3164,27 +3137,26 @@ <h3>Method Details</h3>
           # config, default system parameters will be used. Default system parameters
           # and names is implementation-dependent.
           #
-          # Example: define api key and alt name for all methods
+          # Example: define api key for all methods
+          #
+          #     system_parameters
+          #       rules:
+          #         - selector: "*"
+          #           parameters:
+          #             - name: api_key
+          #               url_query_parameter: api_key
           #
-          # system_parameters
-          #   rules:
-          #     - selector: "*"
-          #       parameters:
-          #         - name: api_key
-          #           url_query_parameter: api_key
-          #         - name: alt
-          #           http_header: Response-Content-Type
           #
           # Example: define 2 api key names for a specific method.
           #
-          # system_parameters
-          #   rules:
-          #     - selector: "/ListShelves"
-          #       parameters:
-          #         - name: api_key
-          #           http_header: Api-Key1
-          #         - name: api_key
-          #           http_header: Api-Key2
+          #     system_parameters
+          #       rules:
+          #         - selector: "/ListShelves"
+          #           parameters:
+          #             - name: api_key
+          #               http_header: Api-Key1
+          #             - name: api_key
+          #               http_header: Api-Key2
           #
           # **NOTE:** All service configuration rules follow "last one wins" order.
         { # Define a system parameter rule mapping system parameter definitions to
@@ -3199,8 +3171,7 @@ <h3>Method Details</h3>
                 # is implementation-dependent.
               "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
                   # sensitive.
-              "name": "A String", # Define the name of the parameter, such as "api_key", "alt", "callback",
-                  # and etc. It is case sensitive.
+              "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
               "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
                   # insensitive.
             },
@@ -3302,14 +3273,14 @@ <h3>Method Details</h3>
         #
         #     name: calendar.googleapis.com
         #     authentication:
+        #       providers:
+        #       - id: google_calendar_auth
+        #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+        #         issuer: https://securetoken.google.com
         #       rules:
         #       - selector: "*"
-        #         oauth:
-        #           canonical_scopes: https://www.googleapis.com/auth/calendar
-        #
-        #       - selector: google.calendar.Delegate
-        #         oauth:
-        #           canonical_scopes: https://www.googleapis.com/auth/calendar.read
+        #         requirements:
+        #           provider_id: google_calendar_auth
       "rules": [ # A list of authentication rules that apply to individual API methods.
           #
           # **NOTE:** All service configuration rules follow "last one wins" order.
@@ -3356,7 +3327,10 @@ <h3>Method Details</h3>
                   # Example:
                   #
                   #     provider_id: bookstore_auth
-              "audiences": "A String", # The list of JWT
+              "audiences": "A String", # NOTE: This will be deprecated soon, once AuthProvider.audiences is
+                  # implemented and accepted in all the runtime components.
+                  #
+                  # The list of JWT
                   # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
                   # that are allowed to access. A JWT containing any of these audiences will
                   # be accepted. When this setting is absent, only JWTs with audience
@@ -3395,6 +3369,19 @@ <h3>Method Details</h3>
               #  - can be inferred from the email domain of the issuer (e.g. a Google service account).
               #
               # Example: https://www.googleapis.com/oauth2/v1/certs
+          "audiences": "A String", # The list of JWT
+              # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
+              # that are allowed to access. A JWT containing any of these audiences will
+              # be accepted. When this setting is absent, only JWTs with audience
+              # "https://Service_name/API_name"
+              # will be accepted. For example, if no audiences are in the setting,
+              # LibraryService API will only accept JWTs with the following audience
+              # "https://library-example.googleapis.com/google.example.library.v1.LibraryService".
+              #
+              # Example:
+              #
+              #     audiences: bookstore_android.apps.googleusercontent.com,
+              #                bookstore_web.apps.googleusercontent.com
           "id": "A String", # The unique identifier of the auth provider. It will be referred to by
               # `AuthRequirement.provider_id`.
               #
@@ -3444,6 +3431,14 @@ <h3>Method Details</h3>
           "allowUnregisteredCalls": True or False, # True, if the method allows unregistered calls; false otherwise.
         },
       ],
+      "producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
+          # service producer.
+          #
+          # Google Service Management currently only supports
+          # [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification
+          # channel. To use Google Cloud Pub/Sub as the channel, this must be the name
+          # of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
+          # documented in https://cloud.google.com/pubsub/docs/overview.
       "requirements": [ # Requirements that must be satisfied before a consumer project can use the
           # service. Each requirement is of the form <service.name>/<requirement-id>;
           # for example 'serviceusage.googleapis.com/billing-enabled'.
@@ -3475,23 +3470,30 @@ <h3>Method Details</h3>
             # message, as in the example below which describes a REST GET
             # operation on a resource collection of messages:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc GetMessage(GetMessageRequest) returns (Message) {
-            #     option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
-            #   }
-            # }
-            # message GetMessageRequest {
-            #   message SubMessage {
-            #     string subfield = 1;
-            #   }
-            #   string message_id = 1; // mapped to the URL
-            #   SubMessage sub = 2;    // `sub.subfield` is url-mapped
-            # }
-            # message Message {
-            #   string text = 1; // content of the resource
-            # }
-            # ```
+            #
+            #     service Messaging {
+            #       rpc GetMessage(GetMessageRequest) returns (Message) {
+            #         option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
+            #       }
+            #     }
+            #     message GetMessageRequest {
+            #       message SubMessage {
+            #         string subfield = 1;
+            #       }
+            #       string message_id = 1; // mapped to the URL
+            #       SubMessage sub = 2;    // `sub.subfield` is url-mapped
+            #     }
+            #     message Message {
+            #       string text = 1; // content of the resource
+            #     }
+            #
+            # The same http annotation can alternatively be expressed inside the
+            # `GRPC API Configuration` YAML file.
+            #
+            #     http:
+            #       rules:
+            #         - selector: <proto_package_name>.Messaging.GetMessage
+            #           get: /v1/messages/{message_id}/{sub.subfield}
             #
             # This definition enables an automatic, bidrectional mapping of HTTP
             # JSON to RPC. Example:
@@ -3508,16 +3510,16 @@ <h3>Method Details</h3>
             # pattern automatically become (optional) HTTP query
             # parameters. Assume the following definition of the request message:
             #
-            # ```proto
-            # message GetMessageRequest {
-            #   message SubMessage {
-            #     string subfield = 1;
-            #   }
-            #   string message_id = 1; // mapped to the URL
-            #   int64 revision = 2;    // becomes a parameter
-            #   SubMessage sub = 3;    // `sub.subfield` becomes a parameter
-            # }
-            # ```
+            #
+            #     message GetMessageRequest {
+            #       message SubMessage {
+            #         string subfield = 1;
+            #       }
+            #       string message_id = 1; // mapped to the URL
+            #       int64 revision = 2;    // becomes a parameter
+            #       SubMessage sub = 3;    // `sub.subfield` becomes a parameter
+            #     }
+            #
             #
             # This enables a HTTP JSON to RPC mapping as below:
             #
@@ -3534,20 +3536,20 @@ <h3>Method Details</h3>
             # specifies the mapping. Consider a REST update method on the
             # message resource collection:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
-            #     option (google.api.http) = {
-            #       put: "/v1/messages/{message_id}"
-            #       body: "message"
-            #     };
-            #   }
-            # }
-            # message UpdateMessageRequest {
-            #   string message_id = 1; // mapped to the URL
-            #   Message message = 2;   // mapped to the body
-            # }
-            # ```
+            #
+            #     service Messaging {
+            #       rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
+            #         option (google.api.http) = {
+            #           put: "/v1/messages/{message_id}"
+            #           body: "message"
+            #         };
+            #       }
+            #     }
+            #     message UpdateMessageRequest {
+            #       string message_id = 1; // mapped to the URL
+            #       Message message = 2;   // mapped to the body
+            #     }
+            #
             #
             # The following HTTP JSON to RPC mapping is enabled, where the
             # representation of the JSON in the request body is determined by
@@ -3562,20 +3564,19 @@ <h3>Method Details</h3>
             # request body.  This enables the following alternative definition of
             # the update method:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc UpdateMessage(Message) returns (Message) {
-            #     option (google.api.http) = {
-            #       put: "/v1/messages/{message_id}"
-            #       body: "*"
-            #     };
-            #   }
-            # }
-            # message Message {
-            #   string message_id = 1;
-            #   string text = 2;
-            # }
-            # ```
+            #     service Messaging {
+            #       rpc UpdateMessage(Message) returns (Message) {
+            #         option (google.api.http) = {
+            #           put: "/v1/messages/{message_id}"
+            #           body: "*"
+            #         };
+            #       }
+            #     }
+            #     message Message {
+            #       string message_id = 1;
+            #       string text = 2;
+            #     }
+            #
             #
             # The following HTTP JSON to RPC mapping is enabled:
             #
@@ -3592,22 +3593,21 @@ <h3>Method Details</h3>
             # It is possible to define multiple HTTP methods for one RPC by using
             # the `additional_bindings` option. Example:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc GetMessage(GetMessageRequest) returns (Message) {
-            #     option (google.api.http) = {
-            #       get: "/v1/messages/{message_id}"
-            #       additional_bindings {
-            #         get: "/v1/users/{user_id}/messages/{message_id}"
+            #     service Messaging {
+            #       rpc GetMessage(GetMessageRequest) returns (Message) {
+            #         option (google.api.http) = {
+            #           get: "/v1/messages/{message_id}"
+            #           additional_bindings {
+            #             get: "/v1/users/{user_id}/messages/{message_id}"
+            #           }
+            #         };
             #       }
-            #     };
-            #   }
-            # }
-            # message GetMessageRequest {
-            #   string message_id = 1;
-            #   string user_id = 2;
-            # }
-            # ```
+            #     }
+            #     message GetMessageRequest {
+            #       string message_id = 1;
+            #       string user_id = 2;
+            #     }
+            #
             #
             # This enables the following two alternative HTTP JSON to RPC
             # mappings:
@@ -3648,7 +3648,7 @@ <h3>Method Details</h3>
             #
             # The syntax `**` matches zero or more path segments. It follows the semantics
             # of [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.3 Reserved
-            # Expansion.
+            # Expansion. NOTE: it must be the last segment in the path except the Verb.
             #
             # The syntax `LITERAL` matches literal text in the URL path.
             #
@@ -3667,7 +3667,7 @@ <h3>Method Details</h3>
           "body": "A String", # The name of the request field whose value is mapped to the HTTP body, or
               # `*` for mapping all fields not captured by the path pattern to the HTTP
               # body. NOTE: the referred field must not be a repeated field and must be
-              # present at the top-level of response message type.
+              # present at the top-level of request message type.
           "get": "A String", # Used for listing and getting information about resources.
           "mediaDownload": { # Do not use this. For media support, add instead # Do not use this. For media support, add instead
               # [][google.bytestream.RestByteStream] as an API to your
@@ -3724,8 +3724,14 @@ <h3>Method Details</h3>
             "options": [ # Any metadata attached to the method.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -3845,8 +3851,14 @@ <h3>Method Details</h3>
         "options": [ # Any metadata attached to the API.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -3929,7 +3941,9 @@ <h3>Method Details</h3>
       ],
     },
     "metrics": [ # Defines the metrics used by this service.
-      { # Defines a metric type and its schema.
+      { # Defines a metric type and its schema. Once a metric descriptor is created,
+          # deleting or altering it stops data collection and makes the metric type's
+          # existing data unusable.
         "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
             # Use sentence case without an ending period, for example "Request count".
         "description": "A String", # A detailed description of the metric, which can be used in documentation.
@@ -3937,29 +3951,25 @@ <h3>Method Details</h3>
             # Some combinations of `metric_kind` and `value_type` might not be supported.
         "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
             # Some combinations of `metric_kind` and `value_type` might not be supported.
-        "labels": [ # The set of labels that can be used to describe a specific instance of this
-            # metric type. For example, the
-            # `compute.googleapis.com/instance/network/received_bytes_count` metric type
-            # has a label, `loadbalanced`, that specifies whether the traffic was
-            # received through a load balanced IP address.
+        "labels": [ # The set of labels that can be used to describe a specific
+            # instance of this metric type. For example, the
+            # `appengine.googleapis.com/http/server/response_latencies` metric
+            # type has a label for the HTTP response code, `response_code`, so
+            # you can look at latencies for successful responses or just
+            # for responses that failed.
           { # A description of a label.
             "valueType": "A String", # The type of data that can be assigned to the label.
             "description": "A String", # A human-readable description for the label.
             "key": "A String", # The label key.
           },
         ],
-        "type": "A String", # The metric type including a DNS name prefix, for example
-            # `"compute.googleapis.com/instance/cpu/utilization"`. Metric types
-            # should use a natural hierarchical grouping such as the following:
-            #
-            #     compute.googleapis.com/instance/cpu/utilization
-            #     compute.googleapis.com/instance/disk/read_ops_count
-            #     compute.googleapis.com/instance/network/received_bytes_count
-            #
-            # Note that if the metric type changes, the monitoring data will be
-            # discontinued, and anything depends on it will break, such as monitoring
-            # dashboards, alerting rules and quota limits. Therefore, once a metric has
-            # been published, its type should be immutable.
+        "type": "A String", # The metric type, including its DNS name prefix. The type is not
+            # URL-encoded.  All user-defined metric types have the DNS name
+            # `custom.googleapis.com`.  Metric types should use a natural hierarchical
+            # grouping. For example:
+            #
+            #     "custom.googleapis.com/invoice/paid/amount"
+            #     "appengine.googleapis.com/http/server/response_latencies"
         "unit": "A String", # The unit in which the metric value is reported. It is only applicable
             # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
             # supported units are a subset of [The Unified Code for Units of
@@ -4024,11 +4034,14 @@ <h3>Method Details</h3>
             #    `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
             # * `NAME` is a sequence of non-blank printable ASCII characters not
             #    containing '{' or '}'.
-        "name": "A String", # Resource name. The format of the name may vary between different
-            # implementations. For examples:
-            #
-            #     projects/{project_id}/metricDescriptors/{type=**}
-            #     metricDescriptors/{type=**}
+        "name": "A String", # The resource name of the metric descriptor. Depending on the
+            # implementation, the name typically includes: (1) the parent resource name
+            # that defines the scope of the metric type or of its data; and (2) the
+            # metric's URL-encoded type, which also appears in the `type` field of this
+            # descriptor. For example, following is the resource name of a custom
+            # metric within the GCP project 123456789:
+            #
+            #     "projects/123456789/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
       },
     ],
     "enums": [ # A list of all enum types included in this API service.  Enums
@@ -4050,8 +4063,14 @@ <h3>Method Details</h3>
             "options": [ # Protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -4062,8 +4081,14 @@ <h3>Method Details</h3>
         "options": [ # Protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -4106,8 +4131,14 @@ <h3>Method Details</h3>
             "options": [ # The protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -4118,8 +4149,14 @@ <h3>Method Details</h3>
         "options": [ # The protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -4335,8 +4372,14 @@ <h3>Method Details</h3>
             "options": [ # The protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -4347,8 +4390,14 @@ <h3>Method Details</h3>
         "options": [ # The protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -4407,29 +4456,7 @@ <h3>Method Details</h3>
           #       # it to decide whether the subsequent cross-origin request is
           #       # allowed to proceed.
           #     - name: library-example.googleapis.com
-          #       apis: google.example.library.v1.Library
           #       allow_cors: true
-          #       # Below entry makes 'google.example.library.v1.Library'
-          #       # API be served from endpoint address
-          #       # google.example.library-example.v1.LibraryManager.
-          #     - name: library-manager.googleapis.com
-          #       apis: google.example.library.v1.LibraryManager
-          #       # BNS address for a borg job. Can specify a task by appending
-          #       # "/taskId" (e.g. "/0") to the job spec.
-          #
-          # Example OpenAPI extension for endpoint with allow_cors set to true:
-          #
-          #     {
-          #       "swagger": "2.0",
-          #       "info": {
-          #         "description": "A simple..."
-          #       },
-          #       "host": "MY_PROJECT_ID.appspot.com",
-          #       "x-google-endpoints": [{
-          #         "name": "MY_PROJECT_ID.appspot.com",
-          #         "allow_cors": "true"
-          #       }]
-          #     }
         "allowCors": True or False, # Allowing
             # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
             # cross-domain traffic, would allow the backends served from this endpoint to
@@ -4490,10 +4517,15 @@ <h3>Method Details</h3>
           #     title: Google Calendar API
           #     apis:
           #     - name: google.calendar.v3.Calendar
-          #     backend:
+          #     authentication:
+          #       providers:
+          #       - id: google_calendar_auth
+          #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+          #         issuer: https://securetoken.google.com
           #       rules:
-          #       - selector: "google.calendar.v3.*"
-          #         address: calendar.example.com
+          #       - selector: "*"
+          #         requirements:
+          #           provider_id: google_calendar_auth
         "control": { # Selects and configures the service controller used by the service.  The # Configuration for the service control plane.
             # service controller handles features like abuse, quota, billing, logging,
             # monitoring, etc.
@@ -4565,56 +4597,6 @@ <h3>Method Details</h3>
                 # slash, underscore, hyphen, period [/_-.].
           },
         ],
-        "analytics": { # Analytics configuration of the service. # WARNING: DO NOT USE UNTIL THIS MESSAGE IS REMOVED.
-            #
-            # Analytics configuration.
-            #
-            # The example below shows how to configure monitored resources and metrics
-            # for analytics. In the example, a monitored resource and two metrics are
-            # defined. The `library.googleapis.com/book/returned_count` and
-            # `library.googleapis.com/book/overdue_count` metric are sent
-            # to the analytics.
-            #
-            #     monitored_resources:
-            #     - type: library.googleapis.com/branch
-            #       labels:
-            #       - key: /city
-            #         description: The city where the library branch is located in.
-            #       - key: /name
-            #         description: The name of the branch.
-            #     metrics:
-            #     - name: library.googleapis.com/book/returned_count
-            #       metric_kind: DELTA
-            #       value_type: INT64
-            #       labels:
-            #       - key: /customer_id
-            #     - name: library.googleapis.com/book/overdue_count
-            #       metric_kind: GAUGE
-            #       value_type: INT64
-            #       labels:
-            #       - key: /customer_id
-            #     analytics:
-            #       producer_destinations:
-            #       - monitored_resource: library.googleapis.com/branch
-            #         metrics:
-            #         - library.googleapis.com/book/returned_count
-            #         - library.googleapis.com/book/overdue_count
-          "producerDestinations": [ # Analytics configurations for sending metrics to the analytics backend.
-              # There can be multiple producer destinations, each one must have a
-              # different monitored resource type. A metric can be used in at most
-              # one producer destination.
-            { # Configuration of a specific analytics destination.
-              "monitoredResource": "A String", # The monitored resource type. The type must be defined in
-                  # Service.monitored_resources section.
-              "metrics": [ # Names of the metrics to report to this analytics destination.
-                  # Each name must be defined in Service.metrics section. Metrics
-                  # with value type BOOL and STRING must be of GUAGE kind, metrics with
-                  # value type INT64, DOUBLE and MONEY must be of DELTA kind.
-                "A String",
-              ],
-            },
-          ],
-        },
         "systemParameters": { # ### System parameter configuration # System parameter configuration.
             #
             # A system parameter is a special kind of parameter defined by the API
@@ -4628,27 +4610,26 @@ <h3>Method Details</h3>
               # config, default system parameters will be used. Default system parameters
               # and names is implementation-dependent.
               #
-              # Example: define api key and alt name for all methods
+              # Example: define api key for all methods
+              #
+              #     system_parameters
+              #       rules:
+              #         - selector: "*"
+              #           parameters:
+              #             - name: api_key
+              #               url_query_parameter: api_key
               #
-              # system_parameters
-              #   rules:
-              #     - selector: "*"
-              #       parameters:
-              #         - name: api_key
-              #           url_query_parameter: api_key
-              #         - name: alt
-              #           http_header: Response-Content-Type
               #
               # Example: define 2 api key names for a specific method.
               #
-              # system_parameters
-              #   rules:
-              #     - selector: "/ListShelves"
-              #       parameters:
-              #         - name: api_key
-              #           http_header: Api-Key1
-              #         - name: api_key
-              #           http_header: Api-Key2
+              #     system_parameters
+              #       rules:
+              #         - selector: "/ListShelves"
+              #           parameters:
+              #             - name: api_key
+              #               http_header: Api-Key1
+              #             - name: api_key
+              #               http_header: Api-Key2
               #
               # **NOTE:** All service configuration rules follow "last one wins" order.
             { # Define a system parameter rule mapping system parameter definitions to
@@ -4663,8 +4644,7 @@ <h3>Method Details</h3>
                     # is implementation-dependent.
                   "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
                       # sensitive.
-                  "name": "A String", # Define the name of the parameter, such as "api_key", "alt", "callback",
-                      # and etc. It is case sensitive.
+                  "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
                   "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
                       # insensitive.
                 },
@@ -4766,14 +4746,14 @@ <h3>Method Details</h3>
             #
             #     name: calendar.googleapis.com
             #     authentication:
+            #       providers:
+            #       - id: google_calendar_auth
+            #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+            #         issuer: https://securetoken.google.com
             #       rules:
             #       - selector: "*"
-            #         oauth:
-            #           canonical_scopes: https://www.googleapis.com/auth/calendar
-            #
-            #       - selector: google.calendar.Delegate
-            #         oauth:
-            #           canonical_scopes: https://www.googleapis.com/auth/calendar.read
+            #         requirements:
+            #           provider_id: google_calendar_auth
           "rules": [ # A list of authentication rules that apply to individual API methods.
               #
               # **NOTE:** All service configuration rules follow "last one wins" order.
@@ -4820,7 +4800,10 @@ <h3>Method Details</h3>
                       # Example:
                       #
                       #     provider_id: bookstore_auth
-                  "audiences": "A String", # The list of JWT
+                  "audiences": "A String", # NOTE: This will be deprecated soon, once AuthProvider.audiences is
+                      # implemented and accepted in all the runtime components.
+                      #
+                      # The list of JWT
                       # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
                       # that are allowed to access. A JWT containing any of these audiences will
                       # be accepted. When this setting is absent, only JWTs with audience
@@ -4859,6 +4842,19 @@ <h3>Method Details</h3>
                   #  - can be inferred from the email domain of the issuer (e.g. a Google service account).
                   #
                   # Example: https://www.googleapis.com/oauth2/v1/certs
+              "audiences": "A String", # The list of JWT
+                  # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
+                  # that are allowed to access. A JWT containing any of these audiences will
+                  # be accepted. When this setting is absent, only JWTs with audience
+                  # "https://Service_name/API_name"
+                  # will be accepted. For example, if no audiences are in the setting,
+                  # LibraryService API will only accept JWTs with the following audience
+                  # "https://library-example.googleapis.com/google.example.library.v1.LibraryService".
+                  #
+                  # Example:
+                  #
+                  #     audiences: bookstore_android.apps.googleusercontent.com,
+                  #                bookstore_web.apps.googleusercontent.com
               "id": "A String", # The unique identifier of the auth provider. It will be referred to by
                   # `AuthRequirement.provider_id`.
                   #
@@ -4908,6 +4904,14 @@ <h3>Method Details</h3>
               "allowUnregisteredCalls": True or False, # True, if the method allows unregistered calls; false otherwise.
             },
           ],
+          "producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
+              # service producer.
+              #
+              # Google Service Management currently only supports
+              # [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification
+              # channel. To use Google Cloud Pub/Sub as the channel, this must be the name
+              # of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
+              # documented in https://cloud.google.com/pubsub/docs/overview.
           "requirements": [ # Requirements that must be satisfied before a consumer project can use the
               # service. Each requirement is of the form <service.name>/<requirement-id>;
               # for example 'serviceusage.googleapis.com/billing-enabled'.
@@ -4939,23 +4943,30 @@ <h3>Method Details</h3>
                 # message, as in the example below which describes a REST GET
                 # operation on a resource collection of messages:
                 #
-                # ```proto
-                # service Messaging {
-                #   rpc GetMessage(GetMessageRequest) returns (Message) {
-                #     option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
-                #   }
-                # }
-                # message GetMessageRequest {
-                #   message SubMessage {
-                #     string subfield = 1;
-                #   }
-                #   string message_id = 1; // mapped to the URL
-                #   SubMessage sub = 2;    // `sub.subfield` is url-mapped
-                # }
-                # message Message {
-                #   string text = 1; // content of the resource
-                # }
-                # ```
+                #
+                #     service Messaging {
+                #       rpc GetMessage(GetMessageRequest) returns (Message) {
+                #         option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
+                #       }
+                #     }
+                #     message GetMessageRequest {
+                #       message SubMessage {
+                #         string subfield = 1;
+                #       }
+                #       string message_id = 1; // mapped to the URL
+                #       SubMessage sub = 2;    // `sub.subfield` is url-mapped
+                #     }
+                #     message Message {
+                #       string text = 1; // content of the resource
+                #     }
+                #
+                # The same http annotation can alternatively be expressed inside the
+                # `GRPC API Configuration` YAML file.
+                #
+                #     http:
+                #       rules:
+                #         - selector: <proto_package_name>.Messaging.GetMessage
+                #           get: /v1/messages/{message_id}/{sub.subfield}
                 #
                 # This definition enables an automatic, bidrectional mapping of HTTP
                 # JSON to RPC. Example:
@@ -4972,16 +4983,16 @@ <h3>Method Details</h3>
                 # pattern automatically become (optional) HTTP query
                 # parameters. Assume the following definition of the request message:
                 #
-                # ```proto
-                # message GetMessageRequest {
-                #   message SubMessage {
-                #     string subfield = 1;
-                #   }
-                #   string message_id = 1; // mapped to the URL
-                #   int64 revision = 2;    // becomes a parameter
-                #   SubMessage sub = 3;    // `sub.subfield` becomes a parameter
-                # }
-                # ```
+                #
+                #     message GetMessageRequest {
+                #       message SubMessage {
+                #         string subfield = 1;
+                #       }
+                #       string message_id = 1; // mapped to the URL
+                #       int64 revision = 2;    // becomes a parameter
+                #       SubMessage sub = 3;    // `sub.subfield` becomes a parameter
+                #     }
+                #
                 #
                 # This enables a HTTP JSON to RPC mapping as below:
                 #
@@ -4998,20 +5009,20 @@ <h3>Method Details</h3>
                 # specifies the mapping. Consider a REST update method on the
                 # message resource collection:
                 #
-                # ```proto
-                # service Messaging {
-                #   rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
-                #     option (google.api.http) = {
-                #       put: "/v1/messages/{message_id}"
-                #       body: "message"
-                #     };
-                #   }
-                # }
-                # message UpdateMessageRequest {
-                #   string message_id = 1; // mapped to the URL
-                #   Message message = 2;   // mapped to the body
-                # }
-                # ```
+                #
+                #     service Messaging {
+                #       rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
+                #         option (google.api.http) = {
+                #           put: "/v1/messages/{message_id}"
+                #           body: "message"
+                #         };
+                #       }
+                #     }
+                #     message UpdateMessageRequest {
+                #       string message_id = 1; // mapped to the URL
+                #       Message message = 2;   // mapped to the body
+                #     }
+                #
                 #
                 # The following HTTP JSON to RPC mapping is enabled, where the
                 # representation of the JSON in the request body is determined by
@@ -5026,20 +5037,19 @@ <h3>Method Details</h3>
                 # request body.  This enables the following alternative definition of
                 # the update method:
                 #
-                # ```proto
-                # service Messaging {
-                #   rpc UpdateMessage(Message) returns (Message) {
-                #     option (google.api.http) = {
-                #       put: "/v1/messages/{message_id}"
-                #       body: "*"
-                #     };
-                #   }
-                # }
-                # message Message {
-                #   string message_id = 1;
-                #   string text = 2;
-                # }
-                # ```
+                #     service Messaging {
+                #       rpc UpdateMessage(Message) returns (Message) {
+                #         option (google.api.http) = {
+                #           put: "/v1/messages/{message_id}"
+                #           body: "*"
+                #         };
+                #       }
+                #     }
+                #     message Message {
+                #       string message_id = 1;
+                #       string text = 2;
+                #     }
+                #
                 #
                 # The following HTTP JSON to RPC mapping is enabled:
                 #
@@ -5056,22 +5066,21 @@ <h3>Method Details</h3>
                 # It is possible to define multiple HTTP methods for one RPC by using
                 # the `additional_bindings` option. Example:
                 #
-                # ```proto
-                # service Messaging {
-                #   rpc GetMessage(GetMessageRequest) returns (Message) {
-                #     option (google.api.http) = {
-                #       get: "/v1/messages/{message_id}"
-                #       additional_bindings {
-                #         get: "/v1/users/{user_id}/messages/{message_id}"
+                #     service Messaging {
+                #       rpc GetMessage(GetMessageRequest) returns (Message) {
+                #         option (google.api.http) = {
+                #           get: "/v1/messages/{message_id}"
+                #           additional_bindings {
+                #             get: "/v1/users/{user_id}/messages/{message_id}"
+                #           }
+                #         };
                 #       }
-                #     };
-                #   }
-                # }
-                # message GetMessageRequest {
-                #   string message_id = 1;
-                #   string user_id = 2;
-                # }
-                # ```
+                #     }
+                #     message GetMessageRequest {
+                #       string message_id = 1;
+                #       string user_id = 2;
+                #     }
+                #
                 #
                 # This enables the following two alternative HTTP JSON to RPC
                 # mappings:
@@ -5112,7 +5121,7 @@ <h3>Method Details</h3>
                 #
                 # The syntax `**` matches zero or more path segments. It follows the semantics
                 # of [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.3 Reserved
-                # Expansion.
+                # Expansion. NOTE: it must be the last segment in the path except the Verb.
                 #
                 # The syntax `LITERAL` matches literal text in the URL path.
                 #
@@ -5131,7 +5140,7 @@ <h3>Method Details</h3>
               "body": "A String", # The name of the request field whose value is mapped to the HTTP body, or
                   # `*` for mapping all fields not captured by the path pattern to the HTTP
                   # body. NOTE: the referred field must not be a repeated field and must be
-                  # present at the top-level of response message type.
+                  # present at the top-level of request message type.
               "get": "A String", # Used for listing and getting information about resources.
               "mediaDownload": { # Do not use this. For media support, add instead # Do not use this. For media support, add instead
                   # [][google.bytestream.RestByteStream] as an API to your
@@ -5188,8 +5197,14 @@ <h3>Method Details</h3>
                 "options": [ # Any metadata attached to the method.
                   { # A protocol buffer option, which can be attached to a message, field,
                       # enumeration, etc.
-                    "name": "A String", # The option's name. For example, `"java_package"`.
-                    "value": { # The option's value. For example, `"com.google.protobuf"`.
+                    "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                        # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                        # For custom options, it should be the fully-qualified name. For example,
+                        # `"google.api.http"`.
+                    "value": { # The option's value packed in an Any message. If the value is a primitive,
+                        # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                        # should be used. If the value is an enum, it should be stored as an int32
+                        # value using the google.protobuf.Int32Value type.
                       "a_key": "", # Properties of the object. Contains field @type with type URL.
                     },
                   },
@@ -5309,8 +5324,14 @@ <h3>Method Details</h3>
             "options": [ # Any metadata attached to the API.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -5393,7 +5414,9 @@ <h3>Method Details</h3>
           ],
         },
         "metrics": [ # Defines the metrics used by this service.
-          { # Defines a metric type and its schema.
+          { # Defines a metric type and its schema. Once a metric descriptor is created,
+              # deleting or altering it stops data collection and makes the metric type's
+              # existing data unusable.
             "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
                 # Use sentence case without an ending period, for example "Request count".
             "description": "A String", # A detailed description of the metric, which can be used in documentation.
@@ -5401,29 +5424,25 @@ <h3>Method Details</h3>
                 # Some combinations of `metric_kind` and `value_type` might not be supported.
             "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
                 # Some combinations of `metric_kind` and `value_type` might not be supported.
-            "labels": [ # The set of labels that can be used to describe a specific instance of this
-                # metric type. For example, the
-                # `compute.googleapis.com/instance/network/received_bytes_count` metric type
-                # has a label, `loadbalanced`, that specifies whether the traffic was
-                # received through a load balanced IP address.
+            "labels": [ # The set of labels that can be used to describe a specific
+                # instance of this metric type. For example, the
+                # `appengine.googleapis.com/http/server/response_latencies` metric
+                # type has a label for the HTTP response code, `response_code`, so
+                # you can look at latencies for successful responses or just
+                # for responses that failed.
               { # A description of a label.
                 "valueType": "A String", # The type of data that can be assigned to the label.
                 "description": "A String", # A human-readable description for the label.
                 "key": "A String", # The label key.
               },
             ],
-            "type": "A String", # The metric type including a DNS name prefix, for example
-                # `"compute.googleapis.com/instance/cpu/utilization"`. Metric types
-                # should use a natural hierarchical grouping such as the following:
-                #
-                #     compute.googleapis.com/instance/cpu/utilization
-                #     compute.googleapis.com/instance/disk/read_ops_count
-                #     compute.googleapis.com/instance/network/received_bytes_count
+            "type": "A String", # The metric type, including its DNS name prefix. The type is not
+                # URL-encoded.  All user-defined metric types have the DNS name
+                # `custom.googleapis.com`.  Metric types should use a natural hierarchical
+                # grouping. For example:
                 #
-                # Note that if the metric type changes, the monitoring data will be
-                # discontinued, and anything depends on it will break, such as monitoring
-                # dashboards, alerting rules and quota limits. Therefore, once a metric has
-                # been published, its type should be immutable.
+                #     "custom.googleapis.com/invoice/paid/amount"
+                #     "appengine.googleapis.com/http/server/response_latencies"
             "unit": "A String", # The unit in which the metric value is reported. It is only applicable
                 # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
                 # supported units are a subset of [The Unified Code for Units of
@@ -5488,11 +5507,14 @@ <h3>Method Details</h3>
                 #    `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
                 # * `NAME` is a sequence of non-blank printable ASCII characters not
                 #    containing '{' or '}'.
-            "name": "A String", # Resource name. The format of the name may vary between different
-                # implementations. For examples:
+            "name": "A String", # The resource name of the metric descriptor. Depending on the
+                # implementation, the name typically includes: (1) the parent resource name
+                # that defines the scope of the metric type or of its data; and (2) the
+                # metric's URL-encoded type, which also appears in the `type` field of this
+                # descriptor. For example, following is the resource name of a custom
+                # metric within the GCP project 123456789:
                 #
-                #     projects/{project_id}/metricDescriptors/{type=**}
-                #     metricDescriptors/{type=**}
+                #     "projects/123456789/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
           },
         ],
         "enums": [ # A list of all enum types included in this API service.  Enums
@@ -5514,8 +5536,14 @@ <h3>Method Details</h3>
                 "options": [ # Protocol buffer options.
                   { # A protocol buffer option, which can be attached to a message, field,
                       # enumeration, etc.
-                    "name": "A String", # The option's name. For example, `"java_package"`.
-                    "value": { # The option's value. For example, `"com.google.protobuf"`.
+                    "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                        # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                        # For custom options, it should be the fully-qualified name. For example,
+                        # `"google.api.http"`.
+                    "value": { # The option's value packed in an Any message. If the value is a primitive,
+                        # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                        # should be used. If the value is an enum, it should be stored as an int32
+                        # value using the google.protobuf.Int32Value type.
                       "a_key": "", # Properties of the object. Contains field @type with type URL.
                     },
                   },
@@ -5526,8 +5554,14 @@ <h3>Method Details</h3>
             "options": [ # Protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -5570,8 +5604,14 @@ <h3>Method Details</h3>
                 "options": [ # The protocol buffer options.
                   { # A protocol buffer option, which can be attached to a message, field,
                       # enumeration, etc.
-                    "name": "A String", # The option's name. For example, `"java_package"`.
-                    "value": { # The option's value. For example, `"com.google.protobuf"`.
+                    "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                        # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                        # For custom options, it should be the fully-qualified name. For example,
+                        # `"google.api.http"`.
+                    "value": { # The option's value packed in an Any message. If the value is a primitive,
+                        # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                        # should be used. If the value is an enum, it should be stored as an int32
+                        # value using the google.protobuf.Int32Value type.
                       "a_key": "", # Properties of the object. Contains field @type with type URL.
                     },
                   },
@@ -5582,8 +5622,14 @@ <h3>Method Details</h3>
             "options": [ # The protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -5799,8 +5845,14 @@ <h3>Method Details</h3>
                 "options": [ # The protocol buffer options.
                   { # A protocol buffer option, which can be attached to a message, field,
                       # enumeration, etc.
-                    "name": "A String", # The option's name. For example, `"java_package"`.
-                    "value": { # The option's value. For example, `"com.google.protobuf"`.
+                    "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                        # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                        # For custom options, it should be the fully-qualified name. For example,
+                        # `"google.api.http"`.
+                    "value": { # The option's value packed in an Any message. If the value is a primitive,
+                        # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                        # should be used. If the value is an enum, it should be stored as an int32
+                        # value using the google.protobuf.Int32Value type.
                       "a_key": "", # Properties of the object. Contains field @type with type URL.
                     },
                   },
@@ -5811,8 +5863,14 @@ <h3>Method Details</h3>
             "options": [ # The protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -5871,29 +5929,7 @@ <h3>Method Details</h3>
               #       # it to decide whether the subsequent cross-origin request is
               #       # allowed to proceed.
               #     - name: library-example.googleapis.com
-              #       apis: google.example.library.v1.Library
               #       allow_cors: true
-              #       # Below entry makes 'google.example.library.v1.Library'
-              #       # API be served from endpoint address
-              #       # google.example.library-example.v1.LibraryManager.
-              #     - name: library-manager.googleapis.com
-              #       apis: google.example.library.v1.LibraryManager
-              #       # BNS address for a borg job. Can specify a task by appending
-              #       # "/taskId" (e.g. "/0") to the job spec.
-              #
-              # Example OpenAPI extension for endpoint with allow_cors set to true:
-              #
-              #     {
-              #       "swagger": "2.0",
-              #       "info": {
-              #         "description": "A simple..."
-              #       },
-              #       "host": "MY_PROJECT_ID.appspot.com",
-              #       "x-google-endpoints": [{
-              #         "name": "MY_PROJECT_ID.appspot.com",
-              #         "allow_cors": "true"
-              #       }]
-              #     }
             "allowCors": True or False, # Allowing
                 # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
                 # cross-domain traffic, would allow the backends served from this endpoint to
diff --git a/docs/dyn/servicemanagement_v1.services.html b/docs/dyn/servicemanagement_v1.services.html
index 31cfe5bad29..efcad15d447 100644
--- a/docs/dyn/servicemanagement_v1.services.html
+++ b/docs/dyn/servicemanagement_v1.services.html
@@ -89,7 +89,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Creates a new managed service.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(serviceName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a managed service. This method will change the serivce in the</p>
+<p class="firstline">Deletes a managed service. This method will change the service to the</p>
 <p class="toc_element">
   <code><a href="#disable">disable(serviceName=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Disable a managed service for a project.</p>
@@ -101,7 +101,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Generates and returns a report (errors, warnings and changes from</p>
 <p class="toc_element">
   <code><a href="#get">get(serviceName=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets a managed service.</p>
+<p class="firstline">Gets a managed service. Authentication is required unless the service is</p>
 <p class="toc_element">
   <code><a href="#getConfig">getConfig(serviceName=None, configId=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets a service configuration (version) for a managed service.</p>
@@ -109,8 +109,8 @@ <h2>Instance Methods</h2>
   <code><a href="#getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets the access control policy for a resource.</p>
 <p class="toc_element">
-  <code><a href="#list">list(producerProjectId=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists all managed services.</p>
+  <code><a href="#list">list(producerProjectId=None, pageSize=None, consumerId=None, pageToken=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists managed services.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -242,7 +242,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="delete">delete(serviceName=None, x__xgafv=None)</code>
-  <pre>Deletes a managed service. This method will change the serivce in the
+  <pre>Deletes a managed service. This method will change the service to the
 `Soft-Delete` state for 30 days. Within this period, service producers may
 call UndeleteService to restore the service.
 After 30 days, the service will be permanently deleted.
@@ -367,7 +367,8 @@ <h3>Method Details</h3>
         # applied to.
         # 
         # The Google Service Management implementation accepts the following
-        # forms: "project:<project_id>", "project_number:<project_number>".
+        # forms:
+        # - "project:<project_id>"
         # 
         # Note: this is made compatible with
         # google.api.servicecontrol.v1.Operation.consumer_id.
@@ -491,7 +492,8 @@ <h3>Method Details</h3>
         # applied to.
         # 
         # The Google Service Management implementation accepts the following
-        # forms: "project:<project_id>", "project_number:<project_number>".
+        # forms:
+        # - "project:<project_id>"
         # 
         # Note: this is made compatible with
         # google.api.servicecontrol.v1.Operation.consumer_id.
@@ -698,7 +700,8 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(serviceName=None, x__xgafv=None)</code>
-  <pre>Gets a managed service.
+  <pre>Gets a managed service. Authentication is required unless the service is
+public.
 
 Args:
   serviceName: string, The name of the service.  See the `ServiceManager` overview for naming
@@ -726,7 +729,7 @@ <h3>Method Details</h3>
 Args:
   serviceName: string, The name of the service.  See the [overview](/service-management/overview)
 for naming requirements.  For example: `example.googleapis.com`. (required)
-  configId: string, A parameter
+  configId: string, The id of the service configuration resource.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -749,10 +752,15 @@ <h3>Method Details</h3>
       #     title: Google Calendar API
       #     apis:
       #     - name: google.calendar.v3.Calendar
-      #     backend:
+      #     authentication:
+      #       providers:
+      #       - id: google_calendar_auth
+      #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+      #         issuer: https://securetoken.google.com
       #       rules:
-      #       - selector: "google.calendar.v3.*"
-      #         address: calendar.example.com
+      #       - selector: "*"
+      #         requirements:
+      #           provider_id: google_calendar_auth
     "control": { # Selects and configures the service controller used by the service.  The # Configuration for the service control plane.
         # service controller handles features like abuse, quota, billing, logging,
         # monitoring, etc.
@@ -824,56 +832,6 @@ <h3>Method Details</h3>
             # slash, underscore, hyphen, period [/_-.].
       },
     ],
-    "analytics": { # Analytics configuration of the service. # WARNING: DO NOT USE UNTIL THIS MESSAGE IS REMOVED.
-        #
-        # Analytics configuration.
-        #
-        # The example below shows how to configure monitored resources and metrics
-        # for analytics. In the example, a monitored resource and two metrics are
-        # defined. The `library.googleapis.com/book/returned_count` and
-        # `library.googleapis.com/book/overdue_count` metric are sent
-        # to the analytics.
-        #
-        #     monitored_resources:
-        #     - type: library.googleapis.com/branch
-        #       labels:
-        #       - key: /city
-        #         description: The city where the library branch is located in.
-        #       - key: /name
-        #         description: The name of the branch.
-        #     metrics:
-        #     - name: library.googleapis.com/book/returned_count
-        #       metric_kind: DELTA
-        #       value_type: INT64
-        #       labels:
-        #       - key: /customer_id
-        #     - name: library.googleapis.com/book/overdue_count
-        #       metric_kind: GAUGE
-        #       value_type: INT64
-        #       labels:
-        #       - key: /customer_id
-        #     analytics:
-        #       producer_destinations:
-        #       - monitored_resource: library.googleapis.com/branch
-        #         metrics:
-        #         - library.googleapis.com/book/returned_count
-        #         - library.googleapis.com/book/overdue_count
-      "producerDestinations": [ # Analytics configurations for sending metrics to the analytics backend.
-          # There can be multiple producer destinations, each one must have a
-          # different monitored resource type. A metric can be used in at most
-          # one producer destination.
-        { # Configuration of a specific analytics destination.
-          "monitoredResource": "A String", # The monitored resource type. The type must be defined in
-              # Service.monitored_resources section.
-          "metrics": [ # Names of the metrics to report to this analytics destination.
-              # Each name must be defined in Service.metrics section. Metrics
-              # with value type BOOL and STRING must be of GUAGE kind, metrics with
-              # value type INT64, DOUBLE and MONEY must be of DELTA kind.
-            "A String",
-          ],
-        },
-      ],
-    },
     "systemParameters": { # ### System parameter configuration # System parameter configuration.
         #
         # A system parameter is a special kind of parameter defined by the API
@@ -887,27 +845,26 @@ <h3>Method Details</h3>
           # config, default system parameters will be used. Default system parameters
           # and names is implementation-dependent.
           #
-          # Example: define api key and alt name for all methods
+          # Example: define api key for all methods
+          #
+          #     system_parameters
+          #       rules:
+          #         - selector: "*"
+          #           parameters:
+          #             - name: api_key
+          #               url_query_parameter: api_key
           #
-          # system_parameters
-          #   rules:
-          #     - selector: "*"
-          #       parameters:
-          #         - name: api_key
-          #           url_query_parameter: api_key
-          #         - name: alt
-          #           http_header: Response-Content-Type
           #
           # Example: define 2 api key names for a specific method.
           #
-          # system_parameters
-          #   rules:
-          #     - selector: "/ListShelves"
-          #       parameters:
-          #         - name: api_key
-          #           http_header: Api-Key1
-          #         - name: api_key
-          #           http_header: Api-Key2
+          #     system_parameters
+          #       rules:
+          #         - selector: "/ListShelves"
+          #           parameters:
+          #             - name: api_key
+          #               http_header: Api-Key1
+          #             - name: api_key
+          #               http_header: Api-Key2
           #
           # **NOTE:** All service configuration rules follow "last one wins" order.
         { # Define a system parameter rule mapping system parameter definitions to
@@ -922,8 +879,7 @@ <h3>Method Details</h3>
                 # is implementation-dependent.
               "urlQueryParameter": "A String", # Define the URL query parameter name to use for the parameter. It is case
                   # sensitive.
-              "name": "A String", # Define the name of the parameter, such as "api_key", "alt", "callback",
-                  # and etc. It is case sensitive.
+              "name": "A String", # Define the name of the parameter, such as "api_key" . It is case sensitive.
               "httpHeader": "A String", # Define the HTTP header name to use for the parameter. It is case
                   # insensitive.
             },
@@ -1025,14 +981,14 @@ <h3>Method Details</h3>
         #
         #     name: calendar.googleapis.com
         #     authentication:
+        #       providers:
+        #       - id: google_calendar_auth
+        #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+        #         issuer: https://securetoken.google.com
         #       rules:
         #       - selector: "*"
-        #         oauth:
-        #           canonical_scopes: https://www.googleapis.com/auth/calendar
-        #
-        #       - selector: google.calendar.Delegate
-        #         oauth:
-        #           canonical_scopes: https://www.googleapis.com/auth/calendar.read
+        #         requirements:
+        #           provider_id: google_calendar_auth
       "rules": [ # A list of authentication rules that apply to individual API methods.
           #
           # **NOTE:** All service configuration rules follow "last one wins" order.
@@ -1079,7 +1035,10 @@ <h3>Method Details</h3>
                   # Example:
                   #
                   #     provider_id: bookstore_auth
-              "audiences": "A String", # The list of JWT
+              "audiences": "A String", # NOTE: This will be deprecated soon, once AuthProvider.audiences is
+                  # implemented and accepted in all the runtime components.
+                  #
+                  # The list of JWT
                   # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
                   # that are allowed to access. A JWT containing any of these audiences will
                   # be accepted. When this setting is absent, only JWTs with audience
@@ -1118,6 +1077,19 @@ <h3>Method Details</h3>
               #  - can be inferred from the email domain of the issuer (e.g. a Google service account).
               #
               # Example: https://www.googleapis.com/oauth2/v1/certs
+          "audiences": "A String", # The list of JWT
+              # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
+              # that are allowed to access. A JWT containing any of these audiences will
+              # be accepted. When this setting is absent, only JWTs with audience
+              # "https://Service_name/API_name"
+              # will be accepted. For example, if no audiences are in the setting,
+              # LibraryService API will only accept JWTs with the following audience
+              # "https://library-example.googleapis.com/google.example.library.v1.LibraryService".
+              #
+              # Example:
+              #
+              #     audiences: bookstore_android.apps.googleusercontent.com,
+              #                bookstore_web.apps.googleusercontent.com
           "id": "A String", # The unique identifier of the auth provider. It will be referred to by
               # `AuthRequirement.provider_id`.
               #
@@ -1167,6 +1139,14 @@ <h3>Method Details</h3>
           "allowUnregisteredCalls": True or False, # True, if the method allows unregistered calls; false otherwise.
         },
       ],
+      "producerNotificationChannel": "A String", # The full resource name of a channel used for sending notifications to the
+          # service producer.
+          #
+          # Google Service Management currently only supports
+          # [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification
+          # channel. To use Google Cloud Pub/Sub as the channel, this must be the name
+          # of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
+          # documented in https://cloud.google.com/pubsub/docs/overview.
       "requirements": [ # Requirements that must be satisfied before a consumer project can use the
           # service. Each requirement is of the form <service.name>/<requirement-id>;
           # for example 'serviceusage.googleapis.com/billing-enabled'.
@@ -1198,23 +1178,30 @@ <h3>Method Details</h3>
             # message, as in the example below which describes a REST GET
             # operation on a resource collection of messages:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc GetMessage(GetMessageRequest) returns (Message) {
-            #     option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
-            #   }
-            # }
-            # message GetMessageRequest {
-            #   message SubMessage {
-            #     string subfield = 1;
-            #   }
-            #   string message_id = 1; // mapped to the URL
-            #   SubMessage sub = 2;    // `sub.subfield` is url-mapped
-            # }
-            # message Message {
-            #   string text = 1; // content of the resource
-            # }
-            # ```
+            #
+            #     service Messaging {
+            #       rpc GetMessage(GetMessageRequest) returns (Message) {
+            #         option (google.api.http).get = "/v1/messages/{message_id}/{sub.subfield}";
+            #       }
+            #     }
+            #     message GetMessageRequest {
+            #       message SubMessage {
+            #         string subfield = 1;
+            #       }
+            #       string message_id = 1; // mapped to the URL
+            #       SubMessage sub = 2;    // `sub.subfield` is url-mapped
+            #     }
+            #     message Message {
+            #       string text = 1; // content of the resource
+            #     }
+            #
+            # The same http annotation can alternatively be expressed inside the
+            # `GRPC API Configuration` YAML file.
+            #
+            #     http:
+            #       rules:
+            #         - selector: <proto_package_name>.Messaging.GetMessage
+            #           get: /v1/messages/{message_id}/{sub.subfield}
             #
             # This definition enables an automatic, bidrectional mapping of HTTP
             # JSON to RPC. Example:
@@ -1231,16 +1218,16 @@ <h3>Method Details</h3>
             # pattern automatically become (optional) HTTP query
             # parameters. Assume the following definition of the request message:
             #
-            # ```proto
-            # message GetMessageRequest {
-            #   message SubMessage {
-            #     string subfield = 1;
-            #   }
-            #   string message_id = 1; // mapped to the URL
-            #   int64 revision = 2;    // becomes a parameter
-            #   SubMessage sub = 3;    // `sub.subfield` becomes a parameter
-            # }
-            # ```
+            #
+            #     message GetMessageRequest {
+            #       message SubMessage {
+            #         string subfield = 1;
+            #       }
+            #       string message_id = 1; // mapped to the URL
+            #       int64 revision = 2;    // becomes a parameter
+            #       SubMessage sub = 3;    // `sub.subfield` becomes a parameter
+            #     }
+            #
             #
             # This enables a HTTP JSON to RPC mapping as below:
             #
@@ -1257,20 +1244,20 @@ <h3>Method Details</h3>
             # specifies the mapping. Consider a REST update method on the
             # message resource collection:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
-            #     option (google.api.http) = {
-            #       put: "/v1/messages/{message_id}"
-            #       body: "message"
-            #     };
-            #   }
-            # }
-            # message UpdateMessageRequest {
-            #   string message_id = 1; // mapped to the URL
-            #   Message message = 2;   // mapped to the body
-            # }
-            # ```
+            #
+            #     service Messaging {
+            #       rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
+            #         option (google.api.http) = {
+            #           put: "/v1/messages/{message_id}"
+            #           body: "message"
+            #         };
+            #       }
+            #     }
+            #     message UpdateMessageRequest {
+            #       string message_id = 1; // mapped to the URL
+            #       Message message = 2;   // mapped to the body
+            #     }
+            #
             #
             # The following HTTP JSON to RPC mapping is enabled, where the
             # representation of the JSON in the request body is determined by
@@ -1285,20 +1272,19 @@ <h3>Method Details</h3>
             # request body.  This enables the following alternative definition of
             # the update method:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc UpdateMessage(Message) returns (Message) {
-            #     option (google.api.http) = {
-            #       put: "/v1/messages/{message_id}"
-            #       body: "*"
-            #     };
-            #   }
-            # }
-            # message Message {
-            #   string message_id = 1;
-            #   string text = 2;
-            # }
-            # ```
+            #     service Messaging {
+            #       rpc UpdateMessage(Message) returns (Message) {
+            #         option (google.api.http) = {
+            #           put: "/v1/messages/{message_id}"
+            #           body: "*"
+            #         };
+            #       }
+            #     }
+            #     message Message {
+            #       string message_id = 1;
+            #       string text = 2;
+            #     }
+            #
             #
             # The following HTTP JSON to RPC mapping is enabled:
             #
@@ -1315,22 +1301,21 @@ <h3>Method Details</h3>
             # It is possible to define multiple HTTP methods for one RPC by using
             # the `additional_bindings` option. Example:
             #
-            # ```proto
-            # service Messaging {
-            #   rpc GetMessage(GetMessageRequest) returns (Message) {
-            #     option (google.api.http) = {
-            #       get: "/v1/messages/{message_id}"
-            #       additional_bindings {
-            #         get: "/v1/users/{user_id}/messages/{message_id}"
+            #     service Messaging {
+            #       rpc GetMessage(GetMessageRequest) returns (Message) {
+            #         option (google.api.http) = {
+            #           get: "/v1/messages/{message_id}"
+            #           additional_bindings {
+            #             get: "/v1/users/{user_id}/messages/{message_id}"
+            #           }
+            #         };
             #       }
-            #     };
-            #   }
-            # }
-            # message GetMessageRequest {
-            #   string message_id = 1;
-            #   string user_id = 2;
-            # }
-            # ```
+            #     }
+            #     message GetMessageRequest {
+            #       string message_id = 1;
+            #       string user_id = 2;
+            #     }
+            #
             #
             # This enables the following two alternative HTTP JSON to RPC
             # mappings:
@@ -1371,7 +1356,7 @@ <h3>Method Details</h3>
             #
             # The syntax `**` matches zero or more path segments. It follows the semantics
             # of [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.3 Reserved
-            # Expansion.
+            # Expansion. NOTE: it must be the last segment in the path except the Verb.
             #
             # The syntax `LITERAL` matches literal text in the URL path.
             #
@@ -1390,7 +1375,7 @@ <h3>Method Details</h3>
           "body": "A String", # The name of the request field whose value is mapped to the HTTP body, or
               # `*` for mapping all fields not captured by the path pattern to the HTTP
               # body. NOTE: the referred field must not be a repeated field and must be
-              # present at the top-level of response message type.
+              # present at the top-level of request message type.
           "get": "A String", # Used for listing and getting information about resources.
           "mediaDownload": { # Do not use this. For media support, add instead # Do not use this. For media support, add instead
               # [][google.bytestream.RestByteStream] as an API to your
@@ -1447,8 +1432,14 @@ <h3>Method Details</h3>
             "options": [ # Any metadata attached to the method.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -1568,8 +1559,14 @@ <h3>Method Details</h3>
         "options": [ # Any metadata attached to the API.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -1652,7 +1649,9 @@ <h3>Method Details</h3>
       ],
     },
     "metrics": [ # Defines the metrics used by this service.
-      { # Defines a metric type and its schema.
+      { # Defines a metric type and its schema. Once a metric descriptor is created,
+          # deleting or altering it stops data collection and makes the metric type's
+          # existing data unusable.
         "displayName": "A String", # A concise name for the metric, which can be displayed in user interfaces.
             # Use sentence case without an ending period, for example "Request count".
         "description": "A String", # A detailed description of the metric, which can be used in documentation.
@@ -1660,29 +1659,25 @@ <h3>Method Details</h3>
             # Some combinations of `metric_kind` and `value_type` might not be supported.
         "valueType": "A String", # Whether the measurement is an integer, a floating-point number, etc.
             # Some combinations of `metric_kind` and `value_type` might not be supported.
-        "labels": [ # The set of labels that can be used to describe a specific instance of this
-            # metric type. For example, the
-            # `compute.googleapis.com/instance/network/received_bytes_count` metric type
-            # has a label, `loadbalanced`, that specifies whether the traffic was
-            # received through a load balanced IP address.
+        "labels": [ # The set of labels that can be used to describe a specific
+            # instance of this metric type. For example, the
+            # `appengine.googleapis.com/http/server/response_latencies` metric
+            # type has a label for the HTTP response code, `response_code`, so
+            # you can look at latencies for successful responses or just
+            # for responses that failed.
           { # A description of a label.
             "valueType": "A String", # The type of data that can be assigned to the label.
             "description": "A String", # A human-readable description for the label.
             "key": "A String", # The label key.
           },
         ],
-        "type": "A String", # The metric type including a DNS name prefix, for example
-            # `"compute.googleapis.com/instance/cpu/utilization"`. Metric types
-            # should use a natural hierarchical grouping such as the following:
-            #
-            #     compute.googleapis.com/instance/cpu/utilization
-            #     compute.googleapis.com/instance/disk/read_ops_count
-            #     compute.googleapis.com/instance/network/received_bytes_count
-            #
-            # Note that if the metric type changes, the monitoring data will be
-            # discontinued, and anything depends on it will break, such as monitoring
-            # dashboards, alerting rules and quota limits. Therefore, once a metric has
-            # been published, its type should be immutable.
+        "type": "A String", # The metric type, including its DNS name prefix. The type is not
+            # URL-encoded.  All user-defined metric types have the DNS name
+            # `custom.googleapis.com`.  Metric types should use a natural hierarchical
+            # grouping. For example:
+            #
+            #     "custom.googleapis.com/invoice/paid/amount"
+            #     "appengine.googleapis.com/http/server/response_latencies"
         "unit": "A String", # The unit in which the metric value is reported. It is only applicable
             # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
             # supported units are a subset of [The Unified Code for Units of
@@ -1747,11 +1742,14 @@ <h3>Method Details</h3>
             #    `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
             # * `NAME` is a sequence of non-blank printable ASCII characters not
             #    containing '{' or '}'.
-        "name": "A String", # Resource name. The format of the name may vary between different
-            # implementations. For examples:
-            #
-            #     projects/{project_id}/metricDescriptors/{type=**}
-            #     metricDescriptors/{type=**}
+        "name": "A String", # The resource name of the metric descriptor. Depending on the
+            # implementation, the name typically includes: (1) the parent resource name
+            # that defines the scope of the metric type or of its data; and (2) the
+            # metric's URL-encoded type, which also appears in the `type` field of this
+            # descriptor. For example, following is the resource name of a custom
+            # metric within the GCP project 123456789:
+            #
+            #     "projects/123456789/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
       },
     ],
     "enums": [ # A list of all enum types included in this API service.  Enums
@@ -1773,8 +1771,14 @@ <h3>Method Details</h3>
             "options": [ # Protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -1785,8 +1789,14 @@ <h3>Method Details</h3>
         "options": [ # Protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -1829,8 +1839,14 @@ <h3>Method Details</h3>
             "options": [ # The protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -1841,8 +1857,14 @@ <h3>Method Details</h3>
         "options": [ # The protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -2058,8 +2080,14 @@ <h3>Method Details</h3>
             "options": [ # The protocol buffer options.
               { # A protocol buffer option, which can be attached to a message, field,
                   # enumeration, etc.
-                "name": "A String", # The option's name. For example, `"java_package"`.
-                "value": { # The option's value. For example, `"com.google.protobuf"`.
+                "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                    # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                    # For custom options, it should be the fully-qualified name. For example,
+                    # `"google.api.http"`.
+                "value": { # The option's value packed in an Any message. If the value is a primitive,
+                    # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                    # should be used. If the value is an enum, it should be stored as an int32
+                    # value using the google.protobuf.Int32Value type.
                   "a_key": "", # Properties of the object. Contains field @type with type URL.
                 },
               },
@@ -2070,8 +2098,14 @@ <h3>Method Details</h3>
         "options": [ # The protocol buffer options.
           { # A protocol buffer option, which can be attached to a message, field,
               # enumeration, etc.
-            "name": "A String", # The option's name. For example, `"java_package"`.
-            "value": { # The option's value. For example, `"com.google.protobuf"`.
+            "name": "A String", # The option's name. For protobuf built-in options (options defined in
+                # descriptor.proto), this is the short name. For example, `"map_entry"`.
+                # For custom options, it should be the fully-qualified name. For example,
+                # `"google.api.http"`.
+            "value": { # The option's value packed in an Any message. If the value is a primitive,
+                # the corresponding wrapper type defined in google/protobuf/wrappers.proto
+                # should be used. If the value is an enum, it should be stored as an int32
+                # value using the google.protobuf.Int32Value type.
               "a_key": "", # Properties of the object. Contains field @type with type URL.
             },
           },
@@ -2130,29 +2164,7 @@ <h3>Method Details</h3>
           #       # it to decide whether the subsequent cross-origin request is
           #       # allowed to proceed.
           #     - name: library-example.googleapis.com
-          #       apis: google.example.library.v1.Library
           #       allow_cors: true
-          #       # Below entry makes 'google.example.library.v1.Library'
-          #       # API be served from endpoint address
-          #       # google.example.library-example.v1.LibraryManager.
-          #     - name: library-manager.googleapis.com
-          #       apis: google.example.library.v1.LibraryManager
-          #       # BNS address for a borg job. Can specify a task by appending
-          #       # "/taskId" (e.g. "/0") to the job spec.
-          #
-          # Example OpenAPI extension for endpoint with allow_cors set to true:
-          #
-          #     {
-          #       "swagger": "2.0",
-          #       "info": {
-          #         "description": "A simple..."
-          #       },
-          #       "host": "MY_PROJECT_ID.appspot.com",
-          #       "x-google-endpoints": [{
-          #         "name": "MY_PROJECT_ID.appspot.com",
-          #         "allow_cors": "true"
-          #       }]
-          #     }
         "allowCors": True or False, # Allowing
             # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
             # cross-domain traffic, would allow the backends served from this endpoint to
@@ -2239,15 +2251,24 @@ <h3>Method Details</h3>
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always
         # enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list
-          # of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service.
+          # Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit
             # logging for the `service` specified above.
             # Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit
-            # logging.
+        "auditLogConfigs": [ # The configuration for each type of logging
+            # Next ID: 4
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging
+                # Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging.
             # For example, `resourcemanager`, `storage`, `compute`.
             # `allServices` is a special value that covers all services.
       },
@@ -2378,12 +2399,25 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(producerProjectId=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Lists all managed services.
+    <code class="details" id="list">list(producerProjectId=None, pageSize=None, consumerId=None, pageToken=None, x__xgafv=None)</code>
+  <pre>Lists managed services.
+
+If called without any authentication, it returns only the public services.
+If called with authentication, it returns all services that the caller has
+"servicemanagement.services.get" permission for.
+
+**BETA:** If the caller specifies the `consumer_id`, it returns only the
+services enabled on the consumer. The `consumer_id` must have the format
+of "project:{PROJECT-ID}".
 
 Args:
   producerProjectId: string, Include services produced by the specified project.
   pageSize: integer, Requested size of the next page of data.
+  consumerId: string, Include services consumed by the specified consumer.
+
+The Google Service Management implementation accepts the following
+forms:
+- project:<project_id>
   pageToken: string, Token identifying which result to start with; returned by a previous list
 call.
   x__xgafv: string, V1 error format.
@@ -2396,7 +2430,7 @@ <h3>Method Details</h3>
 
     { # Response message for `ListServices` method.
     "nextPageToken": "A String", # Token that can be passed to `ListServices` to resume a paginated query.
-    "services": [ # The results of the query.
+    "services": [ # The returned services will only have the name field set.
       { # The full representation of a Service that is managed by
           # Google Service Management.
         "serviceName": "A String", # The name of the service. See the [overview](/service-management/overview)
@@ -2474,15 +2508,24 @@ <h3>Method Details</h3>
           #
           # Note: `AuditConfig` doesn't apply to "admin activity", which always
           # enables audit logging.
-        { # Enables "data access" audit logging for a service and specifies a list
-            # of members that are log-exempted.
+        { # Provides the configuration for non-admin_activity logging for a service.
+            # Controls exemptions and specific log sub-types.
           "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit
               # logging for the `service` specified above.
               # Follows the same format of Binding.members.
             "A String",
           ],
-          "service": "A String", # Specifies a service that will be enabled for "data access" audit
-              # logging.
+          "auditLogConfigs": [ # The configuration for each type of logging
+              # Next ID: 4
+            { # Provides the configuration for a sub-type of logging.
+              "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging
+                  # Follows the same format of Binding.members.
+                "A String",
+              ],
+              "logType": "A String", # The log type that this config enables.
+            },
+          ],
+          "service": "A String", # Specifies a service that will be enabled for audit logging.
               # For example, `resourcemanager`, `storage`, `compute`.
               # `allServices` is a special value that covers all services.
         },
@@ -2610,6 +2653,11 @@ <h3>Method Details</h3>
       ],
       "iamOwned": True or False,
     },
+    "updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
+        # the fields in the mask will be modified. If no mask is provided, a default
+        # mask is used:
+        # paths: "bindings, etag"
+        # This field is only used by Cloud IAM.
   }
 
   x__xgafv: string, V1 error format.
@@ -2657,15 +2705,24 @@ <h3>Method Details</h3>
         #
         # Note: `AuditConfig` doesn't apply to "admin activity", which always
         # enables audit logging.
-      { # Enables "data access" audit logging for a service and specifies a list
-          # of members that are log-exempted.
+      { # Provides the configuration for non-admin_activity logging for a service.
+          # Controls exemptions and specific log sub-types.
         "exemptedMembers": [ # Specifies the identities that are exempted from "data access" audit
             # logging for the `service` specified above.
             # Follows the same format of Binding.members.
           "A String",
         ],
-        "service": "A String", # Specifies a service that will be enabled for "data access" audit
-            # logging.
+        "auditLogConfigs": [ # The configuration for each type of logging
+            # Next ID: 4
+          { # Provides the configuration for a sub-type of logging.
+            "exemptedMembers": [ # Specifies the identities that are exempted from this type of logging
+                # Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging.
             # For example, `resourcemanager`, `storage`, `compute`.
             # `allServices` is a special value that covers all services.
       },
@@ -2798,6 +2855,8 @@ <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
   <pre>Returns permissions that a caller has on the specified resource.
+If the resource does not exist, this will return an empty set of
+permissions, not a NOT_FOUND error.
 
 Args:
   resource: string, REQUIRED: The resource for which the policy detail is being requested.
diff --git a/docs/dyn/sheets_v4.spreadsheets.html b/docs/dyn/sheets_v4.spreadsheets.html
index cd507af5c33..0562d2648c7 100644
--- a/docs/dyn/sheets_v4.spreadsheets.html
+++ b/docs/dyn/sheets_v4.spreadsheets.html
@@ -122,6 +122,15 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The request for updating any aspect of a spreadsheet.
+    "responseRanges": [ # Limits the ranges included in the response spreadsheet.
+        # Meaningful only if include_spreadsheet_response is 'true'.
+      "A String",
+    ],
+    "includeSpreadsheetInResponse": True or False, # Determines if the update response should include the spreadsheet
+        # resource.
+    "responseIncludeGridData": True or False, # True if grid data should be returned. Meaningful only if
+        # if include_spreadsheet_response is 'true'.
+        # This parameter is ignored if a field mask was set in the request.
     "requests": [ # A list of updates to apply to the spreadsheet.
       { # A single kind of update to apply to a spreadsheet.
         "duplicateFilterView": { # Duplicates a particular filter view. # Duplicates a filter view.
@@ -3929,7 +3938,13 @@ <h3>Method Details</h3>
             "index": 42, # The index of the sheet within the spreadsheet.
                 # When adding or updating sheet properties, if this field
                 # is excluded then the sheet will be added or moved to the end
-                # of the sheet list.
+                # of the sheet list. When updating sheet indices or inserting
+                # sheets, movement is considered in "before the move" indexes.
+                # For example, if there were 3 sheets (S1, S2, S3) in order to
+                # move S1 ahead of S2 the index would have to be set to 2. A sheet
+                # index update request will be ignored if the requested index is
+                # identical to the sheets current index or if the requested new
+                # index is equal to the current sheet index + 1.
             "title": "A String", # The name of the sheet.
             "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
                 # (If the sheet is an object sheet, containing a chart or image, then
@@ -5848,6 +5863,9 @@ <h3>Method Details</h3>
             },
           },
         },
+        "deleteBanding": { # Removes the banded range with the given ID from the spreadsheet. # Removes a banded range
+          "bandedRangeId": 42, # The ID of the banded range to delete.
+        },
         "repeatCell": { # Updates all cells in the range to the values in the given Cell object. # Repeats a single cell across a range.
             # Only the fields listed in the fields field are updated; others are
             # unchanged.
@@ -11242,160 +11260,12 @@ <h3>Method Details</h3>
           "sheetId": 42, # The sheet to append rows or columns to.
           "dimension": "A String", # Whether rows or columns should be appended.
         },
-        "autoResizeDimensions": { # Automatically resizes one or more dimensions based on the contents # Automatically resizes one or more dimensions based on the contents
-            # of the cells in that dimension.
-            # of the cells in that dimension.
-          "dimensions": { # A range along a single dimension on a sheet. # The dimensions to automatically resize.
-              # Only COLUMNS are supported.
-              # All indexes are zero-based.
-              # Indexes are half open: the start index is inclusive
-              # and the end index is exclusive.
-              # Missing indexes indicate the range is unbounded on that side.
-            "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded.
-            "startIndex": 42, # The start (inclusive) of the span, or not set if unbounded.
-            "sheetId": 42, # The sheet this span is on.
-            "dimension": "A String", # The dimension of the span.
-          },
-        },
-        "updateDimensionProperties": { # Updates properties of dimensions within the specified range. # Updates dimensions' properties.
+        "updateBanding": { # Updates properties of the supplied banded range. # Updates a banded range
           "fields": "A String", # The fields that should be updated.  At least one field must be specified.
-              # The root `properties` is implied and should not be specified.
+              # The root `bandedRange` is implied and should not be specified.
               # A single `"*"` can be used as short-hand for listing every field.
-          "range": { # A range along a single dimension on a sheet. # The rows or columns to update.
-              # All indexes are zero-based.
-              # Indexes are half open: the start index is inclusive
-              # and the end index is exclusive.
-              # Missing indexes indicate the range is unbounded on that side.
-            "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded.
-            "startIndex": 42, # The start (inclusive) of the span, or not set if unbounded.
-            "sheetId": 42, # The sheet this span is on.
-            "dimension": "A String", # The dimension of the span.
-          },
-          "properties": { # Properties about a dimension. # Properties to update.
-            "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
-            "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
-            "hiddenByFilter": True or False, # True if this dimension is being filtered.
-                # This field is read-only.
-          },
-        },
-        "unmergeCells": { # Unmerges cells in the given range. # Unmerges merged cells.
-          "range": { # A range on a sheet. # The range within which all cells should be unmerged.
-              # If the range spans multiple merges, all will be unmerged.
-              # The range must not partially span any merge.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-        },
-        "setDataValidation": { # Sets a data validation rule to every cell in the range. # Sets data validation for one or more cells.
-            # To clear validation in a range, call this with no rule specified.
-          "range": { # A range on a sheet. # The range the data validation rule should apply to.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "rule": { # A data validation rule. # The data validation rule to set on each cell in the range,
-              # or empty to clear the data validation in the range.
-            "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
-                # If true, "List" conditions will show a dropdown.
-            "strict": True or False, # True if invalid data should be rejected.
-            "inputMessage": "A String", # A message to show the user when adding data to the cell.
-            "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
-                # BooleanConditions are used by conditional formatting,
-                # data validation, and the criteria in filters.
-              "type": "A String", # The type of condition.
-              "values": [ # The values of the condition. The number of supported values depends
-                  # on the condition type.  Some support zero values,
-                  # others one or two values,
-                  # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                { # The value of the condition.
-                  "relativeDate": "A String", # A relative date (based on the current date).
-                      # Valid only if the type is
-                      # DATE_BEFORE,
-                      # DATE_AFTER,
-                      # DATE_ON_OR_BEFORE or
-                      # DATE_ON_OR_AFTER.
-                      #
-                      # Relative dates are not supported in data validation.
-                      # They are supported only in conditional formatting and
-                      # conditional filters.
-                  "userEnteredValue": "A String", # A value the condition is based on.
-                      # The value will be parsed as if the user typed into a cell.
-                      # Formulas are supported (and must begin with an `=`).
-                },
-              ],
-            },
-          },
-        },
-        "clearBasicFilter": { # Clears the basic filter, if any exists on the sheet. # Clears the basic filter on a sheet.
-          "sheetId": 42, # The sheet ID on which the basic filter should be cleared.
-        },
-        "addNamedRange": { # Adds a named range to the spreadsheet. # Adds a named range.
-          "namedRange": { # A named range. # The named range to add. The namedRangeId
-              # field is optional; if one is not set, an id will be randomly generated. (It
-              # is an error to specify the ID of a range that already exists.)
-            "namedRangeId": "A String", # The ID of the named range.
-            "range": { # A range on a sheet. # The range this represents.
+          "bandedRange": { # A banded (alternating colors) range in a sheet. # The banded range to update with the new properties.
+            "range": { # A range on a sheet. # The range over which these properties are applied.
                 # All indexes are zero-based.
                 # Indexes are half open, e.g the start index is inclusive
                 # and the end index is exclusive -- [start_index, end_index).
@@ -11430,3452 +11300,1566 @@ <h3>Method Details</h3>
               "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
               "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
             },
-            "name": "A String", # The name of the named range.
-          },
-        },
-        "updateChartSpec": { # Updates a chart's specifications. # Updates a chart's specifications.
-            # (This does not move or resize a chart. To move or resize a chart, use
-            #  UpdateEmbeddedObjectPositionRequest.)
-          "chartId": 42, # The ID of the chart to update.
-          "spec": { # The specifications of a chart. # The specification to apply to the chart.
-            "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
-            "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
-              "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
-                "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                  "sources": [ # The ranges of data for a series or domain.
-                      # Exactly one dimension must have a length of 1,
-                      # and all sources in the list must have the same dimension
-                      # with length 1.
-                      # The domain (if it exists) & all series must have the same number
-                      # of source ranges. If using more than one source range, then the source
-                      # range at a given offset must be contiguous across the domain and series.
-                      #
-                      # For example, these are valid configurations:
-                      #
-                      #     domain sources: A1:A5
-                      #     series1 sources: B1:B5
-                      #     series2 sources: D6:D10
-                      #
-                      #     domain sources: A1:A5, C10:C12
-                      #     series1 sources: B1:B5, D10:D12
-                      #     series2 sources: C1:C5, E10:E12
-                    { # A range on a sheet.
-                        # All indexes are zero-based.
-                        # Indexes are half open, e.g the start index is inclusive
-                        # and the end index is exclusive -- [start_index, end_index).
-                        # Missing indexes indicate the range is unbounded on that side.
-                        #
-                        # For example, if `"Sheet1"` is sheet ID 0, then:
-                        #
-                        #   `Sheet1!A1:A1 == sheet_id: 0,
-                        #                   start_row_index: 0, end_row_index: 1,
-                        #                   start_column_index: 0, end_column_index: 1`
-                        #
-                        #   `Sheet1!A3:B4 == sheet_id: 0,
-                        #                   start_row_index: 2, end_row_index: 4,
-                        #                   start_column_index: 0, end_column_index: 2`
-                        #
-                        #   `Sheet1!A:B == sheet_id: 0,
-                        #                 start_column_index: 0, end_column_index: 2`
-                        #
-                        #   `Sheet1!A5:B == sheet_id: 0,
-                        #                  start_row_index: 4,
-                        #                  start_column_index: 0, end_column_index: 2`
-                        #
-                        #   `Sheet1 == sheet_id:0`
-                        #
-                        # The start index must always be less than or equal to the end index.
-                        # If the start index equals the end index, then the range is empty.
-                        # Empty ranges are typically not meaningful and are usually rendered in the
-                        # UI as `#REF!`.
-                      "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                      "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                      "sheetId": 42, # The sheet this range is on.
-                      "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                      "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                    },
-                  ],
-                },
-              },
-              "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
-                "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                  "sources": [ # The ranges of data for a series or domain.
-                      # Exactly one dimension must have a length of 1,
-                      # and all sources in the list must have the same dimension
-                      # with length 1.
-                      # The domain (if it exists) & all series must have the same number
-                      # of source ranges. If using more than one source range, then the source
-                      # range at a given offset must be contiguous across the domain and series.
-                      #
-                      # For example, these are valid configurations:
-                      #
-                      #     domain sources: A1:A5
-                      #     series1 sources: B1:B5
-                      #     series2 sources: D6:D10
-                      #
-                      #     domain sources: A1:A5, C10:C12
-                      #     series1 sources: B1:B5, D10:D12
-                      #     series2 sources: C1:C5, E10:E12
-                    { # A range on a sheet.
-                        # All indexes are zero-based.
-                        # Indexes are half open, e.g the start index is inclusive
-                        # and the end index is exclusive -- [start_index, end_index).
-                        # Missing indexes indicate the range is unbounded on that side.
-                        #
-                        # For example, if `"Sheet1"` is sheet ID 0, then:
-                        #
-                        #   `Sheet1!A1:A1 == sheet_id: 0,
-                        #                   start_row_index: 0, end_row_index: 1,
-                        #                   start_column_index: 0, end_column_index: 1`
-                        #
-                        #   `Sheet1!A3:B4 == sheet_id: 0,
-                        #                   start_row_index: 2, end_row_index: 4,
-                        #                   start_column_index: 0, end_column_index: 2`
-                        #
-                        #   `Sheet1!A:B == sheet_id: 0,
-                        #                 start_column_index: 0, end_column_index: 2`
-                        #
-                        #   `Sheet1!A5:B == sheet_id: 0,
-                        #                  start_row_index: 4,
-                        #                  start_column_index: 0, end_column_index: 2`
-                        #
-                        #   `Sheet1 == sheet_id:0`
-                        #
-                        # The start index must always be less than or equal to the end index.
-                        # If the start index equals the end index, then the range is empty.
-                        # Empty ranges are typically not meaningful and are usually rendered in the
-                        # UI as `#REF!`.
-                      "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                      "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                      "sheetId": 42, # The sheet this range is on.
-                      "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                      "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                    },
-                  ],
-                },
+            "columnProperties": { # Properties referring a single dimension (either row or column). If both # Properties for column bands. These properties will be applied on a column-
+                # by-column basis throughout all the columns in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-              "threeDimensional": True or False, # True if the pie is three dimensional.
-              "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
-              "pieHole": 3.14, # The size of the hole in the pie chart.
-            },
-            "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
-                # See BasicChartType for the list of all
-                # charts this supports.
-                # of charts this supports.
-              "headerCount": 42, # The number of rows or columns in the data that are "headers".
-                  # If not set, Google Sheets will guess how many rows are headers based
-                  # on the data.
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                   #
-                  # (Note that BasicChartAxis.title may override the axis title
-                  #  inferred from the header values.)
-              "series": [ # The data this chart is visualizing.
-                { # A single series of data in a chart.
-                    # For example, if charting stock prices over time, multiple series may exist,
-                    # one for the "Open Price", "High Price", "Low Price" and "Close Price".
-                  "series": { # The data included in a domain or series. # The data being visualized in this chart series.
-                    "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                      "sources": [ # The ranges of data for a series or domain.
-                          # Exactly one dimension must have a length of 1,
-                          # and all sources in the list must have the same dimension
-                          # with length 1.
-                          # The domain (if it exists) & all series must have the same number
-                          # of source ranges. If using more than one source range, then the source
-                          # range at a given offset must be contiguous across the domain and series.
-                          #
-                          # For example, these are valid configurations:
-                          #
-                          #     domain sources: A1:A5
-                          #     series1 sources: B1:B5
-                          #     series2 sources: D6:D10
-                          #
-                          #     domain sources: A1:A5, C10:C12
-                          #     series1 sources: B1:B5, D10:D12
-                          #     series2 sources: C1:C5, E10:E12
-                        { # A range on a sheet.
-                            # All indexes are zero-based.
-                            # Indexes are half open, e.g the start index is inclusive
-                            # and the end index is exclusive -- [start_index, end_index).
-                            # Missing indexes indicate the range is unbounded on that side.
-                            #
-                            # For example, if `"Sheet1"` is sheet ID 0, then:
-                            #
-                            #   `Sheet1!A1:A1 == sheet_id: 0,
-                            #                   start_row_index: 0, end_row_index: 1,
-                            #                   start_column_index: 0, end_column_index: 1`
-                            #
-                            #   `Sheet1!A3:B4 == sheet_id: 0,
-                            #                   start_row_index: 2, end_row_index: 4,
-                            #                   start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A:B == sheet_id: 0,
-                            #                 start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A5:B == sheet_id: 0,
-                            #                  start_row_index: 4,
-                            #                  start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1 == sheet_id:0`
-                            #
-                            # The start index must always be less than or equal to the end index.
-                            # If the start index equals the end index, then the range is empty.
-                            # Empty ranges are typically not meaningful and are usually rendered in the
-                            # UI as `#REF!`.
-                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                          "sheetId": 42, # The sheet this range is on.
-                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                        },
-                      ],
-                    },
-                  },
-                  "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
-                      # For example, if charting stocks over time, the "Volume" series
-                      # may want to be pinned to the right with the prices pinned to the left,
-                      # because the scale of trading volume is different than the scale of
-                      # prices.
-                      # It is an error to specify an axis that isn't a valid minor axis
-                      # for the chart's type.
-                  "type": "A String", # The type of this series. Valid only if the
-                      # chartType is
-                      # COMBO.
-                      # Different types will change the way the series is visualized.
-                      # Only LINE, AREA,
-                      # and COLUMN are supported.
-                },
-              ],
-              "legendPosition": "A String", # The position of the chart legend.
-              "domains": [ # The domain of data this is charting.
-                  # Only a single domain is currently supported.
-                { # The domain of a chart.
-                    # For example, if charting stock prices over time, this would be the date.
-                  "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
-                      # this is the data representing the dates.
-                    "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                      "sources": [ # The ranges of data for a series or domain.
-                          # Exactly one dimension must have a length of 1,
-                          # and all sources in the list must have the same dimension
-                          # with length 1.
-                          # The domain (if it exists) & all series must have the same number
-                          # of source ranges. If using more than one source range, then the source
-                          # range at a given offset must be contiguous across the domain and series.
-                          #
-                          # For example, these are valid configurations:
-                          #
-                          #     domain sources: A1:A5
-                          #     series1 sources: B1:B5
-                          #     series2 sources: D6:D10
-                          #
-                          #     domain sources: A1:A5, C10:C12
-                          #     series1 sources: B1:B5, D10:D12
-                          #     series2 sources: C1:C5, E10:E12
-                        { # A range on a sheet.
-                            # All indexes are zero-based.
-                            # Indexes are half open, e.g the start index is inclusive
-                            # and the end index is exclusive -- [start_index, end_index).
-                            # Missing indexes indicate the range is unbounded on that side.
-                            #
-                            # For example, if `"Sheet1"` is sheet ID 0, then:
-                            #
-                            #   `Sheet1!A1:A1 == sheet_id: 0,
-                            #                   start_row_index: 0, end_row_index: 1,
-                            #                   start_column_index: 0, end_column_index: 1`
-                            #
-                            #   `Sheet1!A3:B4 == sheet_id: 0,
-                            #                   start_row_index: 2, end_row_index: 4,
-                            #                   start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A:B == sheet_id: 0,
-                            #                 start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A5:B == sheet_id: 0,
-                            #                  start_row_index: 4,
-                            #                  start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1 == sheet_id:0`
-                            #
-                            # The start index must always be less than or equal to the end index.
-                            # If the start index equals the end index, then the range is empty.
-                            # Empty ranges are typically not meaningful and are usually rendered in the
-                            # UI as `#REF!`.
-                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                          "sheetId": 42, # The sheet this range is on.
-                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                        },
-                      ],
-                    },
-                  },
-                },
-              ],
-              "chartType": "A String", # The type of the chart.
-              "axis": [ # The axis on the chart.
-                { # An axis of the chart.
-                    # A chart may not have more than one axis per
-                    # axis position.
-                  "position": "A String", # The position of this axis.
-                  "format": { # The format of a run of text in a cell. # The format of the title.
-                      # Only valid if the axis is not associated with the domain.
-                      # Absent values indicate that the field isn't specified.
-                    "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "bold": True or False, # True if the text is bold.
-                    "strikethrough": True or False, # True if the text has a strikethrough.
-                    "fontFamily": "A String", # The font family.
-                    "fontSize": 42, # The size of the font.
-                    "italic": True or False, # True if the text is italicized.
-                    "underline": True or False, # True if the text is underlined.
-                  },
-                  "title": "A String", # The title of this axis. If set, this overrides any title inferred
-                      # from headers of the data.
-                },
-              ],
-            },
-            "title": "A String", # The title of the chart.
-          },
-        },
-        "moveDimension": { # Moves one or more rows or columns. # Moves rows or columns to another location in a sheet.
-          "source": { # A range along a single dimension on a sheet. # The source dimensions to move.
-              # All indexes are zero-based.
-              # Indexes are half open: the start index is inclusive
-              # and the end index is exclusive.
-              # Missing indexes indicate the range is unbounded on that side.
-            "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded.
-            "startIndex": 42, # The start (inclusive) of the span, or not set if unbounded.
-            "sheetId": 42, # The sheet this span is on.
-            "dimension": "A String", # The dimension of the span.
-          },
-          "destinationIndex": 42, # The zero-based start index of where to move the source data to,
-              # based on the coordinates *before* the source data is removed
-              # from the grid.  Existing data will be shifted down or right
-              # (depending on the dimension) to make room for the moved dimensions.
-              # The source dimensions are removed from the grid, so the
-              # the data may end up in a different index than specified.
-              #
-              # For example, given `A1..A5` of `0, 1, 2, 3, 4` and wanting to move
-              # `"1"` and `"2"` to between `"3"` and `"4"`, the source would be
-              # `ROWS [1..3)`,and the destination index would be `"4"`
-              # (the zero-based index of row 5).
-              # The end result would be `A1..A5` of `0, 3, 1, 2, 4`.
-        },
-        "textToColumns": { # Splits a column of text into multiple columns, # Converts a column of text into many columns of text.
-            # based on a delimiter in each cell.
-          "source": { # A range on a sheet. # The source data range.  This must span exactly one column.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "delimiter": "A String", # The delimiter to use. Used only if delimiterType is
-              # CUSTOM.
-          "delimiterType": "A String", # The delimiter type to use.
-        },
-        "deleteFilterView": { # Deletes a particular filter view. # Deletes a filter view from a sheet.
-          "filterId": 42, # The ID of the filter to delete.
-        },
-        "mergeCells": { # Merges all cells in the range. # Merges cells together.
-          "range": { # A range on a sheet. # The range of cells to merge.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "mergeType": "A String", # How the cells should be merged.
-        },
-        "deleteProtectedRange": { # Deletes the protected range with the given ID. # Deletes a protected range.
-          "protectedRangeId": 42, # The ID of the protected range to delete.
-        },
-        "addFilterView": { # Adds a filter view. # Adds a filter view.
-          "filter": { # A filter view. # The filter to add. The filterViewId
-              # field is optional; if one is not set, an id will be randomly generated. (It
-              # is an error to specify the ID of a filter that already exists.)
-            "title": "A String", # The name of the filter view.
-            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-            "filterViewId": 42, # The ID of the filter view.
-            "range": { # A range on a sheet. # The range this filter view covers.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-            "sortSpecs": [ # The sort order per column. Later specifications are used when values
-                # are equal in the earlier specifications.
-              { # A sort order associated with a specific column or row.
-                "sortOrder": "A String", # The order data should be sorted.
-                "dimensionIndex": 42, # The dimension the sort should be applied to.
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-            ],
-            "criteria": { # The criteria for showing/hiding values per column.
-                # The map's key is the column index, and the value is the criteria for
-                # that column.
-              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
-                "hiddenValues": [ # Values that should be hidden.
-                  "A String",
-                ],
-                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
-                    # (This does not override hiddenValues -- if a value is listed there,
-                    #  it will still be hidden.)
-                    # BooleanConditions are used by conditional formatting,
-                    # data validation, and the criteria in filters.
-                  "type": "A String", # The type of condition.
-                  "values": [ # The values of the condition. The number of supported values depends
-                      # on the condition type.  Some support zero values,
-                      # others one or two values,
-                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                    { # The value of the condition.
-                      "relativeDate": "A String", # A relative date (based on the current date).
-                          # Valid only if the type is
-                          # DATE_BEFORE,
-                          # DATE_AFTER,
-                          # DATE_ON_OR_BEFORE or
-                          # DATE_ON_OR_AFTER.
-                          #
-                          # Relative dates are not supported in data validation.
-                          # They are supported only in conditional formatting and
-                          # conditional filters.
-                      "userEnteredValue": "A String", # A value the condition is based on.
-                          # The value will be parsed as if the user typed into a cell.
-                          # Formulas are supported (and must begin with an `=`).
-                    },
-                  ],
-                },
-              },
-            },
-          },
-        },
-        "deleteSheet": { # Deletes the requested sheet. # Deletes a sheet.
-          "sheetId": 42, # The ID of the sheet to delete.
-        },
-        "updateBorders": { # Updates the borders of a range. # Updates the borders in a range of cells.
-            # If a field is not set in the request, that means the border remains as-is.
-            # For example, with two subsequent UpdateBordersRequest:
-            #
-            #  1. range: A1:A5 `{ top: RED, bottom: WHITE }`
-            #  2. range: A1:A5 `{ left: BLUE }`
-            #
-            # That would result in A1:A5 having a borders of
-            # `{ top: RED, bottom: WHITE, left: BLUE }`.
-            # If you want to clear a border, explicitly set the style to
-            # NONE.
-          "right": { # A border along a cell. # The border to put at the right of the range.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  # Example (Java):
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-          "bottom": { # A border along a cell. # The border to put at the bottom of the range.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+                  #      import com.google.type.Color;
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-          "top": { # A border along a cell. # The border to put at the top of the range.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-          "innerHorizontal": { # A border along a cell. # The horizontal border to put within the range.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+                  # Example (iOS / Obj-C):
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-          "range": { # A range on a sheet. # The range whose borders should be updated.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "innerVertical": { # A border along a cell. # The vertical border to put within the range.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #  Example (JavaScript):
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-          "left": { # A border along a cell. # The border to put at the left of the range.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+                  #     // ...
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-        },
-        "cutPaste": { # Moves data from the source to the destination. # Cuts data from one area and pastes it to another.
-          "pasteType": "A String", # What kind of data to paste.  All the source data will be cut, regardless
-              # of what is pasted.
-          "source": { # A range on a sheet. # The source data to cut.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "destination": { # A coordinate in a sheet. # The top-left coordinate where the data should be pasted.
-              # All indexes are zero-based.
-            "rowIndex": 42, # The row index of the coordinate.
-            "columnIndex": 42, # The column index of the coordinate.
-            "sheetId": 42, # The sheet this coordinate is on.
-          },
-        },
-        "copyPaste": { # Copies data from the source to the destination. # Copies data from one area and pastes it to another.
-          "pasteType": "A String", # What kind of data to paste.
-          "source": { # A range on a sheet. # The source range to copy.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "destination": { # A range on a sheet. # The location to paste to. If the range covers a span that's
-              # a multiple of the source's height or width, then the
-              # data will be repeated to fill in the destination range.
-              # If the range is smaller than the source range, the entire
-              # source data will still be copied (beyond the end of the destination range).
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "pasteOrientation": "A String", # How that data should be oriented when pasting.
-        },
-        "addSheet": { # Adds a new sheet. # Adds a sheet.
-            # When a sheet is added at a given index,
-            # all subsequent sheets' indexes are incremented.
-            # To add an object sheet, use AddChartRequest instead and specify
-            # EmbeddedObjectPosition.sheetId or
-            # EmbeddedObjectPosition.newSheet.
-          "properties": { # Properties of a sheet. # The properties the new sheet should have.
-              # All properties are optional.
-              # The sheetId field is optional; if one is not
-              # set, an id will be randomly generated. (It is an error to specify the ID
-              # of a sheet that already exists.)
-            "sheetType": "A String", # The type of sheet. Defaults to GRID.
-                # This field cannot be changed once set.
-            "index": 42, # The index of the sheet within the spreadsheet.
-                # When adding or updating sheet properties, if this field
-                # is excluded then the sheet will be added or moved to the end
-                # of the sheet list.
-            "title": "A String", # The name of the sheet.
-            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
-                # (If the sheet is an object sheet, containing a chart or image, then
-                # this field will be absent.)
-                # When writing it is an error to set any grid properties on non-grid sheets.
-              "columnCount": 42, # The number of columns in the grid.
-              "rowCount": 42, # The number of rows in the grid.
-              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
-              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
-              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
-            },
-            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
-            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
-            "sheetId": 42, # The ID of the sheet. Must be non-negative.
-                # This field cannot be changed once set.
-          },
-        },
-        "deleteNamedRange": { # Removes the named range with the given ID from the spreadsheet. # Deletes a named range.
-          "namedRangeId": "A String", # The ID of the named range to delete.
-        },
-        "updateNamedRange": { # Updates properties of the named range with the specified # Updates a named range.
-            # namedRangeId.
-          "fields": "A String", # The fields that should be updated.  At least one field must be specified.
-              # The root `namedRange` is implied and should not be specified.
-              # A single `"*"` can be used as short-hand for listing every field.
-          "namedRange": { # A named range. # The named range to update with the new properties.
-            "namedRangeId": "A String", # The ID of the named range.
-            "range": { # A range on a sheet. # The range this represents.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-            "name": "A String", # The name of the named range.
-          },
-        },
-        "insertDimension": { # Inserts rows or columns in a sheet at a particular index. # Inserts new rows or columns in a sheet.
-          "inheritFromBefore": True or False, # Whether dimension properties should be extended from the dimensions
-              # before or after the newly inserted dimensions.
-              # True to inherit from the dimensions before (in which case the start
-              # index must be greater than 0), and false to inherit from the dimensions
-              # after.
-              #
-              # For example, if row index 0 has red background and row index 1
-              # has a green background, then inserting 2 rows at index 1 can inherit
-              # either the green or red background.  If `inheritFromBefore` is true,
-              # the two new rows will be red (because the row before the insertion point
-              # was red), whereas if `inheritFromBefore` is false, the two new rows will
-              # be green (because the row after the insertion point was green).
-          "range": { # A range along a single dimension on a sheet. # The dimensions to insert.  Both the start and end indexes must be bounded.
-              # All indexes are zero-based.
-              # Indexes are half open: the start index is inclusive
-              # and the end index is exclusive.
-              # Missing indexes indicate the range is unbounded on that side.
-            "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded.
-            "startIndex": 42, # The start (inclusive) of the span, or not set if unbounded.
-            "sheetId": 42, # The sheet this span is on.
-            "dimension": "A String", # The dimension of the span.
-          },
-        },
-        "updateFilterView": { # Updates properties of the filter view. # Updates the properties of a filter view.
-          "filter": { # A filter view. # The new properties of the filter view.
-            "title": "A String", # The name of the filter view.
-            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-            "filterViewId": 42, # The ID of the filter view.
-            "range": { # A range on a sheet. # The range this filter view covers.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-            "sortSpecs": [ # The sort order per column. Later specifications are used when values
-                # are equal in the earlier specifications.
-              { # A sort order associated with a specific column or row.
-                "sortOrder": "A String", # The order data should be sorted.
-                "dimensionIndex": 42, # The dimension the sort should be applied to.
-              },
-            ],
-            "criteria": { # The criteria for showing/hiding values per column.
-                # The map's key is the column index, and the value is the criteria for
-                # that column.
-              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
-                "hiddenValues": [ # Values that should be hidden.
-                  "A String",
-                ],
-                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
-                    # (This does not override hiddenValues -- if a value is listed there,
-                    #  it will still be hidden.)
-                    # BooleanConditions are used by conditional formatting,
-                    # data validation, and the criteria in filters.
-                  "type": "A String", # The type of condition.
-                  "values": [ # The values of the condition. The number of supported values depends
-                      # on the condition type.  Some support zero values,
-                      # others one or two values,
-                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                    { # The value of the condition.
-                      "relativeDate": "A String", # A relative date (based on the current date).
-                          # Valid only if the type is
-                          # DATE_BEFORE,
-                          # DATE_AFTER,
-                          # DATE_ON_OR_BEFORE or
-                          # DATE_ON_OR_AFTER.
-                          #
-                          # Relative dates are not supported in data validation.
-                          # They are supported only in conditional formatting and
-                          # conditional filters.
-                      "userEnteredValue": "A String", # A value the condition is based on.
-                          # The value will be parsed as if the user typed into a cell.
-                          # Formulas are supported (and must begin with an `=`).
-                    },
-                  ],
-                },
-              },
-            },
-          },
-          "fields": "A String", # The fields that should be updated.  At least one field must be specified.
-              # The root `filter` is implied and should not be specified.
-              # A single `"*"` can be used as short-hand for listing every field.
-        },
-        "deleteConditionalFormatRule": { # Deletes a conditional format rule at the given index. # Deletes an existing conditional format rule.
-            # All subsequent rules' indexes are decremented.
-          "index": 42, # The zero-based index of the rule to be deleted.
-          "sheetId": 42, # The sheet the rule is being deleted from.
-        },
-      },
-    ],
-  }
-
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # The reply for batch updating a spreadsheet.
-    "spreadsheetId": "A String", # The spreadsheet the updates were applied to.
-    "replies": [ # The reply of the updates.  This maps 1:1 with the updates, although
-        # replies to some requests may be empty.
-      { # A single response from an update.
-        "duplicateFilterView": { # The result of a filter view being duplicated. # A reply from duplicating a filter view.
-          "filter": { # A filter view. # The newly created filter.
-            "title": "A String", # The name of the filter view.
-            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-            "filterViewId": 42, # The ID of the filter view.
-            "range": { # A range on a sheet. # The range this filter view covers.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-            "sortSpecs": [ # The sort order per column. Later specifications are used when values
-                # are equal in the earlier specifications.
-              { # A sort order associated with a specific column or row.
-                "sortOrder": "A String", # The order data should be sorted.
-                "dimensionIndex": 42, # The dimension the sort should be applied to.
-              },
-            ],
-            "criteria": { # The criteria for showing/hiding values per column.
-                # The map's key is the column index, and the value is the criteria for
-                # that column.
-              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
-                "hiddenValues": [ # Values that should be hidden.
-                  "A String",
-                ],
-                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
-                    # (This does not override hiddenValues -- if a value is listed there,
-                    #  it will still be hidden.)
-                    # BooleanConditions are used by conditional formatting,
-                    # data validation, and the criteria in filters.
-                  "type": "A String", # The type of condition.
-                  "values": [ # The values of the condition. The number of supported values depends
-                      # on the condition type.  Some support zero values,
-                      # others one or two values,
-                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                    { # The value of the condition.
-                      "relativeDate": "A String", # A relative date (based on the current date).
-                          # Valid only if the type is
-                          # DATE_BEFORE,
-                          # DATE_AFTER,
-                          # DATE_ON_OR_BEFORE or
-                          # DATE_ON_OR_AFTER.
-                          #
-                          # Relative dates are not supported in data validation.
-                          # They are supported only in conditional formatting and
-                          # conditional filters.
-                      "userEnteredValue": "A String", # A value the condition is based on.
-                          # The value will be parsed as if the user typed into a cell.
-                          # Formulas are supported (and must begin with an `=`).
-                    },
-                  ],
-                },
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-            },
-          },
-        },
-        "duplicateSheet": { # The result of duplicating a sheet. # A reply from duplicating a sheet.
-          "properties": { # Properties of a sheet. # The properties of the duplicate sheet.
-            "sheetType": "A String", # The type of sheet. Defaults to GRID.
-                # This field cannot be changed once set.
-            "index": 42, # The index of the sheet within the spreadsheet.
-                # When adding or updating sheet properties, if this field
-                # is excluded then the sheet will be added or moved to the end
-                # of the sheet list.
-            "title": "A String", # The name of the sheet.
-            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
-                # (If the sheet is an object sheet, containing a chart or image, then
-                # this field will be absent.)
-                # When writing it is an error to set any grid properties on non-grid sheets.
-              "columnCount": 42, # The number of columns in the grid.
-              "rowCount": 42, # The number of rows in the grid.
-              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
-              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
-              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
-            },
-            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
-            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  # Example (Java):
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
-            "sheetId": 42, # The ID of the sheet. Must be non-negative.
-                # This field cannot be changed once set.
-          },
-        },
-        "updateEmbeddedObjectPosition": { # The result of updating an embedded object's position. # A reply from updating an embedded object's position.
-          "position": { # The position of an embedded object such as a chart. # The new position of the embedded object.
-            "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
-                # is chosen for you. Used only when writing.
-            "sheetId": 42, # The sheet this is on. Set only if the embedded object
-                # is on its own sheet. Must be non-negative.
-            "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
-              "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
-                  # All indexes are zero-based.
-                "rowIndex": 42, # The row index of the coordinate.
-                "columnIndex": 42, # The column index of the coordinate.
-                "sheetId": 42, # The sheet this coordinate is on.
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-              "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
-                  # from the anchor cell.
-              "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
-              "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
-                  # from the anchor cell.
-              "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
             },
-          },
-        },
-        "addChart": { # The result of adding a chart to a spreadsheet. # A reply from adding a chart.
-          "chart": { # A chart embedded in a sheet. # The newly added chart.
-            "chartId": 42, # The ID of the chart.
-            "position": { # The position of an embedded object such as a chart. # The position of the chart.
-              "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
-                  # is chosen for you. Used only when writing.
-              "sheetId": 42, # The sheet this is on. Set only if the embedded object
-                  # is on its own sheet. Must be non-negative.
-              "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
-                "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
-                    # All indexes are zero-based.
-                  "rowIndex": 42, # The row index of the coordinate.
-                  "columnIndex": 42, # The column index of the coordinate.
-                  "sheetId": 42, # The sheet this coordinate is on.
-                },
-                "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
-                    # from the anchor cell.
-                "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
-                "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
-                    # from the anchor cell.
-                "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
+            "rowProperties": { # Properties referring a single dimension (either row or column). If both # Properties for row bands. These properties will be applied on a row-by-row
+                # basis throughout all the rows in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-            },
-            "spec": { # The specifications of a chart. # The specification of the chart.
-              "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
-              "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
-                "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
-                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                    "sources": [ # The ranges of data for a series or domain.
-                        # Exactly one dimension must have a length of 1,
-                        # and all sources in the list must have the same dimension
-                        # with length 1.
-                        # The domain (if it exists) & all series must have the same number
-                        # of source ranges. If using more than one source range, then the source
-                        # range at a given offset must be contiguous across the domain and series.
-                        #
-                        # For example, these are valid configurations:
-                        #
-                        #     domain sources: A1:A5
-                        #     series1 sources: B1:B5
-                        #     series2 sources: D6:D10
-                        #
-                        #     domain sources: A1:A5, C10:C12
-                        #     series1 sources: B1:B5, D10:D12
-                        #     series2 sources: C1:C5, E10:E12
-                      { # A range on a sheet.
-                          # All indexes are zero-based.
-                          # Indexes are half open, e.g the start index is inclusive
-                          # and the end index is exclusive -- [start_index, end_index).
-                          # Missing indexes indicate the range is unbounded on that side.
-                          #
-                          # For example, if `"Sheet1"` is sheet ID 0, then:
-                          #
-                          #   `Sheet1!A1:A1 == sheet_id: 0,
-                          #                   start_row_index: 0, end_row_index: 1,
-                          #                   start_column_index: 0, end_column_index: 1`
-                          #
-                          #   `Sheet1!A3:B4 == sheet_id: 0,
-                          #                   start_row_index: 2, end_row_index: 4,
-                          #                   start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A:B == sheet_id: 0,
-                          #                 start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A5:B == sheet_id: 0,
-                          #                  start_row_index: 4,
-                          #                  start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1 == sheet_id:0`
-                          #
-                          # The start index must always be less than or equal to the end index.
-                          # If the start index equals the end index, then the range is empty.
-                          # Empty ranges are typically not meaningful and are usually rendered in the
-                          # UI as `#REF!`.
-                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                        "sheetId": 42, # The sheet this range is on.
-                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                      },
-                    ],
-                  },
-                },
-                "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
-                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                    "sources": [ # The ranges of data for a series or domain.
-                        # Exactly one dimension must have a length of 1,
-                        # and all sources in the list must have the same dimension
-                        # with length 1.
-                        # The domain (if it exists) & all series must have the same number
-                        # of source ranges. If using more than one source range, then the source
-                        # range at a given offset must be contiguous across the domain and series.
-                        #
-                        # For example, these are valid configurations:
-                        #
-                        #     domain sources: A1:A5
-                        #     series1 sources: B1:B5
-                        #     series2 sources: D6:D10
-                        #
-                        #     domain sources: A1:A5, C10:C12
-                        #     series1 sources: B1:B5, D10:D12
-                        #     series2 sources: C1:C5, E10:E12
-                      { # A range on a sheet.
-                          # All indexes are zero-based.
-                          # Indexes are half open, e.g the start index is inclusive
-                          # and the end index is exclusive -- [start_index, end_index).
-                          # Missing indexes indicate the range is unbounded on that side.
-                          #
-                          # For example, if `"Sheet1"` is sheet ID 0, then:
-                          #
-                          #   `Sheet1!A1:A1 == sheet_id: 0,
-                          #                   start_row_index: 0, end_row_index: 1,
-                          #                   start_column_index: 0, end_column_index: 1`
-                          #
-                          #   `Sheet1!A3:B4 == sheet_id: 0,
-                          #                   start_row_index: 2, end_row_index: 4,
-                          #                   start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A:B == sheet_id: 0,
-                          #                 start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A5:B == sheet_id: 0,
-                          #                  start_row_index: 4,
-                          #                  start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1 == sheet_id:0`
-                          #
-                          # The start index must always be less than or equal to the end index.
-                          # If the start index equals the end index, then the range is empty.
-                          # Empty ranges are typically not meaningful and are usually rendered in the
-                          # UI as `#REF!`.
-                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                        "sheetId": 42, # The sheet this range is on.
-                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                      },
-                    ],
-                  },
-                },
-                "threeDimensional": True or False, # True if the pie is three dimensional.
-                "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
-                "pieHole": 3.14, # The size of the hole in the pie chart.
-              },
-              "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
-                  # See BasicChartType for the list of all
-                  # charts this supports.
-                  # of charts this supports.
-                "headerCount": 42, # The number of rows or columns in the data that are "headers".
-                    # If not set, Google Sheets will guess how many rows are headers based
-                    # on the data.
-                    #
-                    # (Note that BasicChartAxis.title may override the axis title
-                    #  inferred from the header values.)
-                "series": [ # The data this chart is visualizing.
-                  { # A single series of data in a chart.
-                      # For example, if charting stock prices over time, multiple series may exist,
-                      # one for the "Open Price", "High Price", "Low Price" and "Close Price".
-                    "series": { # The data included in a domain or series. # The data being visualized in this chart series.
-                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                        "sources": [ # The ranges of data for a series or domain.
-                            # Exactly one dimension must have a length of 1,
-                            # and all sources in the list must have the same dimension
-                            # with length 1.
-                            # The domain (if it exists) & all series must have the same number
-                            # of source ranges. If using more than one source range, then the source
-                            # range at a given offset must be contiguous across the domain and series.
-                            #
-                            # For example, these are valid configurations:
-                            #
-                            #     domain sources: A1:A5
-                            #     series1 sources: B1:B5
-                            #     series2 sources: D6:D10
-                            #
-                            #     domain sources: A1:A5, C10:C12
-                            #     series1 sources: B1:B5, D10:D12
-                            #     series2 sources: C1:C5, E10:E12
-                          { # A range on a sheet.
-                              # All indexes are zero-based.
-                              # Indexes are half open, e.g the start index is inclusive
-                              # and the end index is exclusive -- [start_index, end_index).
-                              # Missing indexes indicate the range is unbounded on that side.
-                              #
-                              # For example, if `"Sheet1"` is sheet ID 0, then:
-                              #
-                              #   `Sheet1!A1:A1 == sheet_id: 0,
-                              #                   start_row_index: 0, end_row_index: 1,
-                              #                   start_column_index: 0, end_column_index: 1`
-                              #
-                              #   `Sheet1!A3:B4 == sheet_id: 0,
-                              #                   start_row_index: 2, end_row_index: 4,
-                              #                   start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1!A:B == sheet_id: 0,
-                              #                 start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1!A5:B == sheet_id: 0,
-                              #                  start_row_index: 4,
-                              #                  start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1 == sheet_id:0`
-                              #
-                              # The start index must always be less than or equal to the end index.
-                              # If the start index equals the end index, then the range is empty.
-                              # Empty ranges are typically not meaningful and are usually rendered in the
-                              # UI as `#REF!`.
-                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                            "sheetId": 42, # The sheet this range is on.
-                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                          },
-                        ],
-                      },
-                    },
-                    "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
-                        # For example, if charting stocks over time, the "Volume" series
-                        # may want to be pinned to the right with the prices pinned to the left,
-                        # because the scale of trading volume is different than the scale of
-                        # prices.
-                        # It is an error to specify an axis that isn't a valid minor axis
-                        # for the chart's type.
-                    "type": "A String", # The type of this series. Valid only if the
-                        # chartType is
-                        # COMBO.
-                        # Different types will change the way the series is visualized.
-                        # Only LINE, AREA,
-                        # and COLUMN are supported.
-                  },
-                ],
-                "legendPosition": "A String", # The position of the chart legend.
-                "domains": [ # The domain of data this is charting.
-                    # Only a single domain is currently supported.
-                  { # The domain of a chart.
-                      # For example, if charting stock prices over time, this would be the date.
-                    "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
-                        # this is the data representing the dates.
-                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                        "sources": [ # The ranges of data for a series or domain.
-                            # Exactly one dimension must have a length of 1,
-                            # and all sources in the list must have the same dimension
-                            # with length 1.
-                            # The domain (if it exists) & all series must have the same number
-                            # of source ranges. If using more than one source range, then the source
-                            # range at a given offset must be contiguous across the domain and series.
-                            #
-                            # For example, these are valid configurations:
-                            #
-                            #     domain sources: A1:A5
-                            #     series1 sources: B1:B5
-                            #     series2 sources: D6:D10
-                            #
-                            #     domain sources: A1:A5, C10:C12
-                            #     series1 sources: B1:B5, D10:D12
-                            #     series2 sources: C1:C5, E10:E12
-                          { # A range on a sheet.
-                              # All indexes are zero-based.
-                              # Indexes are half open, e.g the start index is inclusive
-                              # and the end index is exclusive -- [start_index, end_index).
-                              # Missing indexes indicate the range is unbounded on that side.
-                              #
-                              # For example, if `"Sheet1"` is sheet ID 0, then:
-                              #
-                              #   `Sheet1!A1:A1 == sheet_id: 0,
-                              #                   start_row_index: 0, end_row_index: 1,
-                              #                   start_column_index: 0, end_column_index: 1`
-                              #
-                              #   `Sheet1!A3:B4 == sheet_id: 0,
-                              #                   start_row_index: 2, end_row_index: 4,
-                              #                   start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1!A:B == sheet_id: 0,
-                              #                 start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1!A5:B == sheet_id: 0,
-                              #                  start_row_index: 4,
-                              #                  start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1 == sheet_id:0`
-                              #
-                              # The start index must always be less than or equal to the end index.
-                              # If the start index equals the end index, then the range is empty.
-                              # Empty ranges are typically not meaningful and are usually rendered in the
-                              # UI as `#REF!`.
-                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                            "sheetId": 42, # The sheet this range is on.
-                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                          },
-                        ],
-                      },
-                    },
-                  },
-                ],
-                "chartType": "A String", # The type of the chart.
-                "axis": [ # The axis on the chart.
-                  { # An axis of the chart.
-                      # A chart may not have more than one axis per
-                      # axis position.
-                    "position": "A String", # The position of this axis.
-                    "format": { # The format of a run of text in a cell. # The format of the title.
-                        # Only valid if the axis is not associated with the domain.
-                        # Absent values indicate that the field isn't specified.
-                      "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                          # for simplicity of conversion to/from color representations in various
-                          # languages over compactness; for example, the fields of this representation
-                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                          # method in iOS; and, with just a little work, it can be easily formatted into
-                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                          #
-                          # Example (Java):
-                          #
-                          #      import com.google.type.Color;
-                          #
-                          #      // ...
-                          #      public static java.awt.Color fromProto(Color protocolor) {
-                          #        float alpha = protocolor.hasAlpha()
-                          #            ? protocolor.getAlpha().getValue()
-                          #            : 1.0;
-                          #
-                          #        return new java.awt.Color(
-                          #            protocolor.getRed(),
-                          #            protocolor.getGreen(),
-                          #            protocolor.getBlue(),
-                          #            alpha);
-                          #      }
-                          #
-                          #      public static Color toProto(java.awt.Color color) {
-                          #        float red = (float) color.getRed();
-                          #        float green = (float) color.getGreen();
-                          #        float blue = (float) color.getBlue();
-                          #        float denominator = 255.0;
-                          #        Color.Builder resultBuilder =
-                          #            Color
-                          #                .newBuilder()
-                          #                .setRed(red / denominator)
-                          #                .setGreen(green / denominator)
-                          #                .setBlue(blue / denominator);
-                          #        int alpha = color.getAlpha();
-                          #        if (alpha != 255) {
-                          #          result.setAlpha(
-                          #              FloatValue
-                          #                  .newBuilder()
-                          #                  .setValue(((float) alpha) / denominator)
-                          #                  .build());
-                          #        }
-                          #        return resultBuilder.build();
-                          #      }
-                          #      // ...
-                          #
-                          # Example (iOS / Obj-C):
-                          #
-                          #      // ...
-                          #      static UIColor* fromProto(Color* protocolor) {
-                          #         float red = [protocolor red];
-                          #         float green = [protocolor green];
-                          #         float blue = [protocolor blue];
-                          #         FloatValue* alpha_wrapper = [protocolor alpha];
-                          #         float alpha = 1.0;
-                          #         if (alpha_wrapper != nil) {
-                          #           alpha = [alpha_wrapper value];
-                          #         }
-                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                          #      }
-                          #
-                          #      static Color* toProto(UIColor* color) {
-                          #          CGFloat red, green, blue, alpha;
-                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                          #            return nil;
-                          #          }
-                          #          Color* result = [Color alloc] init];
-                          #          [result setRed:red];
-                          #          [result setGreen:green];
-                          #          [result setBlue:blue];
-                          #          if (alpha <= 0.9999) {
-                          #            [result setAlpha:floatWrapperWithValue(alpha)];
-                          #          }
-                          #          [result autorelease];
-                          #          return result;
-                          #     }
-                          #     // ...
-                          #
-                          #  Example (JavaScript):
-                          #
-                          #     // ...
-                          #
-                          #     var protoToCssColor = function(rgb_color) {
-                          #        var redFrac = rgb_color.red || 0.0;
-                          #        var greenFrac = rgb_color.green || 0.0;
-                          #        var blueFrac = rgb_color.blue || 0.0;
-                          #        var red = Math.floor(redFrac * 255);
-                          #        var green = Math.floor(greenFrac * 255);
-                          #        var blue = Math.floor(blueFrac * 255);
-                          #
-                          #        if (!('alpha' in rgb_color)) {
-                          #           return rgbToCssColor_(red, green, blue);
-                          #        }
-                          #
-                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                          #        var rgbParams = [red, green, blue].join(',');
-                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                          #     };
-                          #
-                          #     var rgbToCssColor_ = function(red, green, blue) {
-                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                          #       var hexString = rgbNumber.toString(16);
-                          #       var missingZeros = 6 - hexString.length;
-                          #       var resultBuilder = ['#'];
-                          #       for (var i = 0; i < missingZeros; i++) {
-                          #          resultBuilder.push('0');
-                          #       }
-                          #       resultBuilder.push(hexString);
-                          #       return resultBuilder.join('');
-                          #     };
-                          #
-                          #     // ...
-                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                            # the final pixel color is defined by the equation:
-                            #
-                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                            #
-                            # This means that a value of 1.0 corresponds to a solid color, whereas
-                            # a value of 0.0 corresponds to a completely transparent color. This
-                            # uses a wrapper message rather than a simple float scalar so that it is
-                            # possible to distinguish between a default value and the value being unset.
-                            # If omitted, this color object is to be rendered as a solid color
-                            # (as if the alpha value had been explicitly given with a value of 1.0).
-                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                      },
-                      "bold": True or False, # True if the text is bold.
-                      "strikethrough": True or False, # True if the text has a strikethrough.
-                      "fontFamily": "A String", # The font family.
-                      "fontSize": 42, # The size of the font.
-                      "italic": True or False, # True if the text is italicized.
-                      "underline": True or False, # True if the text is underlined.
-                    },
-                    "title": "A String", # The title of this axis. If set, this overrides any title inferred
-                        # from headers of the data.
-                  },
-                ],
-              },
-              "title": "A String", # The title of the chart.
-            },
-          },
-        },
-        "updateConditionalFormatRule": { # The result of updating a conditional format rule. # A reply from updating a conditional format rule.
-          "oldIndex": 42, # The old index of the rule. Not set if a rule was replaced
-              # (because it is the same as new_index).
-          "newIndex": 42, # The index of the new rule.
-          "oldRule": { # A rule describing a conditional format. # The old (deleted) rule. Not set if a rule was moved
-              # (because it is the same as new_rule).
-            "ranges": [ # The ranges that will be formatted if the condition is true.
-                # All the ranges must be on the same grid.
-              { # A range on a sheet.
-                  # All indexes are zero-based.
-                  # Indexes are half open, e.g the start index is inclusive
-                  # and the end index is exclusive -- [start_index, end_index).
-                  # Missing indexes indicate the range is unbounded on that side.
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                   #
-                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  # Example (Java):
                   #
-                  #   `Sheet1!A1:A1 == sheet_id: 0,
-                  #                   start_row_index: 0, end_row_index: 1,
-                  #                   start_column_index: 0, end_column_index: 1`
+                  #      import com.google.type.Color;
                   #
-                  #   `Sheet1!A3:B4 == sheet_id: 0,
-                  #                   start_row_index: 2, end_row_index: 4,
-                  #                   start_column_index: 0, end_column_index: 2`
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
                   #
-                  #   `Sheet1!A:B == sheet_id: 0,
-                  #                 start_column_index: 0, end_column_index: 2`
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
                   #
-                  #   `Sheet1!A5:B == sheet_id: 0,
-                  #                  start_row_index: 4,
-                  #                  start_column_index: 0, end_column_index: 2`
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
                   #
-                  #   `Sheet1 == sheet_id:0`
+                  # Example (iOS / Obj-C):
                   #
-                  # The start index must always be less than or equal to the end index.
-                  # If the start index equals the end index, then the range is empty.
-                  # Empty ranges are typically not meaningful and are usually rendered in the
-                  # UI as `#REF!`.
-                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                "sheetId": 42, # The sheet this range is on.
-                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-            ],
-            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
-              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
-                  # the format will be applied.
-                  # BooleanConditions are used by conditional formatting,
-                  # data validation, and the criteria in filters.
-                "type": "A String", # The type of condition.
-                "values": [ # The values of the condition. The number of supported values depends
-                    # on the condition type.  Some support zero values,
-                    # others one or two values,
-                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                  { # The value of the condition.
-                    "relativeDate": "A String", # A relative date (based on the current date).
-                        # Valid only if the type is
-                        # DATE_BEFORE,
-                        # DATE_AFTER,
-                        # DATE_ON_OR_BEFORE or
-                        # DATE_ON_OR_AFTER.
-                        #
-                        # Relative dates are not supported in data validation.
-                        # They are supported only in conditional formatting and
-                        # conditional filters.
-                    "userEnteredValue": "A String", # A value the condition is based on.
-                        # The value will be parsed as if the user typed into a cell.
-                        # Formulas are supported (and must begin with an `=`).
-                  },
-                ],
-              },
-              "format": { # The format of a cell. # The format to apply.
-                  # Conditional formatting can only apply a subset of formatting:
-                  # bold, italic,
-                  # strikethrough,
-                  # foreground color &
-                  # background color.
-                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                      # the user's locale will be used if necessary for the given type.
-                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                      # information about the supported patterns.
-                  "type": "A String", # The type of the number format.
-                      # When writing, this field must be set.
-                },
-                "textDirection": "A String", # The direction of the text in the cell.
-                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                    # When updating padding, every field must be specified.
-                  "top": 42, # The top padding of the cell.
-                  "right": 42, # The right padding of the cell.
-                  "bottom": 42, # The bottom padding of the cell.
-                  "left": 42, # The left padding of the cell.
-                },
-                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                    # Absent values indicate that the field isn't specified.
-                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                      # for simplicity of conversion to/from color representations in various
-                      # languages over compactness; for example, the fields of this representation
-                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                      # method in iOS; and, with just a little work, it can be easily formatted into
-                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                      #
-                      # Example (Java):
-                      #
-                      #      import com.google.type.Color;
-                      #
-                      #      // ...
-                      #      public static java.awt.Color fromProto(Color protocolor) {
-                      #        float alpha = protocolor.hasAlpha()
-                      #            ? protocolor.getAlpha().getValue()
-                      #            : 1.0;
-                      #
-                      #        return new java.awt.Color(
-                      #            protocolor.getRed(),
-                      #            protocolor.getGreen(),
-                      #            protocolor.getBlue(),
-                      #            alpha);
-                      #      }
-                      #
-                      #      public static Color toProto(java.awt.Color color) {
-                      #        float red = (float) color.getRed();
-                      #        float green = (float) color.getGreen();
-                      #        float blue = (float) color.getBlue();
-                      #        float denominator = 255.0;
-                      #        Color.Builder resultBuilder =
-                      #            Color
-                      #                .newBuilder()
-                      #                .setRed(red / denominator)
-                      #                .setGreen(green / denominator)
-                      #                .setBlue(blue / denominator);
-                      #        int alpha = color.getAlpha();
-                      #        if (alpha != 255) {
-                      #          result.setAlpha(
-                      #              FloatValue
-                      #                  .newBuilder()
-                      #                  .setValue(((float) alpha) / denominator)
-                      #                  .build());
-                      #        }
-                      #        return resultBuilder.build();
-                      #      }
-                      #      // ...
-                      #
-                      # Example (iOS / Obj-C):
-                      #
-                      #      // ...
-                      #      static UIColor* fromProto(Color* protocolor) {
-                      #         float red = [protocolor red];
-                      #         float green = [protocolor green];
-                      #         float blue = [protocolor blue];
-                      #         FloatValue* alpha_wrapper = [protocolor alpha];
-                      #         float alpha = 1.0;
-                      #         if (alpha_wrapper != nil) {
-                      #           alpha = [alpha_wrapper value];
-                      #         }
-                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                      #      }
-                      #
-                      #      static Color* toProto(UIColor* color) {
-                      #          CGFloat red, green, blue, alpha;
-                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                      #            return nil;
-                      #          }
-                      #          Color* result = [Color alloc] init];
-                      #          [result setRed:red];
-                      #          [result setGreen:green];
-                      #          [result setBlue:blue];
-                      #          if (alpha <= 0.9999) {
-                      #            [result setAlpha:floatWrapperWithValue(alpha)];
-                      #          }
-                      #          [result autorelease];
-                      #          return result;
-                      #     }
-                      #     // ...
-                      #
-                      #  Example (JavaScript):
-                      #
-                      #     // ...
-                      #
-                      #     var protoToCssColor = function(rgb_color) {
-                      #        var redFrac = rgb_color.red || 0.0;
-                      #        var greenFrac = rgb_color.green || 0.0;
-                      #        var blueFrac = rgb_color.blue || 0.0;
-                      #        var red = Math.floor(redFrac * 255);
-                      #        var green = Math.floor(greenFrac * 255);
-                      #        var blue = Math.floor(blueFrac * 255);
-                      #
-                      #        if (!('alpha' in rgb_color)) {
-                      #           return rgbToCssColor_(red, green, blue);
-                      #        }
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+            },
+            "bandedRangeId": 42, # The id of the banded range.
+          },
+        },
+        "autoResizeDimensions": { # Automatically resizes one or more dimensions based on the contents # Automatically resizes one or more dimensions based on the contents
+            # of the cells in that dimension.
+            # of the cells in that dimension.
+          "dimensions": { # A range along a single dimension on a sheet. # The dimensions to automatically resize.
+              # Only COLUMNS are supported.
+              # All indexes are zero-based.
+              # Indexes are half open: the start index is inclusive
+              # and the end index is exclusive.
+              # Missing indexes indicate the range is unbounded on that side.
+            "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded.
+            "startIndex": 42, # The start (inclusive) of the span, or not set if unbounded.
+            "sheetId": 42, # The sheet this span is on.
+            "dimension": "A String", # The dimension of the span.
+          },
+        },
+        "updateDimensionProperties": { # Updates properties of dimensions within the specified range. # Updates dimensions' properties.
+          "fields": "A String", # The fields that should be updated.  At least one field must be specified.
+              # The root `properties` is implied and should not be specified.
+              # A single `"*"` can be used as short-hand for listing every field.
+          "range": { # A range along a single dimension on a sheet. # The rows or columns to update.
+              # All indexes are zero-based.
+              # Indexes are half open: the start index is inclusive
+              # and the end index is exclusive.
+              # Missing indexes indicate the range is unbounded on that side.
+            "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded.
+            "startIndex": 42, # The start (inclusive) of the span, or not set if unbounded.
+            "sheetId": 42, # The sheet this span is on.
+            "dimension": "A String", # The dimension of the span.
+          },
+          "properties": { # Properties about a dimension. # Properties to update.
+            "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
+            "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
+            "hiddenByFilter": True or False, # True if this dimension is being filtered.
+                # This field is read-only.
+          },
+        },
+        "unmergeCells": { # Unmerges cells in the given range. # Unmerges merged cells.
+          "range": { # A range on a sheet. # The range within which all cells should be unmerged.
+              # If the range spans multiple merges, all will be unmerged.
+              # The range must not partially span any merge.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+        },
+        "setDataValidation": { # Sets a data validation rule to every cell in the range. # Sets data validation for one or more cells.
+            # To clear validation in a range, call this with no rule specified.
+          "range": { # A range on a sheet. # The range the data validation rule should apply to.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "rule": { # A data validation rule. # The data validation rule to set on each cell in the range,
+              # or empty to clear the data validation in the range.
+            "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
+                # If true, "List" conditions will show a dropdown.
+            "strict": True or False, # True if invalid data should be rejected.
+            "inputMessage": "A String", # A message to show the user when adding data to the cell.
+            "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
+                # BooleanConditions are used by conditional formatting,
+                # data validation, and the criteria in filters.
+              "type": "A String", # The type of condition.
+              "values": [ # The values of the condition. The number of supported values depends
+                  # on the condition type.  Some support zero values,
+                  # others one or two values,
+                  # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                { # The value of the condition.
+                  "relativeDate": "A String", # A relative date (based on the current date).
+                      # Valid only if the type is
+                      # DATE_BEFORE,
+                      # DATE_AFTER,
+                      # DATE_ON_OR_BEFORE or
+                      # DATE_ON_OR_AFTER.
                       #
-                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                      #        var rgbParams = [red, green, blue].join(',');
-                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                      #     };
+                      # Relative dates are not supported in data validation.
+                      # They are supported only in conditional formatting and
+                      # conditional filters.
+                  "userEnteredValue": "A String", # A value the condition is based on.
+                      # The value will be parsed as if the user typed into a cell.
+                      # Formulas are supported (and must begin with an `=`).
+                },
+              ],
+            },
+          },
+        },
+        "clearBasicFilter": { # Clears the basic filter, if any exists on the sheet. # Clears the basic filter on a sheet.
+          "sheetId": 42, # The sheet ID on which the basic filter should be cleared.
+        },
+        "addNamedRange": { # Adds a named range to the spreadsheet. # Adds a named range.
+          "namedRange": { # A named range. # The named range to add. The namedRangeId
+              # field is optional; if one is not set, an id will be randomly generated. (It
+              # is an error to specify the ID of a range that already exists.)
+            "namedRangeId": "A String", # The ID of the named range.
+            "range": { # A range on a sheet. # The range this represents.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "name": "A String", # The name of the named range.
+          },
+        },
+        "updateChartSpec": { # Updates a chart's specifications. # Updates a chart's specifications.
+            # (This does not move or resize a chart. To move or resize a chart, use
+            #  UpdateEmbeddedObjectPositionRequest.)
+          "chartId": 42, # The ID of the chart to update.
+          "spec": { # The specifications of a chart. # The specification to apply to the chart.
+            "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
+            "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
+              "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
+                "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                  "sources": [ # The ranges of data for a series or domain.
+                      # Exactly one dimension must have a length of 1,
+                      # and all sources in the list must have the same dimension
+                      # with length 1.
+                      # The domain (if it exists) & all series must have the same number
+                      # of source ranges. If using more than one source range, then the source
+                      # range at a given offset must be contiguous across the domain and series.
                       #
-                      #     var rgbToCssColor_ = function(red, green, blue) {
-                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                      #       var hexString = rgbNumber.toString(16);
-                      #       var missingZeros = 6 - hexString.length;
-                      #       var resultBuilder = ['#'];
-                      #       for (var i = 0; i < missingZeros; i++) {
-                      #          resultBuilder.push('0');
-                      #       }
-                      #       resultBuilder.push(hexString);
-                      #       return resultBuilder.join('');
-                      #     };
+                      # For example, these are valid configurations:
                       #
-                      #     // ...
-                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                        # the final pixel color is defined by the equation:
-                        #
-                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                        #
-                        # This means that a value of 1.0 corresponds to a solid color, whereas
-                        # a value of 0.0 corresponds to a completely transparent color. This
-                        # uses a wrapper message rather than a simple float scalar so that it is
-                        # possible to distinguish between a default value and the value being unset.
-                        # If omitted, this color object is to be rendered as a solid color
-                        # (as if the alpha value had been explicitly given with a value of 1.0).
-                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                  },
-                  "bold": True or False, # True if the text is bold.
-                  "strikethrough": True or False, # True if the text has a strikethrough.
-                  "fontFamily": "A String", # The font family.
-                  "fontSize": 42, # The size of the font.
-                  "italic": True or False, # True if the text is italicized.
-                  "underline": True or False, # True if the text is underlined.
-                },
-                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                "borders": { # The borders of the cell. # The borders of the cell.
-                  "top": { # A border along a cell. # The top border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
+                      #     domain sources: A1:A5
+                      #     series1 sources: B1:B5
+                      #     series2 sources: D6:D10
+                      #
+                      #     domain sources: A1:A5, C10:C12
+                      #     series1 sources: B1:B5, D10:D12
+                      #     series2 sources: C1:C5, E10:E12
+                    { # A range on a sheet.
+                        # All indexes are zero-based.
+                        # Indexes are half open, e.g the start index is inclusive
+                        # and the end index is exclusive -- [start_index, end_index).
+                        # Missing indexes indicate the range is unbounded on that side.
                         #
-                        #      import com.google.type.Color;
+                        # For example, if `"Sheet1"` is sheet ID 0, then:
                         #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
+                        #   `Sheet1!A1:A1 == sheet_id: 0,
+                        #                   start_row_index: 0, end_row_index: 1,
+                        #                   start_column_index: 0, end_column_index: 1`
                         #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
+                        #   `Sheet1!A3:B4 == sheet_id: 0,
+                        #                   start_row_index: 2, end_row_index: 4,
+                        #                   start_column_index: 0, end_column_index: 2`
                         #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
+                        #   `Sheet1!A:B == sheet_id: 0,
+                        #                 start_column_index: 0, end_column_index: 2`
                         #
-                        # Example (iOS / Obj-C):
+                        #   `Sheet1!A5:B == sheet_id: 0,
+                        #                  start_row_index: 4,
+                        #                  start_column_index: 0, end_column_index: 2`
                         #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
+                        #   `Sheet1 == sheet_id:0`
                         #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
+                        # The start index must always be less than or equal to the end index.
+                        # If the start index equals the end index, then the range is empty.
+                        # Empty ranges are typically not meaningful and are usually rendered in the
+                        # UI as `#REF!`.
+                      "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                      "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                      "sheetId": 42, # The sheet this range is on.
+                      "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                      "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                    },
+                  ],
+                },
+              },
+              "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
+                "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                  "sources": [ # The ranges of data for a series or domain.
+                      # Exactly one dimension must have a length of 1,
+                      # and all sources in the list must have the same dimension
+                      # with length 1.
+                      # The domain (if it exists) & all series must have the same number
+                      # of source ranges. If using more than one source range, then the source
+                      # range at a given offset must be contiguous across the domain and series.
+                      #
+                      # For example, these are valid configurations:
+                      #
+                      #     domain sources: A1:A5
+                      #     series1 sources: B1:B5
+                      #     series2 sources: D6:D10
+                      #
+                      #     domain sources: A1:A5, C10:C12
+                      #     series1 sources: B1:B5, D10:D12
+                      #     series2 sources: C1:C5, E10:E12
+                    { # A range on a sheet.
+                        # All indexes are zero-based.
+                        # Indexes are half open, e.g the start index is inclusive
+                        # and the end index is exclusive -- [start_index, end_index).
+                        # Missing indexes indicate the range is unbounded on that side.
                         #
-                        #  Example (JavaScript):
+                        # For example, if `"Sheet1"` is sheet ID 0, then:
                         #
-                        #     // ...
+                        #   `Sheet1!A1:A1 == sheet_id: 0,
+                        #                   start_row_index: 0, end_row_index: 1,
+                        #                   start_column_index: 0, end_column_index: 1`
                         #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
+                        #   `Sheet1!A3:B4 == sheet_id: 0,
+                        #                   start_row_index: 2, end_row_index: 4,
+                        #                   start_column_index: 0, end_column_index: 2`
                         #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
+                        #   `Sheet1!A:B == sheet_id: 0,
+                        #                 start_column_index: 0, end_column_index: 2`
                         #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
+                        #   `Sheet1!A5:B == sheet_id: 0,
+                        #                  start_row_index: 4,
+                        #                  start_column_index: 0, end_column_index: 2`
                         #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
+                        #   `Sheet1 == sheet_id:0`
                         #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
+                        # The start index must always be less than or equal to the end index.
+                        # If the start index equals the end index, then the range is empty.
+                        # Empty ranges are typically not meaningful and are usually rendered in the
+                        # UI as `#REF!`.
+                      "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                      "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                      "sheetId": 42, # The sheet this range is on.
+                      "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                      "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                    },
+                  ],
+                },
+              },
+              "threeDimensional": True or False, # True if the pie is three dimensional.
+              "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
+              "pieHole": 3.14, # The size of the hole in the pie chart.
+            },
+            "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
+                # See BasicChartType for the list of all
+                # charts this supports.
+                # of charts this supports.
+              "headerCount": 42, # The number of rows or columns in the data that are "headers".
+                  # If not set, Google Sheets will guess how many rows are headers based
+                  # on the data.
+                  #
+                  # (Note that BasicChartAxis.title may override the axis title
+                  #  inferred from the header values.)
+              "series": [ # The data this chart is visualizing.
+                { # A single series of data in a chart.
+                    # For example, if charting stock prices over time, multiple series may exist,
+                    # one for the "Open Price", "High Price", "Low Price" and "Close Price".
+                  "series": { # The data included in a domain or series. # The data being visualized in this chart series.
+                    "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                      "sources": [ # The ranges of data for a series or domain.
+                          # Exactly one dimension must have a length of 1,
+                          # and all sources in the list must have the same dimension
+                          # with length 1.
+                          # The domain (if it exists) & all series must have the same number
+                          # of source ranges. If using more than one source range, then the source
+                          # range at a given offset must be contiguous across the domain and series.
                           #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          # For example, these are valid configurations:
                           #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "right": { # A border along a cell. # The right border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #     domain sources: A1:A5
+                          #     series1 sources: B1:B5
+                          #     series2 sources: D6:D10
                           #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          #     domain sources: A1:A5, C10:C12
+                          #     series1 sources: B1:B5, D10:D12
+                          #     series2 sources: C1:C5, E10:E12
+                        { # A range on a sheet.
+                            # All indexes are zero-based.
+                            # Indexes are half open, e.g the start index is inclusive
+                            # and the end index is exclusive -- [start_index, end_index).
+                            # Missing indexes indicate the range is unbounded on that side.
+                            #
+                            # For example, if `"Sheet1"` is sheet ID 0, then:
+                            #
+                            #   `Sheet1!A1:A1 == sheet_id: 0,
+                            #                   start_row_index: 0, end_row_index: 1,
+                            #                   start_column_index: 0, end_column_index: 1`
+                            #
+                            #   `Sheet1!A3:B4 == sheet_id: 0,
+                            #                   start_row_index: 2, end_row_index: 4,
+                            #                   start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1!A:B == sheet_id: 0,
+                            #                 start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1!A5:B == sheet_id: 0,
+                            #                  start_row_index: 4,
+                            #                  start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1 == sheet_id:0`
+                            #
+                            # The start index must always be less than or equal to the end index.
+                            # If the start index equals the end index, then the range is empty.
+                            # Empty ranges are typically not meaningful and are usually rendered in the
+                            # UI as `#REF!`.
+                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                          "sheetId": 42, # The sheet this range is on.
+                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                        },
+                      ],
                     },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
                   },
-                  "bottom": { # A border along a cell. # The bottom border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
+                  "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
+                      # For example, if charting stocks over time, the "Volume" series
+                      # may want to be pinned to the right with the prices pinned to the left,
+                      # because the scale of trading volume is different than the scale of
+                      # prices.
+                      # It is an error to specify an axis that isn't a valid minor axis
+                      # for the chart's type.
+                  "type": "A String", # The type of this series. Valid only if the
+                      # chartType is
+                      # COMBO.
+                      # Different types will change the way the series is visualized.
+                      # Only LINE, AREA,
+                      # and COLUMN are supported.
+                },
+              ],
+              "legendPosition": "A String", # The position of the chart legend.
+              "domains": [ # The domain of data this is charting.
+                  # Only a single domain is currently supported.
+                { # The domain of a chart.
+                    # For example, if charting stock prices over time, this would be the date.
+                  "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
+                      # this is the data representing the dates.
+                    "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                      "sources": [ # The ranges of data for a series or domain.
+                          # Exactly one dimension must have a length of 1,
+                          # and all sources in the list must have the same dimension
+                          # with length 1.
+                          # The domain (if it exists) & all series must have the same number
+                          # of source ranges. If using more than one source range, then the source
+                          # range at a given offset must be contiguous across the domain and series.
                           #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          # For example, these are valid configurations:
                           #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          #     domain sources: A1:A5
+                          #     series1 sources: B1:B5
+                          #     series2 sources: D6:D10
+                          #
+                          #     domain sources: A1:A5, C10:C12
+                          #     series1 sources: B1:B5, D10:D12
+                          #     series2 sources: C1:C5, E10:E12
+                        { # A range on a sheet.
+                            # All indexes are zero-based.
+                            # Indexes are half open, e.g the start index is inclusive
+                            # and the end index is exclusive -- [start_index, end_index).
+                            # Missing indexes indicate the range is unbounded on that side.
+                            #
+                            # For example, if `"Sheet1"` is sheet ID 0, then:
+                            #
+                            #   `Sheet1!A1:A1 == sheet_id: 0,
+                            #                   start_row_index: 0, end_row_index: 1,
+                            #                   start_column_index: 0, end_column_index: 1`
+                            #
+                            #   `Sheet1!A3:B4 == sheet_id: 0,
+                            #                   start_row_index: 2, end_row_index: 4,
+                            #                   start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1!A:B == sheet_id: 0,
+                            #                 start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1!A5:B == sheet_id: 0,
+                            #                  start_row_index: 4,
+                            #                  start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1 == sheet_id:0`
+                            #
+                            # The start index must always be less than or equal to the end index.
+                            # If the start index equals the end index, then the range is empty.
+                            # Empty ranges are typically not meaningful and are usually rendered in the
+                            # UI as `#REF!`.
+                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                          "sheetId": 42, # The sheet this range is on.
+                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                        },
+                      ],
                     },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
                   },
-                  "left": { # A border along a cell. # The left border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                },
+              ],
+              "chartType": "A String", # The type of the chart.
+              "axis": [ # The axis on the chart.
+                { # An axis of the chart.
+                    # A chart may not have more than one axis per
+                    # axis position.
+                  "position": "A String", # The position of this axis.
+                  "format": { # The format of a run of text in a cell. # The format of the title.
+                      # Only valid if the axis is not associated with the domain.
+                      # Absent values indicate that the field isn't specified.
+                    "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
                         # for simplicity of conversion to/from color representations in various
                         # languages over compactness; for example, the fields of this representation
                         # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -15004,1770 +12988,1361 @@ <h3>Method Details</h3>
                       "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                       "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                     },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
+                    "bold": True or False, # True if the text is bold.
+                    "strikethrough": True or False, # True if the text has a strikethrough.
+                    "fontFamily": "A String", # The font family.
+                    "fontSize": 42, # The size of the font.
+                    "italic": True or False, # True if the text is italicized.
+                    "underline": True or False, # True if the text is underlined.
                   },
+                  "title": "A String", # The title of this axis. If set, this overrides any title inferred
+                      # from headers of the data.
                 },
-                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-              },
-            },
-            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
-                # the interpolation points listed. The format of a cell will vary
-                # based on its contents as compared to the values of the interpolation
-                # points.
-              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
+              ],
             },
+            "title": "A String", # The title of the chart.
           },
-          "newRule": { # A rule describing a conditional format. # The new rule that replaced the old rule (if replacing),
-              # or the rule that was moved (if moved)
-            "ranges": [ # The ranges that will be formatted if the condition is true.
-                # All the ranges must be on the same grid.
-              { # A range on a sheet.
-                  # All indexes are zero-based.
-                  # Indexes are half open, e.g the start index is inclusive
-                  # and the end index is exclusive -- [start_index, end_index).
-                  # Missing indexes indicate the range is unbounded on that side.
+        },
+        "moveDimension": { # Moves one or more rows or columns. # Moves rows or columns to another location in a sheet.
+          "source": { # A range along a single dimension on a sheet. # The source dimensions to move.
+              # All indexes are zero-based.
+              # Indexes are half open: the start index is inclusive
+              # and the end index is exclusive.
+              # Missing indexes indicate the range is unbounded on that side.
+            "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded.
+            "startIndex": 42, # The start (inclusive) of the span, or not set if unbounded.
+            "sheetId": 42, # The sheet this span is on.
+            "dimension": "A String", # The dimension of the span.
+          },
+          "destinationIndex": 42, # The zero-based start index of where to move the source data to,
+              # based on the coordinates *before* the source data is removed
+              # from the grid.  Existing data will be shifted down or right
+              # (depending on the dimension) to make room for the moved dimensions.
+              # The source dimensions are removed from the grid, so the
+              # the data may end up in a different index than specified.
+              #
+              # For example, given `A1..A5` of `0, 1, 2, 3, 4` and wanting to move
+              # `"1"` and `"2"` to between `"3"` and `"4"`, the source would be
+              # `ROWS [1..3)`,and the destination index would be `"4"`
+              # (the zero-based index of row 5).
+              # The end result would be `A1..A5` of `0, 3, 1, 2, 4`.
+        },
+        "textToColumns": { # Splits a column of text into multiple columns, # Converts a column of text into many columns of text.
+            # based on a delimiter in each cell.
+          "source": { # A range on a sheet. # The source data range.  This must span exactly one column.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "delimiter": "A String", # The delimiter to use. Used only if delimiterType is
+              # CUSTOM.
+          "delimiterType": "A String", # The delimiter type to use.
+        },
+        "addBanding": { # Adds a new banded range to the spreadsheet. # Adds a new banded range
+          "bandedRange": { # A banded (alternating colors) range in a sheet. # The banded range to add. The bandedRangeId
+              # field is optional; if one is not set, an id will be randomly generated. (It
+              # is an error to specify the ID of a range that already exists.)
+            "range": { # A range on a sheet. # The range over which these properties are applied.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "columnProperties": { # Properties referring a single dimension (either row or column). If both # Properties for column bands. These properties will be applied on a column-
+                # by-column basis throughout all the columns in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                   #
-                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  # Example (Java):
                   #
-                  #   `Sheet1!A1:A1 == sheet_id: 0,
-                  #                   start_row_index: 0, end_row_index: 1,
-                  #                   start_column_index: 0, end_column_index: 1`
+                  #      import com.google.type.Color;
                   #
-                  #   `Sheet1!A3:B4 == sheet_id: 0,
-                  #                   start_row_index: 2, end_row_index: 4,
-                  #                   start_column_index: 0, end_column_index: 2`
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
                   #
-                  #   `Sheet1!A:B == sheet_id: 0,
-                  #                 start_column_index: 0, end_column_index: 2`
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
                   #
-                  #   `Sheet1!A5:B == sheet_id: 0,
-                  #                  start_row_index: 4,
-                  #                  start_column_index: 0, end_column_index: 2`
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
                   #
-                  #   `Sheet1 == sheet_id:0`
+                  # Example (iOS / Obj-C):
                   #
-                  # The start index must always be less than or equal to the end index.
-                  # If the start index equals the end index, then the range is empty.
-                  # Empty ranges are typically not meaningful and are usually rendered in the
-                  # UI as `#REF!`.
-                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                "sheetId": 42, # The sheet this range is on.
-                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-              },
-            ],
-            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
-              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
-                  # the format will be applied.
-                  # BooleanConditions are used by conditional formatting,
-                  # data validation, and the criteria in filters.
-                "type": "A String", # The type of condition.
-                "values": [ # The values of the condition. The number of supported values depends
-                    # on the condition type.  Some support zero values,
-                    # others one or two values,
-                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                  { # The value of the condition.
-                    "relativeDate": "A String", # A relative date (based on the current date).
-                        # Valid only if the type is
-                        # DATE_BEFORE,
-                        # DATE_AFTER,
-                        # DATE_ON_OR_BEFORE or
-                        # DATE_ON_OR_AFTER.
-                        #
-                        # Relative dates are not supported in data validation.
-                        # They are supported only in conditional formatting and
-                        # conditional filters.
-                    "userEnteredValue": "A String", # A value the condition is based on.
-                        # The value will be parsed as if the user typed into a cell.
-                        # Formulas are supported (and must begin with an `=`).
-                  },
-                ],
-              },
-              "format": { # The format of a cell. # The format to apply.
-                  # Conditional formatting can only apply a subset of formatting:
-                  # bold, italic,
-                  # strikethrough,
-                  # foreground color &
-                  # background color.
-                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                      # the user's locale will be used if necessary for the given type.
-                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                      # information about the supported patterns.
-                  "type": "A String", # The type of the number format.
-                      # When writing, this field must be set.
-                },
-                "textDirection": "A String", # The direction of the text in the cell.
-                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                    # When updating padding, every field must be specified.
-                  "top": 42, # The top padding of the cell.
-                  "right": 42, # The right padding of the cell.
-                  "bottom": 42, # The bottom padding of the cell.
-                  "left": 42, # The left padding of the cell.
-                },
-                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    # Example (Java):
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    #      import com.google.type.Color;
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    # Example (iOS / Obj-C):
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+            },
+            "rowProperties": { # Properties referring a single dimension (either row or column). If both # Properties for row bands. These properties will be applied on a row-by-row
+                # basis throughout all the rows in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #     // ...
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                    # Absent values indicate that the field isn't specified.
-                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                      # for simplicity of conversion to/from color representations in various
-                      # languages over compactness; for example, the fields of this representation
-                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                      # method in iOS; and, with just a little work, it can be easily formatted into
-                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                      #
-                      # Example (Java):
-                      #
-                      #      import com.google.type.Color;
-                      #
-                      #      // ...
-                      #      public static java.awt.Color fromProto(Color protocolor) {
-                      #        float alpha = protocolor.hasAlpha()
-                      #            ? protocolor.getAlpha().getValue()
-                      #            : 1.0;
-                      #
-                      #        return new java.awt.Color(
-                      #            protocolor.getRed(),
-                      #            protocolor.getGreen(),
-                      #            protocolor.getBlue(),
-                      #            alpha);
-                      #      }
-                      #
-                      #      public static Color toProto(java.awt.Color color) {
-                      #        float red = (float) color.getRed();
-                      #        float green = (float) color.getGreen();
-                      #        float blue = (float) color.getBlue();
-                      #        float denominator = 255.0;
-                      #        Color.Builder resultBuilder =
-                      #            Color
-                      #                .newBuilder()
-                      #                .setRed(red / denominator)
-                      #                .setGreen(green / denominator)
-                      #                .setBlue(blue / denominator);
-                      #        int alpha = color.getAlpha();
-                      #        if (alpha != 255) {
-                      #          result.setAlpha(
-                      #              FloatValue
-                      #                  .newBuilder()
-                      #                  .setValue(((float) alpha) / denominator)
-                      #                  .build());
-                      #        }
-                      #        return resultBuilder.build();
-                      #      }
-                      #      // ...
-                      #
-                      # Example (iOS / Obj-C):
-                      #
-                      #      // ...
-                      #      static UIColor* fromProto(Color* protocolor) {
-                      #         float red = [protocolor red];
-                      #         float green = [protocolor green];
-                      #         float blue = [protocolor blue];
-                      #         FloatValue* alpha_wrapper = [protocolor alpha];
-                      #         float alpha = 1.0;
-                      #         if (alpha_wrapper != nil) {
-                      #           alpha = [alpha_wrapper value];
-                      #         }
-                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                      #      }
-                      #
-                      #      static Color* toProto(UIColor* color) {
-                      #          CGFloat red, green, blue, alpha;
-                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                      #            return nil;
-                      #          }
-                      #          Color* result = [Color alloc] init];
-                      #          [result setRed:red];
-                      #          [result setGreen:green];
-                      #          [result setBlue:blue];
-                      #          if (alpha <= 0.9999) {
-                      #            [result setAlpha:floatWrapperWithValue(alpha)];
-                      #          }
-                      #          [result autorelease];
-                      #          return result;
-                      #     }
-                      #     // ...
-                      #
-                      #  Example (JavaScript):
-                      #
-                      #     // ...
-                      #
-                      #     var protoToCssColor = function(rgb_color) {
-                      #        var redFrac = rgb_color.red || 0.0;
-                      #        var greenFrac = rgb_color.green || 0.0;
-                      #        var blueFrac = rgb_color.blue || 0.0;
-                      #        var red = Math.floor(redFrac * 255);
-                      #        var green = Math.floor(greenFrac * 255);
-                      #        var blue = Math.floor(blueFrac * 255);
-                      #
-                      #        if (!('alpha' in rgb_color)) {
-                      #           return rgbToCssColor_(red, green, blue);
-                      #        }
-                      #
-                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                      #        var rgbParams = [red, green, blue].join(',');
-                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                      #     };
-                      #
-                      #     var rgbToCssColor_ = function(red, green, blue) {
-                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                      #       var hexString = rgbNumber.toString(16);
-                      #       var missingZeros = 6 - hexString.length;
-                      #       var resultBuilder = ['#'];
-                      #       for (var i = 0; i < missingZeros; i++) {
-                      #          resultBuilder.push('0');
-                      #       }
-                      #       resultBuilder.push(hexString);
-                      #       return resultBuilder.join('');
-                      #     };
-                      #
-                      #     // ...
-                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                        # the final pixel color is defined by the equation:
-                        #
-                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                        #
-                        # This means that a value of 1.0 corresponds to a solid color, whereas
-                        # a value of 0.0 corresponds to a completely transparent color. This
-                        # uses a wrapper message rather than a simple float scalar so that it is
-                        # possible to distinguish between a default value and the value being unset.
-                        # If omitted, this color object is to be rendered as a solid color
-                        # (as if the alpha value had been explicitly given with a value of 1.0).
-                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                  },
-                  "bold": True or False, # True if the text is bold.
-                  "strikethrough": True or False, # True if the text has a strikethrough.
-                  "fontFamily": "A String", # The font family.
-                  "fontSize": 42, # The size of the font.
-                  "italic": True or False, # True if the text is italicized.
-                  "underline": True or False, # True if the text is underlined.
-                },
-                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                "borders": { # The borders of the cell. # The borders of the cell.
-                  "top": { # A border along a cell. # The top border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+            },
+            "bandedRangeId": 42, # The id of the banded range.
+          },
+        },
+        "deleteFilterView": { # Deletes a particular filter view. # Deletes a filter view from a sheet.
+          "filterId": 42, # The ID of the filter to delete.
+        },
+        "mergeCells": { # Merges all cells in the range. # Merges cells together.
+          "range": { # A range on a sheet. # The range of cells to merge.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "mergeType": "A String", # How the cells should be merged.
+        },
+        "deleteProtectedRange": { # Deletes the protected range with the given ID. # Deletes a protected range.
+          "protectedRangeId": 42, # The ID of the protected range to delete.
+        },
+        "addFilterView": { # Adds a filter view. # Adds a filter view.
+          "filter": { # A filter view. # The filter to add. The filterViewId
+              # field is optional; if one is not set, an id will be randomly generated. (It
+              # is an error to specify the ID of a filter that already exists.)
+            "title": "A String", # The name of the filter view.
+            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "filterViewId": 42, # The ID of the filter view.
+            "range": { # A range on a sheet. # The range this filter view covers.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "sortSpecs": [ # The sort order per column. Later specifications are used when values
+                # are equal in the earlier specifications.
+              { # A sort order associated with a specific column or row.
+                "sortOrder": "A String", # The order data should be sorted.
+                "dimensionIndex": 42, # The dimension the sort should be applied to.
+              },
+            ],
+            "criteria": { # The criteria for showing/hiding values per column.
+                # The map's key is the column index, and the value is the criteria for
+                # that column.
+              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+                "hiddenValues": [ # Values that should be hidden.
+                  "A String",
+                ],
+                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                    # (This does not override hiddenValues -- if a value is listed there,
+                    #  it will still be hidden.)
+                    # BooleanConditions are used by conditional formatting,
+                    # data validation, and the criteria in filters.
+                  "type": "A String", # The type of condition.
+                  "values": [ # The values of the condition. The number of supported values depends
+                      # on the condition type.  Some support zero values,
+                      # others one or two values,
+                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                    { # The value of the condition.
+                      "relativeDate": "A String", # A relative date (based on the current date).
+                          # Valid only if the type is
+                          # DATE_BEFORE,
+                          # DATE_AFTER,
+                          # DATE_ON_OR_BEFORE or
+                          # DATE_ON_OR_AFTER.
                           #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          # Relative dates are not supported in data validation.
+                          # They are supported only in conditional formatting and
+                          # conditional filters.
+                      "userEnteredValue": "A String", # A value the condition is based on.
+                          # The value will be parsed as if the user typed into a cell.
+                          # Formulas are supported (and must begin with an `=`).
                     },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "right": { # A border along a cell. # The right border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "bottom": { # A border along a cell. # The bottom border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "left": { # A border along a cell. # The left border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
+                  ],
                 },
-                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-              },
-            },
-            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
-                # the interpolation points listed. The format of a cell will vary
-                # based on its contents as compared to the values of the interpolation
-                # points.
-              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
               },
             },
           },
         },
-        "addSheet": { # The result of adding a sheet. # A reply from adding a sheet.
-          "properties": { # Properties of a sheet. # The properties of the newly added sheet.
-            "sheetType": "A String", # The type of sheet. Defaults to GRID.
-                # This field cannot be changed once set.
-            "index": 42, # The index of the sheet within the spreadsheet.
-                # When adding or updating sheet properties, if this field
-                # is excluded then the sheet will be added or moved to the end
-                # of the sheet list.
-            "title": "A String", # The name of the sheet.
-            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
-                # (If the sheet is an object sheet, containing a chart or image, then
-                # this field will be absent.)
-                # When writing it is an error to set any grid properties on non-grid sheets.
-              "columnCount": 42, # The number of columns in the grid.
-              "rowCount": 42, # The number of rows in the grid.
-              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
-              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
-              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
-            },
-            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
-            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
+        "deleteSheet": { # Deletes the requested sheet. # Deletes a sheet.
+          "sheetId": 42, # The ID of the sheet to delete.
+        },
+        "updateBorders": { # Updates the borders of a range. # Updates the borders in a range of cells.
+            # If a field is not set in the request, that means the border remains as-is.
+            # For example, with two subsequent UpdateBordersRequest:
+            #
+            #  1. range: A1:A5 `{ top: RED, bottom: WHITE }`
+            #  2. range: A1:A5 `{ left: BLUE }`
+            #
+            # That would result in A1:A5 having a borders of
+            # `{ top: RED, bottom: WHITE, left: BLUE }`.
+            # If you want to clear a border, explicitly set the style to
+            # NONE.
+          "right": { # A border along a cell. # The border to put at the right of the range.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
                 # for simplicity of conversion to/from color representations in various
                 # languages over compactness; for example, the fields of this representation
                 # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -16896,6873 +14471,1178 @@ <h3>Method Details</h3>
               "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
               "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
             },
-            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
-            "sheetId": 42, # The ID of the sheet. Must be non-negative.
-                # This field cannot be changed once set.
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
           },
-        },
-        "findReplace": { # The result of the find/replace. # A reply from doing a find/replace.
-          "occurrencesChanged": 42, # The number of occurrences (possibly multiple within a cell) changed.
-              # For example, if replacing `"e"` with `"o"` in `"Google Sheets"`, this would
-              # be `"3"` because `"Google Sheets"` -> `"Googlo Shoots"`.
-          "sheetsChanged": 42, # The number of sheets changed.
-          "rowsChanged": 42, # The number of rows changed.
-          "valuesChanged": 42, # The number of non-formula cells changed.
-          "formulasChanged": 42, # The number of formula cells changed.
-        },
-        "addNamedRange": { # The result of adding a named range. # A reply from adding a named range.
-          "namedRange": { # A named range. # The named range to add.
-            "namedRangeId": "A String", # The ID of the named range.
-            "range": { # A range on a sheet. # The range this represents.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
+          "bottom": { # A border along a cell. # The border to put at the bottom of the range.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                 #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
+                # Example (Java):
                 #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
+                #      import com.google.type.Color;
                 #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
                 #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
                 #
-                #   `Sheet1 == sheet_id:0`
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
                 #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-            "name": "A String", # The name of the named range.
-          },
-        },
-        "addProtectedRange": { # The result of adding a new protected range. # A reply from adding a protected range.
-          "protectedRange": { # A protected range. # The newly added protected range.
-            "unprotectedRanges": [ # The list of unprotected ranges within a protected sheet.
-                # Unprotected ranges are only supported on protected sheets.
-              { # A range on a sheet.
-                  # All indexes are zero-based.
-                  # Indexes are half open, e.g the start index is inclusive
-                  # and the end index is exclusive -- [start_index, end_index).
-                  # Missing indexes indicate the range is unbounded on that side.
-                  #
-                  # For example, if `"Sheet1"` is sheet ID 0, then:
-                  #
-                  #   `Sheet1!A1:A1 == sheet_id: 0,
-                  #                   start_row_index: 0, end_row_index: 1,
-                  #                   start_column_index: 0, end_column_index: 1`
-                  #
-                  #   `Sheet1!A3:B4 == sheet_id: 0,
-                  #                   start_row_index: 2, end_row_index: 4,
-                  #                   start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1!A:B == sheet_id: 0,
-                  #                 start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1!A5:B == sheet_id: 0,
-                  #                  start_row_index: 4,
-                  #                  start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1 == sheet_id:0`
-                  #
-                  # The start index must always be less than or equal to the end index.
-                  # If the start index equals the end index, then the range is empty.
-                  # Empty ranges are typically not meaningful and are usually rendered in the
-                  # UI as `#REF!`.
-                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                "sheetId": 42, # The sheet this range is on.
-                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-              },
-            ],
-            "requestingUserCanEdit": True or False, # True if the user who requested this protected range can edit the
-                # protected area.
-                # This field is read-only.
-            "description": "A String", # The description of this protected range.
-            "namedRangeId": "A String", # The named range this protected range is backed by, if any.
+                # Example (iOS / Obj-C):
                 #
-                # When writing, only one of range or named_range_id
-                # may be set.
-            "editors": { # The editors of a protected range. # The users and groups with edit access to the protected range.
-                # This field is only visible to users with edit access to the protected
-                # range and the document.
-                # Editors are not supported with warning_only protection.
-              "domainUsersCanEdit": True or False, # True if anyone in the document's domain has edit access to the protected
-                  # range.  Domain protection is only supported on documents within a domain.
-              "users": [ # The email addresses of users with edit access to the protected range.
-                "A String",
-              ],
-              "groups": [ # The email addresses of groups with edit access to the protected range.
-                "A String",
-              ],
-            },
-            "protectedRangeId": 42, # The ID of the protected range.
-                # This field is read-only.
-            "warningOnly": True or False, # True if this protected range will show a warning when editing.
-                # Warning-based protection means that every user can edit data in the
-                # protected range, except editing will prompt a warning asking the user
-                # to confirm the edit.
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
                 #
-                # When writing: if this field is true, then editors is ignored.
-                # Additionally, if this field is changed from true to false and the
-                # `editors` field is not set (nor included in the field mask), then
-                # the editors will be set to all the editors in the document.
-            "range": { # A range on a sheet. # The range that is being protected.
-                # The range may be fully unbounded, in which case this is considered
-                # a protected sheet.
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
                 #
-                # When writing, only one of range or named_range_id
-                # may be set.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
+                #  Example (JavaScript):
                 #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #     // ...
                 #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
                 #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
                 #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
                 #
-                #   `Sheet1 == sheet_id:0`
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
                 #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
             },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
           },
-        },
-        "deleteConditionalFormatRule": { # The result of deleting a conditional format rule. # A reply from deleting a conditional format rule.
-          "rule": { # A rule describing a conditional format. # The rule that was deleted.
-            "ranges": [ # The ranges that will be formatted if the condition is true.
-                # All the ranges must be on the same grid.
-              { # A range on a sheet.
-                  # All indexes are zero-based.
-                  # Indexes are half open, e.g the start index is inclusive
-                  # and the end index is exclusive -- [start_index, end_index).
-                  # Missing indexes indicate the range is unbounded on that side.
-                  #
-                  # For example, if `"Sheet1"` is sheet ID 0, then:
+          "top": { # A border along a cell. # The border to put at the top of the range.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
                   #
-                  #   `Sheet1!A1:A1 == sheet_id: 0,
-                  #                   start_row_index: 0, end_row_index: 1,
-                  #                   start_column_index: 0, end_column_index: 1`
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                   #
-                  #   `Sheet1!A3:B4 == sheet_id: 0,
-                  #                   start_row_index: 2, end_row_index: 4,
-                  #                   start_column_index: 0, end_column_index: 2`
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+          "innerHorizontal": { # A border along a cell. # The horizontal border to put within the range.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
                   #
-                  #   `Sheet1!A:B == sheet_id: 0,
-                  #                 start_column_index: 0, end_column_index: 2`
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                   #
-                  #   `Sheet1!A5:B == sheet_id: 0,
-                  #                  start_row_index: 4,
-                  #                  start_column_index: 0, end_column_index: 2`
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+          "range": { # A range on a sheet. # The range whose borders should be updated.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "innerVertical": { # A border along a cell. # The vertical border to put within the range.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
                   #
-                  #   `Sheet1 == sheet_id:0`
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                   #
-                  # The start index must always be less than or equal to the end index.
-                  # If the start index equals the end index, then the range is empty.
-                  # Empty ranges are typically not meaningful and are usually rendered in the
-                  # UI as `#REF!`.
-                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                "sheetId": 42, # The sheet this range is on.
-                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-              },
-            ],
-            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
-              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
-                  # the format will be applied.
-                  # BooleanConditions are used by conditional formatting,
-                  # data validation, and the criteria in filters.
-                "type": "A String", # The type of condition.
-                "values": [ # The values of the condition. The number of supported values depends
-                    # on the condition type.  Some support zero values,
-                    # others one or two values,
-                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                  { # The value of the condition.
-                    "relativeDate": "A String", # A relative date (based on the current date).
-                        # Valid only if the type is
-                        # DATE_BEFORE,
-                        # DATE_AFTER,
-                        # DATE_ON_OR_BEFORE or
-                        # DATE_ON_OR_AFTER.
-                        #
-                        # Relative dates are not supported in data validation.
-                        # They are supported only in conditional formatting and
-                        # conditional filters.
-                    "userEnteredValue": "A String", # A value the condition is based on.
-                        # The value will be parsed as if the user typed into a cell.
-                        # Formulas are supported (and must begin with an `=`).
-                  },
-                ],
-              },
-              "format": { # The format of a cell. # The format to apply.
-                  # Conditional formatting can only apply a subset of formatting:
-                  # bold, italic,
-                  # strikethrough,
-                  # foreground color &
-                  # background color.
-                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                      # the user's locale will be used if necessary for the given type.
-                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                      # information about the supported patterns.
-                  "type": "A String", # The type of the number format.
-                      # When writing, this field must be set.
-                },
-                "textDirection": "A String", # The direction of the text in the cell.
-                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                    # When updating padding, every field must be specified.
-                  "top": 42, # The top padding of the cell.
-                  "right": 42, # The right padding of the cell.
-                  "bottom": 42, # The bottom padding of the cell.
-                  "left": 42, # The left padding of the cell.
-                },
-                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                    # Absent values indicate that the field isn't specified.
-                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                      # for simplicity of conversion to/from color representations in various
-                      # languages over compactness; for example, the fields of this representation
-                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                      # method in iOS; and, with just a little work, it can be easily formatted into
-                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                      #
-                      # Example (Java):
-                      #
-                      #      import com.google.type.Color;
-                      #
-                      #      // ...
-                      #      public static java.awt.Color fromProto(Color protocolor) {
-                      #        float alpha = protocolor.hasAlpha()
-                      #            ? protocolor.getAlpha().getValue()
-                      #            : 1.0;
-                      #
-                      #        return new java.awt.Color(
-                      #            protocolor.getRed(),
-                      #            protocolor.getGreen(),
-                      #            protocolor.getBlue(),
-                      #            alpha);
-                      #      }
-                      #
-                      #      public static Color toProto(java.awt.Color color) {
-                      #        float red = (float) color.getRed();
-                      #        float green = (float) color.getGreen();
-                      #        float blue = (float) color.getBlue();
-                      #        float denominator = 255.0;
-                      #        Color.Builder resultBuilder =
-                      #            Color
-                      #                .newBuilder()
-                      #                .setRed(red / denominator)
-                      #                .setGreen(green / denominator)
-                      #                .setBlue(blue / denominator);
-                      #        int alpha = color.getAlpha();
-                      #        if (alpha != 255) {
-                      #          result.setAlpha(
-                      #              FloatValue
-                      #                  .newBuilder()
-                      #                  .setValue(((float) alpha) / denominator)
-                      #                  .build());
-                      #        }
-                      #        return resultBuilder.build();
-                      #      }
-                      #      // ...
-                      #
-                      # Example (iOS / Obj-C):
-                      #
-                      #      // ...
-                      #      static UIColor* fromProto(Color* protocolor) {
-                      #         float red = [protocolor red];
-                      #         float green = [protocolor green];
-                      #         float blue = [protocolor blue];
-                      #         FloatValue* alpha_wrapper = [protocolor alpha];
-                      #         float alpha = 1.0;
-                      #         if (alpha_wrapper != nil) {
-                      #           alpha = [alpha_wrapper value];
-                      #         }
-                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                      #      }
-                      #
-                      #      static Color* toProto(UIColor* color) {
-                      #          CGFloat red, green, blue, alpha;
-                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                      #            return nil;
-                      #          }
-                      #          Color* result = [Color alloc] init];
-                      #          [result setRed:red];
-                      #          [result setGreen:green];
-                      #          [result setBlue:blue];
-                      #          if (alpha <= 0.9999) {
-                      #            [result setAlpha:floatWrapperWithValue(alpha)];
-                      #          }
-                      #          [result autorelease];
-                      #          return result;
-                      #     }
-                      #     // ...
-                      #
-                      #  Example (JavaScript):
-                      #
-                      #     // ...
-                      #
-                      #     var protoToCssColor = function(rgb_color) {
-                      #        var redFrac = rgb_color.red || 0.0;
-                      #        var greenFrac = rgb_color.green || 0.0;
-                      #        var blueFrac = rgb_color.blue || 0.0;
-                      #        var red = Math.floor(redFrac * 255);
-                      #        var green = Math.floor(greenFrac * 255);
-                      #        var blue = Math.floor(blueFrac * 255);
-                      #
-                      #        if (!('alpha' in rgb_color)) {
-                      #           return rgbToCssColor_(red, green, blue);
-                      #        }
-                      #
-                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                      #        var rgbParams = [red, green, blue].join(',');
-                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                      #     };
-                      #
-                      #     var rgbToCssColor_ = function(red, green, blue) {
-                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                      #       var hexString = rgbNumber.toString(16);
-                      #       var missingZeros = 6 - hexString.length;
-                      #       var resultBuilder = ['#'];
-                      #       for (var i = 0; i < missingZeros; i++) {
-                      #          resultBuilder.push('0');
-                      #       }
-                      #       resultBuilder.push(hexString);
-                      #       return resultBuilder.join('');
-                      #     };
-                      #
-                      #     // ...
-                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                        # the final pixel color is defined by the equation:
-                        #
-                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                        #
-                        # This means that a value of 1.0 corresponds to a solid color, whereas
-                        # a value of 0.0 corresponds to a completely transparent color. This
-                        # uses a wrapper message rather than a simple float scalar so that it is
-                        # possible to distinguish between a default value and the value being unset.
-                        # If omitted, this color object is to be rendered as a solid color
-                        # (as if the alpha value had been explicitly given with a value of 1.0).
-                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                  },
-                  "bold": True or False, # True if the text is bold.
-                  "strikethrough": True or False, # True if the text has a strikethrough.
-                  "fontFamily": "A String", # The font family.
-                  "fontSize": 42, # The size of the font.
-                  "italic": True or False, # True if the text is italicized.
-                  "underline": True or False, # True if the text is underlined.
-                },
-                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                "borders": { # The borders of the cell. # The borders of the cell.
-                  "top": { # A border along a cell. # The top border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "right": { # A border along a cell. # The right border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "bottom": { # A border along a cell. # The bottom border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "left": { # A border along a cell. # The left border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                },
-                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-              },
-            },
-            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
-                # the interpolation points listed. The format of a cell will vary
-                # based on its contents as compared to the values of the interpolation
-                # points.
-              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-            },
-          },
-        },
-        "addFilterView": { # The result of adding a filter view. # A reply from adding a filter view.
-          "filter": { # A filter view. # The newly added filter view.
-            "title": "A String", # The name of the filter view.
-            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-            "filterViewId": 42, # The ID of the filter view.
-            "range": { # A range on a sheet. # The range this filter view covers.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-            "sortSpecs": [ # The sort order per column. Later specifications are used when values
-                # are equal in the earlier specifications.
-              { # A sort order associated with a specific column or row.
-                "sortOrder": "A String", # The order data should be sorted.
-                "dimensionIndex": 42, # The dimension the sort should be applied to.
-              },
-            ],
-            "criteria": { # The criteria for showing/hiding values per column.
-                # The map's key is the column index, and the value is the criteria for
-                # that column.
-              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
-                "hiddenValues": [ # Values that should be hidden.
-                  "A String",
-                ],
-                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
-                    # (This does not override hiddenValues -- if a value is listed there,
-                    #  it will still be hidden.)
-                    # BooleanConditions are used by conditional formatting,
-                    # data validation, and the criteria in filters.
-                  "type": "A String", # The type of condition.
-                  "values": [ # The values of the condition. The number of supported values depends
-                      # on the condition type.  Some support zero values,
-                      # others one or two values,
-                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                    { # The value of the condition.
-                      "relativeDate": "A String", # A relative date (based on the current date).
-                          # Valid only if the type is
-                          # DATE_BEFORE,
-                          # DATE_AFTER,
-                          # DATE_ON_OR_BEFORE or
-                          # DATE_ON_OR_AFTER.
-                          #
-                          # Relative dates are not supported in data validation.
-                          # They are supported only in conditional formatting and
-                          # conditional filters.
-                      "userEnteredValue": "A String", # A value the condition is based on.
-                          # The value will be parsed as if the user typed into a cell.
-                          # Formulas are supported (and must begin with an `=`).
-                    },
-                  ],
-                },
-              },
-            },
-          },
-        },
-      },
-    ],
-  }</pre>
-</div>
-
-<div class="method">
-    <code class="details" id="create">create(body, x__xgafv=None)</code>
-  <pre>Creates a spreadsheet, returning the newly created spreadsheet.
-
-Args:
-  body: object, The request body. (required)
-    The object takes the form of:
-
-{ # Resource that represents a spreadsheet.
-    "spreadsheetId": "A String", # The ID of the spreadsheet.
-        # This field is read-only.
-    "namedRanges": [ # The named ranges defined in a spreadsheet.
-      { # A named range.
-        "namedRangeId": "A String", # The ID of the named range.
-        "range": { # A range on a sheet. # The range this represents.
-            # All indexes are zero-based.
-            # Indexes are half open, e.g the start index is inclusive
-            # and the end index is exclusive -- [start_index, end_index).
-            # Missing indexes indicate the range is unbounded on that side.
-            #
-            # For example, if `"Sheet1"` is sheet ID 0, then:
-            #
-            #   `Sheet1!A1:A1 == sheet_id: 0,
-            #                   start_row_index: 0, end_row_index: 1,
-            #                   start_column_index: 0, end_column_index: 1`
-            #
-            #   `Sheet1!A3:B4 == sheet_id: 0,
-            #                   start_row_index: 2, end_row_index: 4,
-            #                   start_column_index: 0, end_column_index: 2`
-            #
-            #   `Sheet1!A:B == sheet_id: 0,
-            #                 start_column_index: 0, end_column_index: 2`
-            #
-            #   `Sheet1!A5:B == sheet_id: 0,
-            #                  start_row_index: 4,
-            #                  start_column_index: 0, end_column_index: 2`
-            #
-            #   `Sheet1 == sheet_id:0`
-            #
-            # The start index must always be less than or equal to the end index.
-            # If the start index equals the end index, then the range is empty.
-            # Empty ranges are typically not meaningful and are usually rendered in the
-            # UI as `#REF!`.
-          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-          "sheetId": 42, # The sheet this range is on.
-          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-        },
-        "name": "A String", # The name of the named range.
-      },
-    ],
-    "properties": { # Properties of a spreadsheet. # Overall properties of a spreadsheet.
-      "locale": "A String", # The locale of the spreadsheet in one of the following formats:
-          #
-          # * an ISO 639-1 language code such as `en`
-          #
-          # * an ISO 639-2 language code such as `fil`, if no 639-1 code exists
-          #
-          # * a combination of the ISO language code and country code, such as `en_US`
-          #
-          # Note: when updating this field, not all locales/languages are supported.
-      "timeZone": "A String", # The time zone of the spreadsheet, in CLDR format such as
-          # `America/New_York`. If the time zone isn't recognized, this may
-          # be a custom time zone such as `GMT-07:00`.
-      "autoRecalc": "A String", # The amount of time to wait before volatile functions are recalculated.
-      "defaultFormat": { # The format of a cell. # The default format of all cells in the spreadsheet.
-          # CellData.effectiveFormat will not be set if the
-          # cell's format is equal to this default format.
-          # This field is read-only.
-        "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-          "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-              # the user's locale will be used if necessary for the given type.
-              # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-              # information about the supported patterns.
-          "type": "A String", # The type of the number format.
-              # When writing, this field must be set.
-        },
-        "textDirection": "A String", # The direction of the text in the cell.
-        "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-            # When updating padding, every field must be specified.
-          "top": 42, # The top padding of the cell.
-          "right": 42, # The right padding of the cell.
-          "bottom": 42, # The bottom padding of the cell.
-          "left": 42, # The left padding of the cell.
-        },
-        "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-        "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-            # for simplicity of conversion to/from color representations in various
-            # languages over compactness; for example, the fields of this representation
-            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-            # method in iOS; and, with just a little work, it can be easily formatted into
-            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-            #
-            # Example (Java):
-            #
-            #      import com.google.type.Color;
-            #
-            #      // ...
-            #      public static java.awt.Color fromProto(Color protocolor) {
-            #        float alpha = protocolor.hasAlpha()
-            #            ? protocolor.getAlpha().getValue()
-            #            : 1.0;
-            #
-            #        return new java.awt.Color(
-            #            protocolor.getRed(),
-            #            protocolor.getGreen(),
-            #            protocolor.getBlue(),
-            #            alpha);
-            #      }
-            #
-            #      public static Color toProto(java.awt.Color color) {
-            #        float red = (float) color.getRed();
-            #        float green = (float) color.getGreen();
-            #        float blue = (float) color.getBlue();
-            #        float denominator = 255.0;
-            #        Color.Builder resultBuilder =
-            #            Color
-            #                .newBuilder()
-            #                .setRed(red / denominator)
-            #                .setGreen(green / denominator)
-            #                .setBlue(blue / denominator);
-            #        int alpha = color.getAlpha();
-            #        if (alpha != 255) {
-            #          result.setAlpha(
-            #              FloatValue
-            #                  .newBuilder()
-            #                  .setValue(((float) alpha) / denominator)
-            #                  .build());
-            #        }
-            #        return resultBuilder.build();
-            #      }
-            #      // ...
-            #
-            # Example (iOS / Obj-C):
-            #
-            #      // ...
-            #      static UIColor* fromProto(Color* protocolor) {
-            #         float red = [protocolor red];
-            #         float green = [protocolor green];
-            #         float blue = [protocolor blue];
-            #         FloatValue* alpha_wrapper = [protocolor alpha];
-            #         float alpha = 1.0;
-            #         if (alpha_wrapper != nil) {
-            #           alpha = [alpha_wrapper value];
-            #         }
-            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-            #      }
-            #
-            #      static Color* toProto(UIColor* color) {
-            #          CGFloat red, green, blue, alpha;
-            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-            #            return nil;
-            #          }
-            #          Color* result = [Color alloc] init];
-            #          [result setRed:red];
-            #          [result setGreen:green];
-            #          [result setBlue:blue];
-            #          if (alpha <= 0.9999) {
-            #            [result setAlpha:floatWrapperWithValue(alpha)];
-            #          }
-            #          [result autorelease];
-            #          return result;
-            #     }
-            #     // ...
-            #
-            #  Example (JavaScript):
-            #
-            #     // ...
-            #
-            #     var protoToCssColor = function(rgb_color) {
-            #        var redFrac = rgb_color.red || 0.0;
-            #        var greenFrac = rgb_color.green || 0.0;
-            #        var blueFrac = rgb_color.blue || 0.0;
-            #        var red = Math.floor(redFrac * 255);
-            #        var green = Math.floor(greenFrac * 255);
-            #        var blue = Math.floor(blueFrac * 255);
-            #
-            #        if (!('alpha' in rgb_color)) {
-            #           return rgbToCssColor_(red, green, blue);
-            #        }
-            #
-            #        var alphaFrac = rgb_color.alpha.value || 0.0;
-            #        var rgbParams = [red, green, blue].join(',');
-            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-            #     };
-            #
-            #     var rgbToCssColor_ = function(red, green, blue) {
-            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-            #       var hexString = rgbNumber.toString(16);
-            #       var missingZeros = 6 - hexString.length;
-            #       var resultBuilder = ['#'];
-            #       for (var i = 0; i < missingZeros; i++) {
-            #          resultBuilder.push('0');
-            #       }
-            #       resultBuilder.push(hexString);
-            #       return resultBuilder.join('');
-            #     };
-            #
-            #     // ...
-          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-              # the final pixel color is defined by the equation:
-              #
-              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-              #
-              # This means that a value of 1.0 corresponds to a solid color, whereas
-              # a value of 0.0 corresponds to a completely transparent color. This
-              # uses a wrapper message rather than a simple float scalar so that it is
-              # possible to distinguish between a default value and the value being unset.
-              # If omitted, this color object is to be rendered as a solid color
-              # (as if the alpha value had been explicitly given with a value of 1.0).
-          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-        },
-        "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-        "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-            # Absent values indicate that the field isn't specified.
-          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-              # for simplicity of conversion to/from color representations in various
-              # languages over compactness; for example, the fields of this representation
-              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-              # method in iOS; and, with just a little work, it can be easily formatted into
-              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-              #
-              # Example (Java):
-              #
-              #      import com.google.type.Color;
-              #
-              #      // ...
-              #      public static java.awt.Color fromProto(Color protocolor) {
-              #        float alpha = protocolor.hasAlpha()
-              #            ? protocolor.getAlpha().getValue()
-              #            : 1.0;
-              #
-              #        return new java.awt.Color(
-              #            protocolor.getRed(),
-              #            protocolor.getGreen(),
-              #            protocolor.getBlue(),
-              #            alpha);
-              #      }
-              #
-              #      public static Color toProto(java.awt.Color color) {
-              #        float red = (float) color.getRed();
-              #        float green = (float) color.getGreen();
-              #        float blue = (float) color.getBlue();
-              #        float denominator = 255.0;
-              #        Color.Builder resultBuilder =
-              #            Color
-              #                .newBuilder()
-              #                .setRed(red / denominator)
-              #                .setGreen(green / denominator)
-              #                .setBlue(blue / denominator);
-              #        int alpha = color.getAlpha();
-              #        if (alpha != 255) {
-              #          result.setAlpha(
-              #              FloatValue
-              #                  .newBuilder()
-              #                  .setValue(((float) alpha) / denominator)
-              #                  .build());
-              #        }
-              #        return resultBuilder.build();
-              #      }
-              #      // ...
-              #
-              # Example (iOS / Obj-C):
-              #
-              #      // ...
-              #      static UIColor* fromProto(Color* protocolor) {
-              #         float red = [protocolor red];
-              #         float green = [protocolor green];
-              #         float blue = [protocolor blue];
-              #         FloatValue* alpha_wrapper = [protocolor alpha];
-              #         float alpha = 1.0;
-              #         if (alpha_wrapper != nil) {
-              #           alpha = [alpha_wrapper value];
-              #         }
-              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-              #      }
-              #
-              #      static Color* toProto(UIColor* color) {
-              #          CGFloat red, green, blue, alpha;
-              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-              #            return nil;
-              #          }
-              #          Color* result = [Color alloc] init];
-              #          [result setRed:red];
-              #          [result setGreen:green];
-              #          [result setBlue:blue];
-              #          if (alpha <= 0.9999) {
-              #            [result setAlpha:floatWrapperWithValue(alpha)];
-              #          }
-              #          [result autorelease];
-              #          return result;
-              #     }
-              #     // ...
-              #
-              #  Example (JavaScript):
-              #
-              #     // ...
-              #
-              #     var protoToCssColor = function(rgb_color) {
-              #        var redFrac = rgb_color.red || 0.0;
-              #        var greenFrac = rgb_color.green || 0.0;
-              #        var blueFrac = rgb_color.blue || 0.0;
-              #        var red = Math.floor(redFrac * 255);
-              #        var green = Math.floor(greenFrac * 255);
-              #        var blue = Math.floor(blueFrac * 255);
-              #
-              #        if (!('alpha' in rgb_color)) {
-              #           return rgbToCssColor_(red, green, blue);
-              #        }
-              #
-              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-              #        var rgbParams = [red, green, blue].join(',');
-              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-              #     };
-              #
-              #     var rgbToCssColor_ = function(red, green, blue) {
-              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-              #       var hexString = rgbNumber.toString(16);
-              #       var missingZeros = 6 - hexString.length;
-              #       var resultBuilder = ['#'];
-              #       for (var i = 0; i < missingZeros; i++) {
-              #          resultBuilder.push('0');
-              #       }
-              #       resultBuilder.push(hexString);
-              #       return resultBuilder.join('');
-              #     };
-              #
-              #     // ...
-            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                # the final pixel color is defined by the equation:
-                #
-                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                #
-                # This means that a value of 1.0 corresponds to a solid color, whereas
-                # a value of 0.0 corresponds to a completely transparent color. This
-                # uses a wrapper message rather than a simple float scalar so that it is
-                # possible to distinguish between a default value and the value being unset.
-                # If omitted, this color object is to be rendered as a solid color
-                # (as if the alpha value had been explicitly given with a value of 1.0).
-            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-          },
-          "bold": True or False, # True if the text is bold.
-          "strikethrough": True or False, # True if the text has a strikethrough.
-          "fontFamily": "A String", # The font family.
-          "fontSize": 42, # The size of the font.
-          "italic": True or False, # True if the text is italicized.
-          "underline": True or False, # True if the text is underlined.
-        },
-        "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-        "borders": { # The borders of the cell. # The borders of the cell.
-          "top": { # A border along a cell. # The top border of the cell.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
-                  #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                  #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-          "right": { # A border along a cell. # The right border of the cell.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
-                  #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                  #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-          "bottom": { # A border along a cell. # The bottom border of the cell.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
-                  #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                  #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-          "left": { # A border along a cell. # The left border of the cell.
-            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
-                  #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                  #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "width": 42, # The width of the border, in pixels.
-                # Deprecated; the width is determined by the "style" field.
-            "style": "A String", # The style of the border.
-          },
-        },
-        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-      },
-      "title": "A String", # The title of the spreadsheet.
-    },
-    "sheets": [ # The sheets that are part of a spreadsheet.
-      { # A sheet in a spreadsheet.
-        "conditionalFormats": [ # The conditional format rules in this sheet.
-          { # A rule describing a conditional format.
-            "ranges": [ # The ranges that will be formatted if the condition is true.
-                # All the ranges must be on the same grid.
-              { # A range on a sheet.
-                  # All indexes are zero-based.
-                  # Indexes are half open, e.g the start index is inclusive
-                  # and the end index is exclusive -- [start_index, end_index).
-                  # Missing indexes indicate the range is unbounded on that side.
-                  #
-                  # For example, if `"Sheet1"` is sheet ID 0, then:
-                  #
-                  #   `Sheet1!A1:A1 == sheet_id: 0,
-                  #                   start_row_index: 0, end_row_index: 1,
-                  #                   start_column_index: 0, end_column_index: 1`
-                  #
-                  #   `Sheet1!A3:B4 == sheet_id: 0,
-                  #                   start_row_index: 2, end_row_index: 4,
-                  #                   start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1!A:B == sheet_id: 0,
-                  #                 start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1!A5:B == sheet_id: 0,
-                  #                  start_row_index: 4,
-                  #                  start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1 == sheet_id:0`
-                  #
-                  # The start index must always be less than or equal to the end index.
-                  # If the start index equals the end index, then the range is empty.
-                  # Empty ranges are typically not meaningful and are usually rendered in the
-                  # UI as `#REF!`.
-                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                "sheetId": 42, # The sheet this range is on.
-                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-              },
-            ],
-            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
-              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
-                  # the format will be applied.
-                  # BooleanConditions are used by conditional formatting,
-                  # data validation, and the criteria in filters.
-                "type": "A String", # The type of condition.
-                "values": [ # The values of the condition. The number of supported values depends
-                    # on the condition type.  Some support zero values,
-                    # others one or two values,
-                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                  { # The value of the condition.
-                    "relativeDate": "A String", # A relative date (based on the current date).
-                        # Valid only if the type is
-                        # DATE_BEFORE,
-                        # DATE_AFTER,
-                        # DATE_ON_OR_BEFORE or
-                        # DATE_ON_OR_AFTER.
-                        #
-                        # Relative dates are not supported in data validation.
-                        # They are supported only in conditional formatting and
-                        # conditional filters.
-                    "userEnteredValue": "A String", # A value the condition is based on.
-                        # The value will be parsed as if the user typed into a cell.
-                        # Formulas are supported (and must begin with an `=`).
-                  },
-                ],
-              },
-              "format": { # The format of a cell. # The format to apply.
-                  # Conditional formatting can only apply a subset of formatting:
-                  # bold, italic,
-                  # strikethrough,
-                  # foreground color &
-                  # background color.
-                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                      # the user's locale will be used if necessary for the given type.
-                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                      # information about the supported patterns.
-                  "type": "A String", # The type of the number format.
-                      # When writing, this field must be set.
-                },
-                "textDirection": "A String", # The direction of the text in the cell.
-                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                    # When updating padding, every field must be specified.
-                  "top": 42, # The top padding of the cell.
-                  "right": 42, # The right padding of the cell.
-                  "bottom": 42, # The bottom padding of the cell.
-                  "left": 42, # The left padding of the cell.
-                },
-                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                    # Absent values indicate that the field isn't specified.
-                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                      # for simplicity of conversion to/from color representations in various
-                      # languages over compactness; for example, the fields of this representation
-                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                      # method in iOS; and, with just a little work, it can be easily formatted into
-                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                      #
-                      # Example (Java):
-                      #
-                      #      import com.google.type.Color;
-                      #
-                      #      // ...
-                      #      public static java.awt.Color fromProto(Color protocolor) {
-                      #        float alpha = protocolor.hasAlpha()
-                      #            ? protocolor.getAlpha().getValue()
-                      #            : 1.0;
-                      #
-                      #        return new java.awt.Color(
-                      #            protocolor.getRed(),
-                      #            protocolor.getGreen(),
-                      #            protocolor.getBlue(),
-                      #            alpha);
-                      #      }
-                      #
-                      #      public static Color toProto(java.awt.Color color) {
-                      #        float red = (float) color.getRed();
-                      #        float green = (float) color.getGreen();
-                      #        float blue = (float) color.getBlue();
-                      #        float denominator = 255.0;
-                      #        Color.Builder resultBuilder =
-                      #            Color
-                      #                .newBuilder()
-                      #                .setRed(red / denominator)
-                      #                .setGreen(green / denominator)
-                      #                .setBlue(blue / denominator);
-                      #        int alpha = color.getAlpha();
-                      #        if (alpha != 255) {
-                      #          result.setAlpha(
-                      #              FloatValue
-                      #                  .newBuilder()
-                      #                  .setValue(((float) alpha) / denominator)
-                      #                  .build());
-                      #        }
-                      #        return resultBuilder.build();
-                      #      }
-                      #      // ...
-                      #
-                      # Example (iOS / Obj-C):
-                      #
-                      #      // ...
-                      #      static UIColor* fromProto(Color* protocolor) {
-                      #         float red = [protocolor red];
-                      #         float green = [protocolor green];
-                      #         float blue = [protocolor blue];
-                      #         FloatValue* alpha_wrapper = [protocolor alpha];
-                      #         float alpha = 1.0;
-                      #         if (alpha_wrapper != nil) {
-                      #           alpha = [alpha_wrapper value];
-                      #         }
-                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                      #      }
-                      #
-                      #      static Color* toProto(UIColor* color) {
-                      #          CGFloat red, green, blue, alpha;
-                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                      #            return nil;
-                      #          }
-                      #          Color* result = [Color alloc] init];
-                      #          [result setRed:red];
-                      #          [result setGreen:green];
-                      #          [result setBlue:blue];
-                      #          if (alpha <= 0.9999) {
-                      #            [result setAlpha:floatWrapperWithValue(alpha)];
-                      #          }
-                      #          [result autorelease];
-                      #          return result;
-                      #     }
-                      #     // ...
-                      #
-                      #  Example (JavaScript):
-                      #
-                      #     // ...
-                      #
-                      #     var protoToCssColor = function(rgb_color) {
-                      #        var redFrac = rgb_color.red || 0.0;
-                      #        var greenFrac = rgb_color.green || 0.0;
-                      #        var blueFrac = rgb_color.blue || 0.0;
-                      #        var red = Math.floor(redFrac * 255);
-                      #        var green = Math.floor(greenFrac * 255);
-                      #        var blue = Math.floor(blueFrac * 255);
-                      #
-                      #        if (!('alpha' in rgb_color)) {
-                      #           return rgbToCssColor_(red, green, blue);
-                      #        }
-                      #
-                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                      #        var rgbParams = [red, green, blue].join(',');
-                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                      #     };
-                      #
-                      #     var rgbToCssColor_ = function(red, green, blue) {
-                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                      #       var hexString = rgbNumber.toString(16);
-                      #       var missingZeros = 6 - hexString.length;
-                      #       var resultBuilder = ['#'];
-                      #       for (var i = 0; i < missingZeros; i++) {
-                      #          resultBuilder.push('0');
-                      #       }
-                      #       resultBuilder.push(hexString);
-                      #       return resultBuilder.join('');
-                      #     };
-                      #
-                      #     // ...
-                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                        # the final pixel color is defined by the equation:
-                        #
-                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                        #
-                        # This means that a value of 1.0 corresponds to a solid color, whereas
-                        # a value of 0.0 corresponds to a completely transparent color. This
-                        # uses a wrapper message rather than a simple float scalar so that it is
-                        # possible to distinguish between a default value and the value being unset.
-                        # If omitted, this color object is to be rendered as a solid color
-                        # (as if the alpha value had been explicitly given with a value of 1.0).
-                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                  },
-                  "bold": True or False, # True if the text is bold.
-                  "strikethrough": True or False, # True if the text has a strikethrough.
-                  "fontFamily": "A String", # The font family.
-                  "fontSize": 42, # The size of the font.
-                  "italic": True or False, # True if the text is italicized.
-                  "underline": True or False, # True if the text is underlined.
-                },
-                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                "borders": { # The borders of the cell. # The borders of the cell.
-                  "top": { # A border along a cell. # The top border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "right": { # A border along a cell. # The right border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "bottom": { # A border along a cell. # The bottom border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                  "left": { # A border along a cell. # The left border of the cell.
-                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
-                        #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "width": 42, # The width of the border, in pixels.
-                        # Deprecated; the width is determined by the "style" field.
-                    "style": "A String", # The style of the border.
-                  },
-                },
-                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-              },
-            },
-            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
-                # the interpolation points listed. The format of a cell will vary
-                # based on its contents as compared to the values of the interpolation
-                # points.
-              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
-                  # These pin the gradient color scale according to the color,
-                  # type and value chosen.
-                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                    # for simplicity of conversion to/from color representations in various
-                    # languages over compactness; for example, the fields of this representation
-                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                    # method in iOS; and, with just a little work, it can be easily formatted into
-                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                    #
-                    # Example (Java):
-                    #
-                    #      import com.google.type.Color;
-                    #
-                    #      // ...
-                    #      public static java.awt.Color fromProto(Color protocolor) {
-                    #        float alpha = protocolor.hasAlpha()
-                    #            ? protocolor.getAlpha().getValue()
-                    #            : 1.0;
-                    #
-                    #        return new java.awt.Color(
-                    #            protocolor.getRed(),
-                    #            protocolor.getGreen(),
-                    #            protocolor.getBlue(),
-                    #            alpha);
-                    #      }
-                    #
-                    #      public static Color toProto(java.awt.Color color) {
-                    #        float red = (float) color.getRed();
-                    #        float green = (float) color.getGreen();
-                    #        float blue = (float) color.getBlue();
-                    #        float denominator = 255.0;
-                    #        Color.Builder resultBuilder =
-                    #            Color
-                    #                .newBuilder()
-                    #                .setRed(red / denominator)
-                    #                .setGreen(green / denominator)
-                    #                .setBlue(blue / denominator);
-                    #        int alpha = color.getAlpha();
-                    #        if (alpha != 255) {
-                    #          result.setAlpha(
-                    #              FloatValue
-                    #                  .newBuilder()
-                    #                  .setValue(((float) alpha) / denominator)
-                    #                  .build());
-                    #        }
-                    #        return resultBuilder.build();
-                    #      }
-                    #      // ...
-                    #
-                    # Example (iOS / Obj-C):
-                    #
-                    #      // ...
-                    #      static UIColor* fromProto(Color* protocolor) {
-                    #         float red = [protocolor red];
-                    #         float green = [protocolor green];
-                    #         float blue = [protocolor blue];
-                    #         FloatValue* alpha_wrapper = [protocolor alpha];
-                    #         float alpha = 1.0;
-                    #         if (alpha_wrapper != nil) {
-                    #           alpha = [alpha_wrapper value];
-                    #         }
-                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                    #      }
-                    #
-                    #      static Color* toProto(UIColor* color) {
-                    #          CGFloat red, green, blue, alpha;
-                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                    #            return nil;
-                    #          }
-                    #          Color* result = [Color alloc] init];
-                    #          [result setRed:red];
-                    #          [result setGreen:green];
-                    #          [result setBlue:blue];
-                    #          if (alpha <= 0.9999) {
-                    #            [result setAlpha:floatWrapperWithValue(alpha)];
-                    #          }
-                    #          [result autorelease];
-                    #          return result;
-                    #     }
-                    #     // ...
-                    #
-                    #  Example (JavaScript):
-                    #
-                    #     // ...
-                    #
-                    #     var protoToCssColor = function(rgb_color) {
-                    #        var redFrac = rgb_color.red || 0.0;
-                    #        var greenFrac = rgb_color.green || 0.0;
-                    #        var blueFrac = rgb_color.blue || 0.0;
-                    #        var red = Math.floor(redFrac * 255);
-                    #        var green = Math.floor(greenFrac * 255);
-                    #        var blue = Math.floor(blueFrac * 255);
-                    #
-                    #        if (!('alpha' in rgb_color)) {
-                    #           return rgbToCssColor_(red, green, blue);
-                    #        }
-                    #
-                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                    #        var rgbParams = [red, green, blue].join(',');
-                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                    #     };
-                    #
-                    #     var rgbToCssColor_ = function(red, green, blue) {
-                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                    #       var hexString = rgbNumber.toString(16);
-                    #       var missingZeros = 6 - hexString.length;
-                    #       var resultBuilder = ['#'];
-                    #       for (var i = 0; i < missingZeros; i++) {
-                    #          resultBuilder.push('0');
-                    #       }
-                    #       resultBuilder.push(hexString);
-                    #       return resultBuilder.join('');
-                    #     };
-                    #
-                    #     // ...
-                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                      # the final pixel color is defined by the equation:
-                      #
-                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                      #
-                      # This means that a value of 1.0 corresponds to a solid color, whereas
-                      # a value of 0.0 corresponds to a completely transparent color. This
-                      # uses a wrapper message rather than a simple float scalar so that it is
-                      # possible to distinguish between a default value and the value being unset.
-                      # If omitted, this color object is to be rendered as a solid color
-                      # (as if the alpha value had been explicitly given with a value of 1.0).
-                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                },
-                "type": "A String", # How the value should be interpreted.
-                "value": "A String", # The value this interpolation point uses.  May be a formula.
-                    # Unused if type is MIN or
-                    # MAX.
-              },
-            },
-          },
-        ],
-        "merges": [ # The ranges that are merged together.
-          { # A range on a sheet.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-        ],
-        "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any.
-          "range": { # A range on a sheet. # The range the filter covers.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "sortSpecs": [ # The sort order per column. Later specifications are used when values
-              # are equal in the earlier specifications.
-            { # A sort order associated with a specific column or row.
-              "sortOrder": "A String", # The order data should be sorted.
-              "dimensionIndex": 42, # The dimension the sort should be applied to.
-            },
-          ],
-          "criteria": { # The criteria for showing/hiding values per column.
-              # The map's key is the column index, and the value is the criteria for
-              # that column.
-            "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
-              "hiddenValues": [ # Values that should be hidden.
-                "A String",
-              ],
-              "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
-                  # (This does not override hiddenValues -- if a value is listed there,
-                  #  it will still be hidden.)
-                  # BooleanConditions are used by conditional formatting,
-                  # data validation, and the criteria in filters.
-                "type": "A String", # The type of condition.
-                "values": [ # The values of the condition. The number of supported values depends
-                    # on the condition type.  Some support zero values,
-                    # others one or two values,
-                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                  { # The value of the condition.
-                    "relativeDate": "A String", # A relative date (based on the current date).
-                        # Valid only if the type is
-                        # DATE_BEFORE,
-                        # DATE_AFTER,
-                        # DATE_ON_OR_BEFORE or
-                        # DATE_ON_OR_AFTER.
-                        #
-                        # Relative dates are not supported in data validation.
-                        # They are supported only in conditional formatting and
-                        # conditional filters.
-                    "userEnteredValue": "A String", # A value the condition is based on.
-                        # The value will be parsed as if the user typed into a cell.
-                        # Formulas are supported (and must begin with an `=`).
-                  },
-                ],
-              },
-            },
-          },
-        },
-        "charts": [ # The specifications of every chart on this sheet.
-          { # A chart embedded in a sheet.
-            "chartId": 42, # The ID of the chart.
-            "position": { # The position of an embedded object such as a chart. # The position of the chart.
-              "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
-                  # is chosen for you. Used only when writing.
-              "sheetId": 42, # The sheet this is on. Set only if the embedded object
-                  # is on its own sheet. Must be non-negative.
-              "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
-                "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
-                    # All indexes are zero-based.
-                  "rowIndex": 42, # The row index of the coordinate.
-                  "columnIndex": 42, # The column index of the coordinate.
-                  "sheetId": 42, # The sheet this coordinate is on.
-                },
-                "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
-                    # from the anchor cell.
-                "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
-                "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
-                    # from the anchor cell.
-                "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
-              },
-            },
-            "spec": { # The specifications of a chart. # The specification of the chart.
-              "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
-              "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
-                "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
-                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                    "sources": [ # The ranges of data for a series or domain.
-                        # Exactly one dimension must have a length of 1,
-                        # and all sources in the list must have the same dimension
-                        # with length 1.
-                        # The domain (if it exists) & all series must have the same number
-                        # of source ranges. If using more than one source range, then the source
-                        # range at a given offset must be contiguous across the domain and series.
-                        #
-                        # For example, these are valid configurations:
-                        #
-                        #     domain sources: A1:A5
-                        #     series1 sources: B1:B5
-                        #     series2 sources: D6:D10
-                        #
-                        #     domain sources: A1:A5, C10:C12
-                        #     series1 sources: B1:B5, D10:D12
-                        #     series2 sources: C1:C5, E10:E12
-                      { # A range on a sheet.
-                          # All indexes are zero-based.
-                          # Indexes are half open, e.g the start index is inclusive
-                          # and the end index is exclusive -- [start_index, end_index).
-                          # Missing indexes indicate the range is unbounded on that side.
-                          #
-                          # For example, if `"Sheet1"` is sheet ID 0, then:
-                          #
-                          #   `Sheet1!A1:A1 == sheet_id: 0,
-                          #                   start_row_index: 0, end_row_index: 1,
-                          #                   start_column_index: 0, end_column_index: 1`
-                          #
-                          #   `Sheet1!A3:B4 == sheet_id: 0,
-                          #                   start_row_index: 2, end_row_index: 4,
-                          #                   start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A:B == sheet_id: 0,
-                          #                 start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A5:B == sheet_id: 0,
-                          #                  start_row_index: 4,
-                          #                  start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1 == sheet_id:0`
-                          #
-                          # The start index must always be less than or equal to the end index.
-                          # If the start index equals the end index, then the range is empty.
-                          # Empty ranges are typically not meaningful and are usually rendered in the
-                          # UI as `#REF!`.
-                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                        "sheetId": 42, # The sheet this range is on.
-                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                      },
-                    ],
-                  },
-                },
-                "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
-                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                    "sources": [ # The ranges of data for a series or domain.
-                        # Exactly one dimension must have a length of 1,
-                        # and all sources in the list must have the same dimension
-                        # with length 1.
-                        # The domain (if it exists) & all series must have the same number
-                        # of source ranges. If using more than one source range, then the source
-                        # range at a given offset must be contiguous across the domain and series.
-                        #
-                        # For example, these are valid configurations:
-                        #
-                        #     domain sources: A1:A5
-                        #     series1 sources: B1:B5
-                        #     series2 sources: D6:D10
-                        #
-                        #     domain sources: A1:A5, C10:C12
-                        #     series1 sources: B1:B5, D10:D12
-                        #     series2 sources: C1:C5, E10:E12
-                      { # A range on a sheet.
-                          # All indexes are zero-based.
-                          # Indexes are half open, e.g the start index is inclusive
-                          # and the end index is exclusive -- [start_index, end_index).
-                          # Missing indexes indicate the range is unbounded on that side.
-                          #
-                          # For example, if `"Sheet1"` is sheet ID 0, then:
-                          #
-                          #   `Sheet1!A1:A1 == sheet_id: 0,
-                          #                   start_row_index: 0, end_row_index: 1,
-                          #                   start_column_index: 0, end_column_index: 1`
-                          #
-                          #   `Sheet1!A3:B4 == sheet_id: 0,
-                          #                   start_row_index: 2, end_row_index: 4,
-                          #                   start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A:B == sheet_id: 0,
-                          #                 start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A5:B == sheet_id: 0,
-                          #                  start_row_index: 4,
-                          #                  start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1 == sheet_id:0`
-                          #
-                          # The start index must always be less than or equal to the end index.
-                          # If the start index equals the end index, then the range is empty.
-                          # Empty ranges are typically not meaningful and are usually rendered in the
-                          # UI as `#REF!`.
-                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                        "sheetId": 42, # The sheet this range is on.
-                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                      },
-                    ],
-                  },
-                },
-                "threeDimensional": True or False, # True if the pie is three dimensional.
-                "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
-                "pieHole": 3.14, # The size of the hole in the pie chart.
-              },
-              "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
-                  # See BasicChartType for the list of all
-                  # charts this supports.
-                  # of charts this supports.
-                "headerCount": 42, # The number of rows or columns in the data that are "headers".
-                    # If not set, Google Sheets will guess how many rows are headers based
-                    # on the data.
-                    #
-                    # (Note that BasicChartAxis.title may override the axis title
-                    #  inferred from the header values.)
-                "series": [ # The data this chart is visualizing.
-                  { # A single series of data in a chart.
-                      # For example, if charting stock prices over time, multiple series may exist,
-                      # one for the "Open Price", "High Price", "Low Price" and "Close Price".
-                    "series": { # The data included in a domain or series. # The data being visualized in this chart series.
-                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                        "sources": [ # The ranges of data for a series or domain.
-                            # Exactly one dimension must have a length of 1,
-                            # and all sources in the list must have the same dimension
-                            # with length 1.
-                            # The domain (if it exists) & all series must have the same number
-                            # of source ranges. If using more than one source range, then the source
-                            # range at a given offset must be contiguous across the domain and series.
-                            #
-                            # For example, these are valid configurations:
-                            #
-                            #     domain sources: A1:A5
-                            #     series1 sources: B1:B5
-                            #     series2 sources: D6:D10
-                            #
-                            #     domain sources: A1:A5, C10:C12
-                            #     series1 sources: B1:B5, D10:D12
-                            #     series2 sources: C1:C5, E10:E12
-                          { # A range on a sheet.
-                              # All indexes are zero-based.
-                              # Indexes are half open, e.g the start index is inclusive
-                              # and the end index is exclusive -- [start_index, end_index).
-                              # Missing indexes indicate the range is unbounded on that side.
-                              #
-                              # For example, if `"Sheet1"` is sheet ID 0, then:
-                              #
-                              #   `Sheet1!A1:A1 == sheet_id: 0,
-                              #                   start_row_index: 0, end_row_index: 1,
-                              #                   start_column_index: 0, end_column_index: 1`
-                              #
-                              #   `Sheet1!A3:B4 == sheet_id: 0,
-                              #                   start_row_index: 2, end_row_index: 4,
-                              #                   start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1!A:B == sheet_id: 0,
-                              #                 start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1!A5:B == sheet_id: 0,
-                              #                  start_row_index: 4,
-                              #                  start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1 == sheet_id:0`
-                              #
-                              # The start index must always be less than or equal to the end index.
-                              # If the start index equals the end index, then the range is empty.
-                              # Empty ranges are typically not meaningful and are usually rendered in the
-                              # UI as `#REF!`.
-                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                            "sheetId": 42, # The sheet this range is on.
-                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                          },
-                        ],
-                      },
-                    },
-                    "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
-                        # For example, if charting stocks over time, the "Volume" series
-                        # may want to be pinned to the right with the prices pinned to the left,
-                        # because the scale of trading volume is different than the scale of
-                        # prices.
-                        # It is an error to specify an axis that isn't a valid minor axis
-                        # for the chart's type.
-                    "type": "A String", # The type of this series. Valid only if the
-                        # chartType is
-                        # COMBO.
-                        # Different types will change the way the series is visualized.
-                        # Only LINE, AREA,
-                        # and COLUMN are supported.
-                  },
-                ],
-                "legendPosition": "A String", # The position of the chart legend.
-                "domains": [ # The domain of data this is charting.
-                    # Only a single domain is currently supported.
-                  { # The domain of a chart.
-                      # For example, if charting stock prices over time, this would be the date.
-                    "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
-                        # this is the data representing the dates.
-                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                        "sources": [ # The ranges of data for a series or domain.
-                            # Exactly one dimension must have a length of 1,
-                            # and all sources in the list must have the same dimension
-                            # with length 1.
-                            # The domain (if it exists) & all series must have the same number
-                            # of source ranges. If using more than one source range, then the source
-                            # range at a given offset must be contiguous across the domain and series.
-                            #
-                            # For example, these are valid configurations:
-                            #
-                            #     domain sources: A1:A5
-                            #     series1 sources: B1:B5
-                            #     series2 sources: D6:D10
-                            #
-                            #     domain sources: A1:A5, C10:C12
-                            #     series1 sources: B1:B5, D10:D12
-                            #     series2 sources: C1:C5, E10:E12
-                          { # A range on a sheet.
-                              # All indexes are zero-based.
-                              # Indexes are half open, e.g the start index is inclusive
-                              # and the end index is exclusive -- [start_index, end_index).
-                              # Missing indexes indicate the range is unbounded on that side.
-                              #
-                              # For example, if `"Sheet1"` is sheet ID 0, then:
-                              #
-                              #   `Sheet1!A1:A1 == sheet_id: 0,
-                              #                   start_row_index: 0, end_row_index: 1,
-                              #                   start_column_index: 0, end_column_index: 1`
-                              #
-                              #   `Sheet1!A3:B4 == sheet_id: 0,
-                              #                   start_row_index: 2, end_row_index: 4,
-                              #                   start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1!A:B == sheet_id: 0,
-                              #                 start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1!A5:B == sheet_id: 0,
-                              #                  start_row_index: 4,
-                              #                  start_column_index: 0, end_column_index: 2`
-                              #
-                              #   `Sheet1 == sheet_id:0`
-                              #
-                              # The start index must always be less than or equal to the end index.
-                              # If the start index equals the end index, then the range is empty.
-                              # Empty ranges are typically not meaningful and are usually rendered in the
-                              # UI as `#REF!`.
-                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                            "sheetId": 42, # The sheet this range is on.
-                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                          },
-                        ],
-                      },
-                    },
-                  },
-                ],
-                "chartType": "A String", # The type of the chart.
-                "axis": [ # The axis on the chart.
-                  { # An axis of the chart.
-                      # A chart may not have more than one axis per
-                      # axis position.
-                    "position": "A String", # The position of this axis.
-                    "format": { # The format of a run of text in a cell. # The format of the title.
-                        # Only valid if the axis is not associated with the domain.
-                        # Absent values indicate that the field isn't specified.
-                      "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                          # for simplicity of conversion to/from color representations in various
-                          # languages over compactness; for example, the fields of this representation
-                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                          # method in iOS; and, with just a little work, it can be easily formatted into
-                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                          #
-                          # Example (Java):
-                          #
-                          #      import com.google.type.Color;
-                          #
-                          #      // ...
-                          #      public static java.awt.Color fromProto(Color protocolor) {
-                          #        float alpha = protocolor.hasAlpha()
-                          #            ? protocolor.getAlpha().getValue()
-                          #            : 1.0;
-                          #
-                          #        return new java.awt.Color(
-                          #            protocolor.getRed(),
-                          #            protocolor.getGreen(),
-                          #            protocolor.getBlue(),
-                          #            alpha);
-                          #      }
-                          #
-                          #      public static Color toProto(java.awt.Color color) {
-                          #        float red = (float) color.getRed();
-                          #        float green = (float) color.getGreen();
-                          #        float blue = (float) color.getBlue();
-                          #        float denominator = 255.0;
-                          #        Color.Builder resultBuilder =
-                          #            Color
-                          #                .newBuilder()
-                          #                .setRed(red / denominator)
-                          #                .setGreen(green / denominator)
-                          #                .setBlue(blue / denominator);
-                          #        int alpha = color.getAlpha();
-                          #        if (alpha != 255) {
-                          #          result.setAlpha(
-                          #              FloatValue
-                          #                  .newBuilder()
-                          #                  .setValue(((float) alpha) / denominator)
-                          #                  .build());
-                          #        }
-                          #        return resultBuilder.build();
-                          #      }
-                          #      // ...
-                          #
-                          # Example (iOS / Obj-C):
-                          #
-                          #      // ...
-                          #      static UIColor* fromProto(Color* protocolor) {
-                          #         float red = [protocolor red];
-                          #         float green = [protocolor green];
-                          #         float blue = [protocolor blue];
-                          #         FloatValue* alpha_wrapper = [protocolor alpha];
-                          #         float alpha = 1.0;
-                          #         if (alpha_wrapper != nil) {
-                          #           alpha = [alpha_wrapper value];
-                          #         }
-                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                          #      }
-                          #
-                          #      static Color* toProto(UIColor* color) {
-                          #          CGFloat red, green, blue, alpha;
-                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                          #            return nil;
-                          #          }
-                          #          Color* result = [Color alloc] init];
-                          #          [result setRed:red];
-                          #          [result setGreen:green];
-                          #          [result setBlue:blue];
-                          #          if (alpha <= 0.9999) {
-                          #            [result setAlpha:floatWrapperWithValue(alpha)];
-                          #          }
-                          #          [result autorelease];
-                          #          return result;
-                          #     }
-                          #     // ...
-                          #
-                          #  Example (JavaScript):
-                          #
-                          #     // ...
-                          #
-                          #     var protoToCssColor = function(rgb_color) {
-                          #        var redFrac = rgb_color.red || 0.0;
-                          #        var greenFrac = rgb_color.green || 0.0;
-                          #        var blueFrac = rgb_color.blue || 0.0;
-                          #        var red = Math.floor(redFrac * 255);
-                          #        var green = Math.floor(greenFrac * 255);
-                          #        var blue = Math.floor(blueFrac * 255);
-                          #
-                          #        if (!('alpha' in rgb_color)) {
-                          #           return rgbToCssColor_(red, green, blue);
-                          #        }
-                          #
-                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                          #        var rgbParams = [red, green, blue].join(',');
-                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                          #     };
-                          #
-                          #     var rgbToCssColor_ = function(red, green, blue) {
-                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                          #       var hexString = rgbNumber.toString(16);
-                          #       var missingZeros = 6 - hexString.length;
-                          #       var resultBuilder = ['#'];
-                          #       for (var i = 0; i < missingZeros; i++) {
-                          #          resultBuilder.push('0');
-                          #       }
-                          #       resultBuilder.push(hexString);
-                          #       return resultBuilder.join('');
-                          #     };
-                          #
-                          #     // ...
-                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                            # the final pixel color is defined by the equation:
-                            #
-                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                            #
-                            # This means that a value of 1.0 corresponds to a solid color, whereas
-                            # a value of 0.0 corresponds to a completely transparent color. This
-                            # uses a wrapper message rather than a simple float scalar so that it is
-                            # possible to distinguish between a default value and the value being unset.
-                            # If omitted, this color object is to be rendered as a solid color
-                            # (as if the alpha value had been explicitly given with a value of 1.0).
-                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                      },
-                      "bold": True or False, # True if the text is bold.
-                      "strikethrough": True or False, # True if the text has a strikethrough.
-                      "fontFamily": "A String", # The font family.
-                      "fontSize": 42, # The size of the font.
-                      "italic": True or False, # True if the text is italicized.
-                      "underline": True or False, # True if the text is underlined.
-                    },
-                    "title": "A String", # The title of this axis. If set, this overrides any title inferred
-                        # from headers of the data.
-                  },
-                ],
-              },
-              "title": "A String", # The title of the chart.
-            },
-          },
-        ],
-        "filterViews": [ # The filter views in this sheet.
-          { # A filter view.
-            "title": "A String", # The name of the filter view.
-            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-            "filterViewId": 42, # The ID of the filter view.
-            "range": { # A range on a sheet. # The range this filter view covers.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-            "sortSpecs": [ # The sort order per column. Later specifications are used when values
-                # are equal in the earlier specifications.
-              { # A sort order associated with a specific column or row.
-                "sortOrder": "A String", # The order data should be sorted.
-                "dimensionIndex": 42, # The dimension the sort should be applied to.
-              },
-            ],
-            "criteria": { # The criteria for showing/hiding values per column.
-                # The map's key is the column index, and the value is the criteria for
-                # that column.
-              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
-                "hiddenValues": [ # Values that should be hidden.
-                  "A String",
-                ],
-                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
-                    # (This does not override hiddenValues -- if a value is listed there,
-                    #  it will still be hidden.)
-                    # BooleanConditions are used by conditional formatting,
-                    # data validation, and the criteria in filters.
-                  "type": "A String", # The type of condition.
-                  "values": [ # The values of the condition. The number of supported values depends
-                      # on the condition type.  Some support zero values,
-                      # others one or two values,
-                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                    { # The value of the condition.
-                      "relativeDate": "A String", # A relative date (based on the current date).
-                          # Valid only if the type is
-                          # DATE_BEFORE,
-                          # DATE_AFTER,
-                          # DATE_ON_OR_BEFORE or
-                          # DATE_ON_OR_AFTER.
-                          #
-                          # Relative dates are not supported in data validation.
-                          # They are supported only in conditional formatting and
-                          # conditional filters.
-                      "userEnteredValue": "A String", # A value the condition is based on.
-                          # The value will be parsed as if the user typed into a cell.
-                          # Formulas are supported (and must begin with an `=`).
-                    },
-                  ],
-                },
-              },
-            },
-          },
-        ],
-        "protectedRanges": [ # The protected ranges in this sheet.
-          { # A protected range.
-            "unprotectedRanges": [ # The list of unprotected ranges within a protected sheet.
-                # Unprotected ranges are only supported on protected sheets.
-              { # A range on a sheet.
-                  # All indexes are zero-based.
-                  # Indexes are half open, e.g the start index is inclusive
-                  # and the end index is exclusive -- [start_index, end_index).
-                  # Missing indexes indicate the range is unbounded on that side.
-                  #
-                  # For example, if `"Sheet1"` is sheet ID 0, then:
-                  #
-                  #   `Sheet1!A1:A1 == sheet_id: 0,
-                  #                   start_row_index: 0, end_row_index: 1,
-                  #                   start_column_index: 0, end_column_index: 1`
-                  #
-                  #   `Sheet1!A3:B4 == sheet_id: 0,
-                  #                   start_row_index: 2, end_row_index: 4,
-                  #                   start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1!A:B == sheet_id: 0,
-                  #                 start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1!A5:B == sheet_id: 0,
-                  #                  start_row_index: 4,
-                  #                  start_column_index: 0, end_column_index: 2`
-                  #
-                  #   `Sheet1 == sheet_id:0`
-                  #
-                  # The start index must always be less than or equal to the end index.
-                  # If the start index equals the end index, then the range is empty.
-                  # Empty ranges are typically not meaningful and are usually rendered in the
-                  # UI as `#REF!`.
-                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                "sheetId": 42, # The sheet this range is on.
-                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-              },
-            ],
-            "requestingUserCanEdit": True or False, # True if the user who requested this protected range can edit the
-                # protected area.
-                # This field is read-only.
-            "description": "A String", # The description of this protected range.
-            "namedRangeId": "A String", # The named range this protected range is backed by, if any.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-            "editors": { # The editors of a protected range. # The users and groups with edit access to the protected range.
-                # This field is only visible to users with edit access to the protected
-                # range and the document.
-                # Editors are not supported with warning_only protection.
-              "domainUsersCanEdit": True or False, # True if anyone in the document's domain has edit access to the protected
-                  # range.  Domain protection is only supported on documents within a domain.
-              "users": [ # The email addresses of users with edit access to the protected range.
-                "A String",
-              ],
-              "groups": [ # The email addresses of groups with edit access to the protected range.
-                "A String",
-              ],
-            },
-            "protectedRangeId": 42, # The ID of the protected range.
-                # This field is read-only.
-            "warningOnly": True or False, # True if this protected range will show a warning when editing.
-                # Warning-based protection means that every user can edit data in the
-                # protected range, except editing will prompt a warning asking the user
-                # to confirm the edit.
-                #
-                # When writing: if this field is true, then editors is ignored.
-                # Additionally, if this field is changed from true to false and the
-                # `editors` field is not set (nor included in the field mask), then
-                # the editors will be set to all the editors in the document.
-            "range": { # A range on a sheet. # The range that is being protected.
-                # The range may be fully unbounded, in which case this is considered
-                # a protected sheet.
-                #
-                # When writing, only one of range or named_range_id
-                # may be set.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-          },
-        ],
-        "data": [ # Data in the grid, if this is a grid sheet.
-            # The number of GridData objects returned is dependent on the number of
-            # ranges requested on this sheet. For example, if this is representing
-            # `Sheet1`, and the spreadsheet was requested with ranges
-            # `Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will have a
-            # startRow/startColumn of `0`,
-            # while the second one will have `startRow 14` (zero-based row 15),
-            # and `startColumn 3` (zero-based column D).
-          { # Data in the grid, as well as metadata about the dimensions.
-            "startRow": 42, # The first row this GridData refers to, zero-based.
-            "rowMetadata": [ # Metadata about the requested rows in the grid, starting with the row
-                # in start_row.
-              { # Properties about a dimension.
-                "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
-                "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
-                "hiddenByFilter": True or False, # True if this dimension is being filtered.
-                    # This field is read-only.
-              },
-            ],
-            "startColumn": 42, # The first column this GridData refers to, zero-based.
-            "columnMetadata": [ # Metadata about the requested columns in the grid, starting with the column
-                # in start_column.
-              { # Properties about a dimension.
-                "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
-                "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
-                "hiddenByFilter": True or False, # True if this dimension is being filtered.
-                    # This field is read-only.
-              },
-            ],
-            "rowData": [ # The data in the grid, one entry per row,
-                # starting with the row in startRow.
-                # The values in RowData will correspond to columns starting
-                # at start_column.
-              { # Data about each cell in a row.
-                "values": [ # The values in the row, one per column.
-                  { # Data about a specific cell.
-                    "pivotTable": { # A pivot table. # A pivot table anchored at this cell. The size of pivot table itself
-                        # is computed dynamically based on its data, grouping, filters, values,
-                        # etc. Only the top-left cell of the pivot table contains the pivot table
-                        # definition. The other cells will contain the calculated values of the
-                        # results of the pivot in their effective_value fields.
-                      "valueLayout": "A String", # Whether values should be listed horizontally (as columns)
-                          # or vertically (as rows).
-                      "rows": [ # Each row grouping in the pivot table.
-                        { # A single grouping (either row or column) in a pivot table.
-                          "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
-                          "valueMetadata": [ # Metadata about values in the grouping.
-                            { # Metadata about a value in a pivot grouping.
-                              "collapsed": True or False, # True if the data corresponding to the value is collapsed.
-                              "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
-                                  # (Note that formulaValue is not valid,
-                                  #  because the values will be calculated.)
-                                "numberValue": 3.14, # Represents a double value.
-                                    # Note: Dates, Times and DateTimes are represented as doubles in
-                                    # "serial number" format.
-                                "boolValue": True or False, # Represents a boolean value.
-                                "formulaValue": "A String", # Represents a formula.
-                                "stringValue": "A String", # Represents a string value.
-                                    # Leading single quotes are not included. For example, if the user typed
-                                    # `'123` into the UI, this would be represented as a `stringValue` of
-                                    # `"123"`.
-                                "errorValue": { # An error in a cell. # Represents an error.
-                                    # This field is read-only.
-                                  "message": "A String", # A message with more information about the error
-                                      # (in the spreadsheet's locale).
-                                  "type": "A String", # The type of error.
-                                },
-                              },
-                            },
-                          ],
-                          "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
-                              # If not specified, sorting is alphabetical by this group's values.
-                            "buckets": [ # Determines the bucket from which values are chosen to sort.
-                                #
-                                # For example, in a pivot table with one row group & two column groups,
-                                # the row group can list up to two values. The first value corresponds
-                                # to a value within the first column group, and the second value
-                                # corresponds to a value in the second column group.  If no values
-                                # are listed, this would indicate that the row should be sorted according
-                                # to the "Grand Total" over the column groups. If a single value is listed,
-                                # this would correspond to using the "Total" of that bucket.
-                              { # The kinds of value that a cell in a spreadsheet can have.
-                                "numberValue": 3.14, # Represents a double value.
-                                    # Note: Dates, Times and DateTimes are represented as doubles in
-                                    # "serial number" format.
-                                "boolValue": True or False, # Represents a boolean value.
-                                "formulaValue": "A String", # Represents a formula.
-                                "stringValue": "A String", # Represents a string value.
-                                    # Leading single quotes are not included. For example, if the user typed
-                                    # `'123` into the UI, this would be represented as a `stringValue` of
-                                    # `"123"`.
-                                "errorValue": { # An error in a cell. # Represents an error.
-                                    # This field is read-only.
-                                  "message": "A String", # A message with more information about the error
-                                      # (in the spreadsheet's locale).
-                                  "type": "A String", # The type of error.
-                                },
-                              },
-                            ],
-                            "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
-                                # grouping should be sorted by.
-                          },
-                          "sortOrder": "A String", # The order the values in this group should be sorted.
-                          "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
-                              #
-                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                              # means this group refers to column `C`, whereas the offset `1` would refer
-                              # to column `D`.
-                        },
-                      ],
-                      "source": { # A range on a sheet. # The range the pivot table is reading data from.
-                          # All indexes are zero-based.
-                          # Indexes are half open, e.g the start index is inclusive
-                          # and the end index is exclusive -- [start_index, end_index).
-                          # Missing indexes indicate the range is unbounded on that side.
-                          #
-                          # For example, if `"Sheet1"` is sheet ID 0, then:
-                          #
-                          #   `Sheet1!A1:A1 == sheet_id: 0,
-                          #                   start_row_index: 0, end_row_index: 1,
-                          #                   start_column_index: 0, end_column_index: 1`
-                          #
-                          #   `Sheet1!A3:B4 == sheet_id: 0,
-                          #                   start_row_index: 2, end_row_index: 4,
-                          #                   start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A:B == sheet_id: 0,
-                          #                 start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1!A5:B == sheet_id: 0,
-                          #                  start_row_index: 4,
-                          #                  start_column_index: 0, end_column_index: 2`
-                          #
-                          #   `Sheet1 == sheet_id:0`
-                          #
-                          # The start index must always be less than or equal to the end index.
-                          # If the start index equals the end index, then the range is empty.
-                          # Empty ranges are typically not meaningful and are usually rendered in the
-                          # UI as `#REF!`.
-                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                        "sheetId": 42, # The sheet this range is on.
-                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                      },
-                      "values": [ # A list of values to include in the pivot table.
-                        { # The definition of how a value in a pivot table should be calculated.
-                          "formula": "A String", # A custom formula to calculate the value.  The formula must start
-                              # with an `=` character.
-                          "summarizeFunction": "A String", # A function to summarize the value.
-                              # If formula is set, the only supported values are
-                              # SUM and
-                              # CUSTOM.
-                              # If sourceColumnOffset is set, then `CUSTOM`
-                              # is not supported.
-                          "sourceColumnOffset": 42, # The column offset of the source range that this value reads from.
-                              #
-                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                              # means this value refers to column `C`, whereas the offset `1` would
-                              # refer to column `D`.
-                          "name": "A String", # A name to use for the value. This is only used if formula was set.
-                              # Otherwise, the column name is used.
-                        },
-                      ],
-                      "criteria": { # An optional mapping of filters per source column offset.
-                          #
-                          # The filters will be applied before aggregating data into the pivot table.
-                          # The map's key is the column offset of the source range that you want to
-                          # filter, and the value is the criteria for that column.
-                          #
-                          # For example, if the source was `C10:E15`, a key of `0` will have the filter
-                          # for column `C`, whereas the key `1` is for column `D`.
-                        "a_key": { # Criteria for showing/hiding rows in a pivot table.
-                          "visibleValues": [ # Values that should be included.  Values not listed here are excluded.
-                            "A String",
-                          ],
-                        },
-                      },
-                      "columns": [ # Each column grouping in the pivot table.
-                        { # A single grouping (either row or column) in a pivot table.
-                          "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
-                          "valueMetadata": [ # Metadata about values in the grouping.
-                            { # Metadata about a value in a pivot grouping.
-                              "collapsed": True or False, # True if the data corresponding to the value is collapsed.
-                              "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
-                                  # (Note that formulaValue is not valid,
-                                  #  because the values will be calculated.)
-                                "numberValue": 3.14, # Represents a double value.
-                                    # Note: Dates, Times and DateTimes are represented as doubles in
-                                    # "serial number" format.
-                                "boolValue": True or False, # Represents a boolean value.
-                                "formulaValue": "A String", # Represents a formula.
-                                "stringValue": "A String", # Represents a string value.
-                                    # Leading single quotes are not included. For example, if the user typed
-                                    # `'123` into the UI, this would be represented as a `stringValue` of
-                                    # `"123"`.
-                                "errorValue": { # An error in a cell. # Represents an error.
-                                    # This field is read-only.
-                                  "message": "A String", # A message with more information about the error
-                                      # (in the spreadsheet's locale).
-                                  "type": "A String", # The type of error.
-                                },
-                              },
-                            },
-                          ],
-                          "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
-                              # If not specified, sorting is alphabetical by this group's values.
-                            "buckets": [ # Determines the bucket from which values are chosen to sort.
-                                #
-                                # For example, in a pivot table with one row group & two column groups,
-                                # the row group can list up to two values. The first value corresponds
-                                # to a value within the first column group, and the second value
-                                # corresponds to a value in the second column group.  If no values
-                                # are listed, this would indicate that the row should be sorted according
-                                # to the "Grand Total" over the column groups. If a single value is listed,
-                                # this would correspond to using the "Total" of that bucket.
-                              { # The kinds of value that a cell in a spreadsheet can have.
-                                "numberValue": 3.14, # Represents a double value.
-                                    # Note: Dates, Times and DateTimes are represented as doubles in
-                                    # "serial number" format.
-                                "boolValue": True or False, # Represents a boolean value.
-                                "formulaValue": "A String", # Represents a formula.
-                                "stringValue": "A String", # Represents a string value.
-                                    # Leading single quotes are not included. For example, if the user typed
-                                    # `'123` into the UI, this would be represented as a `stringValue` of
-                                    # `"123"`.
-                                "errorValue": { # An error in a cell. # Represents an error.
-                                    # This field is read-only.
-                                  "message": "A String", # A message with more information about the error
-                                      # (in the spreadsheet's locale).
-                                  "type": "A String", # The type of error.
-                                },
-                              },
-                            ],
-                            "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
-                                # grouping should be sorted by.
-                          },
-                          "sortOrder": "A String", # The order the values in this group should be sorted.
-                          "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
-                              #
-                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                              # means this group refers to column `C`, whereas the offset `1` would refer
-                              # to column `D`.
-                        },
-                      ],
-                    },
-                    "hyperlink": "A String", # A hyperlink this cell points to, if any.
-                        # This field is read-only.  (To set it, use a `=HYPERLINK` formula.)
-                    "effectiveValue": { # The kinds of value that a cell in a spreadsheet can have. # The effective value of the cell. For cells with formulas, this will be
-                        # the calculated value.  For cells with literals, this will be
-                        # the same as the user_entered_value.
-                        # This field is read-only.
-                      "numberValue": 3.14, # Represents a double value.
-                          # Note: Dates, Times and DateTimes are represented as doubles in
-                          # "serial number" format.
-                      "boolValue": True or False, # Represents a boolean value.
-                      "formulaValue": "A String", # Represents a formula.
-                      "stringValue": "A String", # Represents a string value.
-                          # Leading single quotes are not included. For example, if the user typed
-                          # `'123` into the UI, this would be represented as a `stringValue` of
-                          # `"123"`.
-                      "errorValue": { # An error in a cell. # Represents an error.
-                          # This field is read-only.
-                        "message": "A String", # A message with more information about the error
-                            # (in the spreadsheet's locale).
-                        "type": "A String", # The type of error.
-                      },
-                    },
-                    "formattedValue": "A String", # The formatted value of the cell.
-                        # This is the value as it's shown to the user.
-                        # This field is read-only.
-                    "userEnteredValue": { # The kinds of value that a cell in a spreadsheet can have. # The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`
-                        # Note: Dates, Times and DateTimes are represented as doubles in
-                        # serial number format.
-                      "numberValue": 3.14, # Represents a double value.
-                          # Note: Dates, Times and DateTimes are represented as doubles in
-                          # "serial number" format.
-                      "boolValue": True or False, # Represents a boolean value.
-                      "formulaValue": "A String", # Represents a formula.
-                      "stringValue": "A String", # Represents a string value.
-                          # Leading single quotes are not included. For example, if the user typed
-                          # `'123` into the UI, this would be represented as a `stringValue` of
-                          # `"123"`.
-                      "errorValue": { # An error in a cell. # Represents an error.
-                          # This field is read-only.
-                        "message": "A String", # A message with more information about the error
-                            # (in the spreadsheet's locale).
-                        "type": "A String", # The type of error.
-                      },
-                    },
-                    "note": "A String", # Any note on the cell.
-                    "effectiveFormat": { # The format of a cell. # The effective format being used by the cell.
-                        # This includes the results of applying any conditional formatting and,
-                        # if the cell contains a formula, the computed number format.
-                        # If the effective format is the default format, effective format will
-                        # not be written.
-                        # This field is read-only.
-                      "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                        "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                            # the user's locale will be used if necessary for the given type.
-                            # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                            # information about the supported patterns.
-                        "type": "A String", # The type of the number format.
-                            # When writing, this field must be set.
-                      },
-                      "textDirection": "A String", # The direction of the text in the cell.
-                      "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                          # When updating padding, every field must be specified.
-                        "top": 42, # The top padding of the cell.
-                        "right": 42, # The right padding of the cell.
-                        "bottom": 42, # The bottom padding of the cell.
-                        "left": 42, # The left padding of the cell.
-                      },
-                      "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                      "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                          # for simplicity of conversion to/from color representations in various
-                          # languages over compactness; for example, the fields of this representation
-                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                          # method in iOS; and, with just a little work, it can be easily formatted into
-                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                          #
-                          # Example (Java):
-                          #
-                          #      import com.google.type.Color;
-                          #
-                          #      // ...
-                          #      public static java.awt.Color fromProto(Color protocolor) {
-                          #        float alpha = protocolor.hasAlpha()
-                          #            ? protocolor.getAlpha().getValue()
-                          #            : 1.0;
-                          #
-                          #        return new java.awt.Color(
-                          #            protocolor.getRed(),
-                          #            protocolor.getGreen(),
-                          #            protocolor.getBlue(),
-                          #            alpha);
-                          #      }
-                          #
-                          #      public static Color toProto(java.awt.Color color) {
-                          #        float red = (float) color.getRed();
-                          #        float green = (float) color.getGreen();
-                          #        float blue = (float) color.getBlue();
-                          #        float denominator = 255.0;
-                          #        Color.Builder resultBuilder =
-                          #            Color
-                          #                .newBuilder()
-                          #                .setRed(red / denominator)
-                          #                .setGreen(green / denominator)
-                          #                .setBlue(blue / denominator);
-                          #        int alpha = color.getAlpha();
-                          #        if (alpha != 255) {
-                          #          result.setAlpha(
-                          #              FloatValue
-                          #                  .newBuilder()
-                          #                  .setValue(((float) alpha) / denominator)
-                          #                  .build());
-                          #        }
-                          #        return resultBuilder.build();
-                          #      }
-                          #      // ...
-                          #
-                          # Example (iOS / Obj-C):
-                          #
-                          #      // ...
-                          #      static UIColor* fromProto(Color* protocolor) {
-                          #         float red = [protocolor red];
-                          #         float green = [protocolor green];
-                          #         float blue = [protocolor blue];
-                          #         FloatValue* alpha_wrapper = [protocolor alpha];
-                          #         float alpha = 1.0;
-                          #         if (alpha_wrapper != nil) {
-                          #           alpha = [alpha_wrapper value];
-                          #         }
-                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                          #      }
-                          #
-                          #      static Color* toProto(UIColor* color) {
-                          #          CGFloat red, green, blue, alpha;
-                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                          #            return nil;
-                          #          }
-                          #          Color* result = [Color alloc] init];
-                          #          [result setRed:red];
-                          #          [result setGreen:green];
-                          #          [result setBlue:blue];
-                          #          if (alpha <= 0.9999) {
-                          #            [result setAlpha:floatWrapperWithValue(alpha)];
-                          #          }
-                          #          [result autorelease];
-                          #          return result;
-                          #     }
-                          #     // ...
-                          #
-                          #  Example (JavaScript):
-                          #
-                          #     // ...
-                          #
-                          #     var protoToCssColor = function(rgb_color) {
-                          #        var redFrac = rgb_color.red || 0.0;
-                          #        var greenFrac = rgb_color.green || 0.0;
-                          #        var blueFrac = rgb_color.blue || 0.0;
-                          #        var red = Math.floor(redFrac * 255);
-                          #        var green = Math.floor(greenFrac * 255);
-                          #        var blue = Math.floor(blueFrac * 255);
-                          #
-                          #        if (!('alpha' in rgb_color)) {
-                          #           return rgbToCssColor_(red, green, blue);
-                          #        }
-                          #
-                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                          #        var rgbParams = [red, green, blue].join(',');
-                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                          #     };
-                          #
-                          #     var rgbToCssColor_ = function(red, green, blue) {
-                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                          #       var hexString = rgbNumber.toString(16);
-                          #       var missingZeros = 6 - hexString.length;
-                          #       var resultBuilder = ['#'];
-                          #       for (var i = 0; i < missingZeros; i++) {
-                          #          resultBuilder.push('0');
-                          #       }
-                          #       resultBuilder.push(hexString);
-                          #       return resultBuilder.join('');
-                          #     };
-                          #
-                          #     // ...
-                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                            # the final pixel color is defined by the equation:
-                            #
-                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                            #
-                            # This means that a value of 1.0 corresponds to a solid color, whereas
-                            # a value of 0.0 corresponds to a completely transparent color. This
-                            # uses a wrapper message rather than a simple float scalar so that it is
-                            # possible to distinguish between a default value and the value being unset.
-                            # If omitted, this color object is to be rendered as a solid color
-                            # (as if the alpha value had been explicitly given with a value of 1.0).
-                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                      },
-                      "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                      "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                          # Absent values indicate that the field isn't specified.
-                        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                            # for simplicity of conversion to/from color representations in various
-                            # languages over compactness; for example, the fields of this representation
-                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                            # method in iOS; and, with just a little work, it can be easily formatted into
-                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                            #
-                            # Example (Java):
-                            #
-                            #      import com.google.type.Color;
-                            #
-                            #      // ...
-                            #      public static java.awt.Color fromProto(Color protocolor) {
-                            #        float alpha = protocolor.hasAlpha()
-                            #            ? protocolor.getAlpha().getValue()
-                            #            : 1.0;
-                            #
-                            #        return new java.awt.Color(
-                            #            protocolor.getRed(),
-                            #            protocolor.getGreen(),
-                            #            protocolor.getBlue(),
-                            #            alpha);
-                            #      }
-                            #
-                            #      public static Color toProto(java.awt.Color color) {
-                            #        float red = (float) color.getRed();
-                            #        float green = (float) color.getGreen();
-                            #        float blue = (float) color.getBlue();
-                            #        float denominator = 255.0;
-                            #        Color.Builder resultBuilder =
-                            #            Color
-                            #                .newBuilder()
-                            #                .setRed(red / denominator)
-                            #                .setGreen(green / denominator)
-                            #                .setBlue(blue / denominator);
-                            #        int alpha = color.getAlpha();
-                            #        if (alpha != 255) {
-                            #          result.setAlpha(
-                            #              FloatValue
-                            #                  .newBuilder()
-                            #                  .setValue(((float) alpha) / denominator)
-                            #                  .build());
-                            #        }
-                            #        return resultBuilder.build();
-                            #      }
-                            #      // ...
-                            #
-                            # Example (iOS / Obj-C):
-                            #
-                            #      // ...
-                            #      static UIColor* fromProto(Color* protocolor) {
-                            #         float red = [protocolor red];
-                            #         float green = [protocolor green];
-                            #         float blue = [protocolor blue];
-                            #         FloatValue* alpha_wrapper = [protocolor alpha];
-                            #         float alpha = 1.0;
-                            #         if (alpha_wrapper != nil) {
-                            #           alpha = [alpha_wrapper value];
-                            #         }
-                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                            #      }
-                            #
-                            #      static Color* toProto(UIColor* color) {
-                            #          CGFloat red, green, blue, alpha;
-                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                            #            return nil;
-                            #          }
-                            #          Color* result = [Color alloc] init];
-                            #          [result setRed:red];
-                            #          [result setGreen:green];
-                            #          [result setBlue:blue];
-                            #          if (alpha <= 0.9999) {
-                            #            [result setAlpha:floatWrapperWithValue(alpha)];
-                            #          }
-                            #          [result autorelease];
-                            #          return result;
-                            #     }
-                            #     // ...
-                            #
-                            #  Example (JavaScript):
-                            #
-                            #     // ...
-                            #
-                            #     var protoToCssColor = function(rgb_color) {
-                            #        var redFrac = rgb_color.red || 0.0;
-                            #        var greenFrac = rgb_color.green || 0.0;
-                            #        var blueFrac = rgb_color.blue || 0.0;
-                            #        var red = Math.floor(redFrac * 255);
-                            #        var green = Math.floor(greenFrac * 255);
-                            #        var blue = Math.floor(blueFrac * 255);
-                            #
-                            #        if (!('alpha' in rgb_color)) {
-                            #           return rgbToCssColor_(red, green, blue);
-                            #        }
-                            #
-                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                            #        var rgbParams = [red, green, blue].join(',');
-                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                            #     };
-                            #
-                            #     var rgbToCssColor_ = function(red, green, blue) {
-                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                            #       var hexString = rgbNumber.toString(16);
-                            #       var missingZeros = 6 - hexString.length;
-                            #       var resultBuilder = ['#'];
-                            #       for (var i = 0; i < missingZeros; i++) {
-                            #          resultBuilder.push('0');
-                            #       }
-                            #       resultBuilder.push(hexString);
-                            #       return resultBuilder.join('');
-                            #     };
-                            #
-                            #     // ...
-                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                              # the final pixel color is defined by the equation:
-                              #
-                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                              #
-                              # This means that a value of 1.0 corresponds to a solid color, whereas
-                              # a value of 0.0 corresponds to a completely transparent color. This
-                              # uses a wrapper message rather than a simple float scalar so that it is
-                              # possible to distinguish between a default value and the value being unset.
-                              # If omitted, this color object is to be rendered as a solid color
-                              # (as if the alpha value had been explicitly given with a value of 1.0).
-                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                        },
-                        "bold": True or False, # True if the text is bold.
-                        "strikethrough": True or False, # True if the text has a strikethrough.
-                        "fontFamily": "A String", # The font family.
-                        "fontSize": 42, # The size of the font.
-                        "italic": True or False, # True if the text is italicized.
-                        "underline": True or False, # True if the text is underlined.
-                      },
-                      "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                      "borders": { # The borders of the cell. # The borders of the cell.
-                        "top": { # A border along a cell. # The top border of the cell.
-                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "width": 42, # The width of the border, in pixels.
-                              # Deprecated; the width is determined by the "style" field.
-                          "style": "A String", # The style of the border.
-                        },
-                        "right": { # A border along a cell. # The right border of the cell.
-                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "width": 42, # The width of the border, in pixels.
-                              # Deprecated; the width is determined by the "style" field.
-                          "style": "A String", # The style of the border.
-                        },
-                        "bottom": { # A border along a cell. # The bottom border of the cell.
-                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "width": 42, # The width of the border, in pixels.
-                              # Deprecated; the width is determined by the "style" field.
-                          "style": "A String", # The style of the border.
-                        },
-                        "left": { # A border along a cell. # The left border of the cell.
-                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "width": 42, # The width of the border, in pixels.
-                              # Deprecated; the width is determined by the "style" field.
-                          "style": "A String", # The style of the border.
-                        },
-                      },
-                      "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-                    },
-                    "userEnteredFormat": { # The format of a cell. # The format the user entered for the cell.
-                        #
-                        # When writing, the new format will be merged with the existing format.
-                      "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                        "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                            # the user's locale will be used if necessary for the given type.
-                            # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                            # information about the supported patterns.
-                        "type": "A String", # The type of the number format.
-                            # When writing, this field must be set.
-                      },
-                      "textDirection": "A String", # The direction of the text in the cell.
-                      "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                          # When updating padding, every field must be specified.
-                        "top": 42, # The top padding of the cell.
-                        "right": 42, # The right padding of the cell.
-                        "bottom": 42, # The bottom padding of the cell.
-                        "left": 42, # The left padding of the cell.
-                      },
-                      "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                      "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                          # for simplicity of conversion to/from color representations in various
-                          # languages over compactness; for example, the fields of this representation
-                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                          # method in iOS; and, with just a little work, it can be easily formatted into
-                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                          #
-                          # Example (Java):
-                          #
-                          #      import com.google.type.Color;
-                          #
-                          #      // ...
-                          #      public static java.awt.Color fromProto(Color protocolor) {
-                          #        float alpha = protocolor.hasAlpha()
-                          #            ? protocolor.getAlpha().getValue()
-                          #            : 1.0;
-                          #
-                          #        return new java.awt.Color(
-                          #            protocolor.getRed(),
-                          #            protocolor.getGreen(),
-                          #            protocolor.getBlue(),
-                          #            alpha);
-                          #      }
-                          #
-                          #      public static Color toProto(java.awt.Color color) {
-                          #        float red = (float) color.getRed();
-                          #        float green = (float) color.getGreen();
-                          #        float blue = (float) color.getBlue();
-                          #        float denominator = 255.0;
-                          #        Color.Builder resultBuilder =
-                          #            Color
-                          #                .newBuilder()
-                          #                .setRed(red / denominator)
-                          #                .setGreen(green / denominator)
-                          #                .setBlue(blue / denominator);
-                          #        int alpha = color.getAlpha();
-                          #        if (alpha != 255) {
-                          #          result.setAlpha(
-                          #              FloatValue
-                          #                  .newBuilder()
-                          #                  .setValue(((float) alpha) / denominator)
-                          #                  .build());
-                          #        }
-                          #        return resultBuilder.build();
-                          #      }
-                          #      // ...
-                          #
-                          # Example (iOS / Obj-C):
-                          #
-                          #      // ...
-                          #      static UIColor* fromProto(Color* protocolor) {
-                          #         float red = [protocolor red];
-                          #         float green = [protocolor green];
-                          #         float blue = [protocolor blue];
-                          #         FloatValue* alpha_wrapper = [protocolor alpha];
-                          #         float alpha = 1.0;
-                          #         if (alpha_wrapper != nil) {
-                          #           alpha = [alpha_wrapper value];
-                          #         }
-                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                          #      }
-                          #
-                          #      static Color* toProto(UIColor* color) {
-                          #          CGFloat red, green, blue, alpha;
-                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                          #            return nil;
-                          #          }
-                          #          Color* result = [Color alloc] init];
-                          #          [result setRed:red];
-                          #          [result setGreen:green];
-                          #          [result setBlue:blue];
-                          #          if (alpha <= 0.9999) {
-                          #            [result setAlpha:floatWrapperWithValue(alpha)];
-                          #          }
-                          #          [result autorelease];
-                          #          return result;
-                          #     }
-                          #     // ...
-                          #
-                          #  Example (JavaScript):
-                          #
-                          #     // ...
-                          #
-                          #     var protoToCssColor = function(rgb_color) {
-                          #        var redFrac = rgb_color.red || 0.0;
-                          #        var greenFrac = rgb_color.green || 0.0;
-                          #        var blueFrac = rgb_color.blue || 0.0;
-                          #        var red = Math.floor(redFrac * 255);
-                          #        var green = Math.floor(greenFrac * 255);
-                          #        var blue = Math.floor(blueFrac * 255);
-                          #
-                          #        if (!('alpha' in rgb_color)) {
-                          #           return rgbToCssColor_(red, green, blue);
-                          #        }
-                          #
-                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                          #        var rgbParams = [red, green, blue].join(',');
-                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                          #     };
-                          #
-                          #     var rgbToCssColor_ = function(red, green, blue) {
-                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                          #       var hexString = rgbNumber.toString(16);
-                          #       var missingZeros = 6 - hexString.length;
-                          #       var resultBuilder = ['#'];
-                          #       for (var i = 0; i < missingZeros; i++) {
-                          #          resultBuilder.push('0');
-                          #       }
-                          #       resultBuilder.push(hexString);
-                          #       return resultBuilder.join('');
-                          #     };
-                          #
-                          #     // ...
-                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                            # the final pixel color is defined by the equation:
-                            #
-                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                            #
-                            # This means that a value of 1.0 corresponds to a solid color, whereas
-                            # a value of 0.0 corresponds to a completely transparent color. This
-                            # uses a wrapper message rather than a simple float scalar so that it is
-                            # possible to distinguish between a default value and the value being unset.
-                            # If omitted, this color object is to be rendered as a solid color
-                            # (as if the alpha value had been explicitly given with a value of 1.0).
-                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                      },
-                      "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                      "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                          # Absent values indicate that the field isn't specified.
-                        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                            # for simplicity of conversion to/from color representations in various
-                            # languages over compactness; for example, the fields of this representation
-                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                            # method in iOS; and, with just a little work, it can be easily formatted into
-                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                            #
-                            # Example (Java):
-                            #
-                            #      import com.google.type.Color;
-                            #
-                            #      // ...
-                            #      public static java.awt.Color fromProto(Color protocolor) {
-                            #        float alpha = protocolor.hasAlpha()
-                            #            ? protocolor.getAlpha().getValue()
-                            #            : 1.0;
-                            #
-                            #        return new java.awt.Color(
-                            #            protocolor.getRed(),
-                            #            protocolor.getGreen(),
-                            #            protocolor.getBlue(),
-                            #            alpha);
-                            #      }
-                            #
-                            #      public static Color toProto(java.awt.Color color) {
-                            #        float red = (float) color.getRed();
-                            #        float green = (float) color.getGreen();
-                            #        float blue = (float) color.getBlue();
-                            #        float denominator = 255.0;
-                            #        Color.Builder resultBuilder =
-                            #            Color
-                            #                .newBuilder()
-                            #                .setRed(red / denominator)
-                            #                .setGreen(green / denominator)
-                            #                .setBlue(blue / denominator);
-                            #        int alpha = color.getAlpha();
-                            #        if (alpha != 255) {
-                            #          result.setAlpha(
-                            #              FloatValue
-                            #                  .newBuilder()
-                            #                  .setValue(((float) alpha) / denominator)
-                            #                  .build());
-                            #        }
-                            #        return resultBuilder.build();
-                            #      }
-                            #      // ...
-                            #
-                            # Example (iOS / Obj-C):
-                            #
-                            #      // ...
-                            #      static UIColor* fromProto(Color* protocolor) {
-                            #         float red = [protocolor red];
-                            #         float green = [protocolor green];
-                            #         float blue = [protocolor blue];
-                            #         FloatValue* alpha_wrapper = [protocolor alpha];
-                            #         float alpha = 1.0;
-                            #         if (alpha_wrapper != nil) {
-                            #           alpha = [alpha_wrapper value];
-                            #         }
-                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                            #      }
-                            #
-                            #      static Color* toProto(UIColor* color) {
-                            #          CGFloat red, green, blue, alpha;
-                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                            #            return nil;
-                            #          }
-                            #          Color* result = [Color alloc] init];
-                            #          [result setRed:red];
-                            #          [result setGreen:green];
-                            #          [result setBlue:blue];
-                            #          if (alpha <= 0.9999) {
-                            #            [result setAlpha:floatWrapperWithValue(alpha)];
-                            #          }
-                            #          [result autorelease];
-                            #          return result;
-                            #     }
-                            #     // ...
-                            #
-                            #  Example (JavaScript):
-                            #
-                            #     // ...
-                            #
-                            #     var protoToCssColor = function(rgb_color) {
-                            #        var redFrac = rgb_color.red || 0.0;
-                            #        var greenFrac = rgb_color.green || 0.0;
-                            #        var blueFrac = rgb_color.blue || 0.0;
-                            #        var red = Math.floor(redFrac * 255);
-                            #        var green = Math.floor(greenFrac * 255);
-                            #        var blue = Math.floor(blueFrac * 255);
-                            #
-                            #        if (!('alpha' in rgb_color)) {
-                            #           return rgbToCssColor_(red, green, blue);
-                            #        }
-                            #
-                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                            #        var rgbParams = [red, green, blue].join(',');
-                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                            #     };
-                            #
-                            #     var rgbToCssColor_ = function(red, green, blue) {
-                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                            #       var hexString = rgbNumber.toString(16);
-                            #       var missingZeros = 6 - hexString.length;
-                            #       var resultBuilder = ['#'];
-                            #       for (var i = 0; i < missingZeros; i++) {
-                            #          resultBuilder.push('0');
-                            #       }
-                            #       resultBuilder.push(hexString);
-                            #       return resultBuilder.join('');
-                            #     };
-                            #
-                            #     // ...
-                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                              # the final pixel color is defined by the equation:
-                              #
-                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                              #
-                              # This means that a value of 1.0 corresponds to a solid color, whereas
-                              # a value of 0.0 corresponds to a completely transparent color. This
-                              # uses a wrapper message rather than a simple float scalar so that it is
-                              # possible to distinguish between a default value and the value being unset.
-                              # If omitted, this color object is to be rendered as a solid color
-                              # (as if the alpha value had been explicitly given with a value of 1.0).
-                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                        },
-                        "bold": True or False, # True if the text is bold.
-                        "strikethrough": True or False, # True if the text has a strikethrough.
-                        "fontFamily": "A String", # The font family.
-                        "fontSize": 42, # The size of the font.
-                        "italic": True or False, # True if the text is italicized.
-                        "underline": True or False, # True if the text is underlined.
-                      },
-                      "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                      "borders": { # The borders of the cell. # The borders of the cell.
-                        "top": { # A border along a cell. # The top border of the cell.
-                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "width": 42, # The width of the border, in pixels.
-                              # Deprecated; the width is determined by the "style" field.
-                          "style": "A String", # The style of the border.
-                        },
-                        "right": { # A border along a cell. # The right border of the cell.
-                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "width": 42, # The width of the border, in pixels.
-                              # Deprecated; the width is determined by the "style" field.
-                          "style": "A String", # The style of the border.
-                        },
-                        "bottom": { # A border along a cell. # The bottom border of the cell.
-                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "width": 42, # The width of the border, in pixels.
-                              # Deprecated; the width is determined by the "style" field.
-                          "style": "A String", # The style of the border.
-                        },
-                        "left": { # A border along a cell. # The left border of the cell.
-                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "width": 42, # The width of the border, in pixels.
-                              # Deprecated; the width is determined by the "style" field.
-                          "style": "A String", # The style of the border.
-                        },
-                      },
-                      "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-                    },
-                    "dataValidation": { # A data validation rule. # A data validation rule on the cell, if any.
-                        #
-                        # When writing, the new data validation rule will overwrite any prior rule.
-                      "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
-                          # If true, "List" conditions will show a dropdown.
-                      "strict": True or False, # True if invalid data should be rejected.
-                      "inputMessage": "A String", # A message to show the user when adding data to the cell.
-                      "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
-                          # BooleanConditions are used by conditional formatting,
-                          # data validation, and the criteria in filters.
-                        "type": "A String", # The type of condition.
-                        "values": [ # The values of the condition. The number of supported values depends
-                            # on the condition type.  Some support zero values,
-                            # others one or two values,
-                            # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                          { # The value of the condition.
-                            "relativeDate": "A String", # A relative date (based on the current date).
-                                # Valid only if the type is
-                                # DATE_BEFORE,
-                                # DATE_AFTER,
-                                # DATE_ON_OR_BEFORE or
-                                # DATE_ON_OR_AFTER.
-                                #
-                                # Relative dates are not supported in data validation.
-                                # They are supported only in conditional formatting and
-                                # conditional filters.
-                            "userEnteredValue": "A String", # A value the condition is based on.
-                                # The value will be parsed as if the user typed into a cell.
-                                # Formulas are supported (and must begin with an `=`).
-                          },
-                        ],
-                      },
-                    },
-                    "textFormatRuns": [ # Runs of rich text applied to subsections of the cell.  Runs are only valid
-                        # on user entered strings, not formulas, bools, or numbers.
-                        # Runs start at specific indexes in the text and continue until the next
-                        # run. Properties of a run will continue unless explicitly changed
-                        # in a subsequent run (and properties of the first run will continue
-                        # the properties of the cell unless explicitly changed).
-                        #
-                        # When writing, the new runs will overwrite any prior runs.  When writing a
-                        # new user_entered_value, previous runs will be erased.
-                      { # A run of a text format. The format of this run continues until the start
-                          # index of the next run.
-                          # When updating, all fields must be set.
-                        "startIndex": 42, # The character index where this run starts.
-                        "format": { # The format of a run of text in a cell. # The format of this run.  Absent values inherit the cell's format.
-                            # Absent values indicate that the field isn't specified.
-                          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "bold": True or False, # True if the text is bold.
-                          "strikethrough": True or False, # True if the text has a strikethrough.
-                          "fontFamily": "A String", # The font family.
-                          "fontSize": 42, # The size of the font.
-                          "italic": True or False, # True if the text is italicized.
-                          "underline": True or False, # True if the text is underlined.
-                        },
-                      },
-                    ],
-                  },
-                ],
-              },
-            ],
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
           },
-        ],
-        "properties": { # Properties of a sheet. # The properties of the sheet.
-          "sheetType": "A String", # The type of sheet. Defaults to GRID.
-              # This field cannot be changed once set.
-          "index": 42, # The index of the sheet within the spreadsheet.
-              # When adding or updating sheet properties, if this field
-              # is excluded then the sheet will be added or moved to the end
-              # of the sheet list.
-          "title": "A String", # The name of the sheet.
-          "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
-              # (If the sheet is an object sheet, containing a chart or image, then
-              # this field will be absent.)
-              # When writing it is an error to set any grid properties on non-grid sheets.
-            "columnCount": 42, # The number of columns in the grid.
-            "rowCount": 42, # The number of rows in the grid.
-            "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
-            "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
-            "frozenRowCount": 42, # The number of rows that are frozen in the grid.
+          "left": { # A border along a cell. # The border to put at the left of the range.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+        },
+        "cutPaste": { # Moves data from the source to the destination. # Cuts data from one area and pastes it to another.
+          "pasteType": "A String", # What kind of data to paste.  All the source data will be cut, regardless
+              # of what is pasted.
+          "source": { # A range on a sheet. # The source data to cut.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "destination": { # A coordinate in a sheet. # The top-left coordinate where the data should be pasted.
+              # All indexes are zero-based.
+            "rowIndex": 42, # The row index of the coordinate.
+            "columnIndex": 42, # The column index of the coordinate.
+            "sheetId": 42, # The sheet this coordinate is on.
           },
-          "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
-          "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
-              # for simplicity of conversion to/from color representations in various
-              # languages over compactness; for example, the fields of this representation
-              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-              # method in iOS; and, with just a little work, it can be easily formatted into
-              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+        },
+        "copyPaste": { # Copies data from the source to the destination. # Copies data from one area and pastes it to another.
+          "pasteType": "A String", # What kind of data to paste.
+          "source": { # A range on a sheet. # The source range to copy.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
               #
-              # Example (Java):
+              # For example, if `"Sheet1"` is sheet ID 0, then:
               #
-              #      import com.google.type.Color;
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
               #
-              #      // ...
-              #      public static java.awt.Color fromProto(Color protocolor) {
-              #        float alpha = protocolor.hasAlpha()
-              #            ? protocolor.getAlpha().getValue()
-              #            : 1.0;
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
               #
-              #        return new java.awt.Color(
-              #            protocolor.getRed(),
-              #            protocolor.getGreen(),
-              #            protocolor.getBlue(),
-              #            alpha);
-              #      }
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
               #
-              #      public static Color toProto(java.awt.Color color) {
-              #        float red = (float) color.getRed();
-              #        float green = (float) color.getGreen();
-              #        float blue = (float) color.getBlue();
-              #        float denominator = 255.0;
-              #        Color.Builder resultBuilder =
-              #            Color
-              #                .newBuilder()
-              #                .setRed(red / denominator)
-              #                .setGreen(green / denominator)
-              #                .setBlue(blue / denominator);
-              #        int alpha = color.getAlpha();
-              #        if (alpha != 255) {
-              #          result.setAlpha(
-              #              FloatValue
-              #                  .newBuilder()
-              #                  .setValue(((float) alpha) / denominator)
-              #                  .build());
-              #        }
-              #        return resultBuilder.build();
-              #      }
-              #      // ...
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
               #
-              # Example (iOS / Obj-C):
+              #   `Sheet1 == sheet_id:0`
               #
-              #      // ...
-              #      static UIColor* fromProto(Color* protocolor) {
-              #         float red = [protocolor red];
-              #         float green = [protocolor green];
-              #         float blue = [protocolor blue];
-              #         FloatValue* alpha_wrapper = [protocolor alpha];
-              #         float alpha = 1.0;
-              #         if (alpha_wrapper != nil) {
-              #           alpha = [alpha_wrapper value];
-              #         }
-              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-              #      }
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "destination": { # A range on a sheet. # The location to paste to. If the range covers a span that's
+              # a multiple of the source's height or width, then the
+              # data will be repeated to fill in the destination range.
+              # If the range is smaller than the source range, the entire
+              # source data will still be copied (beyond the end of the destination range).
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
               #
-              #      static Color* toProto(UIColor* color) {
-              #          CGFloat red, green, blue, alpha;
-              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-              #            return nil;
-              #          }
-              #          Color* result = [Color alloc] init];
-              #          [result setRed:red];
-              #          [result setGreen:green];
-              #          [result setBlue:blue];
-              #          if (alpha <= 0.9999) {
-              #            [result setAlpha:floatWrapperWithValue(alpha)];
-              #          }
-              #          [result autorelease];
-              #          return result;
-              #     }
-              #     // ...
+              # For example, if `"Sheet1"` is sheet ID 0, then:
               #
-              #  Example (JavaScript):
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
               #
-              #     // ...
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
               #
-              #     var protoToCssColor = function(rgb_color) {
-              #        var redFrac = rgb_color.red || 0.0;
-              #        var greenFrac = rgb_color.green || 0.0;
-              #        var blueFrac = rgb_color.blue || 0.0;
-              #        var red = Math.floor(redFrac * 255);
-              #        var green = Math.floor(greenFrac * 255);
-              #        var blue = Math.floor(blueFrac * 255);
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
               #
-              #        if (!('alpha' in rgb_color)) {
-              #           return rgbToCssColor_(red, green, blue);
-              #        }
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
               #
-              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-              #        var rgbParams = [red, green, blue].join(',');
-              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-              #     };
+              #   `Sheet1 == sheet_id:0`
               #
-              #     var rgbToCssColor_ = function(red, green, blue) {
-              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-              #       var hexString = rgbNumber.toString(16);
-              #       var missingZeros = 6 - hexString.length;
-              #       var resultBuilder = ['#'];
-              #       for (var i = 0; i < missingZeros; i++) {
-              #          resultBuilder.push('0');
-              #       }
-              #       resultBuilder.push(hexString);
-              #       return resultBuilder.join('');
-              #     };
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "pasteOrientation": "A String", # How that data should be oriented when pasting.
+        },
+        "addSheet": { # Adds a new sheet. # Adds a sheet.
+            # When a sheet is added at a given index,
+            # all subsequent sheets' indexes are incremented.
+            # To add an object sheet, use AddChartRequest instead and specify
+            # EmbeddedObjectPosition.sheetId or
+            # EmbeddedObjectPosition.newSheet.
+          "properties": { # Properties of a sheet. # The properties the new sheet should have.
+              # All properties are optional.
+              # The sheetId field is optional; if one is not
+              # set, an id will be randomly generated. (It is an error to specify the ID
+              # of a sheet that already exists.)
+            "sheetType": "A String", # The type of sheet. Defaults to GRID.
+                # This field cannot be changed once set.
+            "index": 42, # The index of the sheet within the spreadsheet.
+                # When adding or updating sheet properties, if this field
+                # is excluded then the sheet will be added or moved to the end
+                # of the sheet list. When updating sheet indices or inserting
+                # sheets, movement is considered in "before the move" indexes.
+                # For example, if there were 3 sheets (S1, S2, S3) in order to
+                # move S1 ahead of S2 the index would have to be set to 2. A sheet
+                # index update request will be ignored if the requested index is
+                # identical to the sheets current index or if the requested new
+                # index is equal to the current sheet index + 1.
+            "title": "A String", # The name of the sheet.
+            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
+                # (If the sheet is an object sheet, containing a chart or image, then
+                # this field will be absent.)
+                # When writing it is an error to set any grid properties on non-grid sheets.
+              "columnCount": 42, # The number of columns in the grid.
+              "rowCount": 42, # The number of rows in the grid.
+              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
+              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
+              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
+            },
+            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
+            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
+            "sheetId": 42, # The ID of the sheet. Must be non-negative.
+                # This field cannot be changed once set.
+          },
+        },
+        "deleteNamedRange": { # Removes the named range with the given ID from the spreadsheet. # Deletes a named range.
+          "namedRangeId": "A String", # The ID of the named range to delete.
+        },
+        "updateNamedRange": { # Updates properties of the named range with the specified # Updates a named range.
+            # namedRangeId.
+          "fields": "A String", # The fields that should be updated.  At least one field must be specified.
+              # The root `namedRange` is implied and should not be specified.
+              # A single `"*"` can be used as short-hand for listing every field.
+          "namedRange": { # A named range. # The named range to update with the new properties.
+            "namedRangeId": "A String", # The ID of the named range.
+            "range": { # A range on a sheet. # The range this represents.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "name": "A String", # The name of the named range.
+          },
+        },
+        "insertDimension": { # Inserts rows or columns in a sheet at a particular index. # Inserts new rows or columns in a sheet.
+          "inheritFromBefore": True or False, # Whether dimension properties should be extended from the dimensions
+              # before or after the newly inserted dimensions.
+              # True to inherit from the dimensions before (in which case the start
+              # index must be greater than 0), and false to inherit from the dimensions
+              # after.
               #
-              #     // ...
-            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                # the final pixel color is defined by the equation:
+              # For example, if row index 0 has red background and row index 1
+              # has a green background, then inserting 2 rows at index 1 can inherit
+              # either the green or red background.  If `inheritFromBefore` is true,
+              # the two new rows will be red (because the row before the insertion point
+              # was red), whereas if `inheritFromBefore` is false, the two new rows will
+              # be green (because the row after the insertion point was green).
+          "range": { # A range along a single dimension on a sheet. # The dimensions to insert.  Both the start and end indexes must be bounded.
+              # All indexes are zero-based.
+              # Indexes are half open: the start index is inclusive
+              # and the end index is exclusive.
+              # Missing indexes indicate the range is unbounded on that side.
+            "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded.
+            "startIndex": 42, # The start (inclusive) of the span, or not set if unbounded.
+            "sheetId": 42, # The sheet this span is on.
+            "dimension": "A String", # The dimension of the span.
+          },
+        },
+        "updateFilterView": { # Updates properties of the filter view. # Updates the properties of a filter view.
+          "filter": { # A filter view. # The new properties of the filter view.
+            "title": "A String", # The name of the filter view.
+            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
                 #
-                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "filterViewId": 42, # The ID of the filter view.
+            "range": { # A range on a sheet. # The range this filter view covers.
                 #
-                # This means that a value of 1.0 corresponds to a solid color, whereas
-                # a value of 0.0 corresponds to a completely transparent color. This
-                # uses a wrapper message rather than a simple float scalar so that it is
-                # possible to distinguish between a default value and the value being unset.
-                # If omitted, this color object is to be rendered as a solid color
-                # (as if the alpha value had been explicitly given with a value of 1.0).
-            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "sortSpecs": [ # The sort order per column. Later specifications are used when values
+                # are equal in the earlier specifications.
+              { # A sort order associated with a specific column or row.
+                "sortOrder": "A String", # The order data should be sorted.
+                "dimensionIndex": 42, # The dimension the sort should be applied to.
+              },
+            ],
+            "criteria": { # The criteria for showing/hiding values per column.
+                # The map's key is the column index, and the value is the criteria for
+                # that column.
+              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+                "hiddenValues": [ # Values that should be hidden.
+                  "A String",
+                ],
+                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                    # (This does not override hiddenValues -- if a value is listed there,
+                    #  it will still be hidden.)
+                    # BooleanConditions are used by conditional formatting,
+                    # data validation, and the criteria in filters.
+                  "type": "A String", # The type of condition.
+                  "values": [ # The values of the condition. The number of supported values depends
+                      # on the condition type.  Some support zero values,
+                      # others one or two values,
+                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                    { # The value of the condition.
+                      "relativeDate": "A String", # A relative date (based on the current date).
+                          # Valid only if the type is
+                          # DATE_BEFORE,
+                          # DATE_AFTER,
+                          # DATE_ON_OR_BEFORE or
+                          # DATE_ON_OR_AFTER.
+                          #
+                          # Relative dates are not supported in data validation.
+                          # They are supported only in conditional formatting and
+                          # conditional filters.
+                      "userEnteredValue": "A String", # A value the condition is based on.
+                          # The value will be parsed as if the user typed into a cell.
+                          # Formulas are supported (and must begin with an `=`).
+                    },
+                  ],
+                },
+              },
+            },
           },
-          "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
-          "sheetId": 42, # The ID of the sheet. Must be non-negative.
-              # This field cannot be changed once set.
+          "fields": "A String", # The fields that should be updated.  At least one field must be specified.
+              # The root `filter` is implied and should not be specified.
+              # A single `"*"` can be used as short-hand for listing every field.
+        },
+        "deleteConditionalFormatRule": { # Deletes a conditional format rule at the given index. # Deletes an existing conditional format rule.
+            # All subsequent rules' indexes are decremented.
+          "index": 42, # The zero-based index of the rule to be deleted.
+          "sheetId": 42, # The sheet the rule is being deleted from.
         },
       },
     ],
@@ -23776,7 +15656,10 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Resource that represents a spreadsheet.
+    { # The reply for batch updating a spreadsheet.
+    "spreadsheetId": "A String", # The spreadsheet the updates were applied to.
+    "updatedSpreadsheet": { # Resource that represents a spreadsheet. # The spreadsheet after updates were applied. This is only set if
+        # [BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response] is `true`.
       "spreadsheetId": "A String", # The ID of the spreadsheet.
           # This field is read-only.
       "namedRanges": [ # The named ranges defined in a spreadsheet.
@@ -25857,133 +17740,1253 @@ <h3>Method Details</h3>
                       # method in iOS; and, with just a little work, it can be easily formatted into
                       # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                       #
-                      # Example (Java):
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "type": "A String", # How the value should be interpreted.
+                  "value": "A String", # The value this interpolation point uses.  May be a formula.
+                      # Unused if type is MIN or
+                      # MAX.
+                },
+              },
+            },
+          ],
+          "bandedRanges": [ # The banded (i.e. alternating colors) ranges on this sheet.
+            { # A banded (alternating colors) range in a sheet.
+              "range": { # A range on a sheet. # The range over which these properties are applied.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+              "columnProperties": { # Properties referring a single dimension (either row or column). If both # Properties for column bands. These properties will be applied on a column-
+                  # by-column basis throughout all the columns in the range. At least one of
+                  # row_properties or column_properties must be specified.
+                  # BandedRange.row_properties and BandedRange.column_properties are
+                  # set, the fill colors are applied to cells according to the following rules:
+                  #
+                  # * header_color and footer_color take priority over band colors.
+                  # * first_band_color takes priority over second_band_color.
+                  # * row_properties takes priority over column_properties.
+                  #
+                  # For example, the first row color takes priority over the first column
+                  # color, but the first column color takes priority over the second row color.
+                  # Similarly, the row header takes priority over the column header in the
+                  # top left cell, but the column header takes priority over the first row
+                  # color if the row header is not set.
+                "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                       #
-                      #      import com.google.type.Color;
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                    # row or column will be filled with this color and the colors will
+                    # alternate between first_band_color and second_band_color starting
+                    # from the second row or column. Otherwise, the first row or column will be
+                    # filled with first_band_color and the colors will proceed to alternate
+                    # as they normally would.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      #      // ...
-                      #      public static java.awt.Color fromProto(Color protocolor) {
-                      #        float alpha = protocolor.hasAlpha()
-                      #            ? protocolor.getAlpha().getValue()
-                      #            : 1.0;
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                       #
-                      #        return new java.awt.Color(
-                      #            protocolor.getRed(),
-                      #            protocolor.getGreen(),
-                      #            protocolor.getBlue(),
-                      #            alpha);
-                      #      }
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                    # row or column will be filled with either first_band_color or
+                    # second_band_color, depending on the color of the previous row or
+                    # column.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      #      public static Color toProto(java.awt.Color color) {
-                      #        float red = (float) color.getRed();
-                      #        float green = (float) color.getGreen();
-                      #        float blue = (float) color.getBlue();
-                      #        float denominator = 255.0;
-                      #        Color.Builder resultBuilder =
-                      #            Color
-                      #                .newBuilder()
-                      #                .setRed(red / denominator)
-                      #                .setGreen(green / denominator)
-                      #                .setBlue(blue / denominator);
-                      #        int alpha = color.getAlpha();
-                      #        if (alpha != 255) {
-                      #          result.setAlpha(
-                      #              FloatValue
-                      #                  .newBuilder()
-                      #                  .setValue(((float) alpha) / denominator)
-                      #                  .build());
-                      #        }
-                      #        return resultBuilder.build();
-                      #      }
-                      #      // ...
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                       #
-                      # Example (iOS / Obj-C):
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      #      // ...
-                      #      static UIColor* fromProto(Color* protocolor) {
-                      #         float red = [protocolor red];
-                      #         float green = [protocolor green];
-                      #         float blue = [protocolor blue];
-                      #         FloatValue* alpha_wrapper = [protocolor alpha];
-                      #         float alpha = 1.0;
-                      #         if (alpha_wrapper != nil) {
-                      #           alpha = [alpha_wrapper value];
-                      #         }
-                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                      #      }
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+              },
+              "rowProperties": { # Properties referring a single dimension (either row or column). If both # Properties for row bands. These properties will be applied on a row-by-row
+                  # basis throughout all the rows in the range. At least one of
+                  # row_properties or column_properties must be specified.
+                  # BandedRange.row_properties and BandedRange.column_properties are
+                  # set, the fill colors are applied to cells according to the following rules:
+                  #
+                  # * header_color and footer_color take priority over band colors.
+                  # * first_band_color takes priority over second_band_color.
+                  # * row_properties takes priority over column_properties.
+                  #
+                  # For example, the first row color takes priority over the first column
+                  # color, but the first column color takes priority over the second row color.
+                  # Similarly, the row header takes priority over the column header in the
+                  # top left cell, but the column header takes priority over the first row
+                  # color if the row header is not set.
+                "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      #      static Color* toProto(UIColor* color) {
-                      #          CGFloat red, green, blue, alpha;
-                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                      #            return nil;
-                      #          }
-                      #          Color* result = [Color alloc] init];
-                      #          [result setRed:red];
-                      #          [result setGreen:green];
-                      #          [result setBlue:blue];
-                      #          if (alpha <= 0.9999) {
-                      #            [result setAlpha:floatWrapperWithValue(alpha)];
-                      #          }
-                      #          [result autorelease];
-                      #          return result;
-                      #     }
-                      #     // ...
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                       #
-                      #  Example (JavaScript):
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                    # row or column will be filled with this color and the colors will
+                    # alternate between first_band_color and second_band_color starting
+                    # from the second row or column. Otherwise, the first row or column will be
+                    # filled with first_band_color and the colors will proceed to alternate
+                    # as they normally would.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      #     // ...
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                       #
-                      #     var protoToCssColor = function(rgb_color) {
-                      #        var redFrac = rgb_color.red || 0.0;
-                      #        var greenFrac = rgb_color.green || 0.0;
-                      #        var blueFrac = rgb_color.blue || 0.0;
-                      #        var red = Math.floor(redFrac * 255);
-                      #        var green = Math.floor(greenFrac * 255);
-                      #        var blue = Math.floor(blueFrac * 255);
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                    # row or column will be filled with either first_band_color or
+                    # second_band_color, depending on the color of the previous row or
+                    # column.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      #        if (!('alpha' in rgb_color)) {
-                      #           return rgbToCssColor_(red, green, blue);
-                      #        }
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                       #
-                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                      #        var rgbParams = [red, green, blue].join(',');
-                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                      #     };
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      #     var rgbToCssColor_ = function(red, green, blue) {
-                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                      #       var hexString = rgbNumber.toString(16);
-                      #       var missingZeros = 6 - hexString.length;
-                      #       var resultBuilder = ['#'];
-                      #       for (var i = 0; i < missingZeros; i++) {
-                      #          resultBuilder.push('0');
-                      #       }
-                      #       resultBuilder.push(hexString);
-                      #       return resultBuilder.join('');
-                      #     };
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                       #
-                      #     // ...
-                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                        # the final pixel color is defined by the equation:
-                        #
-                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                        #
-                        # This means that a value of 1.0 corresponds to a solid color, whereas
-                        # a value of 0.0 corresponds to a completely transparent color. This
-                        # uses a wrapper message rather than a simple float scalar so that it is
-                        # possible to distinguish between a default value and the value being unset.
-                        # If omitted, this color object is to be rendered as a solid color
-                        # (as if the alpha value had been explicitly given with a value of 1.0).
-                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                  },
-                  "type": "A String", # How the value should be interpreted.
-                  "value": "A String", # The value this interpolation point uses.  May be a formula.
-                      # Unused if type is MIN or
-                      # MAX.
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                 },
               },
+              "bandedRangeId": 42, # The id of the banded range.
             },
           ],
           "merges": [ # The ranges that are merged together.
@@ -26831,229 +19834,1058 @@ <h3>Method Details</h3>
                                 # If not specified, sorting is alphabetical by this group's values.
                               "buckets": [ # Determines the bucket from which values are chosen to sort.
                                   #
-                                  # For example, in a pivot table with one row group & two column groups,
-                                  # the row group can list up to two values. The first value corresponds
-                                  # to a value within the first column group, and the second value
-                                  # corresponds to a value in the second column group.  If no values
-                                  # are listed, this would indicate that the row should be sorted according
-                                  # to the "Grand Total" over the column groups. If a single value is listed,
-                                  # this would correspond to using the "Total" of that bucket.
-                                { # The kinds of value that a cell in a spreadsheet can have.
-                                  "numberValue": 3.14, # Represents a double value.
-                                      # Note: Dates, Times and DateTimes are represented as doubles in
-                                      # "serial number" format.
-                                  "boolValue": True or False, # Represents a boolean value.
-                                  "formulaValue": "A String", # Represents a formula.
-                                  "stringValue": "A String", # Represents a string value.
-                                      # Leading single quotes are not included. For example, if the user typed
-                                      # `'123` into the UI, this would be represented as a `stringValue` of
-                                      # `"123"`.
-                                  "errorValue": { # An error in a cell. # Represents an error.
-                                      # This field is read-only.
-                                    "message": "A String", # A message with more information about the error
-                                        # (in the spreadsheet's locale).
-                                    "type": "A String", # The type of error.
-                                  },
-                                },
-                              ],
-                              "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
-                                  # grouping should be sorted by.
+                                  # For example, in a pivot table with one row group & two column groups,
+                                  # the row group can list up to two values. The first value corresponds
+                                  # to a value within the first column group, and the second value
+                                  # corresponds to a value in the second column group.  If no values
+                                  # are listed, this would indicate that the row should be sorted according
+                                  # to the "Grand Total" over the column groups. If a single value is listed,
+                                  # this would correspond to using the "Total" of that bucket.
+                                { # The kinds of value that a cell in a spreadsheet can have.
+                                  "numberValue": 3.14, # Represents a double value.
+                                      # Note: Dates, Times and DateTimes are represented as doubles in
+                                      # "serial number" format.
+                                  "boolValue": True or False, # Represents a boolean value.
+                                  "formulaValue": "A String", # Represents a formula.
+                                  "stringValue": "A String", # Represents a string value.
+                                      # Leading single quotes are not included. For example, if the user typed
+                                      # `'123` into the UI, this would be represented as a `stringValue` of
+                                      # `"123"`.
+                                  "errorValue": { # An error in a cell. # Represents an error.
+                                      # This field is read-only.
+                                    "message": "A String", # A message with more information about the error
+                                        # (in the spreadsheet's locale).
+                                    "type": "A String", # The type of error.
+                                  },
+                                },
+                              ],
+                              "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
+                                  # grouping should be sorted by.
+                            },
+                            "sortOrder": "A String", # The order the values in this group should be sorted.
+                            "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                                #
+                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                                # means this group refers to column `C`, whereas the offset `1` would refer
+                                # to column `D`.
+                          },
+                        ],
+                        "source": { # A range on a sheet. # The range the pivot table is reading data from.
+                            # All indexes are zero-based.
+                            # Indexes are half open, e.g the start index is inclusive
+                            # and the end index is exclusive -- [start_index, end_index).
+                            # Missing indexes indicate the range is unbounded on that side.
+                            #
+                            # For example, if `"Sheet1"` is sheet ID 0, then:
+                            #
+                            #   `Sheet1!A1:A1 == sheet_id: 0,
+                            #                   start_row_index: 0, end_row_index: 1,
+                            #                   start_column_index: 0, end_column_index: 1`
+                            #
+                            #   `Sheet1!A3:B4 == sheet_id: 0,
+                            #                   start_row_index: 2, end_row_index: 4,
+                            #                   start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1!A:B == sheet_id: 0,
+                            #                 start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1!A5:B == sheet_id: 0,
+                            #                  start_row_index: 4,
+                            #                  start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1 == sheet_id:0`
+                            #
+                            # The start index must always be less than or equal to the end index.
+                            # If the start index equals the end index, then the range is empty.
+                            # Empty ranges are typically not meaningful and are usually rendered in the
+                            # UI as `#REF!`.
+                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                          "sheetId": 42, # The sheet this range is on.
+                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                        },
+                        "values": [ # A list of values to include in the pivot table.
+                          { # The definition of how a value in a pivot table should be calculated.
+                            "formula": "A String", # A custom formula to calculate the value.  The formula must start
+                                # with an `=` character.
+                            "summarizeFunction": "A String", # A function to summarize the value.
+                                # If formula is set, the only supported values are
+                                # SUM and
+                                # CUSTOM.
+                                # If sourceColumnOffset is set, then `CUSTOM`
+                                # is not supported.
+                            "sourceColumnOffset": 42, # The column offset of the source range that this value reads from.
+                                #
+                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                                # means this value refers to column `C`, whereas the offset `1` would
+                                # refer to column `D`.
+                            "name": "A String", # A name to use for the value. This is only used if formula was set.
+                                # Otherwise, the column name is used.
+                          },
+                        ],
+                        "criteria": { # An optional mapping of filters per source column offset.
+                            #
+                            # The filters will be applied before aggregating data into the pivot table.
+                            # The map's key is the column offset of the source range that you want to
+                            # filter, and the value is the criteria for that column.
+                            #
+                            # For example, if the source was `C10:E15`, a key of `0` will have the filter
+                            # for column `C`, whereas the key `1` is for column `D`.
+                          "a_key": { # Criteria for showing/hiding rows in a pivot table.
+                            "visibleValues": [ # Values that should be included.  Values not listed here are excluded.
+                              "A String",
+                            ],
+                          },
+                        },
+                        "columns": [ # Each column grouping in the pivot table.
+                          { # A single grouping (either row or column) in a pivot table.
+                            "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
+                            "valueMetadata": [ # Metadata about values in the grouping.
+                              { # Metadata about a value in a pivot grouping.
+                                "collapsed": True or False, # True if the data corresponding to the value is collapsed.
+                                "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
+                                    # (Note that formulaValue is not valid,
+                                    #  because the values will be calculated.)
+                                  "numberValue": 3.14, # Represents a double value.
+                                      # Note: Dates, Times and DateTimes are represented as doubles in
+                                      # "serial number" format.
+                                  "boolValue": True or False, # Represents a boolean value.
+                                  "formulaValue": "A String", # Represents a formula.
+                                  "stringValue": "A String", # Represents a string value.
+                                      # Leading single quotes are not included. For example, if the user typed
+                                      # `'123` into the UI, this would be represented as a `stringValue` of
+                                      # `"123"`.
+                                  "errorValue": { # An error in a cell. # Represents an error.
+                                      # This field is read-only.
+                                    "message": "A String", # A message with more information about the error
+                                        # (in the spreadsheet's locale).
+                                    "type": "A String", # The type of error.
+                                  },
+                                },
+                              },
+                            ],
+                            "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
+                                # If not specified, sorting is alphabetical by this group's values.
+                              "buckets": [ # Determines the bucket from which values are chosen to sort.
+                                  #
+                                  # For example, in a pivot table with one row group & two column groups,
+                                  # the row group can list up to two values. The first value corresponds
+                                  # to a value within the first column group, and the second value
+                                  # corresponds to a value in the second column group.  If no values
+                                  # are listed, this would indicate that the row should be sorted according
+                                  # to the "Grand Total" over the column groups. If a single value is listed,
+                                  # this would correspond to using the "Total" of that bucket.
+                                { # The kinds of value that a cell in a spreadsheet can have.
+                                  "numberValue": 3.14, # Represents a double value.
+                                      # Note: Dates, Times and DateTimes are represented as doubles in
+                                      # "serial number" format.
+                                  "boolValue": True or False, # Represents a boolean value.
+                                  "formulaValue": "A String", # Represents a formula.
+                                  "stringValue": "A String", # Represents a string value.
+                                      # Leading single quotes are not included. For example, if the user typed
+                                      # `'123` into the UI, this would be represented as a `stringValue` of
+                                      # `"123"`.
+                                  "errorValue": { # An error in a cell. # Represents an error.
+                                      # This field is read-only.
+                                    "message": "A String", # A message with more information about the error
+                                        # (in the spreadsheet's locale).
+                                    "type": "A String", # The type of error.
+                                  },
+                                },
+                              ],
+                              "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
+                                  # grouping should be sorted by.
+                            },
+                            "sortOrder": "A String", # The order the values in this group should be sorted.
+                            "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                                #
+                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                                # means this group refers to column `C`, whereas the offset `1` would refer
+                                # to column `D`.
+                          },
+                        ],
+                      },
+                      "hyperlink": "A String", # A hyperlink this cell points to, if any.
+                          # This field is read-only.  (To set it, use a `=HYPERLINK` formula.)
+                      "effectiveValue": { # The kinds of value that a cell in a spreadsheet can have. # The effective value of the cell. For cells with formulas, this will be
+                          # the calculated value.  For cells with literals, this will be
+                          # the same as the user_entered_value.
+                          # This field is read-only.
+                        "numberValue": 3.14, # Represents a double value.
+                            # Note: Dates, Times and DateTimes are represented as doubles in
+                            # "serial number" format.
+                        "boolValue": True or False, # Represents a boolean value.
+                        "formulaValue": "A String", # Represents a formula.
+                        "stringValue": "A String", # Represents a string value.
+                            # Leading single quotes are not included. For example, if the user typed
+                            # `'123` into the UI, this would be represented as a `stringValue` of
+                            # `"123"`.
+                        "errorValue": { # An error in a cell. # Represents an error.
+                            # This field is read-only.
+                          "message": "A String", # A message with more information about the error
+                              # (in the spreadsheet's locale).
+                          "type": "A String", # The type of error.
+                        },
+                      },
+                      "formattedValue": "A String", # The formatted value of the cell.
+                          # This is the value as it's shown to the user.
+                          # This field is read-only.
+                      "userEnteredValue": { # The kinds of value that a cell in a spreadsheet can have. # The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`
+                          # Note: Dates, Times and DateTimes are represented as doubles in
+                          # serial number format.
+                        "numberValue": 3.14, # Represents a double value.
+                            # Note: Dates, Times and DateTimes are represented as doubles in
+                            # "serial number" format.
+                        "boolValue": True or False, # Represents a boolean value.
+                        "formulaValue": "A String", # Represents a formula.
+                        "stringValue": "A String", # Represents a string value.
+                            # Leading single quotes are not included. For example, if the user typed
+                            # `'123` into the UI, this would be represented as a `stringValue` of
+                            # `"123"`.
+                        "errorValue": { # An error in a cell. # Represents an error.
+                            # This field is read-only.
+                          "message": "A String", # A message with more information about the error
+                              # (in the spreadsheet's locale).
+                          "type": "A String", # The type of error.
+                        },
+                      },
+                      "note": "A String", # Any note on the cell.
+                      "effectiveFormat": { # The format of a cell. # The effective format being used by the cell.
+                          # This includes the results of applying any conditional formatting and,
+                          # if the cell contains a formula, the computed number format.
+                          # If the effective format is the default format, effective format will
+                          # not be written.
+                          # This field is read-only.
+                        "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                          "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                              # the user's locale will be used if necessary for the given type.
+                              # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                              # information about the supported patterns.
+                          "type": "A String", # The type of the number format.
+                              # When writing, this field must be set.
+                        },
+                        "textDirection": "A String", # The direction of the text in the cell.
+                        "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                            # When updating padding, every field must be specified.
+                          "top": 42, # The top padding of the cell.
+                          "right": 42, # The right padding of the cell.
+                          "bottom": 42, # The bottom padding of the cell.
+                          "left": 42, # The left padding of the cell.
+                        },
+                        "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                        "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                        "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                            # Absent values indicate that the field isn't specified.
+                          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "bold": True or False, # True if the text is bold.
+                          "strikethrough": True or False, # True if the text has a strikethrough.
+                          "fontFamily": "A String", # The font family.
+                          "fontSize": 42, # The size of the font.
+                          "italic": True or False, # True if the text is italicized.
+                          "underline": True or False, # True if the text is underlined.
+                        },
+                        "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                        "borders": { # The borders of the cell. # The borders of the cell.
+                          "top": { # A border along a cell. # The top border of the cell.
+                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                                # for simplicity of conversion to/from color representations in various
+                                # languages over compactness; for example, the fields of this representation
+                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                                # method in iOS; and, with just a little work, it can be easily formatted into
+                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                                #
+                                # Example (Java):
+                                #
+                                #      import com.google.type.Color;
+                                #
+                                #      // ...
+                                #      public static java.awt.Color fromProto(Color protocolor) {
+                                #        float alpha = protocolor.hasAlpha()
+                                #            ? protocolor.getAlpha().getValue()
+                                #            : 1.0;
+                                #
+                                #        return new java.awt.Color(
+                                #            protocolor.getRed(),
+                                #            protocolor.getGreen(),
+                                #            protocolor.getBlue(),
+                                #            alpha);
+                                #      }
+                                #
+                                #      public static Color toProto(java.awt.Color color) {
+                                #        float red = (float) color.getRed();
+                                #        float green = (float) color.getGreen();
+                                #        float blue = (float) color.getBlue();
+                                #        float denominator = 255.0;
+                                #        Color.Builder resultBuilder =
+                                #            Color
+                                #                .newBuilder()
+                                #                .setRed(red / denominator)
+                                #                .setGreen(green / denominator)
+                                #                .setBlue(blue / denominator);
+                                #        int alpha = color.getAlpha();
+                                #        if (alpha != 255) {
+                                #          result.setAlpha(
+                                #              FloatValue
+                                #                  .newBuilder()
+                                #                  .setValue(((float) alpha) / denominator)
+                                #                  .build());
+                                #        }
+                                #        return resultBuilder.build();
+                                #      }
+                                #      // ...
+                                #
+                                # Example (iOS / Obj-C):
+                                #
+                                #      // ...
+                                #      static UIColor* fromProto(Color* protocolor) {
+                                #         float red = [protocolor red];
+                                #         float green = [protocolor green];
+                                #         float blue = [protocolor blue];
+                                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                                #         float alpha = 1.0;
+                                #         if (alpha_wrapper != nil) {
+                                #           alpha = [alpha_wrapper value];
+                                #         }
+                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                                #      }
+                                #
+                                #      static Color* toProto(UIColor* color) {
+                                #          CGFloat red, green, blue, alpha;
+                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                                #            return nil;
+                                #          }
+                                #          Color* result = [Color alloc] init];
+                                #          [result setRed:red];
+                                #          [result setGreen:green];
+                                #          [result setBlue:blue];
+                                #          if (alpha <= 0.9999) {
+                                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                                #          }
+                                #          [result autorelease];
+                                #          return result;
+                                #     }
+                                #     // ...
+                                #
+                                #  Example (JavaScript):
+                                #
+                                #     // ...
+                                #
+                                #     var protoToCssColor = function(rgb_color) {
+                                #        var redFrac = rgb_color.red || 0.0;
+                                #        var greenFrac = rgb_color.green || 0.0;
+                                #        var blueFrac = rgb_color.blue || 0.0;
+                                #        var red = Math.floor(redFrac * 255);
+                                #        var green = Math.floor(greenFrac * 255);
+                                #        var blue = Math.floor(blueFrac * 255);
+                                #
+                                #        if (!('alpha' in rgb_color)) {
+                                #           return rgbToCssColor_(red, green, blue);
+                                #        }
+                                #
+                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                                #        var rgbParams = [red, green, blue].join(',');
+                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                                #     };
+                                #
+                                #     var rgbToCssColor_ = function(red, green, blue) {
+                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                                #       var hexString = rgbNumber.toString(16);
+                                #       var missingZeros = 6 - hexString.length;
+                                #       var resultBuilder = ['#'];
+                                #       for (var i = 0; i < missingZeros; i++) {
+                                #          resultBuilder.push('0');
+                                #       }
+                                #       resultBuilder.push(hexString);
+                                #       return resultBuilder.join('');
+                                #     };
+                                #
+                                #     // ...
+                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                  # the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color. This
+                                  # uses a wrapper message rather than a simple float scalar so that it is
+                                  # possible to distinguish between a default value and the value being unset.
+                                  # If omitted, this color object is to be rendered as a solid color
+                                  # (as if the alpha value had been explicitly given with a value of 1.0).
+                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                             },
-                            "sortOrder": "A String", # The order the values in this group should be sorted.
-                            "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                            "width": 42, # The width of the border, in pixels.
+                                # Deprecated; the width is determined by the "style" field.
+                            "style": "A String", # The style of the border.
+                          },
+                          "right": { # A border along a cell. # The right border of the cell.
+                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                                # for simplicity of conversion to/from color representations in various
+                                # languages over compactness; for example, the fields of this representation
+                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                                # method in iOS; and, with just a little work, it can be easily formatted into
+                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                                 #
-                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                                # means this group refers to column `C`, whereas the offset `1` would refer
-                                # to column `D`.
+                                # Example (Java):
+                                #
+                                #      import com.google.type.Color;
+                                #
+                                #      // ...
+                                #      public static java.awt.Color fromProto(Color protocolor) {
+                                #        float alpha = protocolor.hasAlpha()
+                                #            ? protocolor.getAlpha().getValue()
+                                #            : 1.0;
+                                #
+                                #        return new java.awt.Color(
+                                #            protocolor.getRed(),
+                                #            protocolor.getGreen(),
+                                #            protocolor.getBlue(),
+                                #            alpha);
+                                #      }
+                                #
+                                #      public static Color toProto(java.awt.Color color) {
+                                #        float red = (float) color.getRed();
+                                #        float green = (float) color.getGreen();
+                                #        float blue = (float) color.getBlue();
+                                #        float denominator = 255.0;
+                                #        Color.Builder resultBuilder =
+                                #            Color
+                                #                .newBuilder()
+                                #                .setRed(red / denominator)
+                                #                .setGreen(green / denominator)
+                                #                .setBlue(blue / denominator);
+                                #        int alpha = color.getAlpha();
+                                #        if (alpha != 255) {
+                                #          result.setAlpha(
+                                #              FloatValue
+                                #                  .newBuilder()
+                                #                  .setValue(((float) alpha) / denominator)
+                                #                  .build());
+                                #        }
+                                #        return resultBuilder.build();
+                                #      }
+                                #      // ...
+                                #
+                                # Example (iOS / Obj-C):
+                                #
+                                #      // ...
+                                #      static UIColor* fromProto(Color* protocolor) {
+                                #         float red = [protocolor red];
+                                #         float green = [protocolor green];
+                                #         float blue = [protocolor blue];
+                                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                                #         float alpha = 1.0;
+                                #         if (alpha_wrapper != nil) {
+                                #           alpha = [alpha_wrapper value];
+                                #         }
+                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                                #      }
+                                #
+                                #      static Color* toProto(UIColor* color) {
+                                #          CGFloat red, green, blue, alpha;
+                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                                #            return nil;
+                                #          }
+                                #          Color* result = [Color alloc] init];
+                                #          [result setRed:red];
+                                #          [result setGreen:green];
+                                #          [result setBlue:blue];
+                                #          if (alpha <= 0.9999) {
+                                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                                #          }
+                                #          [result autorelease];
+                                #          return result;
+                                #     }
+                                #     // ...
+                                #
+                                #  Example (JavaScript):
+                                #
+                                #     // ...
+                                #
+                                #     var protoToCssColor = function(rgb_color) {
+                                #        var redFrac = rgb_color.red || 0.0;
+                                #        var greenFrac = rgb_color.green || 0.0;
+                                #        var blueFrac = rgb_color.blue || 0.0;
+                                #        var red = Math.floor(redFrac * 255);
+                                #        var green = Math.floor(greenFrac * 255);
+                                #        var blue = Math.floor(blueFrac * 255);
+                                #
+                                #        if (!('alpha' in rgb_color)) {
+                                #           return rgbToCssColor_(red, green, blue);
+                                #        }
+                                #
+                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                                #        var rgbParams = [red, green, blue].join(',');
+                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                                #     };
+                                #
+                                #     var rgbToCssColor_ = function(red, green, blue) {
+                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                                #       var hexString = rgbNumber.toString(16);
+                                #       var missingZeros = 6 - hexString.length;
+                                #       var resultBuilder = ['#'];
+                                #       for (var i = 0; i < missingZeros; i++) {
+                                #          resultBuilder.push('0');
+                                #       }
+                                #       resultBuilder.push(hexString);
+                                #       return resultBuilder.join('');
+                                #     };
+                                #
+                                #     // ...
+                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                  # the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color. This
+                                  # uses a wrapper message rather than a simple float scalar so that it is
+                                  # possible to distinguish between a default value and the value being unset.
+                                  # If omitted, this color object is to be rendered as a solid color
+                                  # (as if the alpha value had been explicitly given with a value of 1.0).
+                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                            },
+                            "width": 42, # The width of the border, in pixels.
+                                # Deprecated; the width is determined by the "style" field.
+                            "style": "A String", # The style of the border.
                           },
-                        ],
-                        "source": { # A range on a sheet. # The range the pivot table is reading data from.
-                            # All indexes are zero-based.
-                            # Indexes are half open, e.g the start index is inclusive
-                            # and the end index is exclusive -- [start_index, end_index).
-                            # Missing indexes indicate the range is unbounded on that side.
-                            #
-                            # For example, if `"Sheet1"` is sheet ID 0, then:
-                            #
-                            #   `Sheet1!A1:A1 == sheet_id: 0,
-                            #                   start_row_index: 0, end_row_index: 1,
-                            #                   start_column_index: 0, end_column_index: 1`
-                            #
-                            #   `Sheet1!A3:B4 == sheet_id: 0,
-                            #                   start_row_index: 2, end_row_index: 4,
-                            #                   start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A:B == sheet_id: 0,
-                            #                 start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A5:B == sheet_id: 0,
-                            #                  start_row_index: 4,
-                            #                  start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1 == sheet_id:0`
-                            #
-                            # The start index must always be less than or equal to the end index.
-                            # If the start index equals the end index, then the range is empty.
-                            # Empty ranges are typically not meaningful and are usually rendered in the
-                            # UI as `#REF!`.
-                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                          "sheetId": 42, # The sheet this range is on.
-                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                        },
-                        "values": [ # A list of values to include in the pivot table.
-                          { # The definition of how a value in a pivot table should be calculated.
-                            "formula": "A String", # A custom formula to calculate the value.  The formula must start
-                                # with an `=` character.
-                            "summarizeFunction": "A String", # A function to summarize the value.
-                                # If formula is set, the only supported values are
-                                # SUM and
-                                # CUSTOM.
-                                # If sourceColumnOffset is set, then `CUSTOM`
-                                # is not supported.
-                            "sourceColumnOffset": 42, # The column offset of the source range that this value reads from.
+                          "bottom": { # A border along a cell. # The bottom border of the cell.
+                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                                # for simplicity of conversion to/from color representations in various
+                                # languages over compactness; for example, the fields of this representation
+                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                                # method in iOS; and, with just a little work, it can be easily formatted into
+                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                                #
+                                # Example (Java):
+                                #
+                                #      import com.google.type.Color;
+                                #
+                                #      // ...
+                                #      public static java.awt.Color fromProto(Color protocolor) {
+                                #        float alpha = protocolor.hasAlpha()
+                                #            ? protocolor.getAlpha().getValue()
+                                #            : 1.0;
+                                #
+                                #        return new java.awt.Color(
+                                #            protocolor.getRed(),
+                                #            protocolor.getGreen(),
+                                #            protocolor.getBlue(),
+                                #            alpha);
+                                #      }
+                                #
+                                #      public static Color toProto(java.awt.Color color) {
+                                #        float red = (float) color.getRed();
+                                #        float green = (float) color.getGreen();
+                                #        float blue = (float) color.getBlue();
+                                #        float denominator = 255.0;
+                                #        Color.Builder resultBuilder =
+                                #            Color
+                                #                .newBuilder()
+                                #                .setRed(red / denominator)
+                                #                .setGreen(green / denominator)
+                                #                .setBlue(blue / denominator);
+                                #        int alpha = color.getAlpha();
+                                #        if (alpha != 255) {
+                                #          result.setAlpha(
+                                #              FloatValue
+                                #                  .newBuilder()
+                                #                  .setValue(((float) alpha) / denominator)
+                                #                  .build());
+                                #        }
+                                #        return resultBuilder.build();
+                                #      }
+                                #      // ...
+                                #
+                                # Example (iOS / Obj-C):
+                                #
+                                #      // ...
+                                #      static UIColor* fromProto(Color* protocolor) {
+                                #         float red = [protocolor red];
+                                #         float green = [protocolor green];
+                                #         float blue = [protocolor blue];
+                                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                                #         float alpha = 1.0;
+                                #         if (alpha_wrapper != nil) {
+                                #           alpha = [alpha_wrapper value];
+                                #         }
+                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                                #      }
+                                #
+                                #      static Color* toProto(UIColor* color) {
+                                #          CGFloat red, green, blue, alpha;
+                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                                #            return nil;
+                                #          }
+                                #          Color* result = [Color alloc] init];
+                                #          [result setRed:red];
+                                #          [result setGreen:green];
+                                #          [result setBlue:blue];
+                                #          if (alpha <= 0.9999) {
+                                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                                #          }
+                                #          [result autorelease];
+                                #          return result;
+                                #     }
+                                #     // ...
                                 #
-                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                                # means this value refers to column `C`, whereas the offset `1` would
-                                # refer to column `D`.
-                            "name": "A String", # A name to use for the value. This is only used if formula was set.
-                                # Otherwise, the column name is used.
-                          },
-                        ],
-                        "criteria": { # An optional mapping of filters per source column offset.
-                            #
-                            # The filters will be applied before aggregating data into the pivot table.
-                            # The map's key is the column offset of the source range that you want to
-                            # filter, and the value is the criteria for that column.
-                            #
-                            # For example, if the source was `C10:E15`, a key of `0` will have the filter
-                            # for column `C`, whereas the key `1` is for column `D`.
-                          "a_key": { # Criteria for showing/hiding rows in a pivot table.
-                            "visibleValues": [ # Values that should be included.  Values not listed here are excluded.
-                              "A String",
-                            ],
-                          },
-                        },
-                        "columns": [ # Each column grouping in the pivot table.
-                          { # A single grouping (either row or column) in a pivot table.
-                            "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
-                            "valueMetadata": [ # Metadata about values in the grouping.
-                              { # Metadata about a value in a pivot grouping.
-                                "collapsed": True or False, # True if the data corresponding to the value is collapsed.
-                                "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
-                                    # (Note that formulaValue is not valid,
-                                    #  because the values will be calculated.)
-                                  "numberValue": 3.14, # Represents a double value.
-                                      # Note: Dates, Times and DateTimes are represented as doubles in
-                                      # "serial number" format.
-                                  "boolValue": True or False, # Represents a boolean value.
-                                  "formulaValue": "A String", # Represents a formula.
-                                  "stringValue": "A String", # Represents a string value.
-                                      # Leading single quotes are not included. For example, if the user typed
-                                      # `'123` into the UI, this would be represented as a `stringValue` of
-                                      # `"123"`.
-                                  "errorValue": { # An error in a cell. # Represents an error.
-                                      # This field is read-only.
-                                    "message": "A String", # A message with more information about the error
-                                        # (in the spreadsheet's locale).
-                                    "type": "A String", # The type of error.
-                                  },
-                                },
-                              },
-                            ],
-                            "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
-                                # If not specified, sorting is alphabetical by this group's values.
-                              "buckets": [ # Determines the bucket from which values are chosen to sort.
+                                #  Example (JavaScript):
+                                #
+                                #     // ...
+                                #
+                                #     var protoToCssColor = function(rgb_color) {
+                                #        var redFrac = rgb_color.red || 0.0;
+                                #        var greenFrac = rgb_color.green || 0.0;
+                                #        var blueFrac = rgb_color.blue || 0.0;
+                                #        var red = Math.floor(redFrac * 255);
+                                #        var green = Math.floor(greenFrac * 255);
+                                #        var blue = Math.floor(blueFrac * 255);
+                                #
+                                #        if (!('alpha' in rgb_color)) {
+                                #           return rgbToCssColor_(red, green, blue);
+                                #        }
+                                #
+                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                                #        var rgbParams = [red, green, blue].join(',');
+                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                                #     };
+                                #
+                                #     var rgbToCssColor_ = function(red, green, blue) {
+                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                                #       var hexString = rgbNumber.toString(16);
+                                #       var missingZeros = 6 - hexString.length;
+                                #       var resultBuilder = ['#'];
+                                #       for (var i = 0; i < missingZeros; i++) {
+                                #          resultBuilder.push('0');
+                                #       }
+                                #       resultBuilder.push(hexString);
+                                #       return resultBuilder.join('');
+                                #     };
+                                #
+                                #     // ...
+                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                  # the final pixel color is defined by the equation:
                                   #
-                                  # For example, in a pivot table with one row group & two column groups,
-                                  # the row group can list up to two values. The first value corresponds
-                                  # to a value within the first column group, and the second value
-                                  # corresponds to a value in the second column group.  If no values
-                                  # are listed, this would indicate that the row should be sorted according
-                                  # to the "Grand Total" over the column groups. If a single value is listed,
-                                  # this would correspond to using the "Total" of that bucket.
-                                { # The kinds of value that a cell in a spreadsheet can have.
-                                  "numberValue": 3.14, # Represents a double value.
-                                      # Note: Dates, Times and DateTimes are represented as doubles in
-                                      # "serial number" format.
-                                  "boolValue": True or False, # Represents a boolean value.
-                                  "formulaValue": "A String", # Represents a formula.
-                                  "stringValue": "A String", # Represents a string value.
-                                      # Leading single quotes are not included. For example, if the user typed
-                                      # `'123` into the UI, this would be represented as a `stringValue` of
-                                      # `"123"`.
-                                  "errorValue": { # An error in a cell. # Represents an error.
-                                      # This field is read-only.
-                                    "message": "A String", # A message with more information about the error
-                                        # (in the spreadsheet's locale).
-                                    "type": "A String", # The type of error.
-                                  },
-                                },
-                              ],
-                              "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
-                                  # grouping should be sorted by.
+                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color. This
+                                  # uses a wrapper message rather than a simple float scalar so that it is
+                                  # possible to distinguish between a default value and the value being unset.
+                                  # If omitted, this color object is to be rendered as a solid color
+                                  # (as if the alpha value had been explicitly given with a value of 1.0).
+                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                             },
-                            "sortOrder": "A String", # The order the values in this group should be sorted.
-                            "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                            "width": 42, # The width of the border, in pixels.
+                                # Deprecated; the width is determined by the "style" field.
+                            "style": "A String", # The style of the border.
+                          },
+                          "left": { # A border along a cell. # The left border of the cell.
+                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                                # for simplicity of conversion to/from color representations in various
+                                # languages over compactness; for example, the fields of this representation
+                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                                # method in iOS; and, with just a little work, it can be easily formatted into
+                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                                 #
-                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                                # means this group refers to column `C`, whereas the offset `1` would refer
-                                # to column `D`.
+                                # Example (Java):
+                                #
+                                #      import com.google.type.Color;
+                                #
+                                #      // ...
+                                #      public static java.awt.Color fromProto(Color protocolor) {
+                                #        float alpha = protocolor.hasAlpha()
+                                #            ? protocolor.getAlpha().getValue()
+                                #            : 1.0;
+                                #
+                                #        return new java.awt.Color(
+                                #            protocolor.getRed(),
+                                #            protocolor.getGreen(),
+                                #            protocolor.getBlue(),
+                                #            alpha);
+                                #      }
+                                #
+                                #      public static Color toProto(java.awt.Color color) {
+                                #        float red = (float) color.getRed();
+                                #        float green = (float) color.getGreen();
+                                #        float blue = (float) color.getBlue();
+                                #        float denominator = 255.0;
+                                #        Color.Builder resultBuilder =
+                                #            Color
+                                #                .newBuilder()
+                                #                .setRed(red / denominator)
+                                #                .setGreen(green / denominator)
+                                #                .setBlue(blue / denominator);
+                                #        int alpha = color.getAlpha();
+                                #        if (alpha != 255) {
+                                #          result.setAlpha(
+                                #              FloatValue
+                                #                  .newBuilder()
+                                #                  .setValue(((float) alpha) / denominator)
+                                #                  .build());
+                                #        }
+                                #        return resultBuilder.build();
+                                #      }
+                                #      // ...
+                                #
+                                # Example (iOS / Obj-C):
+                                #
+                                #      // ...
+                                #      static UIColor* fromProto(Color* protocolor) {
+                                #         float red = [protocolor red];
+                                #         float green = [protocolor green];
+                                #         float blue = [protocolor blue];
+                                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                                #         float alpha = 1.0;
+                                #         if (alpha_wrapper != nil) {
+                                #           alpha = [alpha_wrapper value];
+                                #         }
+                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                                #      }
+                                #
+                                #      static Color* toProto(UIColor* color) {
+                                #          CGFloat red, green, blue, alpha;
+                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                                #            return nil;
+                                #          }
+                                #          Color* result = [Color alloc] init];
+                                #          [result setRed:red];
+                                #          [result setGreen:green];
+                                #          [result setBlue:blue];
+                                #          if (alpha <= 0.9999) {
+                                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                                #          }
+                                #          [result autorelease];
+                                #          return result;
+                                #     }
+                                #     // ...
+                                #
+                                #  Example (JavaScript):
+                                #
+                                #     // ...
+                                #
+                                #     var protoToCssColor = function(rgb_color) {
+                                #        var redFrac = rgb_color.red || 0.0;
+                                #        var greenFrac = rgb_color.green || 0.0;
+                                #        var blueFrac = rgb_color.blue || 0.0;
+                                #        var red = Math.floor(redFrac * 255);
+                                #        var green = Math.floor(greenFrac * 255);
+                                #        var blue = Math.floor(blueFrac * 255);
+                                #
+                                #        if (!('alpha' in rgb_color)) {
+                                #           return rgbToCssColor_(red, green, blue);
+                                #        }
+                                #
+                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                                #        var rgbParams = [red, green, blue].join(',');
+                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                                #     };
+                                #
+                                #     var rgbToCssColor_ = function(red, green, blue) {
+                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                                #       var hexString = rgbNumber.toString(16);
+                                #       var missingZeros = 6 - hexString.length;
+                                #       var resultBuilder = ['#'];
+                                #       for (var i = 0; i < missingZeros; i++) {
+                                #          resultBuilder.push('0');
+                                #       }
+                                #       resultBuilder.push(hexString);
+                                #       return resultBuilder.join('');
+                                #     };
+                                #
+                                #     // ...
+                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                  # the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color. This
+                                  # uses a wrapper message rather than a simple float scalar so that it is
+                                  # possible to distinguish between a default value and the value being unset.
+                                  # If omitted, this color object is to be rendered as a solid color
+                                  # (as if the alpha value had been explicitly given with a value of 1.0).
+                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                            },
+                            "width": 42, # The width of the border, in pixels.
+                                # Deprecated; the width is determined by the "style" field.
+                            "style": "A String", # The style of the border.
                           },
-                        ],
-                      },
-                      "hyperlink": "A String", # A hyperlink this cell points to, if any.
-                          # This field is read-only.  (To set it, use a `=HYPERLINK` formula.)
-                      "effectiveValue": { # The kinds of value that a cell in a spreadsheet can have. # The effective value of the cell. For cells with formulas, this will be
-                          # the calculated value.  For cells with literals, this will be
-                          # the same as the user_entered_value.
-                          # This field is read-only.
-                        "numberValue": 3.14, # Represents a double value.
-                            # Note: Dates, Times and DateTimes are represented as doubles in
-                            # "serial number" format.
-                        "boolValue": True or False, # Represents a boolean value.
-                        "formulaValue": "A String", # Represents a formula.
-                        "stringValue": "A String", # Represents a string value.
-                            # Leading single quotes are not included. For example, if the user typed
-                            # `'123` into the UI, this would be represented as a `stringValue` of
-                            # `"123"`.
-                        "errorValue": { # An error in a cell. # Represents an error.
-                            # This field is read-only.
-                          "message": "A String", # A message with more information about the error
-                              # (in the spreadsheet's locale).
-                          "type": "A String", # The type of error.
-                        },
-                      },
-                      "formattedValue": "A String", # The formatted value of the cell.
-                          # This is the value as it's shown to the user.
-                          # This field is read-only.
-                      "userEnteredValue": { # The kinds of value that a cell in a spreadsheet can have. # The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`
-                          # Note: Dates, Times and DateTimes are represented as doubles in
-                          # serial number format.
-                        "numberValue": 3.14, # Represents a double value.
-                            # Note: Dates, Times and DateTimes are represented as doubles in
-                            # "serial number" format.
-                        "boolValue": True or False, # Represents a boolean value.
-                        "formulaValue": "A String", # Represents a formula.
-                        "stringValue": "A String", # Represents a string value.
-                            # Leading single quotes are not included. For example, if the user typed
-                            # `'123` into the UI, this would be represented as a `stringValue` of
-                            # `"123"`.
-                        "errorValue": { # An error in a cell. # Represents an error.
-                            # This field is read-only.
-                          "message": "A String", # A message with more information about the error
-                              # (in the spreadsheet's locale).
-                          "type": "A String", # The type of error.
                         },
+                        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
                       },
-                      "note": "A String", # Any note on the cell.
-                      "effectiveFormat": { # The format of a cell. # The effective format being used by the cell.
-                          # This includes the results of applying any conditional formatting and,
-                          # if the cell contains a formula, the computed number format.
-                          # If the effective format is the default format, effective format will
-                          # not be written.
-                          # This field is read-only.
+                      "userEnteredFormat": { # The format of a cell. # The format the user entered for the cell.
+                          #
+                          # When writing, the new format will be merged with the existing format.
                         "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
                           "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
                               # the user's locale will be used if necessary for the given type.
@@ -27877,1575 +21709,15814 @@ <h3>Method Details</h3>
                                 # Deprecated; the width is determined by the "style" field.
                             "style": "A String", # The style of the border.
                           },
-                        },
-                        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+                        },
+                        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+                      },
+                      "dataValidation": { # A data validation rule. # A data validation rule on the cell, if any.
+                          #
+                          # When writing, the new data validation rule will overwrite any prior rule.
+                        "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
+                            # If true, "List" conditions will show a dropdown.
+                        "strict": True or False, # True if invalid data should be rejected.
+                        "inputMessage": "A String", # A message to show the user when adding data to the cell.
+                        "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
+                            # BooleanConditions are used by conditional formatting,
+                            # data validation, and the criteria in filters.
+                          "type": "A String", # The type of condition.
+                          "values": [ # The values of the condition. The number of supported values depends
+                              # on the condition type.  Some support zero values,
+                              # others one or two values,
+                              # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                            { # The value of the condition.
+                              "relativeDate": "A String", # A relative date (based on the current date).
+                                  # Valid only if the type is
+                                  # DATE_BEFORE,
+                                  # DATE_AFTER,
+                                  # DATE_ON_OR_BEFORE or
+                                  # DATE_ON_OR_AFTER.
+                                  #
+                                  # Relative dates are not supported in data validation.
+                                  # They are supported only in conditional formatting and
+                                  # conditional filters.
+                              "userEnteredValue": "A String", # A value the condition is based on.
+                                  # The value will be parsed as if the user typed into a cell.
+                                  # Formulas are supported (and must begin with an `=`).
+                            },
+                          ],
+                        },
+                      },
+                      "textFormatRuns": [ # Runs of rich text applied to subsections of the cell.  Runs are only valid
+                          # on user entered strings, not formulas, bools, or numbers.
+                          # Runs start at specific indexes in the text and continue until the next
+                          # run. Properties of a run will continue unless explicitly changed
+                          # in a subsequent run (and properties of the first run will continue
+                          # the properties of the cell unless explicitly changed).
+                          #
+                          # When writing, the new runs will overwrite any prior runs.  When writing a
+                          # new user_entered_value, previous runs will be erased.
+                        { # A run of a text format. The format of this run continues until the start
+                            # index of the next run.
+                            # When updating, all fields must be set.
+                          "startIndex": 42, # The character index where this run starts.
+                          "format": { # The format of a run of text in a cell. # The format of this run.  Absent values inherit the cell's format.
+                              # Absent values indicate that the field isn't specified.
+                            "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                                # for simplicity of conversion to/from color representations in various
+                                # languages over compactness; for example, the fields of this representation
+                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                                # method in iOS; and, with just a little work, it can be easily formatted into
+                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                                #
+                                # Example (Java):
+                                #
+                                #      import com.google.type.Color;
+                                #
+                                #      // ...
+                                #      public static java.awt.Color fromProto(Color protocolor) {
+                                #        float alpha = protocolor.hasAlpha()
+                                #            ? protocolor.getAlpha().getValue()
+                                #            : 1.0;
+                                #
+                                #        return new java.awt.Color(
+                                #            protocolor.getRed(),
+                                #            protocolor.getGreen(),
+                                #            protocolor.getBlue(),
+                                #            alpha);
+                                #      }
+                                #
+                                #      public static Color toProto(java.awt.Color color) {
+                                #        float red = (float) color.getRed();
+                                #        float green = (float) color.getGreen();
+                                #        float blue = (float) color.getBlue();
+                                #        float denominator = 255.0;
+                                #        Color.Builder resultBuilder =
+                                #            Color
+                                #                .newBuilder()
+                                #                .setRed(red / denominator)
+                                #                .setGreen(green / denominator)
+                                #                .setBlue(blue / denominator);
+                                #        int alpha = color.getAlpha();
+                                #        if (alpha != 255) {
+                                #          result.setAlpha(
+                                #              FloatValue
+                                #                  .newBuilder()
+                                #                  .setValue(((float) alpha) / denominator)
+                                #                  .build());
+                                #        }
+                                #        return resultBuilder.build();
+                                #      }
+                                #      // ...
+                                #
+                                # Example (iOS / Obj-C):
+                                #
+                                #      // ...
+                                #      static UIColor* fromProto(Color* protocolor) {
+                                #         float red = [protocolor red];
+                                #         float green = [protocolor green];
+                                #         float blue = [protocolor blue];
+                                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                                #         float alpha = 1.0;
+                                #         if (alpha_wrapper != nil) {
+                                #           alpha = [alpha_wrapper value];
+                                #         }
+                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                                #      }
+                                #
+                                #      static Color* toProto(UIColor* color) {
+                                #          CGFloat red, green, blue, alpha;
+                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                                #            return nil;
+                                #          }
+                                #          Color* result = [Color alloc] init];
+                                #          [result setRed:red];
+                                #          [result setGreen:green];
+                                #          [result setBlue:blue];
+                                #          if (alpha <= 0.9999) {
+                                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                                #          }
+                                #          [result autorelease];
+                                #          return result;
+                                #     }
+                                #     // ...
+                                #
+                                #  Example (JavaScript):
+                                #
+                                #     // ...
+                                #
+                                #     var protoToCssColor = function(rgb_color) {
+                                #        var redFrac = rgb_color.red || 0.0;
+                                #        var greenFrac = rgb_color.green || 0.0;
+                                #        var blueFrac = rgb_color.blue || 0.0;
+                                #        var red = Math.floor(redFrac * 255);
+                                #        var green = Math.floor(greenFrac * 255);
+                                #        var blue = Math.floor(blueFrac * 255);
+                                #
+                                #        if (!('alpha' in rgb_color)) {
+                                #           return rgbToCssColor_(red, green, blue);
+                                #        }
+                                #
+                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                                #        var rgbParams = [red, green, blue].join(',');
+                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                                #     };
+                                #
+                                #     var rgbToCssColor_ = function(red, green, blue) {
+                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                                #       var hexString = rgbNumber.toString(16);
+                                #       var missingZeros = 6 - hexString.length;
+                                #       var resultBuilder = ['#'];
+                                #       for (var i = 0; i < missingZeros; i++) {
+                                #          resultBuilder.push('0');
+                                #       }
+                                #       resultBuilder.push(hexString);
+                                #       return resultBuilder.join('');
+                                #     };
+                                #
+                                #     // ...
+                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                  # the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color. This
+                                  # uses a wrapper message rather than a simple float scalar so that it is
+                                  # possible to distinguish between a default value and the value being unset.
+                                  # If omitted, this color object is to be rendered as a solid color
+                                  # (as if the alpha value had been explicitly given with a value of 1.0).
+                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                            },
+                            "bold": True or False, # True if the text is bold.
+                            "strikethrough": True or False, # True if the text has a strikethrough.
+                            "fontFamily": "A String", # The font family.
+                            "fontSize": 42, # The size of the font.
+                            "italic": True or False, # True if the text is italicized.
+                            "underline": True or False, # True if the text is underlined.
+                          },
+                        },
+                      ],
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+          "properties": { # Properties of a sheet. # The properties of the sheet.
+            "sheetType": "A String", # The type of sheet. Defaults to GRID.
+                # This field cannot be changed once set.
+            "index": 42, # The index of the sheet within the spreadsheet.
+                # When adding or updating sheet properties, if this field
+                # is excluded then the sheet will be added or moved to the end
+                # of the sheet list. When updating sheet indices or inserting
+                # sheets, movement is considered in "before the move" indexes.
+                # For example, if there were 3 sheets (S1, S2, S3) in order to
+                # move S1 ahead of S2 the index would have to be set to 2. A sheet
+                # index update request will be ignored if the requested index is
+                # identical to the sheets current index or if the requested new
+                # index is equal to the current sheet index + 1.
+            "title": "A String", # The name of the sheet.
+            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
+                # (If the sheet is an object sheet, containing a chart or image, then
+                # this field will be absent.)
+                # When writing it is an error to set any grid properties on non-grid sheets.
+              "columnCount": 42, # The number of columns in the grid.
+              "rowCount": 42, # The number of rows in the grid.
+              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
+              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
+              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
+            },
+            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
+            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
+            "sheetId": 42, # The ID of the sheet. Must be non-negative.
+                # This field cannot be changed once set.
+          },
+        },
+      ],
+      "spreadsheetUrl": "A String", # The url of the spreadsheet.
+          # This field is read-only.
+    },
+    "replies": [ # The reply of the updates.  This maps 1:1 with the updates, although
+        # replies to some requests may be empty.
+      { # A single response from an update.
+        "duplicateFilterView": { # The result of a filter view being duplicated. # A reply from duplicating a filter view.
+          "filter": { # A filter view. # The newly created filter.
+            "title": "A String", # The name of the filter view.
+            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "filterViewId": 42, # The ID of the filter view.
+            "range": { # A range on a sheet. # The range this filter view covers.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "sortSpecs": [ # The sort order per column. Later specifications are used when values
+                # are equal in the earlier specifications.
+              { # A sort order associated with a specific column or row.
+                "sortOrder": "A String", # The order data should be sorted.
+                "dimensionIndex": 42, # The dimension the sort should be applied to.
+              },
+            ],
+            "criteria": { # The criteria for showing/hiding values per column.
+                # The map's key is the column index, and the value is the criteria for
+                # that column.
+              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+                "hiddenValues": [ # Values that should be hidden.
+                  "A String",
+                ],
+                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                    # (This does not override hiddenValues -- if a value is listed there,
+                    #  it will still be hidden.)
+                    # BooleanConditions are used by conditional formatting,
+                    # data validation, and the criteria in filters.
+                  "type": "A String", # The type of condition.
+                  "values": [ # The values of the condition. The number of supported values depends
+                      # on the condition type.  Some support zero values,
+                      # others one or two values,
+                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                    { # The value of the condition.
+                      "relativeDate": "A String", # A relative date (based on the current date).
+                          # Valid only if the type is
+                          # DATE_BEFORE,
+                          # DATE_AFTER,
+                          # DATE_ON_OR_BEFORE or
+                          # DATE_ON_OR_AFTER.
+                          #
+                          # Relative dates are not supported in data validation.
+                          # They are supported only in conditional formatting and
+                          # conditional filters.
+                      "userEnteredValue": "A String", # A value the condition is based on.
+                          # The value will be parsed as if the user typed into a cell.
+                          # Formulas are supported (and must begin with an `=`).
+                    },
+                  ],
+                },
+              },
+            },
+          },
+        },
+        "duplicateSheet": { # The result of duplicating a sheet. # A reply from duplicating a sheet.
+          "properties": { # Properties of a sheet. # The properties of the duplicate sheet.
+            "sheetType": "A String", # The type of sheet. Defaults to GRID.
+                # This field cannot be changed once set.
+            "index": 42, # The index of the sheet within the spreadsheet.
+                # When adding or updating sheet properties, if this field
+                # is excluded then the sheet will be added or moved to the end
+                # of the sheet list. When updating sheet indices or inserting
+                # sheets, movement is considered in "before the move" indexes.
+                # For example, if there were 3 sheets (S1, S2, S3) in order to
+                # move S1 ahead of S2 the index would have to be set to 2. A sheet
+                # index update request will be ignored if the requested index is
+                # identical to the sheets current index or if the requested new
+                # index is equal to the current sheet index + 1.
+            "title": "A String", # The name of the sheet.
+            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
+                # (If the sheet is an object sheet, containing a chart or image, then
+                # this field will be absent.)
+                # When writing it is an error to set any grid properties on non-grid sheets.
+              "columnCount": 42, # The number of columns in the grid.
+              "rowCount": 42, # The number of rows in the grid.
+              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
+              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
+              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
+            },
+            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
+            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
+            "sheetId": 42, # The ID of the sheet. Must be non-negative.
+                # This field cannot be changed once set.
+          },
+        },
+        "updateEmbeddedObjectPosition": { # The result of updating an embedded object's position. # A reply from updating an embedded object's position.
+          "position": { # The position of an embedded object such as a chart. # The new position of the embedded object.
+            "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
+                # is chosen for you. Used only when writing.
+            "sheetId": 42, # The sheet this is on. Set only if the embedded object
+                # is on its own sheet. Must be non-negative.
+            "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
+              "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
+                  # All indexes are zero-based.
+                "rowIndex": 42, # The row index of the coordinate.
+                "columnIndex": 42, # The column index of the coordinate.
+                "sheetId": 42, # The sheet this coordinate is on.
+              },
+              "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
+                  # from the anchor cell.
+              "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
+              "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
+                  # from the anchor cell.
+              "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
+            },
+          },
+        },
+        "addChart": { # The result of adding a chart to a spreadsheet. # A reply from adding a chart.
+          "chart": { # A chart embedded in a sheet. # The newly added chart.
+            "chartId": 42, # The ID of the chart.
+            "position": { # The position of an embedded object such as a chart. # The position of the chart.
+              "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
+                  # is chosen for you. Used only when writing.
+              "sheetId": 42, # The sheet this is on. Set only if the embedded object
+                  # is on its own sheet. Must be non-negative.
+              "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
+                "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
+                    # All indexes are zero-based.
+                  "rowIndex": 42, # The row index of the coordinate.
+                  "columnIndex": 42, # The column index of the coordinate.
+                  "sheetId": 42, # The sheet this coordinate is on.
+                },
+                "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
+                    # from the anchor cell.
+                "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
+                "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
+                    # from the anchor cell.
+                "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
+              },
+            },
+            "spec": { # The specifications of a chart. # The specification of the chart.
+              "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
+              "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
+                "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
+                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                    "sources": [ # The ranges of data for a series or domain.
+                        # Exactly one dimension must have a length of 1,
+                        # and all sources in the list must have the same dimension
+                        # with length 1.
+                        # The domain (if it exists) & all series must have the same number
+                        # of source ranges. If using more than one source range, then the source
+                        # range at a given offset must be contiguous across the domain and series.
+                        #
+                        # For example, these are valid configurations:
+                        #
+                        #     domain sources: A1:A5
+                        #     series1 sources: B1:B5
+                        #     series2 sources: D6:D10
+                        #
+                        #     domain sources: A1:A5, C10:C12
+                        #     series1 sources: B1:B5, D10:D12
+                        #     series2 sources: C1:C5, E10:E12
+                      { # A range on a sheet.
+                          # All indexes are zero-based.
+                          # Indexes are half open, e.g the start index is inclusive
+                          # and the end index is exclusive -- [start_index, end_index).
+                          # Missing indexes indicate the range is unbounded on that side.
+                          #
+                          # For example, if `"Sheet1"` is sheet ID 0, then:
+                          #
+                          #   `Sheet1!A1:A1 == sheet_id: 0,
+                          #                   start_row_index: 0, end_row_index: 1,
+                          #                   start_column_index: 0, end_column_index: 1`
+                          #
+                          #   `Sheet1!A3:B4 == sheet_id: 0,
+                          #                   start_row_index: 2, end_row_index: 4,
+                          #                   start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A:B == sheet_id: 0,
+                          #                 start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A5:B == sheet_id: 0,
+                          #                  start_row_index: 4,
+                          #                  start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1 == sheet_id:0`
+                          #
+                          # The start index must always be less than or equal to the end index.
+                          # If the start index equals the end index, then the range is empty.
+                          # Empty ranges are typically not meaningful and are usually rendered in the
+                          # UI as `#REF!`.
+                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                        "sheetId": 42, # The sheet this range is on.
+                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                      },
+                    ],
+                  },
+                },
+                "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
+                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                    "sources": [ # The ranges of data for a series or domain.
+                        # Exactly one dimension must have a length of 1,
+                        # and all sources in the list must have the same dimension
+                        # with length 1.
+                        # The domain (if it exists) & all series must have the same number
+                        # of source ranges. If using more than one source range, then the source
+                        # range at a given offset must be contiguous across the domain and series.
+                        #
+                        # For example, these are valid configurations:
+                        #
+                        #     domain sources: A1:A5
+                        #     series1 sources: B1:B5
+                        #     series2 sources: D6:D10
+                        #
+                        #     domain sources: A1:A5, C10:C12
+                        #     series1 sources: B1:B5, D10:D12
+                        #     series2 sources: C1:C5, E10:E12
+                      { # A range on a sheet.
+                          # All indexes are zero-based.
+                          # Indexes are half open, e.g the start index is inclusive
+                          # and the end index is exclusive -- [start_index, end_index).
+                          # Missing indexes indicate the range is unbounded on that side.
+                          #
+                          # For example, if `"Sheet1"` is sheet ID 0, then:
+                          #
+                          #   `Sheet1!A1:A1 == sheet_id: 0,
+                          #                   start_row_index: 0, end_row_index: 1,
+                          #                   start_column_index: 0, end_column_index: 1`
+                          #
+                          #   `Sheet1!A3:B4 == sheet_id: 0,
+                          #                   start_row_index: 2, end_row_index: 4,
+                          #                   start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A:B == sheet_id: 0,
+                          #                 start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A5:B == sheet_id: 0,
+                          #                  start_row_index: 4,
+                          #                  start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1 == sheet_id:0`
+                          #
+                          # The start index must always be less than or equal to the end index.
+                          # If the start index equals the end index, then the range is empty.
+                          # Empty ranges are typically not meaningful and are usually rendered in the
+                          # UI as `#REF!`.
+                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                        "sheetId": 42, # The sheet this range is on.
+                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                      },
+                    ],
+                  },
+                },
+                "threeDimensional": True or False, # True if the pie is three dimensional.
+                "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
+                "pieHole": 3.14, # The size of the hole in the pie chart.
+              },
+              "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
+                  # See BasicChartType for the list of all
+                  # charts this supports.
+                  # of charts this supports.
+                "headerCount": 42, # The number of rows or columns in the data that are "headers".
+                    # If not set, Google Sheets will guess how many rows are headers based
+                    # on the data.
+                    #
+                    # (Note that BasicChartAxis.title may override the axis title
+                    #  inferred from the header values.)
+                "series": [ # The data this chart is visualizing.
+                  { # A single series of data in a chart.
+                      # For example, if charting stock prices over time, multiple series may exist,
+                      # one for the "Open Price", "High Price", "Low Price" and "Close Price".
+                    "series": { # The data included in a domain or series. # The data being visualized in this chart series.
+                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                        "sources": [ # The ranges of data for a series or domain.
+                            # Exactly one dimension must have a length of 1,
+                            # and all sources in the list must have the same dimension
+                            # with length 1.
+                            # The domain (if it exists) & all series must have the same number
+                            # of source ranges. If using more than one source range, then the source
+                            # range at a given offset must be contiguous across the domain and series.
+                            #
+                            # For example, these are valid configurations:
+                            #
+                            #     domain sources: A1:A5
+                            #     series1 sources: B1:B5
+                            #     series2 sources: D6:D10
+                            #
+                            #     domain sources: A1:A5, C10:C12
+                            #     series1 sources: B1:B5, D10:D12
+                            #     series2 sources: C1:C5, E10:E12
+                          { # A range on a sheet.
+                              # All indexes are zero-based.
+                              # Indexes are half open, e.g the start index is inclusive
+                              # and the end index is exclusive -- [start_index, end_index).
+                              # Missing indexes indicate the range is unbounded on that side.
+                              #
+                              # For example, if `"Sheet1"` is sheet ID 0, then:
+                              #
+                              #   `Sheet1!A1:A1 == sheet_id: 0,
+                              #                   start_row_index: 0, end_row_index: 1,
+                              #                   start_column_index: 0, end_column_index: 1`
+                              #
+                              #   `Sheet1!A3:B4 == sheet_id: 0,
+                              #                   start_row_index: 2, end_row_index: 4,
+                              #                   start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A:B == sheet_id: 0,
+                              #                 start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A5:B == sheet_id: 0,
+                              #                  start_row_index: 4,
+                              #                  start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1 == sheet_id:0`
+                              #
+                              # The start index must always be less than or equal to the end index.
+                              # If the start index equals the end index, then the range is empty.
+                              # Empty ranges are typically not meaningful and are usually rendered in the
+                              # UI as `#REF!`.
+                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                            "sheetId": 42, # The sheet this range is on.
+                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                          },
+                        ],
                       },
-                      "userEnteredFormat": { # The format of a cell. # The format the user entered for the cell.
+                    },
+                    "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
+                        # For example, if charting stocks over time, the "Volume" series
+                        # may want to be pinned to the right with the prices pinned to the left,
+                        # because the scale of trading volume is different than the scale of
+                        # prices.
+                        # It is an error to specify an axis that isn't a valid minor axis
+                        # for the chart's type.
+                    "type": "A String", # The type of this series. Valid only if the
+                        # chartType is
+                        # COMBO.
+                        # Different types will change the way the series is visualized.
+                        # Only LINE, AREA,
+                        # and COLUMN are supported.
+                  },
+                ],
+                "legendPosition": "A String", # The position of the chart legend.
+                "domains": [ # The domain of data this is charting.
+                    # Only a single domain is currently supported.
+                  { # The domain of a chart.
+                      # For example, if charting stock prices over time, this would be the date.
+                    "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
+                        # this is the data representing the dates.
+                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                        "sources": [ # The ranges of data for a series or domain.
+                            # Exactly one dimension must have a length of 1,
+                            # and all sources in the list must have the same dimension
+                            # with length 1.
+                            # The domain (if it exists) & all series must have the same number
+                            # of source ranges. If using more than one source range, then the source
+                            # range at a given offset must be contiguous across the domain and series.
+                            #
+                            # For example, these are valid configurations:
+                            #
+                            #     domain sources: A1:A5
+                            #     series1 sources: B1:B5
+                            #     series2 sources: D6:D10
+                            #
+                            #     domain sources: A1:A5, C10:C12
+                            #     series1 sources: B1:B5, D10:D12
+                            #     series2 sources: C1:C5, E10:E12
+                          { # A range on a sheet.
+                              # All indexes are zero-based.
+                              # Indexes are half open, e.g the start index is inclusive
+                              # and the end index is exclusive -- [start_index, end_index).
+                              # Missing indexes indicate the range is unbounded on that side.
+                              #
+                              # For example, if `"Sheet1"` is sheet ID 0, then:
+                              #
+                              #   `Sheet1!A1:A1 == sheet_id: 0,
+                              #                   start_row_index: 0, end_row_index: 1,
+                              #                   start_column_index: 0, end_column_index: 1`
+                              #
+                              #   `Sheet1!A3:B4 == sheet_id: 0,
+                              #                   start_row_index: 2, end_row_index: 4,
+                              #                   start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A:B == sheet_id: 0,
+                              #                 start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A5:B == sheet_id: 0,
+                              #                  start_row_index: 4,
+                              #                  start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1 == sheet_id:0`
+                              #
+                              # The start index must always be less than or equal to the end index.
+                              # If the start index equals the end index, then the range is empty.
+                              # Empty ranges are typically not meaningful and are usually rendered in the
+                              # UI as `#REF!`.
+                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                            "sheetId": 42, # The sheet this range is on.
+                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                          },
+                        ],
+                      },
+                    },
+                  },
+                ],
+                "chartType": "A String", # The type of the chart.
+                "axis": [ # The axis on the chart.
+                  { # An axis of the chart.
+                      # A chart may not have more than one axis per
+                      # axis position.
+                    "position": "A String", # The position of this axis.
+                    "format": { # The format of a run of text in a cell. # The format of the title.
+                        # Only valid if the axis is not associated with the domain.
+                        # Absent values indicate that the field isn't specified.
+                      "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                          # for simplicity of conversion to/from color representations in various
+                          # languages over compactness; for example, the fields of this representation
+                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                          # method in iOS; and, with just a little work, it can be easily formatted into
+                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                          #
+                          # Example (Java):
+                          #
+                          #      import com.google.type.Color;
+                          #
+                          #      // ...
+                          #      public static java.awt.Color fromProto(Color protocolor) {
+                          #        float alpha = protocolor.hasAlpha()
+                          #            ? protocolor.getAlpha().getValue()
+                          #            : 1.0;
+                          #
+                          #        return new java.awt.Color(
+                          #            protocolor.getRed(),
+                          #            protocolor.getGreen(),
+                          #            protocolor.getBlue(),
+                          #            alpha);
+                          #      }
+                          #
+                          #      public static Color toProto(java.awt.Color color) {
+                          #        float red = (float) color.getRed();
+                          #        float green = (float) color.getGreen();
+                          #        float blue = (float) color.getBlue();
+                          #        float denominator = 255.0;
+                          #        Color.Builder resultBuilder =
+                          #            Color
+                          #                .newBuilder()
+                          #                .setRed(red / denominator)
+                          #                .setGreen(green / denominator)
+                          #                .setBlue(blue / denominator);
+                          #        int alpha = color.getAlpha();
+                          #        if (alpha != 255) {
+                          #          result.setAlpha(
+                          #              FloatValue
+                          #                  .newBuilder()
+                          #                  .setValue(((float) alpha) / denominator)
+                          #                  .build());
+                          #        }
+                          #        return resultBuilder.build();
+                          #      }
+                          #      // ...
+                          #
+                          # Example (iOS / Obj-C):
+                          #
+                          #      // ...
+                          #      static UIColor* fromProto(Color* protocolor) {
+                          #         float red = [protocolor red];
+                          #         float green = [protocolor green];
+                          #         float blue = [protocolor blue];
+                          #         FloatValue* alpha_wrapper = [protocolor alpha];
+                          #         float alpha = 1.0;
+                          #         if (alpha_wrapper != nil) {
+                          #           alpha = [alpha_wrapper value];
+                          #         }
+                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                          #      }
+                          #
+                          #      static Color* toProto(UIColor* color) {
+                          #          CGFloat red, green, blue, alpha;
+                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                          #            return nil;
+                          #          }
+                          #          Color* result = [Color alloc] init];
+                          #          [result setRed:red];
+                          #          [result setGreen:green];
+                          #          [result setBlue:blue];
+                          #          if (alpha <= 0.9999) {
+                          #            [result setAlpha:floatWrapperWithValue(alpha)];
+                          #          }
+                          #          [result autorelease];
+                          #          return result;
+                          #     }
+                          #     // ...
+                          #
+                          #  Example (JavaScript):
+                          #
+                          #     // ...
+                          #
+                          #     var protoToCssColor = function(rgb_color) {
+                          #        var redFrac = rgb_color.red || 0.0;
+                          #        var greenFrac = rgb_color.green || 0.0;
+                          #        var blueFrac = rgb_color.blue || 0.0;
+                          #        var red = Math.floor(redFrac * 255);
+                          #        var green = Math.floor(greenFrac * 255);
+                          #        var blue = Math.floor(blueFrac * 255);
+                          #
+                          #        if (!('alpha' in rgb_color)) {
+                          #           return rgbToCssColor_(red, green, blue);
+                          #        }
+                          #
+                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                          #        var rgbParams = [red, green, blue].join(',');
+                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                          #     };
+                          #
+                          #     var rgbToCssColor_ = function(red, green, blue) {
+                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                          #       var hexString = rgbNumber.toString(16);
+                          #       var missingZeros = 6 - hexString.length;
+                          #       var resultBuilder = ['#'];
+                          #       for (var i = 0; i < missingZeros; i++) {
+                          #          resultBuilder.push('0');
+                          #       }
+                          #       resultBuilder.push(hexString);
+                          #       return resultBuilder.join('');
+                          #     };
+                          #
+                          #     // ...
+                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                            # the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color. This
+                            # uses a wrapper message rather than a simple float scalar so that it is
+                            # possible to distinguish between a default value and the value being unset.
+                            # If omitted, this color object is to be rendered as a solid color
+                            # (as if the alpha value had been explicitly given with a value of 1.0).
+                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                      },
+                      "bold": True or False, # True if the text is bold.
+                      "strikethrough": True or False, # True if the text has a strikethrough.
+                      "fontFamily": "A String", # The font family.
+                      "fontSize": 42, # The size of the font.
+                      "italic": True or False, # True if the text is italicized.
+                      "underline": True or False, # True if the text is underlined.
+                    },
+                    "title": "A String", # The title of this axis. If set, this overrides any title inferred
+                        # from headers of the data.
+                  },
+                ],
+              },
+              "title": "A String", # The title of the chart.
+            },
+          },
+        },
+        "updateConditionalFormatRule": { # The result of updating a conditional format rule. # A reply from updating a conditional format rule.
+          "oldIndex": 42, # The old index of the rule. Not set if a rule was replaced
+              # (because it is the same as new_index).
+          "newIndex": 42, # The index of the new rule.
+          "oldRule": { # A rule describing a conditional format. # The old (deleted) rule. Not set if a rule was moved
+              # (because it is the same as new_rule).
+            "ranges": [ # The ranges that will be formatted if the condition is true.
+                # All the ranges must be on the same grid.
+              { # A range on a sheet.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+            ],
+            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
+              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
+                  # the format will be applied.
+                  # BooleanConditions are used by conditional formatting,
+                  # data validation, and the criteria in filters.
+                "type": "A String", # The type of condition.
+                "values": [ # The values of the condition. The number of supported values depends
+                    # on the condition type.  Some support zero values,
+                    # others one or two values,
+                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                  { # The value of the condition.
+                    "relativeDate": "A String", # A relative date (based on the current date).
+                        # Valid only if the type is
+                        # DATE_BEFORE,
+                        # DATE_AFTER,
+                        # DATE_ON_OR_BEFORE or
+                        # DATE_ON_OR_AFTER.
+                        #
+                        # Relative dates are not supported in data validation.
+                        # They are supported only in conditional formatting and
+                        # conditional filters.
+                    "userEnteredValue": "A String", # A value the condition is based on.
+                        # The value will be parsed as if the user typed into a cell.
+                        # Formulas are supported (and must begin with an `=`).
+                  },
+                ],
+              },
+              "format": { # The format of a cell. # The format to apply.
+                  # Conditional formatting can only apply a subset of formatting:
+                  # bold, italic,
+                  # strikethrough,
+                  # foreground color &
+                  # background color.
+                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                      # the user's locale will be used if necessary for the given type.
+                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                      # information about the supported patterns.
+                  "type": "A String", # The type of the number format.
+                      # When writing, this field must be set.
+                },
+                "textDirection": "A String", # The direction of the text in the cell.
+                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                    # When updating padding, every field must be specified.
+                  "top": 42, # The top padding of the cell.
+                  "right": 42, # The right padding of the cell.
+                  "bottom": 42, # The bottom padding of the cell.
+                  "left": 42, # The left padding of the cell.
+                },
+                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                    # Absent values indicate that the field isn't specified.
+                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                      # for simplicity of conversion to/from color representations in various
+                      # languages over compactness; for example, the fields of this representation
+                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                      # method in iOS; and, with just a little work, it can be easily formatted into
+                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                      #
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "bold": True or False, # True if the text is bold.
+                  "strikethrough": True or False, # True if the text has a strikethrough.
+                  "fontFamily": "A String", # The font family.
+                  "fontSize": 42, # The size of the font.
+                  "italic": True or False, # True if the text is italicized.
+                  "underline": True or False, # True if the text is underlined.
+                },
+                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                "borders": { # The borders of the cell. # The borders of the cell.
+                  "top": { # A border along a cell. # The top border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "right": { # A border along a cell. # The right border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "bottom": { # A border along a cell. # The bottom border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "left": { # A border along a cell. # The left border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                },
+                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+              },
+            },
+            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
+                # the interpolation points listed. The format of a cell will vary
+                # based on its contents as compared to the values of the interpolation
+                # points.
+              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+            },
+          },
+          "newRule": { # A rule describing a conditional format. # The new rule that replaced the old rule (if replacing),
+              # or the rule that was moved (if moved)
+            "ranges": [ # The ranges that will be formatted if the condition is true.
+                # All the ranges must be on the same grid.
+              { # A range on a sheet.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+            ],
+            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
+              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
+                  # the format will be applied.
+                  # BooleanConditions are used by conditional formatting,
+                  # data validation, and the criteria in filters.
+                "type": "A String", # The type of condition.
+                "values": [ # The values of the condition. The number of supported values depends
+                    # on the condition type.  Some support zero values,
+                    # others one or two values,
+                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                  { # The value of the condition.
+                    "relativeDate": "A String", # A relative date (based on the current date).
+                        # Valid only if the type is
+                        # DATE_BEFORE,
+                        # DATE_AFTER,
+                        # DATE_ON_OR_BEFORE or
+                        # DATE_ON_OR_AFTER.
+                        #
+                        # Relative dates are not supported in data validation.
+                        # They are supported only in conditional formatting and
+                        # conditional filters.
+                    "userEnteredValue": "A String", # A value the condition is based on.
+                        # The value will be parsed as if the user typed into a cell.
+                        # Formulas are supported (and must begin with an `=`).
+                  },
+                ],
+              },
+              "format": { # The format of a cell. # The format to apply.
+                  # Conditional formatting can only apply a subset of formatting:
+                  # bold, italic,
+                  # strikethrough,
+                  # foreground color &
+                  # background color.
+                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                      # the user's locale will be used if necessary for the given type.
+                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                      # information about the supported patterns.
+                  "type": "A String", # The type of the number format.
+                      # When writing, this field must be set.
+                },
+                "textDirection": "A String", # The direction of the text in the cell.
+                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                    # When updating padding, every field must be specified.
+                  "top": 42, # The top padding of the cell.
+                  "right": 42, # The right padding of the cell.
+                  "bottom": 42, # The bottom padding of the cell.
+                  "left": 42, # The left padding of the cell.
+                },
+                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                    # Absent values indicate that the field isn't specified.
+                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                      # for simplicity of conversion to/from color representations in various
+                      # languages over compactness; for example, the fields of this representation
+                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                      # method in iOS; and, with just a little work, it can be easily formatted into
+                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                      #
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "bold": True or False, # True if the text is bold.
+                  "strikethrough": True or False, # True if the text has a strikethrough.
+                  "fontFamily": "A String", # The font family.
+                  "fontSize": 42, # The size of the font.
+                  "italic": True or False, # True if the text is italicized.
+                  "underline": True or False, # True if the text is underlined.
+                },
+                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                "borders": { # The borders of the cell. # The borders of the cell.
+                  "top": { # A border along a cell. # The top border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "right": { # A border along a cell. # The right border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "bottom": { # A border along a cell. # The bottom border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "left": { # A border along a cell. # The left border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                },
+                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+              },
+            },
+            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
+                # the interpolation points listed. The format of a cell will vary
+                # based on its contents as compared to the values of the interpolation
+                # points.
+              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+            },
+          },
+        },
+        "addSheet": { # The result of adding a sheet. # A reply from adding a sheet.
+          "properties": { # Properties of a sheet. # The properties of the newly added sheet.
+            "sheetType": "A String", # The type of sheet. Defaults to GRID.
+                # This field cannot be changed once set.
+            "index": 42, # The index of the sheet within the spreadsheet.
+                # When adding or updating sheet properties, if this field
+                # is excluded then the sheet will be added or moved to the end
+                # of the sheet list. When updating sheet indices or inserting
+                # sheets, movement is considered in "before the move" indexes.
+                # For example, if there were 3 sheets (S1, S2, S3) in order to
+                # move S1 ahead of S2 the index would have to be set to 2. A sheet
+                # index update request will be ignored if the requested index is
+                # identical to the sheets current index or if the requested new
+                # index is equal to the current sheet index + 1.
+            "title": "A String", # The name of the sheet.
+            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
+                # (If the sheet is an object sheet, containing a chart or image, then
+                # this field will be absent.)
+                # When writing it is an error to set any grid properties on non-grid sheets.
+              "columnCount": 42, # The number of columns in the grid.
+              "rowCount": 42, # The number of rows in the grid.
+              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
+              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
+              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
+            },
+            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
+            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
+            "sheetId": 42, # The ID of the sheet. Must be non-negative.
+                # This field cannot be changed once set.
+          },
+        },
+        "findReplace": { # The result of the find/replace. # A reply from doing a find/replace.
+          "occurrencesChanged": 42, # The number of occurrences (possibly multiple within a cell) changed.
+              # For example, if replacing `"e"` with `"o"` in `"Google Sheets"`, this would
+              # be `"3"` because `"Google Sheets"` -> `"Googlo Shoots"`.
+          "sheetsChanged": 42, # The number of sheets changed.
+          "rowsChanged": 42, # The number of rows changed.
+          "valuesChanged": 42, # The number of non-formula cells changed.
+          "formulasChanged": 42, # The number of formula cells changed.
+        },
+        "addNamedRange": { # The result of adding a named range. # A reply from adding a named range.
+          "namedRange": { # A named range. # The named range to add.
+            "namedRangeId": "A String", # The ID of the named range.
+            "range": { # A range on a sheet. # The range this represents.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "name": "A String", # The name of the named range.
+          },
+        },
+        "addProtectedRange": { # The result of adding a new protected range. # A reply from adding a protected range.
+          "protectedRange": { # A protected range. # The newly added protected range.
+            "unprotectedRanges": [ # The list of unprotected ranges within a protected sheet.
+                # Unprotected ranges are only supported on protected sheets.
+              { # A range on a sheet.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+            ],
+            "requestingUserCanEdit": True or False, # True if the user who requested this protected range can edit the
+                # protected area.
+                # This field is read-only.
+            "description": "A String", # The description of this protected range.
+            "namedRangeId": "A String", # The named range this protected range is backed by, if any.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "editors": { # The editors of a protected range. # The users and groups with edit access to the protected range.
+                # This field is only visible to users with edit access to the protected
+                # range and the document.
+                # Editors are not supported with warning_only protection.
+              "domainUsersCanEdit": True or False, # True if anyone in the document's domain has edit access to the protected
+                  # range.  Domain protection is only supported on documents within a domain.
+              "users": [ # The email addresses of users with edit access to the protected range.
+                "A String",
+              ],
+              "groups": [ # The email addresses of groups with edit access to the protected range.
+                "A String",
+              ],
+            },
+            "protectedRangeId": 42, # The ID of the protected range.
+                # This field is read-only.
+            "warningOnly": True or False, # True if this protected range will show a warning when editing.
+                # Warning-based protection means that every user can edit data in the
+                # protected range, except editing will prompt a warning asking the user
+                # to confirm the edit.
+                #
+                # When writing: if this field is true, then editors is ignored.
+                # Additionally, if this field is changed from true to false and the
+                # `editors` field is not set (nor included in the field mask), then
+                # the editors will be set to all the editors in the document.
+            "range": { # A range on a sheet. # The range that is being protected.
+                # The range may be fully unbounded, in which case this is considered
+                # a protected sheet.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+          },
+        },
+        "deleteConditionalFormatRule": { # The result of deleting a conditional format rule. # A reply from deleting a conditional format rule.
+          "rule": { # A rule describing a conditional format. # The rule that was deleted.
+            "ranges": [ # The ranges that will be formatted if the condition is true.
+                # All the ranges must be on the same grid.
+              { # A range on a sheet.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+            ],
+            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
+              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
+                  # the format will be applied.
+                  # BooleanConditions are used by conditional formatting,
+                  # data validation, and the criteria in filters.
+                "type": "A String", # The type of condition.
+                "values": [ # The values of the condition. The number of supported values depends
+                    # on the condition type.  Some support zero values,
+                    # others one or two values,
+                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                  { # The value of the condition.
+                    "relativeDate": "A String", # A relative date (based on the current date).
+                        # Valid only if the type is
+                        # DATE_BEFORE,
+                        # DATE_AFTER,
+                        # DATE_ON_OR_BEFORE or
+                        # DATE_ON_OR_AFTER.
+                        #
+                        # Relative dates are not supported in data validation.
+                        # They are supported only in conditional formatting and
+                        # conditional filters.
+                    "userEnteredValue": "A String", # A value the condition is based on.
+                        # The value will be parsed as if the user typed into a cell.
+                        # Formulas are supported (and must begin with an `=`).
+                  },
+                ],
+              },
+              "format": { # The format of a cell. # The format to apply.
+                  # Conditional formatting can only apply a subset of formatting:
+                  # bold, italic,
+                  # strikethrough,
+                  # foreground color &
+                  # background color.
+                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                      # the user's locale will be used if necessary for the given type.
+                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                      # information about the supported patterns.
+                  "type": "A String", # The type of the number format.
+                      # When writing, this field must be set.
+                },
+                "textDirection": "A String", # The direction of the text in the cell.
+                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                    # When updating padding, every field must be specified.
+                  "top": 42, # The top padding of the cell.
+                  "right": 42, # The right padding of the cell.
+                  "bottom": 42, # The bottom padding of the cell.
+                  "left": 42, # The left padding of the cell.
+                },
+                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                    # Absent values indicate that the field isn't specified.
+                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                      # for simplicity of conversion to/from color representations in various
+                      # languages over compactness; for example, the fields of this representation
+                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                      # method in iOS; and, with just a little work, it can be easily formatted into
+                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                      #
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "bold": True or False, # True if the text is bold.
+                  "strikethrough": True or False, # True if the text has a strikethrough.
+                  "fontFamily": "A String", # The font family.
+                  "fontSize": 42, # The size of the font.
+                  "italic": True or False, # True if the text is italicized.
+                  "underline": True or False, # True if the text is underlined.
+                },
+                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                "borders": { # The borders of the cell. # The borders of the cell.
+                  "top": { # A border along a cell. # The top border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "right": { # A border along a cell. # The right border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "bottom": { # A border along a cell. # The bottom border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "left": { # A border along a cell. # The left border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                },
+                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+              },
+            },
+            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
+                # the interpolation points listed. The format of a cell will vary
+                # based on its contents as compared to the values of the interpolation
+                # points.
+              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+            },
+          },
+        },
+        "addBanding": { # The result of adding a banded range. # A reply from adding a banded range.
+          "bandedRange": { # A banded (alternating colors) range in a sheet. # The banded range that was added.
+            "range": { # A range on a sheet. # The range over which these properties are applied.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "columnProperties": { # Properties referring a single dimension (either row or column). If both # Properties for column bands. These properties will be applied on a column-
+                # by-column basis throughout all the columns in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+            },
+            "rowProperties": { # Properties referring a single dimension (either row or column). If both # Properties for row bands. These properties will be applied on a row-by-row
+                # basis throughout all the rows in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+            },
+            "bandedRangeId": 42, # The id of the banded range.
+          },
+        },
+        "addFilterView": { # The result of adding a filter view. # A reply from adding a filter view.
+          "filter": { # A filter view. # The newly added filter view.
+            "title": "A String", # The name of the filter view.
+            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "filterViewId": 42, # The ID of the filter view.
+            "range": { # A range on a sheet. # The range this filter view covers.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "sortSpecs": [ # The sort order per column. Later specifications are used when values
+                # are equal in the earlier specifications.
+              { # A sort order associated with a specific column or row.
+                "sortOrder": "A String", # The order data should be sorted.
+                "dimensionIndex": 42, # The dimension the sort should be applied to.
+              },
+            ],
+            "criteria": { # The criteria for showing/hiding values per column.
+                # The map's key is the column index, and the value is the criteria for
+                # that column.
+              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+                "hiddenValues": [ # Values that should be hidden.
+                  "A String",
+                ],
+                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                    # (This does not override hiddenValues -- if a value is listed there,
+                    #  it will still be hidden.)
+                    # BooleanConditions are used by conditional formatting,
+                    # data validation, and the criteria in filters.
+                  "type": "A String", # The type of condition.
+                  "values": [ # The values of the condition. The number of supported values depends
+                      # on the condition type.  Some support zero values,
+                      # others one or two values,
+                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                    { # The value of the condition.
+                      "relativeDate": "A String", # A relative date (based on the current date).
+                          # Valid only if the type is
+                          # DATE_BEFORE,
+                          # DATE_AFTER,
+                          # DATE_ON_OR_BEFORE or
+                          # DATE_ON_OR_AFTER.
+                          #
+                          # Relative dates are not supported in data validation.
+                          # They are supported only in conditional formatting and
+                          # conditional filters.
+                      "userEnteredValue": "A String", # A value the condition is based on.
+                          # The value will be parsed as if the user typed into a cell.
+                          # Formulas are supported (and must begin with an `=`).
+                    },
+                  ],
+                },
+              },
+            },
+          },
+        },
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="create">create(body, x__xgafv=None)</code>
+  <pre>Creates a spreadsheet, returning the newly created spreadsheet.
+
+Args:
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Resource that represents a spreadsheet.
+  "spreadsheetId": "A String", # The ID of the spreadsheet.
+      # This field is read-only.
+  "namedRanges": [ # The named ranges defined in a spreadsheet.
+    { # A named range.
+      "namedRangeId": "A String", # The ID of the named range.
+      "range": { # A range on a sheet. # The range this represents.
+          # All indexes are zero-based.
+          # Indexes are half open, e.g the start index is inclusive
+          # and the end index is exclusive -- [start_index, end_index).
+          # Missing indexes indicate the range is unbounded on that side.
+          #
+          # For example, if `"Sheet1"` is sheet ID 0, then:
+          #
+          #   `Sheet1!A1:A1 == sheet_id: 0,
+          #                   start_row_index: 0, end_row_index: 1,
+          #                   start_column_index: 0, end_column_index: 1`
+          #
+          #   `Sheet1!A3:B4 == sheet_id: 0,
+          #                   start_row_index: 2, end_row_index: 4,
+          #                   start_column_index: 0, end_column_index: 2`
+          #
+          #   `Sheet1!A:B == sheet_id: 0,
+          #                 start_column_index: 0, end_column_index: 2`
+          #
+          #   `Sheet1!A5:B == sheet_id: 0,
+          #                  start_row_index: 4,
+          #                  start_column_index: 0, end_column_index: 2`
+          #
+          #   `Sheet1 == sheet_id:0`
+          #
+          # The start index must always be less than or equal to the end index.
+          # If the start index equals the end index, then the range is empty.
+          # Empty ranges are typically not meaningful and are usually rendered in the
+          # UI as `#REF!`.
+        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+        "sheetId": 42, # The sheet this range is on.
+        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+      },
+      "name": "A String", # The name of the named range.
+    },
+  ],
+  "properties": { # Properties of a spreadsheet. # Overall properties of a spreadsheet.
+    "locale": "A String", # The locale of the spreadsheet in one of the following formats:
+        #
+        # * an ISO 639-1 language code such as `en`
+        #
+        # * an ISO 639-2 language code such as `fil`, if no 639-1 code exists
+        #
+        # * a combination of the ISO language code and country code, such as `en_US`
+        #
+        # Note: when updating this field, not all locales/languages are supported.
+    "timeZone": "A String", # The time zone of the spreadsheet, in CLDR format such as
+        # `America/New_York`. If the time zone isn't recognized, this may
+        # be a custom time zone such as `GMT-07:00`.
+    "autoRecalc": "A String", # The amount of time to wait before volatile functions are recalculated.
+    "defaultFormat": { # The format of a cell. # The default format of all cells in the spreadsheet.
+        # CellData.effectiveFormat will not be set if the
+        # cell's format is equal to this default format.
+        # This field is read-only.
+      "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+        "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+            # the user's locale will be used if necessary for the given type.
+            # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+            # information about the supported patterns.
+        "type": "A String", # The type of the number format.
+            # When writing, this field must be set.
+      },
+      "textDirection": "A String", # The direction of the text in the cell.
+      "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+          # When updating padding, every field must be specified.
+        "top": 42, # The top padding of the cell.
+        "right": 42, # The right padding of the cell.
+        "bottom": 42, # The bottom padding of the cell.
+        "left": 42, # The left padding of the cell.
+      },
+      "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+      "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+          # for simplicity of conversion to/from color representations in various
+          # languages over compactness; for example, the fields of this representation
+          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+          # method in iOS; and, with just a little work, it can be easily formatted into
+          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+          #
+          # Example (Java):
+          #
+          #      import com.google.type.Color;
+          #
+          #      // ...
+          #      public static java.awt.Color fromProto(Color protocolor) {
+          #        float alpha = protocolor.hasAlpha()
+          #            ? protocolor.getAlpha().getValue()
+          #            : 1.0;
+          #
+          #        return new java.awt.Color(
+          #            protocolor.getRed(),
+          #            protocolor.getGreen(),
+          #            protocolor.getBlue(),
+          #            alpha);
+          #      }
+          #
+          #      public static Color toProto(java.awt.Color color) {
+          #        float red = (float) color.getRed();
+          #        float green = (float) color.getGreen();
+          #        float blue = (float) color.getBlue();
+          #        float denominator = 255.0;
+          #        Color.Builder resultBuilder =
+          #            Color
+          #                .newBuilder()
+          #                .setRed(red / denominator)
+          #                .setGreen(green / denominator)
+          #                .setBlue(blue / denominator);
+          #        int alpha = color.getAlpha();
+          #        if (alpha != 255) {
+          #          result.setAlpha(
+          #              FloatValue
+          #                  .newBuilder()
+          #                  .setValue(((float) alpha) / denominator)
+          #                  .build());
+          #        }
+          #        return resultBuilder.build();
+          #      }
+          #      // ...
+          #
+          # Example (iOS / Obj-C):
+          #
+          #      // ...
+          #      static UIColor* fromProto(Color* protocolor) {
+          #         float red = [protocolor red];
+          #         float green = [protocolor green];
+          #         float blue = [protocolor blue];
+          #         FloatValue* alpha_wrapper = [protocolor alpha];
+          #         float alpha = 1.0;
+          #         if (alpha_wrapper != nil) {
+          #           alpha = [alpha_wrapper value];
+          #         }
+          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+          #      }
+          #
+          #      static Color* toProto(UIColor* color) {
+          #          CGFloat red, green, blue, alpha;
+          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+          #            return nil;
+          #          }
+          #          Color* result = [Color alloc] init];
+          #          [result setRed:red];
+          #          [result setGreen:green];
+          #          [result setBlue:blue];
+          #          if (alpha <= 0.9999) {
+          #            [result setAlpha:floatWrapperWithValue(alpha)];
+          #          }
+          #          [result autorelease];
+          #          return result;
+          #     }
+          #     // ...
+          #
+          #  Example (JavaScript):
+          #
+          #     // ...
+          #
+          #     var protoToCssColor = function(rgb_color) {
+          #        var redFrac = rgb_color.red || 0.0;
+          #        var greenFrac = rgb_color.green || 0.0;
+          #        var blueFrac = rgb_color.blue || 0.0;
+          #        var red = Math.floor(redFrac * 255);
+          #        var green = Math.floor(greenFrac * 255);
+          #        var blue = Math.floor(blueFrac * 255);
+          #
+          #        if (!('alpha' in rgb_color)) {
+          #           return rgbToCssColor_(red, green, blue);
+          #        }
+          #
+          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+          #        var rgbParams = [red, green, blue].join(',');
+          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+          #     };
+          #
+          #     var rgbToCssColor_ = function(red, green, blue) {
+          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+          #       var hexString = rgbNumber.toString(16);
+          #       var missingZeros = 6 - hexString.length;
+          #       var resultBuilder = ['#'];
+          #       for (var i = 0; i < missingZeros; i++) {
+          #          resultBuilder.push('0');
+          #       }
+          #       resultBuilder.push(hexString);
+          #       return resultBuilder.join('');
+          #     };
+          #
+          #     // ...
+        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+            # the final pixel color is defined by the equation:
+            #
+            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+            #
+            # This means that a value of 1.0 corresponds to a solid color, whereas
+            # a value of 0.0 corresponds to a completely transparent color. This
+            # uses a wrapper message rather than a simple float scalar so that it is
+            # possible to distinguish between a default value and the value being unset.
+            # If omitted, this color object is to be rendered as a solid color
+            # (as if the alpha value had been explicitly given with a value of 1.0).
+        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+      },
+      "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+      "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+          # Absent values indicate that the field isn't specified.
+        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+            # for simplicity of conversion to/from color representations in various
+            # languages over compactness; for example, the fields of this representation
+            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+            # method in iOS; and, with just a little work, it can be easily formatted into
+            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+            #
+            # Example (Java):
+            #
+            #      import com.google.type.Color;
+            #
+            #      // ...
+            #      public static java.awt.Color fromProto(Color protocolor) {
+            #        float alpha = protocolor.hasAlpha()
+            #            ? protocolor.getAlpha().getValue()
+            #            : 1.0;
+            #
+            #        return new java.awt.Color(
+            #            protocolor.getRed(),
+            #            protocolor.getGreen(),
+            #            protocolor.getBlue(),
+            #            alpha);
+            #      }
+            #
+            #      public static Color toProto(java.awt.Color color) {
+            #        float red = (float) color.getRed();
+            #        float green = (float) color.getGreen();
+            #        float blue = (float) color.getBlue();
+            #        float denominator = 255.0;
+            #        Color.Builder resultBuilder =
+            #            Color
+            #                .newBuilder()
+            #                .setRed(red / denominator)
+            #                .setGreen(green / denominator)
+            #                .setBlue(blue / denominator);
+            #        int alpha = color.getAlpha();
+            #        if (alpha != 255) {
+            #          result.setAlpha(
+            #              FloatValue
+            #                  .newBuilder()
+            #                  .setValue(((float) alpha) / denominator)
+            #                  .build());
+            #        }
+            #        return resultBuilder.build();
+            #      }
+            #      // ...
+            #
+            # Example (iOS / Obj-C):
+            #
+            #      // ...
+            #      static UIColor* fromProto(Color* protocolor) {
+            #         float red = [protocolor red];
+            #         float green = [protocolor green];
+            #         float blue = [protocolor blue];
+            #         FloatValue* alpha_wrapper = [protocolor alpha];
+            #         float alpha = 1.0;
+            #         if (alpha_wrapper != nil) {
+            #           alpha = [alpha_wrapper value];
+            #         }
+            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+            #      }
+            #
+            #      static Color* toProto(UIColor* color) {
+            #          CGFloat red, green, blue, alpha;
+            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+            #            return nil;
+            #          }
+            #          Color* result = [Color alloc] init];
+            #          [result setRed:red];
+            #          [result setGreen:green];
+            #          [result setBlue:blue];
+            #          if (alpha <= 0.9999) {
+            #            [result setAlpha:floatWrapperWithValue(alpha)];
+            #          }
+            #          [result autorelease];
+            #          return result;
+            #     }
+            #     // ...
+            #
+            #  Example (JavaScript):
+            #
+            #     // ...
+            #
+            #     var protoToCssColor = function(rgb_color) {
+            #        var redFrac = rgb_color.red || 0.0;
+            #        var greenFrac = rgb_color.green || 0.0;
+            #        var blueFrac = rgb_color.blue || 0.0;
+            #        var red = Math.floor(redFrac * 255);
+            #        var green = Math.floor(greenFrac * 255);
+            #        var blue = Math.floor(blueFrac * 255);
+            #
+            #        if (!('alpha' in rgb_color)) {
+            #           return rgbToCssColor_(red, green, blue);
+            #        }
+            #
+            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+            #        var rgbParams = [red, green, blue].join(',');
+            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+            #     };
+            #
+            #     var rgbToCssColor_ = function(red, green, blue) {
+            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+            #       var hexString = rgbNumber.toString(16);
+            #       var missingZeros = 6 - hexString.length;
+            #       var resultBuilder = ['#'];
+            #       for (var i = 0; i < missingZeros; i++) {
+            #          resultBuilder.push('0');
+            #       }
+            #       resultBuilder.push(hexString);
+            #       return resultBuilder.join('');
+            #     };
+            #
+            #     // ...
+          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+              # the final pixel color is defined by the equation:
+              #
+              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+              #
+              # This means that a value of 1.0 corresponds to a solid color, whereas
+              # a value of 0.0 corresponds to a completely transparent color. This
+              # uses a wrapper message rather than a simple float scalar so that it is
+              # possible to distinguish between a default value and the value being unset.
+              # If omitted, this color object is to be rendered as a solid color
+              # (as if the alpha value had been explicitly given with a value of 1.0).
+          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+        },
+        "bold": True or False, # True if the text is bold.
+        "strikethrough": True or False, # True if the text has a strikethrough.
+        "fontFamily": "A String", # The font family.
+        "fontSize": 42, # The size of the font.
+        "italic": True or False, # True if the text is italicized.
+        "underline": True or False, # True if the text is underlined.
+      },
+      "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+      "borders": { # The borders of the cell. # The borders of the cell.
+        "top": { # A border along a cell. # The top border of the cell.
+          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+              # for simplicity of conversion to/from color representations in various
+              # languages over compactness; for example, the fields of this representation
+              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+              # method in iOS; and, with just a little work, it can be easily formatted into
+              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+              #
+              # Example (Java):
+              #
+              #      import com.google.type.Color;
+              #
+              #      // ...
+              #      public static java.awt.Color fromProto(Color protocolor) {
+              #        float alpha = protocolor.hasAlpha()
+              #            ? protocolor.getAlpha().getValue()
+              #            : 1.0;
+              #
+              #        return new java.awt.Color(
+              #            protocolor.getRed(),
+              #            protocolor.getGreen(),
+              #            protocolor.getBlue(),
+              #            alpha);
+              #      }
+              #
+              #      public static Color toProto(java.awt.Color color) {
+              #        float red = (float) color.getRed();
+              #        float green = (float) color.getGreen();
+              #        float blue = (float) color.getBlue();
+              #        float denominator = 255.0;
+              #        Color.Builder resultBuilder =
+              #            Color
+              #                .newBuilder()
+              #                .setRed(red / denominator)
+              #                .setGreen(green / denominator)
+              #                .setBlue(blue / denominator);
+              #        int alpha = color.getAlpha();
+              #        if (alpha != 255) {
+              #          result.setAlpha(
+              #              FloatValue
+              #                  .newBuilder()
+              #                  .setValue(((float) alpha) / denominator)
+              #                  .build());
+              #        }
+              #        return resultBuilder.build();
+              #      }
+              #      // ...
+              #
+              # Example (iOS / Obj-C):
+              #
+              #      // ...
+              #      static UIColor* fromProto(Color* protocolor) {
+              #         float red = [protocolor red];
+              #         float green = [protocolor green];
+              #         float blue = [protocolor blue];
+              #         FloatValue* alpha_wrapper = [protocolor alpha];
+              #         float alpha = 1.0;
+              #         if (alpha_wrapper != nil) {
+              #           alpha = [alpha_wrapper value];
+              #         }
+              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+              #      }
+              #
+              #      static Color* toProto(UIColor* color) {
+              #          CGFloat red, green, blue, alpha;
+              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+              #            return nil;
+              #          }
+              #          Color* result = [Color alloc] init];
+              #          [result setRed:red];
+              #          [result setGreen:green];
+              #          [result setBlue:blue];
+              #          if (alpha <= 0.9999) {
+              #            [result setAlpha:floatWrapperWithValue(alpha)];
+              #          }
+              #          [result autorelease];
+              #          return result;
+              #     }
+              #     // ...
+              #
+              #  Example (JavaScript):
+              #
+              #     // ...
+              #
+              #     var protoToCssColor = function(rgb_color) {
+              #        var redFrac = rgb_color.red || 0.0;
+              #        var greenFrac = rgb_color.green || 0.0;
+              #        var blueFrac = rgb_color.blue || 0.0;
+              #        var red = Math.floor(redFrac * 255);
+              #        var green = Math.floor(greenFrac * 255);
+              #        var blue = Math.floor(blueFrac * 255);
+              #
+              #        if (!('alpha' in rgb_color)) {
+              #           return rgbToCssColor_(red, green, blue);
+              #        }
+              #
+              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+              #        var rgbParams = [red, green, blue].join(',');
+              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+              #     };
+              #
+              #     var rgbToCssColor_ = function(red, green, blue) {
+              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+              #       var hexString = rgbNumber.toString(16);
+              #       var missingZeros = 6 - hexString.length;
+              #       var resultBuilder = ['#'];
+              #       for (var i = 0; i < missingZeros; i++) {
+              #          resultBuilder.push('0');
+              #       }
+              #       resultBuilder.push(hexString);
+              #       return resultBuilder.join('');
+              #     };
+              #
+              #     // ...
+            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                # the final pixel color is defined by the equation:
+                #
+                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                #
+                # This means that a value of 1.0 corresponds to a solid color, whereas
+                # a value of 0.0 corresponds to a completely transparent color. This
+                # uses a wrapper message rather than a simple float scalar so that it is
+                # possible to distinguish between a default value and the value being unset.
+                # If omitted, this color object is to be rendered as a solid color
+                # (as if the alpha value had been explicitly given with a value of 1.0).
+            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+          },
+          "width": 42, # The width of the border, in pixels.
+              # Deprecated; the width is determined by the "style" field.
+          "style": "A String", # The style of the border.
+        },
+        "right": { # A border along a cell. # The right border of the cell.
+          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+              # for simplicity of conversion to/from color representations in various
+              # languages over compactness; for example, the fields of this representation
+              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+              # method in iOS; and, with just a little work, it can be easily formatted into
+              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+              #
+              # Example (Java):
+              #
+              #      import com.google.type.Color;
+              #
+              #      // ...
+              #      public static java.awt.Color fromProto(Color protocolor) {
+              #        float alpha = protocolor.hasAlpha()
+              #            ? protocolor.getAlpha().getValue()
+              #            : 1.0;
+              #
+              #        return new java.awt.Color(
+              #            protocolor.getRed(),
+              #            protocolor.getGreen(),
+              #            protocolor.getBlue(),
+              #            alpha);
+              #      }
+              #
+              #      public static Color toProto(java.awt.Color color) {
+              #        float red = (float) color.getRed();
+              #        float green = (float) color.getGreen();
+              #        float blue = (float) color.getBlue();
+              #        float denominator = 255.0;
+              #        Color.Builder resultBuilder =
+              #            Color
+              #                .newBuilder()
+              #                .setRed(red / denominator)
+              #                .setGreen(green / denominator)
+              #                .setBlue(blue / denominator);
+              #        int alpha = color.getAlpha();
+              #        if (alpha != 255) {
+              #          result.setAlpha(
+              #              FloatValue
+              #                  .newBuilder()
+              #                  .setValue(((float) alpha) / denominator)
+              #                  .build());
+              #        }
+              #        return resultBuilder.build();
+              #      }
+              #      // ...
+              #
+              # Example (iOS / Obj-C):
+              #
+              #      // ...
+              #      static UIColor* fromProto(Color* protocolor) {
+              #         float red = [protocolor red];
+              #         float green = [protocolor green];
+              #         float blue = [protocolor blue];
+              #         FloatValue* alpha_wrapper = [protocolor alpha];
+              #         float alpha = 1.0;
+              #         if (alpha_wrapper != nil) {
+              #           alpha = [alpha_wrapper value];
+              #         }
+              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+              #      }
+              #
+              #      static Color* toProto(UIColor* color) {
+              #          CGFloat red, green, blue, alpha;
+              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+              #            return nil;
+              #          }
+              #          Color* result = [Color alloc] init];
+              #          [result setRed:red];
+              #          [result setGreen:green];
+              #          [result setBlue:blue];
+              #          if (alpha <= 0.9999) {
+              #            [result setAlpha:floatWrapperWithValue(alpha)];
+              #          }
+              #          [result autorelease];
+              #          return result;
+              #     }
+              #     // ...
+              #
+              #  Example (JavaScript):
+              #
+              #     // ...
+              #
+              #     var protoToCssColor = function(rgb_color) {
+              #        var redFrac = rgb_color.red || 0.0;
+              #        var greenFrac = rgb_color.green || 0.0;
+              #        var blueFrac = rgb_color.blue || 0.0;
+              #        var red = Math.floor(redFrac * 255);
+              #        var green = Math.floor(greenFrac * 255);
+              #        var blue = Math.floor(blueFrac * 255);
+              #
+              #        if (!('alpha' in rgb_color)) {
+              #           return rgbToCssColor_(red, green, blue);
+              #        }
+              #
+              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+              #        var rgbParams = [red, green, blue].join(',');
+              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+              #     };
+              #
+              #     var rgbToCssColor_ = function(red, green, blue) {
+              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+              #       var hexString = rgbNumber.toString(16);
+              #       var missingZeros = 6 - hexString.length;
+              #       var resultBuilder = ['#'];
+              #       for (var i = 0; i < missingZeros; i++) {
+              #          resultBuilder.push('0');
+              #       }
+              #       resultBuilder.push(hexString);
+              #       return resultBuilder.join('');
+              #     };
+              #
+              #     // ...
+            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                # the final pixel color is defined by the equation:
+                #
+                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                #
+                # This means that a value of 1.0 corresponds to a solid color, whereas
+                # a value of 0.0 corresponds to a completely transparent color. This
+                # uses a wrapper message rather than a simple float scalar so that it is
+                # possible to distinguish between a default value and the value being unset.
+                # If omitted, this color object is to be rendered as a solid color
+                # (as if the alpha value had been explicitly given with a value of 1.0).
+            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+          },
+          "width": 42, # The width of the border, in pixels.
+              # Deprecated; the width is determined by the "style" field.
+          "style": "A String", # The style of the border.
+        },
+        "bottom": { # A border along a cell. # The bottom border of the cell.
+          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+              # for simplicity of conversion to/from color representations in various
+              # languages over compactness; for example, the fields of this representation
+              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+              # method in iOS; and, with just a little work, it can be easily formatted into
+              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+              #
+              # Example (Java):
+              #
+              #      import com.google.type.Color;
+              #
+              #      // ...
+              #      public static java.awt.Color fromProto(Color protocolor) {
+              #        float alpha = protocolor.hasAlpha()
+              #            ? protocolor.getAlpha().getValue()
+              #            : 1.0;
+              #
+              #        return new java.awt.Color(
+              #            protocolor.getRed(),
+              #            protocolor.getGreen(),
+              #            protocolor.getBlue(),
+              #            alpha);
+              #      }
+              #
+              #      public static Color toProto(java.awt.Color color) {
+              #        float red = (float) color.getRed();
+              #        float green = (float) color.getGreen();
+              #        float blue = (float) color.getBlue();
+              #        float denominator = 255.0;
+              #        Color.Builder resultBuilder =
+              #            Color
+              #                .newBuilder()
+              #                .setRed(red / denominator)
+              #                .setGreen(green / denominator)
+              #                .setBlue(blue / denominator);
+              #        int alpha = color.getAlpha();
+              #        if (alpha != 255) {
+              #          result.setAlpha(
+              #              FloatValue
+              #                  .newBuilder()
+              #                  .setValue(((float) alpha) / denominator)
+              #                  .build());
+              #        }
+              #        return resultBuilder.build();
+              #      }
+              #      // ...
+              #
+              # Example (iOS / Obj-C):
+              #
+              #      // ...
+              #      static UIColor* fromProto(Color* protocolor) {
+              #         float red = [protocolor red];
+              #         float green = [protocolor green];
+              #         float blue = [protocolor blue];
+              #         FloatValue* alpha_wrapper = [protocolor alpha];
+              #         float alpha = 1.0;
+              #         if (alpha_wrapper != nil) {
+              #           alpha = [alpha_wrapper value];
+              #         }
+              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+              #      }
+              #
+              #      static Color* toProto(UIColor* color) {
+              #          CGFloat red, green, blue, alpha;
+              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+              #            return nil;
+              #          }
+              #          Color* result = [Color alloc] init];
+              #          [result setRed:red];
+              #          [result setGreen:green];
+              #          [result setBlue:blue];
+              #          if (alpha <= 0.9999) {
+              #            [result setAlpha:floatWrapperWithValue(alpha)];
+              #          }
+              #          [result autorelease];
+              #          return result;
+              #     }
+              #     // ...
+              #
+              #  Example (JavaScript):
+              #
+              #     // ...
+              #
+              #     var protoToCssColor = function(rgb_color) {
+              #        var redFrac = rgb_color.red || 0.0;
+              #        var greenFrac = rgb_color.green || 0.0;
+              #        var blueFrac = rgb_color.blue || 0.0;
+              #        var red = Math.floor(redFrac * 255);
+              #        var green = Math.floor(greenFrac * 255);
+              #        var blue = Math.floor(blueFrac * 255);
+              #
+              #        if (!('alpha' in rgb_color)) {
+              #           return rgbToCssColor_(red, green, blue);
+              #        }
+              #
+              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+              #        var rgbParams = [red, green, blue].join(',');
+              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+              #     };
+              #
+              #     var rgbToCssColor_ = function(red, green, blue) {
+              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+              #       var hexString = rgbNumber.toString(16);
+              #       var missingZeros = 6 - hexString.length;
+              #       var resultBuilder = ['#'];
+              #       for (var i = 0; i < missingZeros; i++) {
+              #          resultBuilder.push('0');
+              #       }
+              #       resultBuilder.push(hexString);
+              #       return resultBuilder.join('');
+              #     };
+              #
+              #     // ...
+            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                # the final pixel color is defined by the equation:
+                #
+                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                #
+                # This means that a value of 1.0 corresponds to a solid color, whereas
+                # a value of 0.0 corresponds to a completely transparent color. This
+                # uses a wrapper message rather than a simple float scalar so that it is
+                # possible to distinguish between a default value and the value being unset.
+                # If omitted, this color object is to be rendered as a solid color
+                # (as if the alpha value had been explicitly given with a value of 1.0).
+            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+          },
+          "width": 42, # The width of the border, in pixels.
+              # Deprecated; the width is determined by the "style" field.
+          "style": "A String", # The style of the border.
+        },
+        "left": { # A border along a cell. # The left border of the cell.
+          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+              # for simplicity of conversion to/from color representations in various
+              # languages over compactness; for example, the fields of this representation
+              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+              # method in iOS; and, with just a little work, it can be easily formatted into
+              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+              #
+              # Example (Java):
+              #
+              #      import com.google.type.Color;
+              #
+              #      // ...
+              #      public static java.awt.Color fromProto(Color protocolor) {
+              #        float alpha = protocolor.hasAlpha()
+              #            ? protocolor.getAlpha().getValue()
+              #            : 1.0;
+              #
+              #        return new java.awt.Color(
+              #            protocolor.getRed(),
+              #            protocolor.getGreen(),
+              #            protocolor.getBlue(),
+              #            alpha);
+              #      }
+              #
+              #      public static Color toProto(java.awt.Color color) {
+              #        float red = (float) color.getRed();
+              #        float green = (float) color.getGreen();
+              #        float blue = (float) color.getBlue();
+              #        float denominator = 255.0;
+              #        Color.Builder resultBuilder =
+              #            Color
+              #                .newBuilder()
+              #                .setRed(red / denominator)
+              #                .setGreen(green / denominator)
+              #                .setBlue(blue / denominator);
+              #        int alpha = color.getAlpha();
+              #        if (alpha != 255) {
+              #          result.setAlpha(
+              #              FloatValue
+              #                  .newBuilder()
+              #                  .setValue(((float) alpha) / denominator)
+              #                  .build());
+              #        }
+              #        return resultBuilder.build();
+              #      }
+              #      // ...
+              #
+              # Example (iOS / Obj-C):
+              #
+              #      // ...
+              #      static UIColor* fromProto(Color* protocolor) {
+              #         float red = [protocolor red];
+              #         float green = [protocolor green];
+              #         float blue = [protocolor blue];
+              #         FloatValue* alpha_wrapper = [protocolor alpha];
+              #         float alpha = 1.0;
+              #         if (alpha_wrapper != nil) {
+              #           alpha = [alpha_wrapper value];
+              #         }
+              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+              #      }
+              #
+              #      static Color* toProto(UIColor* color) {
+              #          CGFloat red, green, blue, alpha;
+              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+              #            return nil;
+              #          }
+              #          Color* result = [Color alloc] init];
+              #          [result setRed:red];
+              #          [result setGreen:green];
+              #          [result setBlue:blue];
+              #          if (alpha <= 0.9999) {
+              #            [result setAlpha:floatWrapperWithValue(alpha)];
+              #          }
+              #          [result autorelease];
+              #          return result;
+              #     }
+              #     // ...
+              #
+              #  Example (JavaScript):
+              #
+              #     // ...
+              #
+              #     var protoToCssColor = function(rgb_color) {
+              #        var redFrac = rgb_color.red || 0.0;
+              #        var greenFrac = rgb_color.green || 0.0;
+              #        var blueFrac = rgb_color.blue || 0.0;
+              #        var red = Math.floor(redFrac * 255);
+              #        var green = Math.floor(greenFrac * 255);
+              #        var blue = Math.floor(blueFrac * 255);
+              #
+              #        if (!('alpha' in rgb_color)) {
+              #           return rgbToCssColor_(red, green, blue);
+              #        }
+              #
+              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+              #        var rgbParams = [red, green, blue].join(',');
+              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+              #     };
+              #
+              #     var rgbToCssColor_ = function(red, green, blue) {
+              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+              #       var hexString = rgbNumber.toString(16);
+              #       var missingZeros = 6 - hexString.length;
+              #       var resultBuilder = ['#'];
+              #       for (var i = 0; i < missingZeros; i++) {
+              #          resultBuilder.push('0');
+              #       }
+              #       resultBuilder.push(hexString);
+              #       return resultBuilder.join('');
+              #     };
+              #
+              #     // ...
+            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                # the final pixel color is defined by the equation:
+                #
+                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                #
+                # This means that a value of 1.0 corresponds to a solid color, whereas
+                # a value of 0.0 corresponds to a completely transparent color. This
+                # uses a wrapper message rather than a simple float scalar so that it is
+                # possible to distinguish between a default value and the value being unset.
+                # If omitted, this color object is to be rendered as a solid color
+                # (as if the alpha value had been explicitly given with a value of 1.0).
+            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+          },
+          "width": 42, # The width of the border, in pixels.
+              # Deprecated; the width is determined by the "style" field.
+          "style": "A String", # The style of the border.
+        },
+      },
+      "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+    },
+    "title": "A String", # The title of the spreadsheet.
+  },
+  "sheets": [ # The sheets that are part of a spreadsheet.
+    { # A sheet in a spreadsheet.
+      "conditionalFormats": [ # The conditional format rules in this sheet.
+        { # A rule describing a conditional format.
+          "ranges": [ # The ranges that will be formatted if the condition is true.
+              # All the ranges must be on the same grid.
+            { # A range on a sheet.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+          ],
+          "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
+            "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
+                # the format will be applied.
+                # BooleanConditions are used by conditional formatting,
+                # data validation, and the criteria in filters.
+              "type": "A String", # The type of condition.
+              "values": [ # The values of the condition. The number of supported values depends
+                  # on the condition type.  Some support zero values,
+                  # others one or two values,
+                  # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                { # The value of the condition.
+                  "relativeDate": "A String", # A relative date (based on the current date).
+                      # Valid only if the type is
+                      # DATE_BEFORE,
+                      # DATE_AFTER,
+                      # DATE_ON_OR_BEFORE or
+                      # DATE_ON_OR_AFTER.
+                      #
+                      # Relative dates are not supported in data validation.
+                      # They are supported only in conditional formatting and
+                      # conditional filters.
+                  "userEnteredValue": "A String", # A value the condition is based on.
+                      # The value will be parsed as if the user typed into a cell.
+                      # Formulas are supported (and must begin with an `=`).
+                },
+              ],
+            },
+            "format": { # The format of a cell. # The format to apply.
+                # Conditional formatting can only apply a subset of formatting:
+                # bold, italic,
+                # strikethrough,
+                # foreground color &
+                # background color.
+              "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                    # the user's locale will be used if necessary for the given type.
+                    # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                    # information about the supported patterns.
+                "type": "A String", # The type of the number format.
+                    # When writing, this field must be set.
+              },
+              "textDirection": "A String", # The direction of the text in the cell.
+              "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                  # When updating padding, every field must be specified.
+                "top": 42, # The top padding of the cell.
+                "right": 42, # The right padding of the cell.
+                "bottom": 42, # The bottom padding of the cell.
+                "left": 42, # The left padding of the cell.
+              },
+              "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+              "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+              "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                  # Absent values indicate that the field isn't specified.
+                "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "bold": True or False, # True if the text is bold.
+                "strikethrough": True or False, # True if the text has a strikethrough.
+                "fontFamily": "A String", # The font family.
+                "fontSize": 42, # The size of the font.
+                "italic": True or False, # True if the text is italicized.
+                "underline": True or False, # True if the text is underlined.
+              },
+              "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+              "borders": { # The borders of the cell. # The borders of the cell.
+                "top": { # A border along a cell. # The top border of the cell.
+                  "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                      # for simplicity of conversion to/from color representations in various
+                      # languages over compactness; for example, the fields of this representation
+                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                      # method in iOS; and, with just a little work, it can be easily formatted into
+                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                      #
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "width": 42, # The width of the border, in pixels.
+                      # Deprecated; the width is determined by the "style" field.
+                  "style": "A String", # The style of the border.
+                },
+                "right": { # A border along a cell. # The right border of the cell.
+                  "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                      # for simplicity of conversion to/from color representations in various
+                      # languages over compactness; for example, the fields of this representation
+                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                      # method in iOS; and, with just a little work, it can be easily formatted into
+                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                      #
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "width": 42, # The width of the border, in pixels.
+                      # Deprecated; the width is determined by the "style" field.
+                  "style": "A String", # The style of the border.
+                },
+                "bottom": { # A border along a cell. # The bottom border of the cell.
+                  "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                      # for simplicity of conversion to/from color representations in various
+                      # languages over compactness; for example, the fields of this representation
+                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                      # method in iOS; and, with just a little work, it can be easily formatted into
+                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                      #
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "width": 42, # The width of the border, in pixels.
+                      # Deprecated; the width is determined by the "style" field.
+                  "style": "A String", # The style of the border.
+                },
+                "left": { # A border along a cell. # The left border of the cell.
+                  "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                      # for simplicity of conversion to/from color representations in various
+                      # languages over compactness; for example, the fields of this representation
+                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                      # method in iOS; and, with just a little work, it can be easily formatted into
+                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                      #
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "width": 42, # The width of the border, in pixels.
+                      # Deprecated; the width is determined by the "style" field.
+                  "style": "A String", # The style of the border.
+                },
+              },
+              "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+            },
+          },
+          "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
+              # the interpolation points listed. The format of a cell will vary
+              # based on its contents as compared to the values of the interpolation
+              # points.
+            "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
+                # These pin the gradient color scale according to the color,
+                # type and value chosen.
+              "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "type": "A String", # How the value should be interpreted.
+              "value": "A String", # The value this interpolation point uses.  May be a formula.
+                  # Unused if type is MIN or
+                  # MAX.
+            },
+            "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
+                # These pin the gradient color scale according to the color,
+                # type and value chosen.
+              "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "type": "A String", # How the value should be interpreted.
+              "value": "A String", # The value this interpolation point uses.  May be a formula.
+                  # Unused if type is MIN or
+                  # MAX.
+            },
+            "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
+                # These pin the gradient color scale according to the color,
+                # type and value chosen.
+              "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "type": "A String", # How the value should be interpreted.
+              "value": "A String", # The value this interpolation point uses.  May be a formula.
+                  # Unused if type is MIN or
+                  # MAX.
+            },
+          },
+        },
+      ],
+      "bandedRanges": [ # The banded (i.e. alternating colors) ranges on this sheet.
+        { # A banded (alternating colors) range in a sheet.
+          "range": { # A range on a sheet. # The range over which these properties are applied.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "columnProperties": { # Properties referring a single dimension (either row or column). If both # Properties for column bands. These properties will be applied on a column-
+              # by-column basis throughout all the columns in the range. At least one of
+              # row_properties or column_properties must be specified.
+              # BandedRange.row_properties and BandedRange.column_properties are
+              # set, the fill colors are applied to cells according to the following rules:
+              #
+              # * header_color and footer_color take priority over band colors.
+              # * first_band_color takes priority over second_band_color.
+              # * row_properties takes priority over column_properties.
+              #
+              # For example, the first row color takes priority over the first column
+              # color, but the first column color takes priority over the second row color.
+              # Similarly, the row header takes priority over the column header in the
+              # top left cell, but the column header takes priority over the first row
+              # color if the row header is not set.
+            "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                # row or column will be filled with this color and the colors will
+                # alternate between first_band_color and second_band_color starting
+                # from the second row or column. Otherwise, the first row or column will be
+                # filled with first_band_color and the colors will proceed to alternate
+                # as they normally would.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                # row or column will be filled with either first_band_color or
+                # second_band_color, depending on the color of the previous row or
+                # column.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+          },
+          "rowProperties": { # Properties referring a single dimension (either row or column). If both # Properties for row bands. These properties will be applied on a row-by-row
+              # basis throughout all the rows in the range. At least one of
+              # row_properties or column_properties must be specified.
+              # BandedRange.row_properties and BandedRange.column_properties are
+              # set, the fill colors are applied to cells according to the following rules:
+              #
+              # * header_color and footer_color take priority over band colors.
+              # * first_band_color takes priority over second_band_color.
+              # * row_properties takes priority over column_properties.
+              #
+              # For example, the first row color takes priority over the first column
+              # color, but the first column color takes priority over the second row color.
+              # Similarly, the row header takes priority over the column header in the
+              # top left cell, but the column header takes priority over the first row
+              # color if the row header is not set.
+            "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                # row or column will be filled with this color and the colors will
+                # alternate between first_band_color and second_band_color starting
+                # from the second row or column. Otherwise, the first row or column will be
+                # filled with first_band_color and the colors will proceed to alternate
+                # as they normally would.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                # row or column will be filled with either first_band_color or
+                # second_band_color, depending on the color of the previous row or
+                # column.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+          },
+          "bandedRangeId": 42, # The id of the banded range.
+        },
+      ],
+      "merges": [ # The ranges that are merged together.
+        { # A range on a sheet.
+            # All indexes are zero-based.
+            # Indexes are half open, e.g the start index is inclusive
+            # and the end index is exclusive -- [start_index, end_index).
+            # Missing indexes indicate the range is unbounded on that side.
+            #
+            # For example, if `"Sheet1"` is sheet ID 0, then:
+            #
+            #   `Sheet1!A1:A1 == sheet_id: 0,
+            #                   start_row_index: 0, end_row_index: 1,
+            #                   start_column_index: 0, end_column_index: 1`
+            #
+            #   `Sheet1!A3:B4 == sheet_id: 0,
+            #                   start_row_index: 2, end_row_index: 4,
+            #                   start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1!A:B == sheet_id: 0,
+            #                 start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1!A5:B == sheet_id: 0,
+            #                  start_row_index: 4,
+            #                  start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1 == sheet_id:0`
+            #
+            # The start index must always be less than or equal to the end index.
+            # If the start index equals the end index, then the range is empty.
+            # Empty ranges are typically not meaningful and are usually rendered in the
+            # UI as `#REF!`.
+          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+          "sheetId": 42, # The sheet this range is on.
+          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+        },
+      ],
+      "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any.
+        "range": { # A range on a sheet. # The range the filter covers.
+            # All indexes are zero-based.
+            # Indexes are half open, e.g the start index is inclusive
+            # and the end index is exclusive -- [start_index, end_index).
+            # Missing indexes indicate the range is unbounded on that side.
+            #
+            # For example, if `"Sheet1"` is sheet ID 0, then:
+            #
+            #   `Sheet1!A1:A1 == sheet_id: 0,
+            #                   start_row_index: 0, end_row_index: 1,
+            #                   start_column_index: 0, end_column_index: 1`
+            #
+            #   `Sheet1!A3:B4 == sheet_id: 0,
+            #                   start_row_index: 2, end_row_index: 4,
+            #                   start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1!A:B == sheet_id: 0,
+            #                 start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1!A5:B == sheet_id: 0,
+            #                  start_row_index: 4,
+            #                  start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1 == sheet_id:0`
+            #
+            # The start index must always be less than or equal to the end index.
+            # If the start index equals the end index, then the range is empty.
+            # Empty ranges are typically not meaningful and are usually rendered in the
+            # UI as `#REF!`.
+          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+          "sheetId": 42, # The sheet this range is on.
+          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+        },
+        "sortSpecs": [ # The sort order per column. Later specifications are used when values
+            # are equal in the earlier specifications.
+          { # A sort order associated with a specific column or row.
+            "sortOrder": "A String", # The order data should be sorted.
+            "dimensionIndex": 42, # The dimension the sort should be applied to.
+          },
+        ],
+        "criteria": { # The criteria for showing/hiding values per column.
+            # The map's key is the column index, and the value is the criteria for
+            # that column.
+          "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+            "hiddenValues": [ # Values that should be hidden.
+              "A String",
+            ],
+            "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                # (This does not override hiddenValues -- if a value is listed there,
+                #  it will still be hidden.)
+                # BooleanConditions are used by conditional formatting,
+                # data validation, and the criteria in filters.
+              "type": "A String", # The type of condition.
+              "values": [ # The values of the condition. The number of supported values depends
+                  # on the condition type.  Some support zero values,
+                  # others one or two values,
+                  # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                { # The value of the condition.
+                  "relativeDate": "A String", # A relative date (based on the current date).
+                      # Valid only if the type is
+                      # DATE_BEFORE,
+                      # DATE_AFTER,
+                      # DATE_ON_OR_BEFORE or
+                      # DATE_ON_OR_AFTER.
+                      #
+                      # Relative dates are not supported in data validation.
+                      # They are supported only in conditional formatting and
+                      # conditional filters.
+                  "userEnteredValue": "A String", # A value the condition is based on.
+                      # The value will be parsed as if the user typed into a cell.
+                      # Formulas are supported (and must begin with an `=`).
+                },
+              ],
+            },
+          },
+        },
+      },
+      "charts": [ # The specifications of every chart on this sheet.
+        { # A chart embedded in a sheet.
+          "chartId": 42, # The ID of the chart.
+          "position": { # The position of an embedded object such as a chart. # The position of the chart.
+            "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
+                # is chosen for you. Used only when writing.
+            "sheetId": 42, # The sheet this is on. Set only if the embedded object
+                # is on its own sheet. Must be non-negative.
+            "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
+              "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
+                  # All indexes are zero-based.
+                "rowIndex": 42, # The row index of the coordinate.
+                "columnIndex": 42, # The column index of the coordinate.
+                "sheetId": 42, # The sheet this coordinate is on.
+              },
+              "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
+                  # from the anchor cell.
+              "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
+              "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
+                  # from the anchor cell.
+              "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
+            },
+          },
+          "spec": { # The specifications of a chart. # The specification of the chart.
+            "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
+            "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
+              "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
+                "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                  "sources": [ # The ranges of data for a series or domain.
+                      # Exactly one dimension must have a length of 1,
+                      # and all sources in the list must have the same dimension
+                      # with length 1.
+                      # The domain (if it exists) & all series must have the same number
+                      # of source ranges. If using more than one source range, then the source
+                      # range at a given offset must be contiguous across the domain and series.
+                      #
+                      # For example, these are valid configurations:
+                      #
+                      #     domain sources: A1:A5
+                      #     series1 sources: B1:B5
+                      #     series2 sources: D6:D10
+                      #
+                      #     domain sources: A1:A5, C10:C12
+                      #     series1 sources: B1:B5, D10:D12
+                      #     series2 sources: C1:C5, E10:E12
+                    { # A range on a sheet.
+                        # All indexes are zero-based.
+                        # Indexes are half open, e.g the start index is inclusive
+                        # and the end index is exclusive -- [start_index, end_index).
+                        # Missing indexes indicate the range is unbounded on that side.
+                        #
+                        # For example, if `"Sheet1"` is sheet ID 0, then:
+                        #
+                        #   `Sheet1!A1:A1 == sheet_id: 0,
+                        #                   start_row_index: 0, end_row_index: 1,
+                        #                   start_column_index: 0, end_column_index: 1`
+                        #
+                        #   `Sheet1!A3:B4 == sheet_id: 0,
+                        #                   start_row_index: 2, end_row_index: 4,
+                        #                   start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1!A:B == sheet_id: 0,
+                        #                 start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1!A5:B == sheet_id: 0,
+                        #                  start_row_index: 4,
+                        #                  start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1 == sheet_id:0`
+                        #
+                        # The start index must always be less than or equal to the end index.
+                        # If the start index equals the end index, then the range is empty.
+                        # Empty ranges are typically not meaningful and are usually rendered in the
+                        # UI as `#REF!`.
+                      "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                      "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                      "sheetId": 42, # The sheet this range is on.
+                      "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                      "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                    },
+                  ],
+                },
+              },
+              "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
+                "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                  "sources": [ # The ranges of data for a series or domain.
+                      # Exactly one dimension must have a length of 1,
+                      # and all sources in the list must have the same dimension
+                      # with length 1.
+                      # The domain (if it exists) & all series must have the same number
+                      # of source ranges. If using more than one source range, then the source
+                      # range at a given offset must be contiguous across the domain and series.
+                      #
+                      # For example, these are valid configurations:
+                      #
+                      #     domain sources: A1:A5
+                      #     series1 sources: B1:B5
+                      #     series2 sources: D6:D10
+                      #
+                      #     domain sources: A1:A5, C10:C12
+                      #     series1 sources: B1:B5, D10:D12
+                      #     series2 sources: C1:C5, E10:E12
+                    { # A range on a sheet.
+                        # All indexes are zero-based.
+                        # Indexes are half open, e.g the start index is inclusive
+                        # and the end index is exclusive -- [start_index, end_index).
+                        # Missing indexes indicate the range is unbounded on that side.
+                        #
+                        # For example, if `"Sheet1"` is sheet ID 0, then:
+                        #
+                        #   `Sheet1!A1:A1 == sheet_id: 0,
+                        #                   start_row_index: 0, end_row_index: 1,
+                        #                   start_column_index: 0, end_column_index: 1`
+                        #
+                        #   `Sheet1!A3:B4 == sheet_id: 0,
+                        #                   start_row_index: 2, end_row_index: 4,
+                        #                   start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1!A:B == sheet_id: 0,
+                        #                 start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1!A5:B == sheet_id: 0,
+                        #                  start_row_index: 4,
+                        #                  start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1 == sheet_id:0`
+                        #
+                        # The start index must always be less than or equal to the end index.
+                        # If the start index equals the end index, then the range is empty.
+                        # Empty ranges are typically not meaningful and are usually rendered in the
+                        # UI as `#REF!`.
+                      "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                      "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                      "sheetId": 42, # The sheet this range is on.
+                      "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                      "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                    },
+                  ],
+                },
+              },
+              "threeDimensional": True or False, # True if the pie is three dimensional.
+              "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
+              "pieHole": 3.14, # The size of the hole in the pie chart.
+            },
+            "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
+                # See BasicChartType for the list of all
+                # charts this supports.
+                # of charts this supports.
+              "headerCount": 42, # The number of rows or columns in the data that are "headers".
+                  # If not set, Google Sheets will guess how many rows are headers based
+                  # on the data.
+                  #
+                  # (Note that BasicChartAxis.title may override the axis title
+                  #  inferred from the header values.)
+              "series": [ # The data this chart is visualizing.
+                { # A single series of data in a chart.
+                    # For example, if charting stock prices over time, multiple series may exist,
+                    # one for the "Open Price", "High Price", "Low Price" and "Close Price".
+                  "series": { # The data included in a domain or series. # The data being visualized in this chart series.
+                    "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                      "sources": [ # The ranges of data for a series or domain.
+                          # Exactly one dimension must have a length of 1,
+                          # and all sources in the list must have the same dimension
+                          # with length 1.
+                          # The domain (if it exists) & all series must have the same number
+                          # of source ranges. If using more than one source range, then the source
+                          # range at a given offset must be contiguous across the domain and series.
                           #
-                          # When writing, the new format will be merged with the existing format.
-                        "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                          "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                              # the user's locale will be used if necessary for the given type.
-                              # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                              # information about the supported patterns.
-                          "type": "A String", # The type of the number format.
-                              # When writing, this field must be set.
-                        },
-                        "textDirection": "A String", # The direction of the text in the cell.
-                        "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                            # When updating padding, every field must be specified.
-                          "top": 42, # The top padding of the cell.
-                          "right": 42, # The right padding of the cell.
-                          "bottom": 42, # The bottom padding of the cell.
-                          "left": 42, # The left padding of the cell.
-                        },
-                        "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                        "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                            # for simplicity of conversion to/from color representations in various
-                            # languages over compactness; for example, the fields of this representation
-                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                            # method in iOS; and, with just a little work, it can be easily formatted into
-                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                            #
-                            # Example (Java):
-                            #
-                            #      import com.google.type.Color;
-                            #
-                            #      // ...
-                            #      public static java.awt.Color fromProto(Color protocolor) {
-                            #        float alpha = protocolor.hasAlpha()
-                            #            ? protocolor.getAlpha().getValue()
-                            #            : 1.0;
+                          # For example, these are valid configurations:
+                          #
+                          #     domain sources: A1:A5
+                          #     series1 sources: B1:B5
+                          #     series2 sources: D6:D10
+                          #
+                          #     domain sources: A1:A5, C10:C12
+                          #     series1 sources: B1:B5, D10:D12
+                          #     series2 sources: C1:C5, E10:E12
+                        { # A range on a sheet.
+                            # All indexes are zero-based.
+                            # Indexes are half open, e.g the start index is inclusive
+                            # and the end index is exclusive -- [start_index, end_index).
+                            # Missing indexes indicate the range is unbounded on that side.
                             #
-                            #        return new java.awt.Color(
-                            #            protocolor.getRed(),
-                            #            protocolor.getGreen(),
-                            #            protocolor.getBlue(),
-                            #            alpha);
-                            #      }
+                            # For example, if `"Sheet1"` is sheet ID 0, then:
                             #
-                            #      public static Color toProto(java.awt.Color color) {
-                            #        float red = (float) color.getRed();
-                            #        float green = (float) color.getGreen();
-                            #        float blue = (float) color.getBlue();
-                            #        float denominator = 255.0;
-                            #        Color.Builder resultBuilder =
-                            #            Color
-                            #                .newBuilder()
-                            #                .setRed(red / denominator)
-                            #                .setGreen(green / denominator)
-                            #                .setBlue(blue / denominator);
-                            #        int alpha = color.getAlpha();
-                            #        if (alpha != 255) {
-                            #          result.setAlpha(
-                            #              FloatValue
-                            #                  .newBuilder()
-                            #                  .setValue(((float) alpha) / denominator)
-                            #                  .build());
-                            #        }
-                            #        return resultBuilder.build();
-                            #      }
-                            #      // ...
+                            #   `Sheet1!A1:A1 == sheet_id: 0,
+                            #                   start_row_index: 0, end_row_index: 1,
+                            #                   start_column_index: 0, end_column_index: 1`
                             #
-                            # Example (iOS / Obj-C):
+                            #   `Sheet1!A3:B4 == sheet_id: 0,
+                            #                   start_row_index: 2, end_row_index: 4,
+                            #                   start_column_index: 0, end_column_index: 2`
                             #
-                            #      // ...
-                            #      static UIColor* fromProto(Color* protocolor) {
-                            #         float red = [protocolor red];
-                            #         float green = [protocolor green];
-                            #         float blue = [protocolor blue];
-                            #         FloatValue* alpha_wrapper = [protocolor alpha];
-                            #         float alpha = 1.0;
-                            #         if (alpha_wrapper != nil) {
-                            #           alpha = [alpha_wrapper value];
-                            #         }
-                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                            #      }
+                            #   `Sheet1!A:B == sheet_id: 0,
+                            #                 start_column_index: 0, end_column_index: 2`
                             #
-                            #      static Color* toProto(UIColor* color) {
-                            #          CGFloat red, green, blue, alpha;
-                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                            #            return nil;
-                            #          }
-                            #          Color* result = [Color alloc] init];
-                            #          [result setRed:red];
-                            #          [result setGreen:green];
-                            #          [result setBlue:blue];
-                            #          if (alpha <= 0.9999) {
-                            #            [result setAlpha:floatWrapperWithValue(alpha)];
-                            #          }
-                            #          [result autorelease];
-                            #          return result;
-                            #     }
-                            #     // ...
+                            #   `Sheet1!A5:B == sheet_id: 0,
+                            #                  start_row_index: 4,
+                            #                  start_column_index: 0, end_column_index: 2`
                             #
-                            #  Example (JavaScript):
+                            #   `Sheet1 == sheet_id:0`
                             #
-                            #     // ...
+                            # The start index must always be less than or equal to the end index.
+                            # If the start index equals the end index, then the range is empty.
+                            # Empty ranges are typically not meaningful and are usually rendered in the
+                            # UI as `#REF!`.
+                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                          "sheetId": 42, # The sheet this range is on.
+                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                        },
+                      ],
+                    },
+                  },
+                  "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
+                      # For example, if charting stocks over time, the "Volume" series
+                      # may want to be pinned to the right with the prices pinned to the left,
+                      # because the scale of trading volume is different than the scale of
+                      # prices.
+                      # It is an error to specify an axis that isn't a valid minor axis
+                      # for the chart's type.
+                  "type": "A String", # The type of this series. Valid only if the
+                      # chartType is
+                      # COMBO.
+                      # Different types will change the way the series is visualized.
+                      # Only LINE, AREA,
+                      # and COLUMN are supported.
+                },
+              ],
+              "legendPosition": "A String", # The position of the chart legend.
+              "domains": [ # The domain of data this is charting.
+                  # Only a single domain is currently supported.
+                { # The domain of a chart.
+                    # For example, if charting stock prices over time, this would be the date.
+                  "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
+                      # this is the data representing the dates.
+                    "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                      "sources": [ # The ranges of data for a series or domain.
+                          # Exactly one dimension must have a length of 1,
+                          # and all sources in the list must have the same dimension
+                          # with length 1.
+                          # The domain (if it exists) & all series must have the same number
+                          # of source ranges. If using more than one source range, then the source
+                          # range at a given offset must be contiguous across the domain and series.
+                          #
+                          # For example, these are valid configurations:
+                          #
+                          #     domain sources: A1:A5
+                          #     series1 sources: B1:B5
+                          #     series2 sources: D6:D10
+                          #
+                          #     domain sources: A1:A5, C10:C12
+                          #     series1 sources: B1:B5, D10:D12
+                          #     series2 sources: C1:C5, E10:E12
+                        { # A range on a sheet.
+                            # All indexes are zero-based.
+                            # Indexes are half open, e.g the start index is inclusive
+                            # and the end index is exclusive -- [start_index, end_index).
+                            # Missing indexes indicate the range is unbounded on that side.
                             #
-                            #     var protoToCssColor = function(rgb_color) {
-                            #        var redFrac = rgb_color.red || 0.0;
-                            #        var greenFrac = rgb_color.green || 0.0;
-                            #        var blueFrac = rgb_color.blue || 0.0;
-                            #        var red = Math.floor(redFrac * 255);
-                            #        var green = Math.floor(greenFrac * 255);
-                            #        var blue = Math.floor(blueFrac * 255);
+                            # For example, if `"Sheet1"` is sheet ID 0, then:
                             #
-                            #        if (!('alpha' in rgb_color)) {
-                            #           return rgbToCssColor_(red, green, blue);
-                            #        }
+                            #   `Sheet1!A1:A1 == sheet_id: 0,
+                            #                   start_row_index: 0, end_row_index: 1,
+                            #                   start_column_index: 0, end_column_index: 1`
                             #
-                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                            #        var rgbParams = [red, green, blue].join(',');
-                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                            #     };
+                            #   `Sheet1!A3:B4 == sheet_id: 0,
+                            #                   start_row_index: 2, end_row_index: 4,
+                            #                   start_column_index: 0, end_column_index: 2`
                             #
-                            #     var rgbToCssColor_ = function(red, green, blue) {
-                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                            #       var hexString = rgbNumber.toString(16);
-                            #       var missingZeros = 6 - hexString.length;
-                            #       var resultBuilder = ['#'];
-                            #       for (var i = 0; i < missingZeros; i++) {
-                            #          resultBuilder.push('0');
-                            #       }
-                            #       resultBuilder.push(hexString);
-                            #       return resultBuilder.join('');
-                            #     };
+                            #   `Sheet1!A:B == sheet_id: 0,
+                            #                 start_column_index: 0, end_column_index: 2`
                             #
-                            #     // ...
-                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                              # the final pixel color is defined by the equation:
-                              #
-                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                              #
-                              # This means that a value of 1.0 corresponds to a solid color, whereas
-                              # a value of 0.0 corresponds to a completely transparent color. This
-                              # uses a wrapper message rather than a simple float scalar so that it is
-                              # possible to distinguish between a default value and the value being unset.
-                              # If omitted, this color object is to be rendered as a solid color
-                              # (as if the alpha value had been explicitly given with a value of 1.0).
-                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                        },
-                        "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                        "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                            # Absent values indicate that the field isn't specified.
-                          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
-                              #
-                              #  Example (JavaScript):
-                              #
-                              #     // ...
-                              #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
-                              #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
-                              #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
-                              #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
-                              #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "bold": True or False, # True if the text is bold.
-                          "strikethrough": True or False, # True if the text has a strikethrough.
-                          "fontFamily": "A String", # The font family.
-                          "fontSize": 42, # The size of the font.
-                          "italic": True or False, # True if the text is italicized.
-                          "underline": True or False, # True if the text is underlined.
-                        },
-                        "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                        "borders": { # The borders of the cell. # The borders of the cell.
-                          "top": { # A border along a cell. # The top border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
-                          },
-                          "right": { # A border along a cell. # The right border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                            #   `Sheet1!A5:B == sheet_id: 0,
+                            #                  start_row_index: 4,
+                            #                  start_column_index: 0, end_column_index: 2`
+                            #
+                            #   `Sheet1 == sheet_id:0`
+                            #
+                            # The start index must always be less than or equal to the end index.
+                            # If the start index equals the end index, then the range is empty.
+                            # Empty ranges are typically not meaningful and are usually rendered in the
+                            # UI as `#REF!`.
+                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                          "sheetId": 42, # The sheet this range is on.
+                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                        },
+                      ],
+                    },
+                  },
+                },
+              ],
+              "chartType": "A String", # The type of the chart.
+              "axis": [ # The axis on the chart.
+                { # An axis of the chart.
+                    # A chart may not have more than one axis per
+                    # axis position.
+                  "position": "A String", # The position of this axis.
+                  "format": { # The format of a run of text in a cell. # The format of the title.
+                      # Only valid if the axis is not associated with the domain.
+                      # Absent values indicate that the field isn't specified.
+                    "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "bold": True or False, # True if the text is bold.
+                    "strikethrough": True or False, # True if the text has a strikethrough.
+                    "fontFamily": "A String", # The font family.
+                    "fontSize": 42, # The size of the font.
+                    "italic": True or False, # True if the text is italicized.
+                    "underline": True or False, # True if the text is underlined.
+                  },
+                  "title": "A String", # The title of this axis. If set, this overrides any title inferred
+                      # from headers of the data.
+                },
+              ],
+            },
+            "title": "A String", # The title of the chart.
+          },
+        },
+      ],
+      "filterViews": [ # The filter views in this sheet.
+        { # A filter view.
+          "title": "A String", # The name of the filter view.
+          "namedRangeId": "A String", # The named range this filter view is backed by, if any.
+              #
+              # When writing, only one of range or named_range_id
+              # may be set.
+          "filterViewId": 42, # The ID of the filter view.
+          "range": { # A range on a sheet. # The range this filter view covers.
+              #
+              # When writing, only one of range or named_range_id
+              # may be set.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "sortSpecs": [ # The sort order per column. Later specifications are used when values
+              # are equal in the earlier specifications.
+            { # A sort order associated with a specific column or row.
+              "sortOrder": "A String", # The order data should be sorted.
+              "dimensionIndex": 42, # The dimension the sort should be applied to.
+            },
+          ],
+          "criteria": { # The criteria for showing/hiding values per column.
+              # The map's key is the column index, and the value is the criteria for
+              # that column.
+            "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+              "hiddenValues": [ # Values that should be hidden.
+                "A String",
+              ],
+              "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                  # (This does not override hiddenValues -- if a value is listed there,
+                  #  it will still be hidden.)
+                  # BooleanConditions are used by conditional formatting,
+                  # data validation, and the criteria in filters.
+                "type": "A String", # The type of condition.
+                "values": [ # The values of the condition. The number of supported values depends
+                    # on the condition type.  Some support zero values,
+                    # others one or two values,
+                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                  { # The value of the condition.
+                    "relativeDate": "A String", # A relative date (based on the current date).
+                        # Valid only if the type is
+                        # DATE_BEFORE,
+                        # DATE_AFTER,
+                        # DATE_ON_OR_BEFORE or
+                        # DATE_ON_OR_AFTER.
+                        #
+                        # Relative dates are not supported in data validation.
+                        # They are supported only in conditional formatting and
+                        # conditional filters.
+                    "userEnteredValue": "A String", # A value the condition is based on.
+                        # The value will be parsed as if the user typed into a cell.
+                        # Formulas are supported (and must begin with an `=`).
+                  },
+                ],
+              },
+            },
+          },
+        },
+      ],
+      "protectedRanges": [ # The protected ranges in this sheet.
+        { # A protected range.
+          "unprotectedRanges": [ # The list of unprotected ranges within a protected sheet.
+              # Unprotected ranges are only supported on protected sheets.
+            { # A range on a sheet.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+          ],
+          "requestingUserCanEdit": True or False, # True if the user who requested this protected range can edit the
+              # protected area.
+              # This field is read-only.
+          "description": "A String", # The description of this protected range.
+          "namedRangeId": "A String", # The named range this protected range is backed by, if any.
+              #
+              # When writing, only one of range or named_range_id
+              # may be set.
+          "editors": { # The editors of a protected range. # The users and groups with edit access to the protected range.
+              # This field is only visible to users with edit access to the protected
+              # range and the document.
+              # Editors are not supported with warning_only protection.
+            "domainUsersCanEdit": True or False, # True if anyone in the document's domain has edit access to the protected
+                # range.  Domain protection is only supported on documents within a domain.
+            "users": [ # The email addresses of users with edit access to the protected range.
+              "A String",
+            ],
+            "groups": [ # The email addresses of groups with edit access to the protected range.
+              "A String",
+            ],
+          },
+          "protectedRangeId": 42, # The ID of the protected range.
+              # This field is read-only.
+          "warningOnly": True or False, # True if this protected range will show a warning when editing.
+              # Warning-based protection means that every user can edit data in the
+              # protected range, except editing will prompt a warning asking the user
+              # to confirm the edit.
+              #
+              # When writing: if this field is true, then editors is ignored.
+              # Additionally, if this field is changed from true to false and the
+              # `editors` field is not set (nor included in the field mask), then
+              # the editors will be set to all the editors in the document.
+          "range": { # A range on a sheet. # The range that is being protected.
+              # The range may be fully unbounded, in which case this is considered
+              # a protected sheet.
+              #
+              # When writing, only one of range or named_range_id
+              # may be set.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+        },
+      ],
+      "data": [ # Data in the grid, if this is a grid sheet.
+          # The number of GridData objects returned is dependent on the number of
+          # ranges requested on this sheet. For example, if this is representing
+          # `Sheet1`, and the spreadsheet was requested with ranges
+          # `Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will have a
+          # startRow/startColumn of `0`,
+          # while the second one will have `startRow 14` (zero-based row 15),
+          # and `startColumn 3` (zero-based column D).
+        { # Data in the grid, as well as metadata about the dimensions.
+          "startRow": 42, # The first row this GridData refers to, zero-based.
+          "rowMetadata": [ # Metadata about the requested rows in the grid, starting with the row
+              # in start_row.
+            { # Properties about a dimension.
+              "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
+              "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
+              "hiddenByFilter": True or False, # True if this dimension is being filtered.
+                  # This field is read-only.
+            },
+          ],
+          "startColumn": 42, # The first column this GridData refers to, zero-based.
+          "columnMetadata": [ # Metadata about the requested columns in the grid, starting with the column
+              # in start_column.
+            { # Properties about a dimension.
+              "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
+              "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
+              "hiddenByFilter": True or False, # True if this dimension is being filtered.
+                  # This field is read-only.
+            },
+          ],
+          "rowData": [ # The data in the grid, one entry per row,
+              # starting with the row in startRow.
+              # The values in RowData will correspond to columns starting
+              # at start_column.
+            { # Data about each cell in a row.
+              "values": [ # The values in the row, one per column.
+                { # Data about a specific cell.
+                  "pivotTable": { # A pivot table. # A pivot table anchored at this cell. The size of pivot table itself
+                      # is computed dynamically based on its data, grouping, filters, values,
+                      # etc. Only the top-left cell of the pivot table contains the pivot table
+                      # definition. The other cells will contain the calculated values of the
+                      # results of the pivot in their effective_value fields.
+                    "valueLayout": "A String", # Whether values should be listed horizontally (as columns)
+                        # or vertically (as rows).
+                    "rows": [ # Each row grouping in the pivot table.
+                      { # A single grouping (either row or column) in a pivot table.
+                        "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
+                        "valueMetadata": [ # Metadata about values in the grouping.
+                          { # Metadata about a value in a pivot grouping.
+                            "collapsed": True or False, # True if the data corresponding to the value is collapsed.
+                            "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
+                                # (Note that formulaValue is not valid,
+                                #  because the values will be calculated.)
+                              "numberValue": 3.14, # Represents a double value.
+                                  # Note: Dates, Times and DateTimes are represented as doubles in
+                                  # "serial number" format.
+                              "boolValue": True or False, # Represents a boolean value.
+                              "formulaValue": "A String", # Represents a formula.
+                              "stringValue": "A String", # Represents a string value.
+                                  # Leading single quotes are not included. For example, if the user typed
+                                  # `'123` into the UI, this would be represented as a `stringValue` of
+                                  # `"123"`.
+                              "errorValue": { # An error in a cell. # Represents an error.
+                                  # This field is read-only.
+                                "message": "A String", # A message with more information about the error
+                                    # (in the spreadsheet's locale).
+                                "type": "A String", # The type of error.
+                              },
                             },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
                           },
-                          "bottom": { # A border along a cell. # The bottom border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        ],
+                        "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
+                            # If not specified, sorting is alphabetical by this group's values.
+                          "buckets": [ # Determines the bucket from which values are chosen to sort.
+                              #
+                              # For example, in a pivot table with one row group & two column groups,
+                              # the row group can list up to two values. The first value corresponds
+                              # to a value within the first column group, and the second value
+                              # corresponds to a value in the second column group.  If no values
+                              # are listed, this would indicate that the row should be sorted according
+                              # to the "Grand Total" over the column groups. If a single value is listed,
+                              # this would correspond to using the "Total" of that bucket.
+                            { # The kinds of value that a cell in a spreadsheet can have.
+                              "numberValue": 3.14, # Represents a double value.
+                                  # Note: Dates, Times and DateTimes are represented as doubles in
+                                  # "serial number" format.
+                              "boolValue": True or False, # Represents a boolean value.
+                              "formulaValue": "A String", # Represents a formula.
+                              "stringValue": "A String", # Represents a string value.
+                                  # Leading single quotes are not included. For example, if the user typed
+                                  # `'123` into the UI, this would be represented as a `stringValue` of
+                                  # `"123"`.
+                              "errorValue": { # An error in a cell. # Represents an error.
+                                  # This field is read-only.
+                                "message": "A String", # A message with more information about the error
+                                    # (in the spreadsheet's locale).
+                                "type": "A String", # The type of error.
+                              },
                             },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
-                          },
-                          "left": { # A border along a cell. # The left border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          ],
+                          "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
+                              # grouping should be sorted by.
+                        },
+                        "sortOrder": "A String", # The order the values in this group should be sorted.
+                        "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                            #
+                            # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                            # means this group refers to column `C`, whereas the offset `1` would refer
+                            # to column `D`.
+                      },
+                    ],
+                    "source": { # A range on a sheet. # The range the pivot table is reading data from.
+                        # All indexes are zero-based.
+                        # Indexes are half open, e.g the start index is inclusive
+                        # and the end index is exclusive -- [start_index, end_index).
+                        # Missing indexes indicate the range is unbounded on that side.
+                        #
+                        # For example, if `"Sheet1"` is sheet ID 0, then:
+                        #
+                        #   `Sheet1!A1:A1 == sheet_id: 0,
+                        #                   start_row_index: 0, end_row_index: 1,
+                        #                   start_column_index: 0, end_column_index: 1`
+                        #
+                        #   `Sheet1!A3:B4 == sheet_id: 0,
+                        #                   start_row_index: 2, end_row_index: 4,
+                        #                   start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1!A:B == sheet_id: 0,
+                        #                 start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1!A5:B == sheet_id: 0,
+                        #                  start_row_index: 4,
+                        #                  start_column_index: 0, end_column_index: 2`
+                        #
+                        #   `Sheet1 == sheet_id:0`
+                        #
+                        # The start index must always be less than or equal to the end index.
+                        # If the start index equals the end index, then the range is empty.
+                        # Empty ranges are typically not meaningful and are usually rendered in the
+                        # UI as `#REF!`.
+                      "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                      "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                      "sheetId": 42, # The sheet this range is on.
+                      "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                      "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                    },
+                    "values": [ # A list of values to include in the pivot table.
+                      { # The definition of how a value in a pivot table should be calculated.
+                        "formula": "A String", # A custom formula to calculate the value.  The formula must start
+                            # with an `=` character.
+                        "summarizeFunction": "A String", # A function to summarize the value.
+                            # If formula is set, the only supported values are
+                            # SUM and
+                            # CUSTOM.
+                            # If sourceColumnOffset is set, then `CUSTOM`
+                            # is not supported.
+                        "sourceColumnOffset": 42, # The column offset of the source range that this value reads from.
+                            #
+                            # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                            # means this value refers to column `C`, whereas the offset `1` would
+                            # refer to column `D`.
+                        "name": "A String", # A name to use for the value. This is only used if formula was set.
+                            # Otherwise, the column name is used.
+                      },
+                    ],
+                    "criteria": { # An optional mapping of filters per source column offset.
+                        #
+                        # The filters will be applied before aggregating data into the pivot table.
+                        # The map's key is the column offset of the source range that you want to
+                        # filter, and the value is the criteria for that column.
+                        #
+                        # For example, if the source was `C10:E15`, a key of `0` will have the filter
+                        # for column `C`, whereas the key `1` is for column `D`.
+                      "a_key": { # Criteria for showing/hiding rows in a pivot table.
+                        "visibleValues": [ # Values that should be included.  Values not listed here are excluded.
+                          "A String",
+                        ],
+                      },
+                    },
+                    "columns": [ # Each column grouping in the pivot table.
+                      { # A single grouping (either row or column) in a pivot table.
+                        "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
+                        "valueMetadata": [ # Metadata about values in the grouping.
+                          { # Metadata about a value in a pivot grouping.
+                            "collapsed": True or False, # True if the data corresponding to the value is collapsed.
+                            "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
+                                # (Note that formulaValue is not valid,
+                                #  because the values will be calculated.)
+                              "numberValue": 3.14, # Represents a double value.
+                                  # Note: Dates, Times and DateTimes are represented as doubles in
+                                  # "serial number" format.
+                              "boolValue": True or False, # Represents a boolean value.
+                              "formulaValue": "A String", # Represents a formula.
+                              "stringValue": "A String", # Represents a string value.
+                                  # Leading single quotes are not included. For example, if the user typed
+                                  # `'123` into the UI, this would be represented as a `stringValue` of
+                                  # `"123"`.
+                              "errorValue": { # An error in a cell. # Represents an error.
+                                  # This field is read-only.
+                                "message": "A String", # A message with more information about the error
+                                    # (in the spreadsheet's locale).
+                                "type": "A String", # The type of error.
+                              },
                             },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
                           },
+                        ],
+                        "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
+                            # If not specified, sorting is alphabetical by this group's values.
+                          "buckets": [ # Determines the bucket from which values are chosen to sort.
+                              #
+                              # For example, in a pivot table with one row group & two column groups,
+                              # the row group can list up to two values. The first value corresponds
+                              # to a value within the first column group, and the second value
+                              # corresponds to a value in the second column group.  If no values
+                              # are listed, this would indicate that the row should be sorted according
+                              # to the "Grand Total" over the column groups. If a single value is listed,
+                              # this would correspond to using the "Total" of that bucket.
+                            { # The kinds of value that a cell in a spreadsheet can have.
+                              "numberValue": 3.14, # Represents a double value.
+                                  # Note: Dates, Times and DateTimes are represented as doubles in
+                                  # "serial number" format.
+                              "boolValue": True or False, # Represents a boolean value.
+                              "formulaValue": "A String", # Represents a formula.
+                              "stringValue": "A String", # Represents a string value.
+                                  # Leading single quotes are not included. For example, if the user typed
+                                  # `'123` into the UI, this would be represented as a `stringValue` of
+                                  # `"123"`.
+                              "errorValue": { # An error in a cell. # Represents an error.
+                                  # This field is read-only.
+                                "message": "A String", # A message with more information about the error
+                                    # (in the spreadsheet's locale).
+                                "type": "A String", # The type of error.
+                              },
+                            },
+                          ],
+                          "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
+                              # grouping should be sorted by.
+                        },
+                        "sortOrder": "A String", # The order the values in this group should be sorted.
+                        "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                            #
+                            # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                            # means this group refers to column `C`, whereas the offset `1` would refer
+                            # to column `D`.
+                      },
+                    ],
+                  },
+                  "hyperlink": "A String", # A hyperlink this cell points to, if any.
+                      # This field is read-only.  (To set it, use a `=HYPERLINK` formula.)
+                  "effectiveValue": { # The kinds of value that a cell in a spreadsheet can have. # The effective value of the cell. For cells with formulas, this will be
+                      # the calculated value.  For cells with literals, this will be
+                      # the same as the user_entered_value.
+                      # This field is read-only.
+                    "numberValue": 3.14, # Represents a double value.
+                        # Note: Dates, Times and DateTimes are represented as doubles in
+                        # "serial number" format.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "formulaValue": "A String", # Represents a formula.
+                    "stringValue": "A String", # Represents a string value.
+                        # Leading single quotes are not included. For example, if the user typed
+                        # `'123` into the UI, this would be represented as a `stringValue` of
+                        # `"123"`.
+                    "errorValue": { # An error in a cell. # Represents an error.
+                        # This field is read-only.
+                      "message": "A String", # A message with more information about the error
+                          # (in the spreadsheet's locale).
+                      "type": "A String", # The type of error.
+                    },
+                  },
+                  "formattedValue": "A String", # The formatted value of the cell.
+                      # This is the value as it's shown to the user.
+                      # This field is read-only.
+                  "userEnteredValue": { # The kinds of value that a cell in a spreadsheet can have. # The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`
+                      # Note: Dates, Times and DateTimes are represented as doubles in
+                      # serial number format.
+                    "numberValue": 3.14, # Represents a double value.
+                        # Note: Dates, Times and DateTimes are represented as doubles in
+                        # "serial number" format.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "formulaValue": "A String", # Represents a formula.
+                    "stringValue": "A String", # Represents a string value.
+                        # Leading single quotes are not included. For example, if the user typed
+                        # `'123` into the UI, this would be represented as a `stringValue` of
+                        # `"123"`.
+                    "errorValue": { # An error in a cell. # Represents an error.
+                        # This field is read-only.
+                      "message": "A String", # A message with more information about the error
+                          # (in the spreadsheet's locale).
+                      "type": "A String", # The type of error.
+                    },
+                  },
+                  "note": "A String", # Any note on the cell.
+                  "effectiveFormat": { # The format of a cell. # The effective format being used by the cell.
+                      # This includes the results of applying any conditional formatting and,
+                      # if the cell contains a formula, the computed number format.
+                      # If the effective format is the default format, effective format will
+                      # not be written.
+                      # This field is read-only.
+                    "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                      "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                          # the user's locale will be used if necessary for the given type.
+                          # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                          # information about the supported patterns.
+                      "type": "A String", # The type of the number format.
+                          # When writing, this field must be set.
+                    },
+                    "textDirection": "A String", # The direction of the text in the cell.
+                    "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                        # When updating padding, every field must be specified.
+                      "top": 42, # The top padding of the cell.
+                      "right": 42, # The right padding of the cell.
+                      "bottom": 42, # The bottom padding of the cell.
+                      "left": 42, # The left padding of the cell.
+                    },
+                    "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                    "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                    "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                        # Absent values indicate that the field isn't specified.
+                      "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                          # for simplicity of conversion to/from color representations in various
+                          # languages over compactness; for example, the fields of this representation
+                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                          # method in iOS; and, with just a little work, it can be easily formatted into
+                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                          #
+                          # Example (Java):
+                          #
+                          #      import com.google.type.Color;
+                          #
+                          #      // ...
+                          #      public static java.awt.Color fromProto(Color protocolor) {
+                          #        float alpha = protocolor.hasAlpha()
+                          #            ? protocolor.getAlpha().getValue()
+                          #            : 1.0;
+                          #
+                          #        return new java.awt.Color(
+                          #            protocolor.getRed(),
+                          #            protocolor.getGreen(),
+                          #            protocolor.getBlue(),
+                          #            alpha);
+                          #      }
+                          #
+                          #      public static Color toProto(java.awt.Color color) {
+                          #        float red = (float) color.getRed();
+                          #        float green = (float) color.getGreen();
+                          #        float blue = (float) color.getBlue();
+                          #        float denominator = 255.0;
+                          #        Color.Builder resultBuilder =
+                          #            Color
+                          #                .newBuilder()
+                          #                .setRed(red / denominator)
+                          #                .setGreen(green / denominator)
+                          #                .setBlue(blue / denominator);
+                          #        int alpha = color.getAlpha();
+                          #        if (alpha != 255) {
+                          #          result.setAlpha(
+                          #              FloatValue
+                          #                  .newBuilder()
+                          #                  .setValue(((float) alpha) / denominator)
+                          #                  .build());
+                          #        }
+                          #        return resultBuilder.build();
+                          #      }
+                          #      // ...
+                          #
+                          # Example (iOS / Obj-C):
+                          #
+                          #      // ...
+                          #      static UIColor* fromProto(Color* protocolor) {
+                          #         float red = [protocolor red];
+                          #         float green = [protocolor green];
+                          #         float blue = [protocolor blue];
+                          #         FloatValue* alpha_wrapper = [protocolor alpha];
+                          #         float alpha = 1.0;
+                          #         if (alpha_wrapper != nil) {
+                          #           alpha = [alpha_wrapper value];
+                          #         }
+                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                          #      }
+                          #
+                          #      static Color* toProto(UIColor* color) {
+                          #          CGFloat red, green, blue, alpha;
+                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                          #            return nil;
+                          #          }
+                          #          Color* result = [Color alloc] init];
+                          #          [result setRed:red];
+                          #          [result setGreen:green];
+                          #          [result setBlue:blue];
+                          #          if (alpha <= 0.9999) {
+                          #            [result setAlpha:floatWrapperWithValue(alpha)];
+                          #          }
+                          #          [result autorelease];
+                          #          return result;
+                          #     }
+                          #     // ...
+                          #
+                          #  Example (JavaScript):
+                          #
+                          #     // ...
+                          #
+                          #     var protoToCssColor = function(rgb_color) {
+                          #        var redFrac = rgb_color.red || 0.0;
+                          #        var greenFrac = rgb_color.green || 0.0;
+                          #        var blueFrac = rgb_color.blue || 0.0;
+                          #        var red = Math.floor(redFrac * 255);
+                          #        var green = Math.floor(greenFrac * 255);
+                          #        var blue = Math.floor(blueFrac * 255);
+                          #
+                          #        if (!('alpha' in rgb_color)) {
+                          #           return rgbToCssColor_(red, green, blue);
+                          #        }
+                          #
+                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                          #        var rgbParams = [red, green, blue].join(',');
+                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                          #     };
+                          #
+                          #     var rgbToCssColor_ = function(red, green, blue) {
+                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                          #       var hexString = rgbNumber.toString(16);
+                          #       var missingZeros = 6 - hexString.length;
+                          #       var resultBuilder = ['#'];
+                          #       for (var i = 0; i < missingZeros; i++) {
+                          #          resultBuilder.push('0');
+                          #       }
+                          #       resultBuilder.push(hexString);
+                          #       return resultBuilder.join('');
+                          #     };
+                          #
+                          #     // ...
+                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                            # the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color. This
+                            # uses a wrapper message rather than a simple float scalar so that it is
+                            # possible to distinguish between a default value and the value being unset.
+                            # If omitted, this color object is to be rendered as a solid color
+                            # (as if the alpha value had been explicitly given with a value of 1.0).
+                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                      },
+                      "bold": True or False, # True if the text is bold.
+                      "strikethrough": True or False, # True if the text has a strikethrough.
+                      "fontFamily": "A String", # The font family.
+                      "fontSize": 42, # The size of the font.
+                      "italic": True or False, # True if the text is italicized.
+                      "underline": True or False, # True if the text is underlined.
+                    },
+                    "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                    "borders": { # The borders of the cell. # The borders of the cell.
+                      "top": { # A border along a cell. # The top border of the cell.
+                        "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "width": 42, # The width of the border, in pixels.
+                            # Deprecated; the width is determined by the "style" field.
+                        "style": "A String", # The style of the border.
+                      },
+                      "right": { # A border along a cell. # The right border of the cell.
+                        "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "width": 42, # The width of the border, in pixels.
+                            # Deprecated; the width is determined by the "style" field.
+                        "style": "A String", # The style of the border.
+                      },
+                      "bottom": { # A border along a cell. # The bottom border of the cell.
+                        "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "width": 42, # The width of the border, in pixels.
+                            # Deprecated; the width is determined by the "style" field.
+                        "style": "A String", # The style of the border.
+                      },
+                      "left": { # A border along a cell. # The left border of the cell.
+                        "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "width": 42, # The width of the border, in pixels.
+                            # Deprecated; the width is determined by the "style" field.
+                        "style": "A String", # The style of the border.
+                      },
+                    },
+                    "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+                  },
+                  "userEnteredFormat": { # The format of a cell. # The format the user entered for the cell.
+                      #
+                      # When writing, the new format will be merged with the existing format.
+                    "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                      "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                          # the user's locale will be used if necessary for the given type.
+                          # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                          # information about the supported patterns.
+                      "type": "A String", # The type of the number format.
+                          # When writing, this field must be set.
+                    },
+                    "textDirection": "A String", # The direction of the text in the cell.
+                    "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                        # When updating padding, every field must be specified.
+                      "top": 42, # The top padding of the cell.
+                      "right": 42, # The right padding of the cell.
+                      "bottom": 42, # The bottom padding of the cell.
+                      "left": 42, # The left padding of the cell.
+                    },
+                    "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                    "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                    "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                        # Absent values indicate that the field isn't specified.
+                      "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                          # for simplicity of conversion to/from color representations in various
+                          # languages over compactness; for example, the fields of this representation
+                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                          # method in iOS; and, with just a little work, it can be easily formatted into
+                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                          #
+                          # Example (Java):
+                          #
+                          #      import com.google.type.Color;
+                          #
+                          #      // ...
+                          #      public static java.awt.Color fromProto(Color protocolor) {
+                          #        float alpha = protocolor.hasAlpha()
+                          #            ? protocolor.getAlpha().getValue()
+                          #            : 1.0;
+                          #
+                          #        return new java.awt.Color(
+                          #            protocolor.getRed(),
+                          #            protocolor.getGreen(),
+                          #            protocolor.getBlue(),
+                          #            alpha);
+                          #      }
+                          #
+                          #      public static Color toProto(java.awt.Color color) {
+                          #        float red = (float) color.getRed();
+                          #        float green = (float) color.getGreen();
+                          #        float blue = (float) color.getBlue();
+                          #        float denominator = 255.0;
+                          #        Color.Builder resultBuilder =
+                          #            Color
+                          #                .newBuilder()
+                          #                .setRed(red / denominator)
+                          #                .setGreen(green / denominator)
+                          #                .setBlue(blue / denominator);
+                          #        int alpha = color.getAlpha();
+                          #        if (alpha != 255) {
+                          #          result.setAlpha(
+                          #              FloatValue
+                          #                  .newBuilder()
+                          #                  .setValue(((float) alpha) / denominator)
+                          #                  .build());
+                          #        }
+                          #        return resultBuilder.build();
+                          #      }
+                          #      // ...
+                          #
+                          # Example (iOS / Obj-C):
+                          #
+                          #      // ...
+                          #      static UIColor* fromProto(Color* protocolor) {
+                          #         float red = [protocolor red];
+                          #         float green = [protocolor green];
+                          #         float blue = [protocolor blue];
+                          #         FloatValue* alpha_wrapper = [protocolor alpha];
+                          #         float alpha = 1.0;
+                          #         if (alpha_wrapper != nil) {
+                          #           alpha = [alpha_wrapper value];
+                          #         }
+                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                          #      }
+                          #
+                          #      static Color* toProto(UIColor* color) {
+                          #          CGFloat red, green, blue, alpha;
+                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                          #            return nil;
+                          #          }
+                          #          Color* result = [Color alloc] init];
+                          #          [result setRed:red];
+                          #          [result setGreen:green];
+                          #          [result setBlue:blue];
+                          #          if (alpha <= 0.9999) {
+                          #            [result setAlpha:floatWrapperWithValue(alpha)];
+                          #          }
+                          #          [result autorelease];
+                          #          return result;
+                          #     }
+                          #     // ...
+                          #
+                          #  Example (JavaScript):
+                          #
+                          #     // ...
+                          #
+                          #     var protoToCssColor = function(rgb_color) {
+                          #        var redFrac = rgb_color.red || 0.0;
+                          #        var greenFrac = rgb_color.green || 0.0;
+                          #        var blueFrac = rgb_color.blue || 0.0;
+                          #        var red = Math.floor(redFrac * 255);
+                          #        var green = Math.floor(greenFrac * 255);
+                          #        var blue = Math.floor(blueFrac * 255);
+                          #
+                          #        if (!('alpha' in rgb_color)) {
+                          #           return rgbToCssColor_(red, green, blue);
+                          #        }
+                          #
+                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                          #        var rgbParams = [red, green, blue].join(',');
+                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                          #     };
+                          #
+                          #     var rgbToCssColor_ = function(red, green, blue) {
+                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                          #       var hexString = rgbNumber.toString(16);
+                          #       var missingZeros = 6 - hexString.length;
+                          #       var resultBuilder = ['#'];
+                          #       for (var i = 0; i < missingZeros; i++) {
+                          #          resultBuilder.push('0');
+                          #       }
+                          #       resultBuilder.push(hexString);
+                          #       return resultBuilder.join('');
+                          #     };
+                          #
+                          #     // ...
+                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                            # the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color. This
+                            # uses a wrapper message rather than a simple float scalar so that it is
+                            # possible to distinguish between a default value and the value being unset.
+                            # If omitted, this color object is to be rendered as a solid color
+                            # (as if the alpha value had been explicitly given with a value of 1.0).
+                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                      },
+                      "bold": True or False, # True if the text is bold.
+                      "strikethrough": True or False, # True if the text has a strikethrough.
+                      "fontFamily": "A String", # The font family.
+                      "fontSize": 42, # The size of the font.
+                      "italic": True or False, # True if the text is italicized.
+                      "underline": True or False, # True if the text is underlined.
+                    },
+                    "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                    "borders": { # The borders of the cell. # The borders of the cell.
+                      "top": { # A border along a cell. # The top border of the cell.
+                        "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "width": 42, # The width of the border, in pixels.
+                            # Deprecated; the width is determined by the "style" field.
+                        "style": "A String", # The style of the border.
+                      },
+                      "right": { # A border along a cell. # The right border of the cell.
+                        "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "width": 42, # The width of the border, in pixels.
+                            # Deprecated; the width is determined by the "style" field.
+                        "style": "A String", # The style of the border.
+                      },
+                      "bottom": { # A border along a cell. # The bottom border of the cell.
+                        "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "width": 42, # The width of the border, in pixels.
+                            # Deprecated; the width is determined by the "style" field.
+                        "style": "A String", # The style of the border.
+                      },
+                      "left": { # A border along a cell. # The left border of the cell.
+                        "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "width": 42, # The width of the border, in pixels.
+                            # Deprecated; the width is determined by the "style" field.
+                        "style": "A String", # The style of the border.
+                      },
+                    },
+                    "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+                  },
+                  "dataValidation": { # A data validation rule. # A data validation rule on the cell, if any.
+                      #
+                      # When writing, the new data validation rule will overwrite any prior rule.
+                    "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
+                        # If true, "List" conditions will show a dropdown.
+                    "strict": True or False, # True if invalid data should be rejected.
+                    "inputMessage": "A String", # A message to show the user when adding data to the cell.
+                    "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
+                        # BooleanConditions are used by conditional formatting,
+                        # data validation, and the criteria in filters.
+                      "type": "A String", # The type of condition.
+                      "values": [ # The values of the condition. The number of supported values depends
+                          # on the condition type.  Some support zero values,
+                          # others one or two values,
+                          # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                        { # The value of the condition.
+                          "relativeDate": "A String", # A relative date (based on the current date).
+                              # Valid only if the type is
+                              # DATE_BEFORE,
+                              # DATE_AFTER,
+                              # DATE_ON_OR_BEFORE or
+                              # DATE_ON_OR_AFTER.
+                              #
+                              # Relative dates are not supported in data validation.
+                              # They are supported only in conditional formatting and
+                              # conditional filters.
+                          "userEnteredValue": "A String", # A value the condition is based on.
+                              # The value will be parsed as if the user typed into a cell.
+                              # Formulas are supported (and must begin with an `=`).
+                        },
+                      ],
+                    },
+                  },
+                  "textFormatRuns": [ # Runs of rich text applied to subsections of the cell.  Runs are only valid
+                      # on user entered strings, not formulas, bools, or numbers.
+                      # Runs start at specific indexes in the text and continue until the next
+                      # run. Properties of a run will continue unless explicitly changed
+                      # in a subsequent run (and properties of the first run will continue
+                      # the properties of the cell unless explicitly changed).
+                      #
+                      # When writing, the new runs will overwrite any prior runs.  When writing a
+                      # new user_entered_value, previous runs will be erased.
+                    { # A run of a text format. The format of this run continues until the start
+                        # index of the next run.
+                        # When updating, all fields must be set.
+                      "startIndex": 42, # The character index where this run starts.
+                      "format": { # The format of a run of text in a cell. # The format of this run.  Absent values inherit the cell's format.
+                          # Absent values indicate that the field isn't specified.
+                        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                         },
-                        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+                        "bold": True or False, # True if the text is bold.
+                        "strikethrough": True or False, # True if the text has a strikethrough.
+                        "fontFamily": "A String", # The font family.
+                        "fontSize": 42, # The size of the font.
+                        "italic": True or False, # True if the text is italicized.
+                        "underline": True or False, # True if the text is underlined.
                       },
-                      "dataValidation": { # A data validation rule. # A data validation rule on the cell, if any.
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        },
+      ],
+      "properties": { # Properties of a sheet. # The properties of the sheet.
+        "sheetType": "A String", # The type of sheet. Defaults to GRID.
+            # This field cannot be changed once set.
+        "index": 42, # The index of the sheet within the spreadsheet.
+            # When adding or updating sheet properties, if this field
+            # is excluded then the sheet will be added or moved to the end
+            # of the sheet list. When updating sheet indices or inserting
+            # sheets, movement is considered in "before the move" indexes.
+            # For example, if there were 3 sheets (S1, S2, S3) in order to
+            # move S1 ahead of S2 the index would have to be set to 2. A sheet
+            # index update request will be ignored if the requested index is
+            # identical to the sheets current index or if the requested new
+            # index is equal to the current sheet index + 1.
+        "title": "A String", # The name of the sheet.
+        "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
+            # (If the sheet is an object sheet, containing a chart or image, then
+            # this field will be absent.)
+            # When writing it is an error to set any grid properties on non-grid sheets.
+          "columnCount": 42, # The number of columns in the grid.
+          "rowCount": 42, # The number of rows in the grid.
+          "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
+          "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
+          "frozenRowCount": 42, # The number of rows that are frozen in the grid.
+        },
+        "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
+        "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
+            # for simplicity of conversion to/from color representations in various
+            # languages over compactness; for example, the fields of this representation
+            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+            # method in iOS; and, with just a little work, it can be easily formatted into
+            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+            #
+            # Example (Java):
+            #
+            #      import com.google.type.Color;
+            #
+            #      // ...
+            #      public static java.awt.Color fromProto(Color protocolor) {
+            #        float alpha = protocolor.hasAlpha()
+            #            ? protocolor.getAlpha().getValue()
+            #            : 1.0;
+            #
+            #        return new java.awt.Color(
+            #            protocolor.getRed(),
+            #            protocolor.getGreen(),
+            #            protocolor.getBlue(),
+            #            alpha);
+            #      }
+            #
+            #      public static Color toProto(java.awt.Color color) {
+            #        float red = (float) color.getRed();
+            #        float green = (float) color.getGreen();
+            #        float blue = (float) color.getBlue();
+            #        float denominator = 255.0;
+            #        Color.Builder resultBuilder =
+            #            Color
+            #                .newBuilder()
+            #                .setRed(red / denominator)
+            #                .setGreen(green / denominator)
+            #                .setBlue(blue / denominator);
+            #        int alpha = color.getAlpha();
+            #        if (alpha != 255) {
+            #          result.setAlpha(
+            #              FloatValue
+            #                  .newBuilder()
+            #                  .setValue(((float) alpha) / denominator)
+            #                  .build());
+            #        }
+            #        return resultBuilder.build();
+            #      }
+            #      // ...
+            #
+            # Example (iOS / Obj-C):
+            #
+            #      // ...
+            #      static UIColor* fromProto(Color* protocolor) {
+            #         float red = [protocolor red];
+            #         float green = [protocolor green];
+            #         float blue = [protocolor blue];
+            #         FloatValue* alpha_wrapper = [protocolor alpha];
+            #         float alpha = 1.0;
+            #         if (alpha_wrapper != nil) {
+            #           alpha = [alpha_wrapper value];
+            #         }
+            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+            #      }
+            #
+            #      static Color* toProto(UIColor* color) {
+            #          CGFloat red, green, blue, alpha;
+            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+            #            return nil;
+            #          }
+            #          Color* result = [Color alloc] init];
+            #          [result setRed:red];
+            #          [result setGreen:green];
+            #          [result setBlue:blue];
+            #          if (alpha <= 0.9999) {
+            #            [result setAlpha:floatWrapperWithValue(alpha)];
+            #          }
+            #          [result autorelease];
+            #          return result;
+            #     }
+            #     // ...
+            #
+            #  Example (JavaScript):
+            #
+            #     // ...
+            #
+            #     var protoToCssColor = function(rgb_color) {
+            #        var redFrac = rgb_color.red || 0.0;
+            #        var greenFrac = rgb_color.green || 0.0;
+            #        var blueFrac = rgb_color.blue || 0.0;
+            #        var red = Math.floor(redFrac * 255);
+            #        var green = Math.floor(greenFrac * 255);
+            #        var blue = Math.floor(blueFrac * 255);
+            #
+            #        if (!('alpha' in rgb_color)) {
+            #           return rgbToCssColor_(red, green, blue);
+            #        }
+            #
+            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+            #        var rgbParams = [red, green, blue].join(',');
+            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+            #     };
+            #
+            #     var rgbToCssColor_ = function(red, green, blue) {
+            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+            #       var hexString = rgbNumber.toString(16);
+            #       var missingZeros = 6 - hexString.length;
+            #       var resultBuilder = ['#'];
+            #       for (var i = 0; i < missingZeros; i++) {
+            #          resultBuilder.push('0');
+            #       }
+            #       resultBuilder.push(hexString);
+            #       return resultBuilder.join('');
+            #     };
+            #
+            #     // ...
+          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+              # the final pixel color is defined by the equation:
+              #
+              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+              #
+              # This means that a value of 1.0 corresponds to a solid color, whereas
+              # a value of 0.0 corresponds to a completely transparent color. This
+              # uses a wrapper message rather than a simple float scalar so that it is
+              # possible to distinguish between a default value and the value being unset.
+              # If omitted, this color object is to be rendered as a solid color
+              # (as if the alpha value had been explicitly given with a value of 1.0).
+          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+        },
+        "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
+        "sheetId": 42, # The ID of the sheet. Must be non-negative.
+            # This field cannot be changed once set.
+      },
+    },
+  ],
+  "spreadsheetUrl": "A String", # The url of the spreadsheet.
+      # This field is read-only.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Resource that represents a spreadsheet.
+    "spreadsheetId": "A String", # The ID of the spreadsheet.
+        # This field is read-only.
+    "namedRanges": [ # The named ranges defined in a spreadsheet.
+      { # A named range.
+        "namedRangeId": "A String", # The ID of the named range.
+        "range": { # A range on a sheet. # The range this represents.
+            # All indexes are zero-based.
+            # Indexes are half open, e.g the start index is inclusive
+            # and the end index is exclusive -- [start_index, end_index).
+            # Missing indexes indicate the range is unbounded on that side.
+            #
+            # For example, if `"Sheet1"` is sheet ID 0, then:
+            #
+            #   `Sheet1!A1:A1 == sheet_id: 0,
+            #                   start_row_index: 0, end_row_index: 1,
+            #                   start_column_index: 0, end_column_index: 1`
+            #
+            #   `Sheet1!A3:B4 == sheet_id: 0,
+            #                   start_row_index: 2, end_row_index: 4,
+            #                   start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1!A:B == sheet_id: 0,
+            #                 start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1!A5:B == sheet_id: 0,
+            #                  start_row_index: 4,
+            #                  start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1 == sheet_id:0`
+            #
+            # The start index must always be less than or equal to the end index.
+            # If the start index equals the end index, then the range is empty.
+            # Empty ranges are typically not meaningful and are usually rendered in the
+            # UI as `#REF!`.
+          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+          "sheetId": 42, # The sheet this range is on.
+          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+        },
+        "name": "A String", # The name of the named range.
+      },
+    ],
+    "properties": { # Properties of a spreadsheet. # Overall properties of a spreadsheet.
+      "locale": "A String", # The locale of the spreadsheet in one of the following formats:
+          #
+          # * an ISO 639-1 language code such as `en`
+          #
+          # * an ISO 639-2 language code such as `fil`, if no 639-1 code exists
+          #
+          # * a combination of the ISO language code and country code, such as `en_US`
+          #
+          # Note: when updating this field, not all locales/languages are supported.
+      "timeZone": "A String", # The time zone of the spreadsheet, in CLDR format such as
+          # `America/New_York`. If the time zone isn't recognized, this may
+          # be a custom time zone such as `GMT-07:00`.
+      "autoRecalc": "A String", # The amount of time to wait before volatile functions are recalculated.
+      "defaultFormat": { # The format of a cell. # The default format of all cells in the spreadsheet.
+          # CellData.effectiveFormat will not be set if the
+          # cell's format is equal to this default format.
+          # This field is read-only.
+        "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+          "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+              # the user's locale will be used if necessary for the given type.
+              # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+              # information about the supported patterns.
+          "type": "A String", # The type of the number format.
+              # When writing, this field must be set.
+        },
+        "textDirection": "A String", # The direction of the text in the cell.
+        "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+            # When updating padding, every field must be specified.
+          "top": 42, # The top padding of the cell.
+          "right": 42, # The right padding of the cell.
+          "bottom": 42, # The bottom padding of the cell.
+          "left": 42, # The left padding of the cell.
+        },
+        "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+        "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+            # for simplicity of conversion to/from color representations in various
+            # languages over compactness; for example, the fields of this representation
+            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+            # method in iOS; and, with just a little work, it can be easily formatted into
+            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+            #
+            # Example (Java):
+            #
+            #      import com.google.type.Color;
+            #
+            #      // ...
+            #      public static java.awt.Color fromProto(Color protocolor) {
+            #        float alpha = protocolor.hasAlpha()
+            #            ? protocolor.getAlpha().getValue()
+            #            : 1.0;
+            #
+            #        return new java.awt.Color(
+            #            protocolor.getRed(),
+            #            protocolor.getGreen(),
+            #            protocolor.getBlue(),
+            #            alpha);
+            #      }
+            #
+            #      public static Color toProto(java.awt.Color color) {
+            #        float red = (float) color.getRed();
+            #        float green = (float) color.getGreen();
+            #        float blue = (float) color.getBlue();
+            #        float denominator = 255.0;
+            #        Color.Builder resultBuilder =
+            #            Color
+            #                .newBuilder()
+            #                .setRed(red / denominator)
+            #                .setGreen(green / denominator)
+            #                .setBlue(blue / denominator);
+            #        int alpha = color.getAlpha();
+            #        if (alpha != 255) {
+            #          result.setAlpha(
+            #              FloatValue
+            #                  .newBuilder()
+            #                  .setValue(((float) alpha) / denominator)
+            #                  .build());
+            #        }
+            #        return resultBuilder.build();
+            #      }
+            #      // ...
+            #
+            # Example (iOS / Obj-C):
+            #
+            #      // ...
+            #      static UIColor* fromProto(Color* protocolor) {
+            #         float red = [protocolor red];
+            #         float green = [protocolor green];
+            #         float blue = [protocolor blue];
+            #         FloatValue* alpha_wrapper = [protocolor alpha];
+            #         float alpha = 1.0;
+            #         if (alpha_wrapper != nil) {
+            #           alpha = [alpha_wrapper value];
+            #         }
+            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+            #      }
+            #
+            #      static Color* toProto(UIColor* color) {
+            #          CGFloat red, green, blue, alpha;
+            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+            #            return nil;
+            #          }
+            #          Color* result = [Color alloc] init];
+            #          [result setRed:red];
+            #          [result setGreen:green];
+            #          [result setBlue:blue];
+            #          if (alpha <= 0.9999) {
+            #            [result setAlpha:floatWrapperWithValue(alpha)];
+            #          }
+            #          [result autorelease];
+            #          return result;
+            #     }
+            #     // ...
+            #
+            #  Example (JavaScript):
+            #
+            #     // ...
+            #
+            #     var protoToCssColor = function(rgb_color) {
+            #        var redFrac = rgb_color.red || 0.0;
+            #        var greenFrac = rgb_color.green || 0.0;
+            #        var blueFrac = rgb_color.blue || 0.0;
+            #        var red = Math.floor(redFrac * 255);
+            #        var green = Math.floor(greenFrac * 255);
+            #        var blue = Math.floor(blueFrac * 255);
+            #
+            #        if (!('alpha' in rgb_color)) {
+            #           return rgbToCssColor_(red, green, blue);
+            #        }
+            #
+            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+            #        var rgbParams = [red, green, blue].join(',');
+            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+            #     };
+            #
+            #     var rgbToCssColor_ = function(red, green, blue) {
+            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+            #       var hexString = rgbNumber.toString(16);
+            #       var missingZeros = 6 - hexString.length;
+            #       var resultBuilder = ['#'];
+            #       for (var i = 0; i < missingZeros; i++) {
+            #          resultBuilder.push('0');
+            #       }
+            #       resultBuilder.push(hexString);
+            #       return resultBuilder.join('');
+            #     };
+            #
+            #     // ...
+          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+              # the final pixel color is defined by the equation:
+              #
+              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+              #
+              # This means that a value of 1.0 corresponds to a solid color, whereas
+              # a value of 0.0 corresponds to a completely transparent color. This
+              # uses a wrapper message rather than a simple float scalar so that it is
+              # possible to distinguish between a default value and the value being unset.
+              # If omitted, this color object is to be rendered as a solid color
+              # (as if the alpha value had been explicitly given with a value of 1.0).
+          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+        },
+        "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+        "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+            # Absent values indicate that the field isn't specified.
+          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+              # for simplicity of conversion to/from color representations in various
+              # languages over compactness; for example, the fields of this representation
+              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+              # method in iOS; and, with just a little work, it can be easily formatted into
+              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+              #
+              # Example (Java):
+              #
+              #      import com.google.type.Color;
+              #
+              #      // ...
+              #      public static java.awt.Color fromProto(Color protocolor) {
+              #        float alpha = protocolor.hasAlpha()
+              #            ? protocolor.getAlpha().getValue()
+              #            : 1.0;
+              #
+              #        return new java.awt.Color(
+              #            protocolor.getRed(),
+              #            protocolor.getGreen(),
+              #            protocolor.getBlue(),
+              #            alpha);
+              #      }
+              #
+              #      public static Color toProto(java.awt.Color color) {
+              #        float red = (float) color.getRed();
+              #        float green = (float) color.getGreen();
+              #        float blue = (float) color.getBlue();
+              #        float denominator = 255.0;
+              #        Color.Builder resultBuilder =
+              #            Color
+              #                .newBuilder()
+              #                .setRed(red / denominator)
+              #                .setGreen(green / denominator)
+              #                .setBlue(blue / denominator);
+              #        int alpha = color.getAlpha();
+              #        if (alpha != 255) {
+              #          result.setAlpha(
+              #              FloatValue
+              #                  .newBuilder()
+              #                  .setValue(((float) alpha) / denominator)
+              #                  .build());
+              #        }
+              #        return resultBuilder.build();
+              #      }
+              #      // ...
+              #
+              # Example (iOS / Obj-C):
+              #
+              #      // ...
+              #      static UIColor* fromProto(Color* protocolor) {
+              #         float red = [protocolor red];
+              #         float green = [protocolor green];
+              #         float blue = [protocolor blue];
+              #         FloatValue* alpha_wrapper = [protocolor alpha];
+              #         float alpha = 1.0;
+              #         if (alpha_wrapper != nil) {
+              #           alpha = [alpha_wrapper value];
+              #         }
+              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+              #      }
+              #
+              #      static Color* toProto(UIColor* color) {
+              #          CGFloat red, green, blue, alpha;
+              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+              #            return nil;
+              #          }
+              #          Color* result = [Color alloc] init];
+              #          [result setRed:red];
+              #          [result setGreen:green];
+              #          [result setBlue:blue];
+              #          if (alpha <= 0.9999) {
+              #            [result setAlpha:floatWrapperWithValue(alpha)];
+              #          }
+              #          [result autorelease];
+              #          return result;
+              #     }
+              #     // ...
+              #
+              #  Example (JavaScript):
+              #
+              #     // ...
+              #
+              #     var protoToCssColor = function(rgb_color) {
+              #        var redFrac = rgb_color.red || 0.0;
+              #        var greenFrac = rgb_color.green || 0.0;
+              #        var blueFrac = rgb_color.blue || 0.0;
+              #        var red = Math.floor(redFrac * 255);
+              #        var green = Math.floor(greenFrac * 255);
+              #        var blue = Math.floor(blueFrac * 255);
+              #
+              #        if (!('alpha' in rgb_color)) {
+              #           return rgbToCssColor_(red, green, blue);
+              #        }
+              #
+              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+              #        var rgbParams = [red, green, blue].join(',');
+              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+              #     };
+              #
+              #     var rgbToCssColor_ = function(red, green, blue) {
+              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+              #       var hexString = rgbNumber.toString(16);
+              #       var missingZeros = 6 - hexString.length;
+              #       var resultBuilder = ['#'];
+              #       for (var i = 0; i < missingZeros; i++) {
+              #          resultBuilder.push('0');
+              #       }
+              #       resultBuilder.push(hexString);
+              #       return resultBuilder.join('');
+              #     };
+              #
+              #     // ...
+            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                # the final pixel color is defined by the equation:
+                #
+                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                #
+                # This means that a value of 1.0 corresponds to a solid color, whereas
+                # a value of 0.0 corresponds to a completely transparent color. This
+                # uses a wrapper message rather than a simple float scalar so that it is
+                # possible to distinguish between a default value and the value being unset.
+                # If omitted, this color object is to be rendered as a solid color
+                # (as if the alpha value had been explicitly given with a value of 1.0).
+            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+          },
+          "bold": True or False, # True if the text is bold.
+          "strikethrough": True or False, # True if the text has a strikethrough.
+          "fontFamily": "A String", # The font family.
+          "fontSize": 42, # The size of the font.
+          "italic": True or False, # True if the text is italicized.
+          "underline": True or False, # True if the text is underlined.
+        },
+        "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+        "borders": { # The borders of the cell. # The borders of the cell.
+          "top": { # A border along a cell. # The top border of the cell.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+          "right": { # A border along a cell. # The right border of the cell.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+          "bottom": { # A border along a cell. # The bottom border of the cell.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+          "left": { # A border along a cell. # The left border of the cell.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+        },
+        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+      },
+      "title": "A String", # The title of the spreadsheet.
+    },
+    "sheets": [ # The sheets that are part of a spreadsheet.
+      { # A sheet in a spreadsheet.
+        "conditionalFormats": [ # The conditional format rules in this sheet.
+          { # A rule describing a conditional format.
+            "ranges": [ # The ranges that will be formatted if the condition is true.
+                # All the ranges must be on the same grid.
+              { # A range on a sheet.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+            ],
+            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
+              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
+                  # the format will be applied.
+                  # BooleanConditions are used by conditional formatting,
+                  # data validation, and the criteria in filters.
+                "type": "A String", # The type of condition.
+                "values": [ # The values of the condition. The number of supported values depends
+                    # on the condition type.  Some support zero values,
+                    # others one or two values,
+                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                  { # The value of the condition.
+                    "relativeDate": "A String", # A relative date (based on the current date).
+                        # Valid only if the type is
+                        # DATE_BEFORE,
+                        # DATE_AFTER,
+                        # DATE_ON_OR_BEFORE or
+                        # DATE_ON_OR_AFTER.
+                        #
+                        # Relative dates are not supported in data validation.
+                        # They are supported only in conditional formatting and
+                        # conditional filters.
+                    "userEnteredValue": "A String", # A value the condition is based on.
+                        # The value will be parsed as if the user typed into a cell.
+                        # Formulas are supported (and must begin with an `=`).
+                  },
+                ],
+              },
+              "format": { # The format of a cell. # The format to apply.
+                  # Conditional formatting can only apply a subset of formatting:
+                  # bold, italic,
+                  # strikethrough,
+                  # foreground color &
+                  # background color.
+                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                      # the user's locale will be used if necessary for the given type.
+                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                      # information about the supported patterns.
+                  "type": "A String", # The type of the number format.
+                      # When writing, this field must be set.
+                },
+                "textDirection": "A String", # The direction of the text in the cell.
+                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                    # When updating padding, every field must be specified.
+                  "top": 42, # The top padding of the cell.
+                  "right": 42, # The right padding of the cell.
+                  "bottom": 42, # The bottom padding of the cell.
+                  "left": 42, # The left padding of the cell.
+                },
+                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                    # Absent values indicate that the field isn't specified.
+                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                      # for simplicity of conversion to/from color representations in various
+                      # languages over compactness; for example, the fields of this representation
+                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                      # method in iOS; and, with just a little work, it can be easily formatted into
+                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                      #
+                      # Example (Java):
+                      #
+                      #      import com.google.type.Color;
+                      #
+                      #      // ...
+                      #      public static java.awt.Color fromProto(Color protocolor) {
+                      #        float alpha = protocolor.hasAlpha()
+                      #            ? protocolor.getAlpha().getValue()
+                      #            : 1.0;
+                      #
+                      #        return new java.awt.Color(
+                      #            protocolor.getRed(),
+                      #            protocolor.getGreen(),
+                      #            protocolor.getBlue(),
+                      #            alpha);
+                      #      }
+                      #
+                      #      public static Color toProto(java.awt.Color color) {
+                      #        float red = (float) color.getRed();
+                      #        float green = (float) color.getGreen();
+                      #        float blue = (float) color.getBlue();
+                      #        float denominator = 255.0;
+                      #        Color.Builder resultBuilder =
+                      #            Color
+                      #                .newBuilder()
+                      #                .setRed(red / denominator)
+                      #                .setGreen(green / denominator)
+                      #                .setBlue(blue / denominator);
+                      #        int alpha = color.getAlpha();
+                      #        if (alpha != 255) {
+                      #          result.setAlpha(
+                      #              FloatValue
+                      #                  .newBuilder()
+                      #                  .setValue(((float) alpha) / denominator)
+                      #                  .build());
+                      #        }
+                      #        return resultBuilder.build();
+                      #      }
+                      #      // ...
+                      #
+                      # Example (iOS / Obj-C):
+                      #
+                      #      // ...
+                      #      static UIColor* fromProto(Color* protocolor) {
+                      #         float red = [protocolor red];
+                      #         float green = [protocolor green];
+                      #         float blue = [protocolor blue];
+                      #         FloatValue* alpha_wrapper = [protocolor alpha];
+                      #         float alpha = 1.0;
+                      #         if (alpha_wrapper != nil) {
+                      #           alpha = [alpha_wrapper value];
+                      #         }
+                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                      #      }
+                      #
+                      #      static Color* toProto(UIColor* color) {
+                      #          CGFloat red, green, blue, alpha;
+                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                      #            return nil;
+                      #          }
+                      #          Color* result = [Color alloc] init];
+                      #          [result setRed:red];
+                      #          [result setGreen:green];
+                      #          [result setBlue:blue];
+                      #          if (alpha <= 0.9999) {
+                      #            [result setAlpha:floatWrapperWithValue(alpha)];
+                      #          }
+                      #          [result autorelease];
+                      #          return result;
+                      #     }
+                      #     // ...
+                      #
+                      #  Example (JavaScript):
+                      #
+                      #     // ...
+                      #
+                      #     var protoToCssColor = function(rgb_color) {
+                      #        var redFrac = rgb_color.red || 0.0;
+                      #        var greenFrac = rgb_color.green || 0.0;
+                      #        var blueFrac = rgb_color.blue || 0.0;
+                      #        var red = Math.floor(redFrac * 255);
+                      #        var green = Math.floor(greenFrac * 255);
+                      #        var blue = Math.floor(blueFrac * 255);
+                      #
+                      #        if (!('alpha' in rgb_color)) {
+                      #           return rgbToCssColor_(red, green, blue);
+                      #        }
+                      #
+                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                      #        var rgbParams = [red, green, blue].join(',');
+                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                      #     };
+                      #
+                      #     var rgbToCssColor_ = function(red, green, blue) {
+                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                      #       var hexString = rgbNumber.toString(16);
+                      #       var missingZeros = 6 - hexString.length;
+                      #       var resultBuilder = ['#'];
+                      #       for (var i = 0; i < missingZeros; i++) {
+                      #          resultBuilder.push('0');
+                      #       }
+                      #       resultBuilder.push(hexString);
+                      #       return resultBuilder.join('');
+                      #     };
+                      #
+                      #     // ...
+                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                        # the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color. This
+                        # uses a wrapper message rather than a simple float scalar so that it is
+                        # possible to distinguish between a default value and the value being unset.
+                        # If omitted, this color object is to be rendered as a solid color
+                        # (as if the alpha value had been explicitly given with a value of 1.0).
+                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  },
+                  "bold": True or False, # True if the text is bold.
+                  "strikethrough": True or False, # True if the text has a strikethrough.
+                  "fontFamily": "A String", # The font family.
+                  "fontSize": 42, # The size of the font.
+                  "italic": True or False, # True if the text is italicized.
+                  "underline": True or False, # True if the text is underlined.
+                },
+                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                "borders": { # The borders of the cell. # The borders of the cell.
+                  "top": { # A border along a cell. # The top border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
                           #
-                          # When writing, the new data validation rule will overwrite any prior rule.
-                        "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
-                            # If true, "List" conditions will show a dropdown.
-                        "strict": True or False, # True if invalid data should be rejected.
-                        "inputMessage": "A String", # A message to show the user when adding data to the cell.
-                        "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
-                            # BooleanConditions are used by conditional formatting,
-                            # data validation, and the criteria in filters.
-                          "type": "A String", # The type of condition.
-                          "values": [ # The values of the condition. The number of supported values depends
-                              # on the condition type.  Some support zero values,
-                              # others one or two values,
-                              # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                            { # The value of the condition.
-                              "relativeDate": "A String", # A relative date (based on the current date).
-                                  # Valid only if the type is
-                                  # DATE_BEFORE,
-                                  # DATE_AFTER,
-                                  # DATE_ON_OR_BEFORE or
-                                  # DATE_ON_OR_AFTER.
-                                  #
-                                  # Relative dates are not supported in data validation.
-                                  # They are supported only in conditional formatting and
-                                  # conditional filters.
-                              "userEnteredValue": "A String", # A value the condition is based on.
-                                  # The value will be parsed as if the user typed into a cell.
-                                  # Formulas are supported (and must begin with an `=`).
-                            },
-                          ],
-                        },
-                      },
-                      "textFormatRuns": [ # Runs of rich text applied to subsections of the cell.  Runs are only valid
-                          # on user entered strings, not formulas, bools, or numbers.
-                          # Runs start at specific indexes in the text and continue until the next
-                          # run. Properties of a run will continue unless explicitly changed
-                          # in a subsequent run (and properties of the first run will continue
-                          # the properties of the cell unless explicitly changed).
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                           #
-                          # When writing, the new runs will overwrite any prior runs.  When writing a
-                          # new user_entered_value, previous runs will be erased.
-                        { # A run of a text format. The format of this run continues until the start
-                            # index of the next run.
-                            # When updating, all fields must be set.
-                          "startIndex": 42, # The character index where this run starts.
-                          "format": { # The format of a run of text in a cell. # The format of this run.  Absent values inherit the cell's format.
-                              # Absent values indicate that the field isn't specified.
-                            "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "bold": True or False, # True if the text is bold.
-                            "strikethrough": True or False, # True if the text has a strikethrough.
-                            "fontFamily": "A String", # The font family.
-                            "fontSize": 42, # The size of the font.
-                            "italic": True or False, # True if the text is italicized.
-                            "underline": True or False, # True if the text is underlined.
-                          },
-                        },
-                      ],
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "right": { # A border along a cell. # The right border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "bottom": { # A border along a cell. # The bottom border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                     },
-                  ],
-                },
-              ],
-            },
-          ],
-          "properties": { # Properties of a sheet. # The properties of the sheet.
-            "sheetType": "A String", # The type of sheet. Defaults to GRID.
-                # This field cannot be changed once set.
-            "index": 42, # The index of the sheet within the spreadsheet.
-                # When adding or updating sheet properties, if this field
-                # is excluded then the sheet will be added or moved to the end
-                # of the sheet list.
-            "title": "A String", # The name of the sheet.
-            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
-                # (If the sheet is an object sheet, containing a chart or image, then
-                # this field will be absent.)
-                # When writing it is an error to set any grid properties on non-grid sheets.
-              "columnCount": 42, # The number of columns in the grid.
-              "rowCount": 42, # The number of rows in the grid.
-              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
-              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
-              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
-            },
-            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
-            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
-                #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
-                #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
-                  #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                  #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
-            "sheetId": 42, # The ID of the sheet. Must be non-negative.
-                # This field cannot be changed once set.
-          },
-        },
-      ],
-    }</pre>
-</div>
-
-<div class="method">
-    <code class="details" id="get">get(spreadsheetId, ranges=None, x__xgafv=None, includeGridData=None)</code>
-  <pre>Returns the spreadsheet at the given ID.
-The caller must specify the spreadsheet ID.
-
-By default, data within grids will not be returned.
-You can include grid data one of two ways:
-
-* Specify a field mask listing your desired fields using the `fields` URL
-parameter in HTTP
-
-* Set the includeGridData
-URL parameter to true.  If a field mask is set, the `includeGridData`
-parameter is ignored
-
-For large spreadsheets, it is recommended to retrieve only the specific
-fields of the spreadsheet that you want.
-
-To retrieve only subsets of the spreadsheet, use the
-ranges URL parameter.
-Multiple ranges can be specified.  Limiting the range will
-return only the portions of the spreadsheet that intersect the requested
-ranges. Ranges are specified using A1 notation.
-
-Args:
-  spreadsheetId: string, The spreadsheet to request. (required)
-  ranges: string, The ranges to retrieve from the spreadsheet. (repeated)
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-  includeGridData: boolean, True if grid data should be returned.
-This parameter is ignored if a field mask was set in the request.
-
-Returns:
-  An object of the form:
-
-    { # Resource that represents a spreadsheet.
-      "spreadsheetId": "A String", # The ID of the spreadsheet.
-          # This field is read-only.
-      "namedRanges": [ # The named ranges defined in a spreadsheet.
-        { # A named range.
-          "namedRangeId": "A String", # The ID of the named range.
-          "range": { # A range on a sheet. # The range this represents.
-              # All indexes are zero-based.
-              # Indexes are half open, e.g the start index is inclusive
-              # and the end index is exclusive -- [start_index, end_index).
-              # Missing indexes indicate the range is unbounded on that side.
-              #
-              # For example, if `"Sheet1"` is sheet ID 0, then:
-              #
-              #   `Sheet1!A1:A1 == sheet_id: 0,
-              #                   start_row_index: 0, end_row_index: 1,
-              #                   start_column_index: 0, end_column_index: 1`
-              #
-              #   `Sheet1!A3:B4 == sheet_id: 0,
-              #                   start_row_index: 2, end_row_index: 4,
-              #                   start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A:B == sheet_id: 0,
-              #                 start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1!A5:B == sheet_id: 0,
-              #                  start_row_index: 4,
-              #                  start_column_index: 0, end_column_index: 2`
-              #
-              #   `Sheet1 == sheet_id:0`
-              #
-              # The start index must always be less than or equal to the end index.
-              # If the start index equals the end index, then the range is empty.
-              # Empty ranges are typically not meaningful and are usually rendered in the
-              # UI as `#REF!`.
-            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-            "sheetId": 42, # The sheet this range is on.
-            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-          },
-          "name": "A String", # The name of the named range.
-        },
-      ],
-      "properties": { # Properties of a spreadsheet. # Overall properties of a spreadsheet.
-        "locale": "A String", # The locale of the spreadsheet in one of the following formats:
-            #
-            # * an ISO 639-1 language code such as `en`
-            #
-            # * an ISO 639-2 language code such as `fil`, if no 639-1 code exists
-            #
-            # * a combination of the ISO language code and country code, such as `en_US`
-            #
-            # Note: when updating this field, not all locales/languages are supported.
-        "timeZone": "A String", # The time zone of the spreadsheet, in CLDR format such as
-            # `America/New_York`. If the time zone isn't recognized, this may
-            # be a custom time zone such as `GMT-07:00`.
-        "autoRecalc": "A String", # The amount of time to wait before volatile functions are recalculated.
-        "defaultFormat": { # The format of a cell. # The default format of all cells in the spreadsheet.
-            # CellData.effectiveFormat will not be set if the
-            # cell's format is equal to this default format.
-            # This field is read-only.
-          "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-            "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                # the user's locale will be used if necessary for the given type.
-                # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                # information about the supported patterns.
-            "type": "A String", # The type of the number format.
-                # When writing, this field must be set.
-          },
-          "textDirection": "A String", # The direction of the text in the cell.
-          "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-              # When updating padding, every field must be specified.
-            "top": 42, # The top padding of the cell.
-            "right": 42, # The right padding of the cell.
-            "bottom": 42, # The bottom padding of the cell.
-            "left": 42, # The left padding of the cell.
-          },
-          "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-          "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-              # for simplicity of conversion to/from color representations in various
-              # languages over compactness; for example, the fields of this representation
-              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-              # method in iOS; and, with just a little work, it can be easily formatted into
-              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-              #
-              # Example (Java):
-              #
-              #      import com.google.type.Color;
-              #
-              #      // ...
-              #      public static java.awt.Color fromProto(Color protocolor) {
-              #        float alpha = protocolor.hasAlpha()
-              #            ? protocolor.getAlpha().getValue()
-              #            : 1.0;
-              #
-              #        return new java.awt.Color(
-              #            protocolor.getRed(),
-              #            protocolor.getGreen(),
-              #            protocolor.getBlue(),
-              #            alpha);
-              #      }
-              #
-              #      public static Color toProto(java.awt.Color color) {
-              #        float red = (float) color.getRed();
-              #        float green = (float) color.getGreen();
-              #        float blue = (float) color.getBlue();
-              #        float denominator = 255.0;
-              #        Color.Builder resultBuilder =
-              #            Color
-              #                .newBuilder()
-              #                .setRed(red / denominator)
-              #                .setGreen(green / denominator)
-              #                .setBlue(blue / denominator);
-              #        int alpha = color.getAlpha();
-              #        if (alpha != 255) {
-              #          result.setAlpha(
-              #              FloatValue
-              #                  .newBuilder()
-              #                  .setValue(((float) alpha) / denominator)
-              #                  .build());
-              #        }
-              #        return resultBuilder.build();
-              #      }
-              #      // ...
-              #
-              # Example (iOS / Obj-C):
-              #
-              #      // ...
-              #      static UIColor* fromProto(Color* protocolor) {
-              #         float red = [protocolor red];
-              #         float green = [protocolor green];
-              #         float blue = [protocolor blue];
-              #         FloatValue* alpha_wrapper = [protocolor alpha];
-              #         float alpha = 1.0;
-              #         if (alpha_wrapper != nil) {
-              #           alpha = [alpha_wrapper value];
-              #         }
-              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-              #      }
-              #
-              #      static Color* toProto(UIColor* color) {
-              #          CGFloat red, green, blue, alpha;
-              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-              #            return nil;
-              #          }
-              #          Color* result = [Color alloc] init];
-              #          [result setRed:red];
-              #          [result setGreen:green];
-              #          [result setBlue:blue];
-              #          if (alpha <= 0.9999) {
-              #            [result setAlpha:floatWrapperWithValue(alpha)];
-              #          }
-              #          [result autorelease];
-              #          return result;
-              #     }
-              #     // ...
-              #
-              #  Example (JavaScript):
-              #
-              #     // ...
-              #
-              #     var protoToCssColor = function(rgb_color) {
-              #        var redFrac = rgb_color.red || 0.0;
-              #        var greenFrac = rgb_color.green || 0.0;
-              #        var blueFrac = rgb_color.blue || 0.0;
-              #        var red = Math.floor(redFrac * 255);
-              #        var green = Math.floor(greenFrac * 255);
-              #        var blue = Math.floor(blueFrac * 255);
-              #
-              #        if (!('alpha' in rgb_color)) {
-              #           return rgbToCssColor_(red, green, blue);
-              #        }
-              #
-              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-              #        var rgbParams = [red, green, blue].join(',');
-              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-              #     };
-              #
-              #     var rgbToCssColor_ = function(red, green, blue) {
-              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-              #       var hexString = rgbNumber.toString(16);
-              #       var missingZeros = 6 - hexString.length;
-              #       var resultBuilder = ['#'];
-              #       for (var i = 0; i < missingZeros; i++) {
-              #          resultBuilder.push('0');
-              #       }
-              #       resultBuilder.push(hexString);
-              #       return resultBuilder.join('');
-              #     };
-              #
-              #     // ...
-            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                # the final pixel color is defined by the equation:
-                #
-                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                #
-                # This means that a value of 1.0 corresponds to a solid color, whereas
-                # a value of 0.0 corresponds to a completely transparent color. This
-                # uses a wrapper message rather than a simple float scalar so that it is
-                # possible to distinguish between a default value and the value being unset.
-                # If omitted, this color object is to be rendered as a solid color
-                # (as if the alpha value had been explicitly given with a value of 1.0).
-            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                  "left": { # A border along a cell. # The left border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
+                  },
+                },
+                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+              },
+            },
+            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
+                # the interpolation points listed. The format of a cell will vary
+                # based on its contents as compared to the values of the interpolation
+                # points.
+              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+            },
           },
-          "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-          "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-              # Absent values indicate that the field isn't specified.
-            "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
+        ],
+        "bandedRanges": [ # The banded (i.e. alternating colors) ranges on this sheet.
+          { # A banded (alternating colors) range in a sheet.
+            "range": { # A range on a sheet. # The range over which these properties are applied.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
                 #
-                #  Example (JavaScript):
+                # For example, if `"Sheet1"` is sheet ID 0, then:
                 #
-                #     // ...
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
                 #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
                 #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
                 #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
                 #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
+                #   `Sheet1 == sheet_id:0`
                 #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "columnProperties": { # Properties referring a single dimension (either row or column). If both # Properties for column bands. These properties will be applied on a column-
+                # by-column basis throughout all the columns in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
                   #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                   #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
             },
-            "bold": True or False, # True if the text is bold.
-            "strikethrough": True or False, # True if the text has a strikethrough.
-            "fontFamily": "A String", # The font family.
-            "fontSize": 42, # The size of the font.
-            "italic": True or False, # True if the text is italicized.
-            "underline": True or False, # True if the text is underlined.
-          },
-          "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-          "borders": { # The borders of the cell. # The borders of the cell.
-            "top": { # A border along a cell. # The top border of the cell.
-              "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+            "rowProperties": { # Properties referring a single dimension (either row or column). If both # Properties for row bands. These properties will be applied on a row-by-row
+                # basis throughout all the rows in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
                   # for simplicity of conversion to/from color representations in various
                   # languages over compactness; for example, the fields of this representation
                   # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -29574,12 +37645,12 @@ <h3>Method Details</h3>
                 "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                 "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-              "width": 42, # The width of the border, in pixels.
-                  # Deprecated; the width is determined by the "style" field.
-              "style": "A String", # The style of the border.
-            },
-            "right": { # A border along a cell. # The right border of the cell.
-              "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
                   # for simplicity of conversion to/from color representations in various
                   # languages over compactness; for example, the fields of this representation
                   # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -29708,12 +37779,10 @@ <h3>Method Details</h3>
                 "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                 "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-              "width": 42, # The width of the border, in pixels.
-                  # Deprecated; the width is determined by the "style" field.
-              "style": "A String", # The style of the border.
-            },
-            "bottom": { # A border along a cell. # The bottom border of the cell.
-              "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
                   # for simplicity of conversion to/from color representations in various
                   # languages over compactness; for example, the fields of this representation
                   # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -29842,12 +37911,7 @@ <h3>Method Details</h3>
                 "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                 "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-              "width": 42, # The width of the border, in pixels.
-                  # Deprecated; the width is determined by the "style" field.
-              "style": "A String", # The style of the border.
-            },
-            "left": { # A border along a cell. # The left border of the cell.
-              "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
                   # for simplicity of conversion to/from color representations in various
                   # languages over compactness; for example, the fields of this representation
                   # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -29976,60 +38040,639 @@ <h3>Method Details</h3>
                 "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                 "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-              "width": 42, # The width of the border, in pixels.
-                  # Deprecated; the width is determined by the "style" field.
-              "style": "A String", # The style of the border.
+            },
+            "bandedRangeId": 42, # The id of the banded range.
+          },
+        ],
+        "merges": [ # The ranges that are merged together.
+          { # A range on a sheet.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+        ],
+        "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any.
+          "range": { # A range on a sheet. # The range the filter covers.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "sortSpecs": [ # The sort order per column. Later specifications are used when values
+              # are equal in the earlier specifications.
+            { # A sort order associated with a specific column or row.
+              "sortOrder": "A String", # The order data should be sorted.
+              "dimensionIndex": 42, # The dimension the sort should be applied to.
+            },
+          ],
+          "criteria": { # The criteria for showing/hiding values per column.
+              # The map's key is the column index, and the value is the criteria for
+              # that column.
+            "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+              "hiddenValues": [ # Values that should be hidden.
+                "A String",
+              ],
+              "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                  # (This does not override hiddenValues -- if a value is listed there,
+                  #  it will still be hidden.)
+                  # BooleanConditions are used by conditional formatting,
+                  # data validation, and the criteria in filters.
+                "type": "A String", # The type of condition.
+                "values": [ # The values of the condition. The number of supported values depends
+                    # on the condition type.  Some support zero values,
+                    # others one or two values,
+                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                  { # The value of the condition.
+                    "relativeDate": "A String", # A relative date (based on the current date).
+                        # Valid only if the type is
+                        # DATE_BEFORE,
+                        # DATE_AFTER,
+                        # DATE_ON_OR_BEFORE or
+                        # DATE_ON_OR_AFTER.
+                        #
+                        # Relative dates are not supported in data validation.
+                        # They are supported only in conditional formatting and
+                        # conditional filters.
+                    "userEnteredValue": "A String", # A value the condition is based on.
+                        # The value will be parsed as if the user typed into a cell.
+                        # Formulas are supported (and must begin with an `=`).
+                  },
+                ],
+              },
+            },
+          },
+        },
+        "charts": [ # The specifications of every chart on this sheet.
+          { # A chart embedded in a sheet.
+            "chartId": 42, # The ID of the chart.
+            "position": { # The position of an embedded object such as a chart. # The position of the chart.
+              "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
+                  # is chosen for you. Used only when writing.
+              "sheetId": 42, # The sheet this is on. Set only if the embedded object
+                  # is on its own sheet. Must be non-negative.
+              "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
+                "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
+                    # All indexes are zero-based.
+                  "rowIndex": 42, # The row index of the coordinate.
+                  "columnIndex": 42, # The column index of the coordinate.
+                  "sheetId": 42, # The sheet this coordinate is on.
+                },
+                "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
+                    # from the anchor cell.
+                "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
+                "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
+                    # from the anchor cell.
+                "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
+              },
+            },
+            "spec": { # The specifications of a chart. # The specification of the chart.
+              "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
+              "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
+                "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
+                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                    "sources": [ # The ranges of data for a series or domain.
+                        # Exactly one dimension must have a length of 1,
+                        # and all sources in the list must have the same dimension
+                        # with length 1.
+                        # The domain (if it exists) & all series must have the same number
+                        # of source ranges. If using more than one source range, then the source
+                        # range at a given offset must be contiguous across the domain and series.
+                        #
+                        # For example, these are valid configurations:
+                        #
+                        #     domain sources: A1:A5
+                        #     series1 sources: B1:B5
+                        #     series2 sources: D6:D10
+                        #
+                        #     domain sources: A1:A5, C10:C12
+                        #     series1 sources: B1:B5, D10:D12
+                        #     series2 sources: C1:C5, E10:E12
+                      { # A range on a sheet.
+                          # All indexes are zero-based.
+                          # Indexes are half open, e.g the start index is inclusive
+                          # and the end index is exclusive -- [start_index, end_index).
+                          # Missing indexes indicate the range is unbounded on that side.
+                          #
+                          # For example, if `"Sheet1"` is sheet ID 0, then:
+                          #
+                          #   `Sheet1!A1:A1 == sheet_id: 0,
+                          #                   start_row_index: 0, end_row_index: 1,
+                          #                   start_column_index: 0, end_column_index: 1`
+                          #
+                          #   `Sheet1!A3:B4 == sheet_id: 0,
+                          #                   start_row_index: 2, end_row_index: 4,
+                          #                   start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A:B == sheet_id: 0,
+                          #                 start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A5:B == sheet_id: 0,
+                          #                  start_row_index: 4,
+                          #                  start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1 == sheet_id:0`
+                          #
+                          # The start index must always be less than or equal to the end index.
+                          # If the start index equals the end index, then the range is empty.
+                          # Empty ranges are typically not meaningful and are usually rendered in the
+                          # UI as `#REF!`.
+                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                        "sheetId": 42, # The sheet this range is on.
+                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                      },
+                    ],
+                  },
+                },
+                "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
+                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                    "sources": [ # The ranges of data for a series or domain.
+                        # Exactly one dimension must have a length of 1,
+                        # and all sources in the list must have the same dimension
+                        # with length 1.
+                        # The domain (if it exists) & all series must have the same number
+                        # of source ranges. If using more than one source range, then the source
+                        # range at a given offset must be contiguous across the domain and series.
+                        #
+                        # For example, these are valid configurations:
+                        #
+                        #     domain sources: A1:A5
+                        #     series1 sources: B1:B5
+                        #     series2 sources: D6:D10
+                        #
+                        #     domain sources: A1:A5, C10:C12
+                        #     series1 sources: B1:B5, D10:D12
+                        #     series2 sources: C1:C5, E10:E12
+                      { # A range on a sheet.
+                          # All indexes are zero-based.
+                          # Indexes are half open, e.g the start index is inclusive
+                          # and the end index is exclusive -- [start_index, end_index).
+                          # Missing indexes indicate the range is unbounded on that side.
+                          #
+                          # For example, if `"Sheet1"` is sheet ID 0, then:
+                          #
+                          #   `Sheet1!A1:A1 == sheet_id: 0,
+                          #                   start_row_index: 0, end_row_index: 1,
+                          #                   start_column_index: 0, end_column_index: 1`
+                          #
+                          #   `Sheet1!A3:B4 == sheet_id: 0,
+                          #                   start_row_index: 2, end_row_index: 4,
+                          #                   start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A:B == sheet_id: 0,
+                          #                 start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A5:B == sheet_id: 0,
+                          #                  start_row_index: 4,
+                          #                  start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1 == sheet_id:0`
+                          #
+                          # The start index must always be less than or equal to the end index.
+                          # If the start index equals the end index, then the range is empty.
+                          # Empty ranges are typically not meaningful and are usually rendered in the
+                          # UI as `#REF!`.
+                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                        "sheetId": 42, # The sheet this range is on.
+                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                      },
+                    ],
+                  },
+                },
+                "threeDimensional": True or False, # True if the pie is three dimensional.
+                "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
+                "pieHole": 3.14, # The size of the hole in the pie chart.
+              },
+              "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
+                  # See BasicChartType for the list of all
+                  # charts this supports.
+                  # of charts this supports.
+                "headerCount": 42, # The number of rows or columns in the data that are "headers".
+                    # If not set, Google Sheets will guess how many rows are headers based
+                    # on the data.
+                    #
+                    # (Note that BasicChartAxis.title may override the axis title
+                    #  inferred from the header values.)
+                "series": [ # The data this chart is visualizing.
+                  { # A single series of data in a chart.
+                      # For example, if charting stock prices over time, multiple series may exist,
+                      # one for the "Open Price", "High Price", "Low Price" and "Close Price".
+                    "series": { # The data included in a domain or series. # The data being visualized in this chart series.
+                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                        "sources": [ # The ranges of data for a series or domain.
+                            # Exactly one dimension must have a length of 1,
+                            # and all sources in the list must have the same dimension
+                            # with length 1.
+                            # The domain (if it exists) & all series must have the same number
+                            # of source ranges. If using more than one source range, then the source
+                            # range at a given offset must be contiguous across the domain and series.
+                            #
+                            # For example, these are valid configurations:
+                            #
+                            #     domain sources: A1:A5
+                            #     series1 sources: B1:B5
+                            #     series2 sources: D6:D10
+                            #
+                            #     domain sources: A1:A5, C10:C12
+                            #     series1 sources: B1:B5, D10:D12
+                            #     series2 sources: C1:C5, E10:E12
+                          { # A range on a sheet.
+                              # All indexes are zero-based.
+                              # Indexes are half open, e.g the start index is inclusive
+                              # and the end index is exclusive -- [start_index, end_index).
+                              # Missing indexes indicate the range is unbounded on that side.
+                              #
+                              # For example, if `"Sheet1"` is sheet ID 0, then:
+                              #
+                              #   `Sheet1!A1:A1 == sheet_id: 0,
+                              #                   start_row_index: 0, end_row_index: 1,
+                              #                   start_column_index: 0, end_column_index: 1`
+                              #
+                              #   `Sheet1!A3:B4 == sheet_id: 0,
+                              #                   start_row_index: 2, end_row_index: 4,
+                              #                   start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A:B == sheet_id: 0,
+                              #                 start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A5:B == sheet_id: 0,
+                              #                  start_row_index: 4,
+                              #                  start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1 == sheet_id:0`
+                              #
+                              # The start index must always be less than or equal to the end index.
+                              # If the start index equals the end index, then the range is empty.
+                              # Empty ranges are typically not meaningful and are usually rendered in the
+                              # UI as `#REF!`.
+                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                            "sheetId": 42, # The sheet this range is on.
+                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                          },
+                        ],
+                      },
+                    },
+                    "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
+                        # For example, if charting stocks over time, the "Volume" series
+                        # may want to be pinned to the right with the prices pinned to the left,
+                        # because the scale of trading volume is different than the scale of
+                        # prices.
+                        # It is an error to specify an axis that isn't a valid minor axis
+                        # for the chart's type.
+                    "type": "A String", # The type of this series. Valid only if the
+                        # chartType is
+                        # COMBO.
+                        # Different types will change the way the series is visualized.
+                        # Only LINE, AREA,
+                        # and COLUMN are supported.
+                  },
+                ],
+                "legendPosition": "A String", # The position of the chart legend.
+                "domains": [ # The domain of data this is charting.
+                    # Only a single domain is currently supported.
+                  { # The domain of a chart.
+                      # For example, if charting stock prices over time, this would be the date.
+                    "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
+                        # this is the data representing the dates.
+                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                        "sources": [ # The ranges of data for a series or domain.
+                            # Exactly one dimension must have a length of 1,
+                            # and all sources in the list must have the same dimension
+                            # with length 1.
+                            # The domain (if it exists) & all series must have the same number
+                            # of source ranges. If using more than one source range, then the source
+                            # range at a given offset must be contiguous across the domain and series.
+                            #
+                            # For example, these are valid configurations:
+                            #
+                            #     domain sources: A1:A5
+                            #     series1 sources: B1:B5
+                            #     series2 sources: D6:D10
+                            #
+                            #     domain sources: A1:A5, C10:C12
+                            #     series1 sources: B1:B5, D10:D12
+                            #     series2 sources: C1:C5, E10:E12
+                          { # A range on a sheet.
+                              # All indexes are zero-based.
+                              # Indexes are half open, e.g the start index is inclusive
+                              # and the end index is exclusive -- [start_index, end_index).
+                              # Missing indexes indicate the range is unbounded on that side.
+                              #
+                              # For example, if `"Sheet1"` is sheet ID 0, then:
+                              #
+                              #   `Sheet1!A1:A1 == sheet_id: 0,
+                              #                   start_row_index: 0, end_row_index: 1,
+                              #                   start_column_index: 0, end_column_index: 1`
+                              #
+                              #   `Sheet1!A3:B4 == sheet_id: 0,
+                              #                   start_row_index: 2, end_row_index: 4,
+                              #                   start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A:B == sheet_id: 0,
+                              #                 start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A5:B == sheet_id: 0,
+                              #                  start_row_index: 4,
+                              #                  start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1 == sheet_id:0`
+                              #
+                              # The start index must always be less than or equal to the end index.
+                              # If the start index equals the end index, then the range is empty.
+                              # Empty ranges are typically not meaningful and are usually rendered in the
+                              # UI as `#REF!`.
+                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                            "sheetId": 42, # The sheet this range is on.
+                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                          },
+                        ],
+                      },
+                    },
+                  },
+                ],
+                "chartType": "A String", # The type of the chart.
+                "axis": [ # The axis on the chart.
+                  { # An axis of the chart.
+                      # A chart may not have more than one axis per
+                      # axis position.
+                    "position": "A String", # The position of this axis.
+                    "format": { # The format of a run of text in a cell. # The format of the title.
+                        # Only valid if the axis is not associated with the domain.
+                        # Absent values indicate that the field isn't specified.
+                      "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                          # for simplicity of conversion to/from color representations in various
+                          # languages over compactness; for example, the fields of this representation
+                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                          # method in iOS; and, with just a little work, it can be easily formatted into
+                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                          #
+                          # Example (Java):
+                          #
+                          #      import com.google.type.Color;
+                          #
+                          #      // ...
+                          #      public static java.awt.Color fromProto(Color protocolor) {
+                          #        float alpha = protocolor.hasAlpha()
+                          #            ? protocolor.getAlpha().getValue()
+                          #            : 1.0;
+                          #
+                          #        return new java.awt.Color(
+                          #            protocolor.getRed(),
+                          #            protocolor.getGreen(),
+                          #            protocolor.getBlue(),
+                          #            alpha);
+                          #      }
+                          #
+                          #      public static Color toProto(java.awt.Color color) {
+                          #        float red = (float) color.getRed();
+                          #        float green = (float) color.getGreen();
+                          #        float blue = (float) color.getBlue();
+                          #        float denominator = 255.0;
+                          #        Color.Builder resultBuilder =
+                          #            Color
+                          #                .newBuilder()
+                          #                .setRed(red / denominator)
+                          #                .setGreen(green / denominator)
+                          #                .setBlue(blue / denominator);
+                          #        int alpha = color.getAlpha();
+                          #        if (alpha != 255) {
+                          #          result.setAlpha(
+                          #              FloatValue
+                          #                  .newBuilder()
+                          #                  .setValue(((float) alpha) / denominator)
+                          #                  .build());
+                          #        }
+                          #        return resultBuilder.build();
+                          #      }
+                          #      // ...
+                          #
+                          # Example (iOS / Obj-C):
+                          #
+                          #      // ...
+                          #      static UIColor* fromProto(Color* protocolor) {
+                          #         float red = [protocolor red];
+                          #         float green = [protocolor green];
+                          #         float blue = [protocolor blue];
+                          #         FloatValue* alpha_wrapper = [protocolor alpha];
+                          #         float alpha = 1.0;
+                          #         if (alpha_wrapper != nil) {
+                          #           alpha = [alpha_wrapper value];
+                          #         }
+                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                          #      }
+                          #
+                          #      static Color* toProto(UIColor* color) {
+                          #          CGFloat red, green, blue, alpha;
+                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                          #            return nil;
+                          #          }
+                          #          Color* result = [Color alloc] init];
+                          #          [result setRed:red];
+                          #          [result setGreen:green];
+                          #          [result setBlue:blue];
+                          #          if (alpha <= 0.9999) {
+                          #            [result setAlpha:floatWrapperWithValue(alpha)];
+                          #          }
+                          #          [result autorelease];
+                          #          return result;
+                          #     }
+                          #     // ...
+                          #
+                          #  Example (JavaScript):
+                          #
+                          #     // ...
+                          #
+                          #     var protoToCssColor = function(rgb_color) {
+                          #        var redFrac = rgb_color.red || 0.0;
+                          #        var greenFrac = rgb_color.green || 0.0;
+                          #        var blueFrac = rgb_color.blue || 0.0;
+                          #        var red = Math.floor(redFrac * 255);
+                          #        var green = Math.floor(greenFrac * 255);
+                          #        var blue = Math.floor(blueFrac * 255);
+                          #
+                          #        if (!('alpha' in rgb_color)) {
+                          #           return rgbToCssColor_(red, green, blue);
+                          #        }
+                          #
+                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                          #        var rgbParams = [red, green, blue].join(',');
+                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                          #     };
+                          #
+                          #     var rgbToCssColor_ = function(red, green, blue) {
+                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                          #       var hexString = rgbNumber.toString(16);
+                          #       var missingZeros = 6 - hexString.length;
+                          #       var resultBuilder = ['#'];
+                          #       for (var i = 0; i < missingZeros; i++) {
+                          #          resultBuilder.push('0');
+                          #       }
+                          #       resultBuilder.push(hexString);
+                          #       return resultBuilder.join('');
+                          #     };
+                          #
+                          #     // ...
+                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                            # the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color. This
+                            # uses a wrapper message rather than a simple float scalar so that it is
+                            # possible to distinguish between a default value and the value being unset.
+                            # If omitted, this color object is to be rendered as a solid color
+                            # (as if the alpha value had been explicitly given with a value of 1.0).
+                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                      },
+                      "bold": True or False, # True if the text is bold.
+                      "strikethrough": True or False, # True if the text has a strikethrough.
+                      "fontFamily": "A String", # The font family.
+                      "fontSize": 42, # The size of the font.
+                      "italic": True or False, # True if the text is italicized.
+                      "underline": True or False, # True if the text is underlined.
+                    },
+                    "title": "A String", # The title of this axis. If set, this overrides any title inferred
+                        # from headers of the data.
+                  },
+                ],
+              },
+              "title": "A String", # The title of the chart.
             },
           },
-          "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-        },
-        "title": "A String", # The title of the spreadsheet.
-      },
-      "sheets": [ # The sheets that are part of a spreadsheet.
-        { # A sheet in a spreadsheet.
-          "conditionalFormats": [ # The conditional format rules in this sheet.
-            { # A rule describing a conditional format.
-              "ranges": [ # The ranges that will be formatted if the condition is true.
-                  # All the ranges must be on the same grid.
-                { # A range on a sheet.
-                    # All indexes are zero-based.
-                    # Indexes are half open, e.g the start index is inclusive
-                    # and the end index is exclusive -- [start_index, end_index).
-                    # Missing indexes indicate the range is unbounded on that side.
-                    #
-                    # For example, if `"Sheet1"` is sheet ID 0, then:
-                    #
-                    #   `Sheet1!A1:A1 == sheet_id: 0,
-                    #                   start_row_index: 0, end_row_index: 1,
-                    #                   start_column_index: 0, end_column_index: 1`
-                    #
-                    #   `Sheet1!A3:B4 == sheet_id: 0,
-                    #                   start_row_index: 2, end_row_index: 4,
-                    #                   start_column_index: 0, end_column_index: 2`
-                    #
-                    #   `Sheet1!A:B == sheet_id: 0,
-                    #                 start_column_index: 0, end_column_index: 2`
-                    #
-                    #   `Sheet1!A5:B == sheet_id: 0,
-                    #                  start_row_index: 4,
-                    #                  start_column_index: 0, end_column_index: 2`
-                    #
-                    #   `Sheet1 == sheet_id:0`
-                    #
-                    # The start index must always be less than or equal to the end index.
-                    # If the start index equals the end index, then the range is empty.
-                    # Empty ranges are typically not meaningful and are usually rendered in the
-                    # UI as `#REF!`.
-                  "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                  "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                  "sheetId": 42, # The sheet this range is on.
-                  "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                  "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                },
-              ],
-              "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
-                "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
-                    # the format will be applied.
+        ],
+        "filterViews": [ # The filter views in this sheet.
+          { # A filter view.
+            "title": "A String", # The name of the filter view.
+            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "filterViewId": 42, # The ID of the filter view.
+            "range": { # A range on a sheet. # The range this filter view covers.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "sortSpecs": [ # The sort order per column. Later specifications are used when values
+                # are equal in the earlier specifications.
+              { # A sort order associated with a specific column or row.
+                "sortOrder": "A String", # The order data should be sorted.
+                "dimensionIndex": 42, # The dimension the sort should be applied to.
+              },
+            ],
+            "criteria": { # The criteria for showing/hiding values per column.
+                # The map's key is the column index, and the value is the criteria for
+                # that column.
+              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+                "hiddenValues": [ # Values that should be hidden.
+                  "A String",
+                ],
+                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                    # (This does not override hiddenValues -- if a value is listed there,
+                    #  it will still be hidden.)
                     # BooleanConditions are used by conditional formatting,
                     # data validation, and the criteria in filters.
                   "type": "A String", # The type of condition.
@@ -30045,444 +38688,1277 @@ <h3>Method Details</h3>
                           # DATE_ON_OR_BEFORE or
                           # DATE_ON_OR_AFTER.
                           #
-                          # Relative dates are not supported in data validation.
-                          # They are supported only in conditional formatting and
-                          # conditional filters.
-                      "userEnteredValue": "A String", # A value the condition is based on.
-                          # The value will be parsed as if the user typed into a cell.
-                          # Formulas are supported (and must begin with an `=`).
+                          # Relative dates are not supported in data validation.
+                          # They are supported only in conditional formatting and
+                          # conditional filters.
+                      "userEnteredValue": "A String", # A value the condition is based on.
+                          # The value will be parsed as if the user typed into a cell.
+                          # Formulas are supported (and must begin with an `=`).
+                    },
+                  ],
+                },
+              },
+            },
+          },
+        ],
+        "protectedRanges": [ # The protected ranges in this sheet.
+          { # A protected range.
+            "unprotectedRanges": [ # The list of unprotected ranges within a protected sheet.
+                # Unprotected ranges are only supported on protected sheets.
+              { # A range on a sheet.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+            ],
+            "requestingUserCanEdit": True or False, # True if the user who requested this protected range can edit the
+                # protected area.
+                # This field is read-only.
+            "description": "A String", # The description of this protected range.
+            "namedRangeId": "A String", # The named range this protected range is backed by, if any.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "editors": { # The editors of a protected range. # The users and groups with edit access to the protected range.
+                # This field is only visible to users with edit access to the protected
+                # range and the document.
+                # Editors are not supported with warning_only protection.
+              "domainUsersCanEdit": True or False, # True if anyone in the document's domain has edit access to the protected
+                  # range.  Domain protection is only supported on documents within a domain.
+              "users": [ # The email addresses of users with edit access to the protected range.
+                "A String",
+              ],
+              "groups": [ # The email addresses of groups with edit access to the protected range.
+                "A String",
+              ],
+            },
+            "protectedRangeId": 42, # The ID of the protected range.
+                # This field is read-only.
+            "warningOnly": True or False, # True if this protected range will show a warning when editing.
+                # Warning-based protection means that every user can edit data in the
+                # protected range, except editing will prompt a warning asking the user
+                # to confirm the edit.
+                #
+                # When writing: if this field is true, then editors is ignored.
+                # Additionally, if this field is changed from true to false and the
+                # `editors` field is not set (nor included in the field mask), then
+                # the editors will be set to all the editors in the document.
+            "range": { # A range on a sheet. # The range that is being protected.
+                # The range may be fully unbounded, in which case this is considered
+                # a protected sheet.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+          },
+        ],
+        "data": [ # Data in the grid, if this is a grid sheet.
+            # The number of GridData objects returned is dependent on the number of
+            # ranges requested on this sheet. For example, if this is representing
+            # `Sheet1`, and the spreadsheet was requested with ranges
+            # `Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will have a
+            # startRow/startColumn of `0`,
+            # while the second one will have `startRow 14` (zero-based row 15),
+            # and `startColumn 3` (zero-based column D).
+          { # Data in the grid, as well as metadata about the dimensions.
+            "startRow": 42, # The first row this GridData refers to, zero-based.
+            "rowMetadata": [ # Metadata about the requested rows in the grid, starting with the row
+                # in start_row.
+              { # Properties about a dimension.
+                "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
+                "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
+                "hiddenByFilter": True or False, # True if this dimension is being filtered.
+                    # This field is read-only.
+              },
+            ],
+            "startColumn": 42, # The first column this GridData refers to, zero-based.
+            "columnMetadata": [ # Metadata about the requested columns in the grid, starting with the column
+                # in start_column.
+              { # Properties about a dimension.
+                "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
+                "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
+                "hiddenByFilter": True or False, # True if this dimension is being filtered.
+                    # This field is read-only.
+              },
+            ],
+            "rowData": [ # The data in the grid, one entry per row,
+                # starting with the row in startRow.
+                # The values in RowData will correspond to columns starting
+                # at start_column.
+              { # Data about each cell in a row.
+                "values": [ # The values in the row, one per column.
+                  { # Data about a specific cell.
+                    "pivotTable": { # A pivot table. # A pivot table anchored at this cell. The size of pivot table itself
+                        # is computed dynamically based on its data, grouping, filters, values,
+                        # etc. Only the top-left cell of the pivot table contains the pivot table
+                        # definition. The other cells will contain the calculated values of the
+                        # results of the pivot in their effective_value fields.
+                      "valueLayout": "A String", # Whether values should be listed horizontally (as columns)
+                          # or vertically (as rows).
+                      "rows": [ # Each row grouping in the pivot table.
+                        { # A single grouping (either row or column) in a pivot table.
+                          "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
+                          "valueMetadata": [ # Metadata about values in the grouping.
+                            { # Metadata about a value in a pivot grouping.
+                              "collapsed": True or False, # True if the data corresponding to the value is collapsed.
+                              "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
+                                  # (Note that formulaValue is not valid,
+                                  #  because the values will be calculated.)
+                                "numberValue": 3.14, # Represents a double value.
+                                    # Note: Dates, Times and DateTimes are represented as doubles in
+                                    # "serial number" format.
+                                "boolValue": True or False, # Represents a boolean value.
+                                "formulaValue": "A String", # Represents a formula.
+                                "stringValue": "A String", # Represents a string value.
+                                    # Leading single quotes are not included. For example, if the user typed
+                                    # `'123` into the UI, this would be represented as a `stringValue` of
+                                    # `"123"`.
+                                "errorValue": { # An error in a cell. # Represents an error.
+                                    # This field is read-only.
+                                  "message": "A String", # A message with more information about the error
+                                      # (in the spreadsheet's locale).
+                                  "type": "A String", # The type of error.
+                                },
+                              },
+                            },
+                          ],
+                          "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
+                              # If not specified, sorting is alphabetical by this group's values.
+                            "buckets": [ # Determines the bucket from which values are chosen to sort.
+                                #
+                                # For example, in a pivot table with one row group & two column groups,
+                                # the row group can list up to two values. The first value corresponds
+                                # to a value within the first column group, and the second value
+                                # corresponds to a value in the second column group.  If no values
+                                # are listed, this would indicate that the row should be sorted according
+                                # to the "Grand Total" over the column groups. If a single value is listed,
+                                # this would correspond to using the "Total" of that bucket.
+                              { # The kinds of value that a cell in a spreadsheet can have.
+                                "numberValue": 3.14, # Represents a double value.
+                                    # Note: Dates, Times and DateTimes are represented as doubles in
+                                    # "serial number" format.
+                                "boolValue": True or False, # Represents a boolean value.
+                                "formulaValue": "A String", # Represents a formula.
+                                "stringValue": "A String", # Represents a string value.
+                                    # Leading single quotes are not included. For example, if the user typed
+                                    # `'123` into the UI, this would be represented as a `stringValue` of
+                                    # `"123"`.
+                                "errorValue": { # An error in a cell. # Represents an error.
+                                    # This field is read-only.
+                                  "message": "A String", # A message with more information about the error
+                                      # (in the spreadsheet's locale).
+                                  "type": "A String", # The type of error.
+                                },
+                              },
+                            ],
+                            "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
+                                # grouping should be sorted by.
+                          },
+                          "sortOrder": "A String", # The order the values in this group should be sorted.
+                          "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                              #
+                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                              # means this group refers to column `C`, whereas the offset `1` would refer
+                              # to column `D`.
+                        },
+                      ],
+                      "source": { # A range on a sheet. # The range the pivot table is reading data from.
+                          # All indexes are zero-based.
+                          # Indexes are half open, e.g the start index is inclusive
+                          # and the end index is exclusive -- [start_index, end_index).
+                          # Missing indexes indicate the range is unbounded on that side.
+                          #
+                          # For example, if `"Sheet1"` is sheet ID 0, then:
+                          #
+                          #   `Sheet1!A1:A1 == sheet_id: 0,
+                          #                   start_row_index: 0, end_row_index: 1,
+                          #                   start_column_index: 0, end_column_index: 1`
+                          #
+                          #   `Sheet1!A3:B4 == sheet_id: 0,
+                          #                   start_row_index: 2, end_row_index: 4,
+                          #                   start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A:B == sheet_id: 0,
+                          #                 start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A5:B == sheet_id: 0,
+                          #                  start_row_index: 4,
+                          #                  start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1 == sheet_id:0`
+                          #
+                          # The start index must always be less than or equal to the end index.
+                          # If the start index equals the end index, then the range is empty.
+                          # Empty ranges are typically not meaningful and are usually rendered in the
+                          # UI as `#REF!`.
+                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                        "sheetId": 42, # The sheet this range is on.
+                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                      },
+                      "values": [ # A list of values to include in the pivot table.
+                        { # The definition of how a value in a pivot table should be calculated.
+                          "formula": "A String", # A custom formula to calculate the value.  The formula must start
+                              # with an `=` character.
+                          "summarizeFunction": "A String", # A function to summarize the value.
+                              # If formula is set, the only supported values are
+                              # SUM and
+                              # CUSTOM.
+                              # If sourceColumnOffset is set, then `CUSTOM`
+                              # is not supported.
+                          "sourceColumnOffset": 42, # The column offset of the source range that this value reads from.
+                              #
+                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                              # means this value refers to column `C`, whereas the offset `1` would
+                              # refer to column `D`.
+                          "name": "A String", # A name to use for the value. This is only used if formula was set.
+                              # Otherwise, the column name is used.
+                        },
+                      ],
+                      "criteria": { # An optional mapping of filters per source column offset.
+                          #
+                          # The filters will be applied before aggregating data into the pivot table.
+                          # The map's key is the column offset of the source range that you want to
+                          # filter, and the value is the criteria for that column.
+                          #
+                          # For example, if the source was `C10:E15`, a key of `0` will have the filter
+                          # for column `C`, whereas the key `1` is for column `D`.
+                        "a_key": { # Criteria for showing/hiding rows in a pivot table.
+                          "visibleValues": [ # Values that should be included.  Values not listed here are excluded.
+                            "A String",
+                          ],
+                        },
+                      },
+                      "columns": [ # Each column grouping in the pivot table.
+                        { # A single grouping (either row or column) in a pivot table.
+                          "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
+                          "valueMetadata": [ # Metadata about values in the grouping.
+                            { # Metadata about a value in a pivot grouping.
+                              "collapsed": True or False, # True if the data corresponding to the value is collapsed.
+                              "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
+                                  # (Note that formulaValue is not valid,
+                                  #  because the values will be calculated.)
+                                "numberValue": 3.14, # Represents a double value.
+                                    # Note: Dates, Times and DateTimes are represented as doubles in
+                                    # "serial number" format.
+                                "boolValue": True or False, # Represents a boolean value.
+                                "formulaValue": "A String", # Represents a formula.
+                                "stringValue": "A String", # Represents a string value.
+                                    # Leading single quotes are not included. For example, if the user typed
+                                    # `'123` into the UI, this would be represented as a `stringValue` of
+                                    # `"123"`.
+                                "errorValue": { # An error in a cell. # Represents an error.
+                                    # This field is read-only.
+                                  "message": "A String", # A message with more information about the error
+                                      # (in the spreadsheet's locale).
+                                  "type": "A String", # The type of error.
+                                },
+                              },
+                            },
+                          ],
+                          "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
+                              # If not specified, sorting is alphabetical by this group's values.
+                            "buckets": [ # Determines the bucket from which values are chosen to sort.
+                                #
+                                # For example, in a pivot table with one row group & two column groups,
+                                # the row group can list up to two values. The first value corresponds
+                                # to a value within the first column group, and the second value
+                                # corresponds to a value in the second column group.  If no values
+                                # are listed, this would indicate that the row should be sorted according
+                                # to the "Grand Total" over the column groups. If a single value is listed,
+                                # this would correspond to using the "Total" of that bucket.
+                              { # The kinds of value that a cell in a spreadsheet can have.
+                                "numberValue": 3.14, # Represents a double value.
+                                    # Note: Dates, Times and DateTimes are represented as doubles in
+                                    # "serial number" format.
+                                "boolValue": True or False, # Represents a boolean value.
+                                "formulaValue": "A String", # Represents a formula.
+                                "stringValue": "A String", # Represents a string value.
+                                    # Leading single quotes are not included. For example, if the user typed
+                                    # `'123` into the UI, this would be represented as a `stringValue` of
+                                    # `"123"`.
+                                "errorValue": { # An error in a cell. # Represents an error.
+                                    # This field is read-only.
+                                  "message": "A String", # A message with more information about the error
+                                      # (in the spreadsheet's locale).
+                                  "type": "A String", # The type of error.
+                                },
+                              },
+                            ],
+                            "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
+                                # grouping should be sorted by.
+                          },
+                          "sortOrder": "A String", # The order the values in this group should be sorted.
+                          "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                              #
+                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                              # means this group refers to column `C`, whereas the offset `1` would refer
+                              # to column `D`.
+                        },
+                      ],
+                    },
+                    "hyperlink": "A String", # A hyperlink this cell points to, if any.
+                        # This field is read-only.  (To set it, use a `=HYPERLINK` formula.)
+                    "effectiveValue": { # The kinds of value that a cell in a spreadsheet can have. # The effective value of the cell. For cells with formulas, this will be
+                        # the calculated value.  For cells with literals, this will be
+                        # the same as the user_entered_value.
+                        # This field is read-only.
+                      "numberValue": 3.14, # Represents a double value.
+                          # Note: Dates, Times and DateTimes are represented as doubles in
+                          # "serial number" format.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "formulaValue": "A String", # Represents a formula.
+                      "stringValue": "A String", # Represents a string value.
+                          # Leading single quotes are not included. For example, if the user typed
+                          # `'123` into the UI, this would be represented as a `stringValue` of
+                          # `"123"`.
+                      "errorValue": { # An error in a cell. # Represents an error.
+                          # This field is read-only.
+                        "message": "A String", # A message with more information about the error
+                            # (in the spreadsheet's locale).
+                        "type": "A String", # The type of error.
+                      },
+                    },
+                    "formattedValue": "A String", # The formatted value of the cell.
+                        # This is the value as it's shown to the user.
+                        # This field is read-only.
+                    "userEnteredValue": { # The kinds of value that a cell in a spreadsheet can have. # The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`
+                        # Note: Dates, Times and DateTimes are represented as doubles in
+                        # serial number format.
+                      "numberValue": 3.14, # Represents a double value.
+                          # Note: Dates, Times and DateTimes are represented as doubles in
+                          # "serial number" format.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "formulaValue": "A String", # Represents a formula.
+                      "stringValue": "A String", # Represents a string value.
+                          # Leading single quotes are not included. For example, if the user typed
+                          # `'123` into the UI, this would be represented as a `stringValue` of
+                          # `"123"`.
+                      "errorValue": { # An error in a cell. # Represents an error.
+                          # This field is read-only.
+                        "message": "A String", # A message with more information about the error
+                            # (in the spreadsheet's locale).
+                        "type": "A String", # The type of error.
+                      },
+                    },
+                    "note": "A String", # Any note on the cell.
+                    "effectiveFormat": { # The format of a cell. # The effective format being used by the cell.
+                        # This includes the results of applying any conditional formatting and,
+                        # if the cell contains a formula, the computed number format.
+                        # If the effective format is the default format, effective format will
+                        # not be written.
+                        # This field is read-only.
+                      "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                        "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                            # the user's locale will be used if necessary for the given type.
+                            # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                            # information about the supported patterns.
+                        "type": "A String", # The type of the number format.
+                            # When writing, this field must be set.
+                      },
+                      "textDirection": "A String", # The direction of the text in the cell.
+                      "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                          # When updating padding, every field must be specified.
+                        "top": 42, # The top padding of the cell.
+                        "right": 42, # The right padding of the cell.
+                        "bottom": 42, # The bottom padding of the cell.
+                        "left": 42, # The left padding of the cell.
+                      },
+                      "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                      "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                          # for simplicity of conversion to/from color representations in various
+                          # languages over compactness; for example, the fields of this representation
+                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                          # method in iOS; and, with just a little work, it can be easily formatted into
+                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                          #
+                          # Example (Java):
+                          #
+                          #      import com.google.type.Color;
+                          #
+                          #      // ...
+                          #      public static java.awt.Color fromProto(Color protocolor) {
+                          #        float alpha = protocolor.hasAlpha()
+                          #            ? protocolor.getAlpha().getValue()
+                          #            : 1.0;
+                          #
+                          #        return new java.awt.Color(
+                          #            protocolor.getRed(),
+                          #            protocolor.getGreen(),
+                          #            protocolor.getBlue(),
+                          #            alpha);
+                          #      }
+                          #
+                          #      public static Color toProto(java.awt.Color color) {
+                          #        float red = (float) color.getRed();
+                          #        float green = (float) color.getGreen();
+                          #        float blue = (float) color.getBlue();
+                          #        float denominator = 255.0;
+                          #        Color.Builder resultBuilder =
+                          #            Color
+                          #                .newBuilder()
+                          #                .setRed(red / denominator)
+                          #                .setGreen(green / denominator)
+                          #                .setBlue(blue / denominator);
+                          #        int alpha = color.getAlpha();
+                          #        if (alpha != 255) {
+                          #          result.setAlpha(
+                          #              FloatValue
+                          #                  .newBuilder()
+                          #                  .setValue(((float) alpha) / denominator)
+                          #                  .build());
+                          #        }
+                          #        return resultBuilder.build();
+                          #      }
+                          #      // ...
+                          #
+                          # Example (iOS / Obj-C):
+                          #
+                          #      // ...
+                          #      static UIColor* fromProto(Color* protocolor) {
+                          #         float red = [protocolor red];
+                          #         float green = [protocolor green];
+                          #         float blue = [protocolor blue];
+                          #         FloatValue* alpha_wrapper = [protocolor alpha];
+                          #         float alpha = 1.0;
+                          #         if (alpha_wrapper != nil) {
+                          #           alpha = [alpha_wrapper value];
+                          #         }
+                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                          #      }
+                          #
+                          #      static Color* toProto(UIColor* color) {
+                          #          CGFloat red, green, blue, alpha;
+                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                          #            return nil;
+                          #          }
+                          #          Color* result = [Color alloc] init];
+                          #          [result setRed:red];
+                          #          [result setGreen:green];
+                          #          [result setBlue:blue];
+                          #          if (alpha <= 0.9999) {
+                          #            [result setAlpha:floatWrapperWithValue(alpha)];
+                          #          }
+                          #          [result autorelease];
+                          #          return result;
+                          #     }
+                          #     // ...
+                          #
+                          #  Example (JavaScript):
+                          #
+                          #     // ...
+                          #
+                          #     var protoToCssColor = function(rgb_color) {
+                          #        var redFrac = rgb_color.red || 0.0;
+                          #        var greenFrac = rgb_color.green || 0.0;
+                          #        var blueFrac = rgb_color.blue || 0.0;
+                          #        var red = Math.floor(redFrac * 255);
+                          #        var green = Math.floor(greenFrac * 255);
+                          #        var blue = Math.floor(blueFrac * 255);
+                          #
+                          #        if (!('alpha' in rgb_color)) {
+                          #           return rgbToCssColor_(red, green, blue);
+                          #        }
+                          #
+                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                          #        var rgbParams = [red, green, blue].join(',');
+                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                          #     };
+                          #
+                          #     var rgbToCssColor_ = function(red, green, blue) {
+                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                          #       var hexString = rgbNumber.toString(16);
+                          #       var missingZeros = 6 - hexString.length;
+                          #       var resultBuilder = ['#'];
+                          #       for (var i = 0; i < missingZeros; i++) {
+                          #          resultBuilder.push('0');
+                          #       }
+                          #       resultBuilder.push(hexString);
+                          #       return resultBuilder.join('');
+                          #     };
+                          #
+                          #     // ...
+                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                            # the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color. This
+                            # uses a wrapper message rather than a simple float scalar so that it is
+                            # possible to distinguish between a default value and the value being unset.
+                            # If omitted, this color object is to be rendered as a solid color
+                            # (as if the alpha value had been explicitly given with a value of 1.0).
+                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                      },
+                      "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                      "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                          # Absent values indicate that the field isn't specified.
+                        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "bold": True or False, # True if the text is bold.
+                        "strikethrough": True or False, # True if the text has a strikethrough.
+                        "fontFamily": "A String", # The font family.
+                        "fontSize": 42, # The size of the font.
+                        "italic": True or False, # True if the text is italicized.
+                        "underline": True or False, # True if the text is underlined.
+                      },
+                      "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                      "borders": { # The borders of the cell. # The borders of the cell.
+                        "top": { # A border along a cell. # The top border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "right": { # A border along a cell. # The right border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "bottom": { # A border along a cell. # The bottom border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "left": { # A border along a cell. # The left border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                      },
+                      "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
                     },
-                  ],
-                },
-                "format": { # The format of a cell. # The format to apply.
-                    # Conditional formatting can only apply a subset of formatting:
-                    # bold, italic,
-                    # strikethrough,
-                    # foreground color &
-                    # background color.
-                  "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                    "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                        # the user's locale will be used if necessary for the given type.
-                        # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                        # information about the supported patterns.
-                    "type": "A String", # The type of the number format.
-                        # When writing, this field must be set.
-                  },
-                  "textDirection": "A String", # The direction of the text in the cell.
-                  "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                      # When updating padding, every field must be specified.
-                    "top": 42, # The top padding of the cell.
-                    "right": 42, # The right padding of the cell.
-                    "bottom": 42, # The bottom padding of the cell.
-                    "left": 42, # The left padding of the cell.
-                  },
-                  "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                  "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                      # for simplicity of conversion to/from color representations in various
-                      # languages over compactness; for example, the fields of this representation
-                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                      # method in iOS; and, with just a little work, it can be easily formatted into
-                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                      #
-                      # Example (Java):
-                      #
-                      #      import com.google.type.Color;
-                      #
-                      #      // ...
-                      #      public static java.awt.Color fromProto(Color protocolor) {
-                      #        float alpha = protocolor.hasAlpha()
-                      #            ? protocolor.getAlpha().getValue()
-                      #            : 1.0;
-                      #
-                      #        return new java.awt.Color(
-                      #            protocolor.getRed(),
-                      #            protocolor.getGreen(),
-                      #            protocolor.getBlue(),
-                      #            alpha);
-                      #      }
-                      #
-                      #      public static Color toProto(java.awt.Color color) {
-                      #        float red = (float) color.getRed();
-                      #        float green = (float) color.getGreen();
-                      #        float blue = (float) color.getBlue();
-                      #        float denominator = 255.0;
-                      #        Color.Builder resultBuilder =
-                      #            Color
-                      #                .newBuilder()
-                      #                .setRed(red / denominator)
-                      #                .setGreen(green / denominator)
-                      #                .setBlue(blue / denominator);
-                      #        int alpha = color.getAlpha();
-                      #        if (alpha != 255) {
-                      #          result.setAlpha(
-                      #              FloatValue
-                      #                  .newBuilder()
-                      #                  .setValue(((float) alpha) / denominator)
-                      #                  .build());
-                      #        }
-                      #        return resultBuilder.build();
-                      #      }
-                      #      // ...
-                      #
-                      # Example (iOS / Obj-C):
-                      #
-                      #      // ...
-                      #      static UIColor* fromProto(Color* protocolor) {
-                      #         float red = [protocolor red];
-                      #         float green = [protocolor green];
-                      #         float blue = [protocolor blue];
-                      #         FloatValue* alpha_wrapper = [protocolor alpha];
-                      #         float alpha = 1.0;
-                      #         if (alpha_wrapper != nil) {
-                      #           alpha = [alpha_wrapper value];
-                      #         }
-                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                      #      }
-                      #
-                      #      static Color* toProto(UIColor* color) {
-                      #          CGFloat red, green, blue, alpha;
-                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                      #            return nil;
-                      #          }
-                      #          Color* result = [Color alloc] init];
-                      #          [result setRed:red];
-                      #          [result setGreen:green];
-                      #          [result setBlue:blue];
-                      #          if (alpha <= 0.9999) {
-                      #            [result setAlpha:floatWrapperWithValue(alpha)];
-                      #          }
-                      #          [result autorelease];
-                      #          return result;
-                      #     }
-                      #     // ...
-                      #
-                      #  Example (JavaScript):
-                      #
-                      #     // ...
-                      #
-                      #     var protoToCssColor = function(rgb_color) {
-                      #        var redFrac = rgb_color.red || 0.0;
-                      #        var greenFrac = rgb_color.green || 0.0;
-                      #        var blueFrac = rgb_color.blue || 0.0;
-                      #        var red = Math.floor(redFrac * 255);
-                      #        var green = Math.floor(greenFrac * 255);
-                      #        var blue = Math.floor(blueFrac * 255);
-                      #
-                      #        if (!('alpha' in rgb_color)) {
-                      #           return rgbToCssColor_(red, green, blue);
-                      #        }
-                      #
-                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                      #        var rgbParams = [red, green, blue].join(',');
-                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                      #     };
-                      #
-                      #     var rgbToCssColor_ = function(red, green, blue) {
-                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                      #       var hexString = rgbNumber.toString(16);
-                      #       var missingZeros = 6 - hexString.length;
-                      #       var resultBuilder = ['#'];
-                      #       for (var i = 0; i < missingZeros; i++) {
-                      #          resultBuilder.push('0');
-                      #       }
-                      #       resultBuilder.push(hexString);
-                      #       return resultBuilder.join('');
-                      #     };
-                      #
-                      #     // ...
-                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                        # the final pixel color is defined by the equation:
-                        #
-                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                        #
-                        # This means that a value of 1.0 corresponds to a solid color, whereas
-                        # a value of 0.0 corresponds to a completely transparent color. This
-                        # uses a wrapper message rather than a simple float scalar so that it is
-                        # possible to distinguish between a default value and the value being unset.
-                        # If omitted, this color object is to be rendered as a solid color
-                        # (as if the alpha value had been explicitly given with a value of 1.0).
-                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                  },
-                  "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                  "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                      # Absent values indicate that the field isn't specified.
-                    "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                        # for simplicity of conversion to/from color representations in various
-                        # languages over compactness; for example, the fields of this representation
-                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                        # method in iOS; and, with just a little work, it can be easily formatted into
-                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                        #
-                        # Example (Java):
-                        #
-                        #      import com.google.type.Color;
-                        #
-                        #      // ...
-                        #      public static java.awt.Color fromProto(Color protocolor) {
-                        #        float alpha = protocolor.hasAlpha()
-                        #            ? protocolor.getAlpha().getValue()
-                        #            : 1.0;
-                        #
-                        #        return new java.awt.Color(
-                        #            protocolor.getRed(),
-                        #            protocolor.getGreen(),
-                        #            protocolor.getBlue(),
-                        #            alpha);
-                        #      }
-                        #
-                        #      public static Color toProto(java.awt.Color color) {
-                        #        float red = (float) color.getRed();
-                        #        float green = (float) color.getGreen();
-                        #        float blue = (float) color.getBlue();
-                        #        float denominator = 255.0;
-                        #        Color.Builder resultBuilder =
-                        #            Color
-                        #                .newBuilder()
-                        #                .setRed(red / denominator)
-                        #                .setGreen(green / denominator)
-                        #                .setBlue(blue / denominator);
-                        #        int alpha = color.getAlpha();
-                        #        if (alpha != 255) {
-                        #          result.setAlpha(
-                        #              FloatValue
-                        #                  .newBuilder()
-                        #                  .setValue(((float) alpha) / denominator)
-                        #                  .build());
-                        #        }
-                        #        return resultBuilder.build();
-                        #      }
-                        #      // ...
-                        #
-                        # Example (iOS / Obj-C):
-                        #
-                        #      // ...
-                        #      static UIColor* fromProto(Color* protocolor) {
-                        #         float red = [protocolor red];
-                        #         float green = [protocolor green];
-                        #         float blue = [protocolor blue];
-                        #         FloatValue* alpha_wrapper = [protocolor alpha];
-                        #         float alpha = 1.0;
-                        #         if (alpha_wrapper != nil) {
-                        #           alpha = [alpha_wrapper value];
-                        #         }
-                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                        #      }
-                        #
-                        #      static Color* toProto(UIColor* color) {
-                        #          CGFloat red, green, blue, alpha;
-                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                        #            return nil;
-                        #          }
-                        #          Color* result = [Color alloc] init];
-                        #          [result setRed:red];
-                        #          [result setGreen:green];
-                        #          [result setBlue:blue];
-                        #          if (alpha <= 0.9999) {
-                        #            [result setAlpha:floatWrapperWithValue(alpha)];
-                        #          }
-                        #          [result autorelease];
-                        #          return result;
-                        #     }
-                        #     // ...
-                        #
-                        #  Example (JavaScript):
-                        #
-                        #     // ...
-                        #
-                        #     var protoToCssColor = function(rgb_color) {
-                        #        var redFrac = rgb_color.red || 0.0;
-                        #        var greenFrac = rgb_color.green || 0.0;
-                        #        var blueFrac = rgb_color.blue || 0.0;
-                        #        var red = Math.floor(redFrac * 255);
-                        #        var green = Math.floor(greenFrac * 255);
-                        #        var blue = Math.floor(blueFrac * 255);
-                        #
-                        #        if (!('alpha' in rgb_color)) {
-                        #           return rgbToCssColor_(red, green, blue);
-                        #        }
-                        #
-                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                        #        var rgbParams = [red, green, blue].join(',');
-                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                        #     };
-                        #
-                        #     var rgbToCssColor_ = function(red, green, blue) {
-                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                        #       var hexString = rgbNumber.toString(16);
-                        #       var missingZeros = 6 - hexString.length;
-                        #       var resultBuilder = ['#'];
-                        #       for (var i = 0; i < missingZeros; i++) {
-                        #          resultBuilder.push('0');
-                        #       }
-                        #       resultBuilder.push(hexString);
-                        #       return resultBuilder.join('');
-                        #     };
+                    "userEnteredFormat": { # The format of a cell. # The format the user entered for the cell.
                         #
-                        #     // ...
-                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                          # the final pixel color is defined by the equation:
-                          #
-                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                          #
-                          # This means that a value of 1.0 corresponds to a solid color, whereas
-                          # a value of 0.0 corresponds to a completely transparent color. This
-                          # uses a wrapper message rather than a simple float scalar so that it is
-                          # possible to distinguish between a default value and the value being unset.
-                          # If omitted, this color object is to be rendered as a solid color
-                          # (as if the alpha value had been explicitly given with a value of 1.0).
-                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                    },
-                    "bold": True or False, # True if the text is bold.
-                    "strikethrough": True or False, # True if the text has a strikethrough.
-                    "fontFamily": "A String", # The font family.
-                    "fontSize": 42, # The size of the font.
-                    "italic": True or False, # True if the text is italicized.
-                    "underline": True or False, # True if the text is underlined.
-                  },
-                  "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                  "borders": { # The borders of the cell. # The borders of the cell.
-                    "top": { # A border along a cell. # The top border of the cell.
-                      "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                          # for simplicity of conversion to/from color representations in various
-                          # languages over compactness; for example, the fields of this representation
-                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                          # method in iOS; and, with just a little work, it can be easily formatted into
-                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                          #
-                          # Example (Java):
-                          #
-                          #      import com.google.type.Color;
-                          #
-                          #      // ...
-                          #      public static java.awt.Color fromProto(Color protocolor) {
-                          #        float alpha = protocolor.hasAlpha()
-                          #            ? protocolor.getAlpha().getValue()
-                          #            : 1.0;
-                          #
-                          #        return new java.awt.Color(
-                          #            protocolor.getRed(),
-                          #            protocolor.getGreen(),
-                          #            protocolor.getBlue(),
-                          #            alpha);
-                          #      }
-                          #
-                          #      public static Color toProto(java.awt.Color color) {
-                          #        float red = (float) color.getRed();
-                          #        float green = (float) color.getGreen();
-                          #        float blue = (float) color.getBlue();
-                          #        float denominator = 255.0;
-                          #        Color.Builder resultBuilder =
-                          #            Color
-                          #                .newBuilder()
-                          #                .setRed(red / denominator)
-                          #                .setGreen(green / denominator)
-                          #                .setBlue(blue / denominator);
-                          #        int alpha = color.getAlpha();
-                          #        if (alpha != 255) {
-                          #          result.setAlpha(
-                          #              FloatValue
-                          #                  .newBuilder()
-                          #                  .setValue(((float) alpha) / denominator)
-                          #                  .build());
-                          #        }
-                          #        return resultBuilder.build();
-                          #      }
-                          #      // ...
-                          #
-                          # Example (iOS / Obj-C):
-                          #
-                          #      // ...
-                          #      static UIColor* fromProto(Color* protocolor) {
-                          #         float red = [protocolor red];
-                          #         float green = [protocolor green];
-                          #         float blue = [protocolor blue];
-                          #         FloatValue* alpha_wrapper = [protocolor alpha];
-                          #         float alpha = 1.0;
-                          #         if (alpha_wrapper != nil) {
-                          #           alpha = [alpha_wrapper value];
-                          #         }
-                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                          #      }
-                          #
-                          #      static Color* toProto(UIColor* color) {
-                          #          CGFloat red, green, blue, alpha;
-                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                          #            return nil;
-                          #          }
-                          #          Color* result = [Color alloc] init];
-                          #          [result setRed:red];
-                          #          [result setGreen:green];
-                          #          [result setBlue:blue];
-                          #          if (alpha <= 0.9999) {
-                          #            [result setAlpha:floatWrapperWithValue(alpha)];
-                          #          }
-                          #          [result autorelease];
-                          #          return result;
-                          #     }
-                          #     // ...
-                          #
-                          #  Example (JavaScript):
-                          #
-                          #     // ...
-                          #
-                          #     var protoToCssColor = function(rgb_color) {
-                          #        var redFrac = rgb_color.red || 0.0;
-                          #        var greenFrac = rgb_color.green || 0.0;
-                          #        var blueFrac = rgb_color.blue || 0.0;
-                          #        var red = Math.floor(redFrac * 255);
-                          #        var green = Math.floor(greenFrac * 255);
-                          #        var blue = Math.floor(blueFrac * 255);
-                          #
-                          #        if (!('alpha' in rgb_color)) {
-                          #           return rgbToCssColor_(red, green, blue);
-                          #        }
-                          #
-                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                          #        var rgbParams = [red, green, blue].join(',');
-                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                          #     };
-                          #
-                          #     var rgbToCssColor_ = function(red, green, blue) {
-                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                          #       var hexString = rgbNumber.toString(16);
-                          #       var missingZeros = 6 - hexString.length;
-                          #       var resultBuilder = ['#'];
-                          #       for (var i = 0; i < missingZeros; i++) {
-                          #          resultBuilder.push('0');
-                          #       }
-                          #       resultBuilder.push(hexString);
-                          #       return resultBuilder.join('');
-                          #     };
-                          #
-                          #     // ...
-                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                            # the final pixel color is defined by the equation:
-                            #
-                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                            #
-                            # This means that a value of 1.0 corresponds to a solid color, whereas
-                            # a value of 0.0 corresponds to a completely transparent color. This
-                            # uses a wrapper message rather than a simple float scalar so that it is
-                            # possible to distinguish between a default value and the value being unset.
-                            # If omitted, this color object is to be rendered as a solid color
-                            # (as if the alpha value had been explicitly given with a value of 1.0).
-                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        # When writing, the new format will be merged with the existing format.
+                      "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                        "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                            # the user's locale will be used if necessary for the given type.
+                            # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                            # information about the supported patterns.
+                        "type": "A String", # The type of the number format.
+                            # When writing, this field must be set.
+                      },
+                      "textDirection": "A String", # The direction of the text in the cell.
+                      "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                          # When updating padding, every field must be specified.
+                        "top": 42, # The top padding of the cell.
+                        "right": 42, # The right padding of the cell.
+                        "bottom": 42, # The bottom padding of the cell.
+                        "left": 42, # The left padding of the cell.
                       },
-                      "width": 42, # The width of the border, in pixels.
-                          # Deprecated; the width is determined by the "style" field.
-                      "style": "A String", # The style of the border.
-                    },
-                    "right": { # A border along a cell. # The right border of the cell.
-                      "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                      "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                      "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
                           # for simplicity of conversion to/from color representations in various
                           # languages over compactness; for example, the fields of this representation
                           # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -30611,427 +40087,2195 @@ <h3>Method Details</h3>
                         "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                         "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                       },
-                      "width": 42, # The width of the border, in pixels.
-                          # Deprecated; the width is determined by the "style" field.
-                      "style": "A String", # The style of the border.
+                      "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                      "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                          # Absent values indicate that the field isn't specified.
+                        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "bold": True or False, # True if the text is bold.
+                        "strikethrough": True or False, # True if the text has a strikethrough.
+                        "fontFamily": "A String", # The font family.
+                        "fontSize": 42, # The size of the font.
+                        "italic": True or False, # True if the text is italicized.
+                        "underline": True or False, # True if the text is underlined.
+                      },
+                      "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                      "borders": { # The borders of the cell. # The borders of the cell.
+                        "top": { # A border along a cell. # The top border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "right": { # A border along a cell. # The right border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "bottom": { # A border along a cell. # The bottom border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "left": { # A border along a cell. # The left border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                      },
+                      "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
                     },
-                    "bottom": { # A border along a cell. # The bottom border of the cell.
-                      "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                          # for simplicity of conversion to/from color representations in various
-                          # languages over compactness; for example, the fields of this representation
-                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                          # method in iOS; and, with just a little work, it can be easily formatted into
-                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                          #
-                          # Example (Java):
-                          #
-                          #      import com.google.type.Color;
-                          #
-                          #      // ...
-                          #      public static java.awt.Color fromProto(Color protocolor) {
-                          #        float alpha = protocolor.hasAlpha()
-                          #            ? protocolor.getAlpha().getValue()
-                          #            : 1.0;
-                          #
-                          #        return new java.awt.Color(
-                          #            protocolor.getRed(),
-                          #            protocolor.getGreen(),
-                          #            protocolor.getBlue(),
-                          #            alpha);
-                          #      }
-                          #
-                          #      public static Color toProto(java.awt.Color color) {
-                          #        float red = (float) color.getRed();
-                          #        float green = (float) color.getGreen();
-                          #        float blue = (float) color.getBlue();
-                          #        float denominator = 255.0;
-                          #        Color.Builder resultBuilder =
-                          #            Color
-                          #                .newBuilder()
-                          #                .setRed(red / denominator)
-                          #                .setGreen(green / denominator)
-                          #                .setBlue(blue / denominator);
-                          #        int alpha = color.getAlpha();
-                          #        if (alpha != 255) {
-                          #          result.setAlpha(
-                          #              FloatValue
-                          #                  .newBuilder()
-                          #                  .setValue(((float) alpha) / denominator)
-                          #                  .build());
-                          #        }
-                          #        return resultBuilder.build();
-                          #      }
-                          #      // ...
-                          #
-                          # Example (iOS / Obj-C):
-                          #
-                          #      // ...
-                          #      static UIColor* fromProto(Color* protocolor) {
-                          #         float red = [protocolor red];
-                          #         float green = [protocolor green];
-                          #         float blue = [protocolor blue];
-                          #         FloatValue* alpha_wrapper = [protocolor alpha];
-                          #         float alpha = 1.0;
-                          #         if (alpha_wrapper != nil) {
-                          #           alpha = [alpha_wrapper value];
-                          #         }
-                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                          #      }
-                          #
-                          #      static Color* toProto(UIColor* color) {
-                          #          CGFloat red, green, blue, alpha;
-                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                          #            return nil;
-                          #          }
-                          #          Color* result = [Color alloc] init];
-                          #          [result setRed:red];
-                          #          [result setGreen:green];
-                          #          [result setBlue:blue];
-                          #          if (alpha <= 0.9999) {
-                          #            [result setAlpha:floatWrapperWithValue(alpha)];
-                          #          }
-                          #          [result autorelease];
-                          #          return result;
-                          #     }
-                          #     // ...
-                          #
-                          #  Example (JavaScript):
-                          #
-                          #     // ...
-                          #
-                          #     var protoToCssColor = function(rgb_color) {
-                          #        var redFrac = rgb_color.red || 0.0;
-                          #        var greenFrac = rgb_color.green || 0.0;
-                          #        var blueFrac = rgb_color.blue || 0.0;
-                          #        var red = Math.floor(redFrac * 255);
-                          #        var green = Math.floor(greenFrac * 255);
-                          #        var blue = Math.floor(blueFrac * 255);
-                          #
-                          #        if (!('alpha' in rgb_color)) {
-                          #           return rgbToCssColor_(red, green, blue);
-                          #        }
-                          #
-                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                          #        var rgbParams = [red, green, blue].join(',');
-                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                          #     };
-                          #
-                          #     var rgbToCssColor_ = function(red, green, blue) {
-                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                          #       var hexString = rgbNumber.toString(16);
-                          #       var missingZeros = 6 - hexString.length;
-                          #       var resultBuilder = ['#'];
-                          #       for (var i = 0; i < missingZeros; i++) {
-                          #          resultBuilder.push('0');
-                          #       }
-                          #       resultBuilder.push(hexString);
-                          #       return resultBuilder.join('');
-                          #     };
-                          #
-                          #     // ...
-                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                            # the final pixel color is defined by the equation:
-                            #
-                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                            #
-                            # This means that a value of 1.0 corresponds to a solid color, whereas
-                            # a value of 0.0 corresponds to a completely transparent color. This
-                            # uses a wrapper message rather than a simple float scalar so that it is
-                            # possible to distinguish between a default value and the value being unset.
-                            # If omitted, this color object is to be rendered as a solid color
-                            # (as if the alpha value had been explicitly given with a value of 1.0).
-                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    "dataValidation": { # A data validation rule. # A data validation rule on the cell, if any.
+                        #
+                        # When writing, the new data validation rule will overwrite any prior rule.
+                      "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
+                          # If true, "List" conditions will show a dropdown.
+                      "strict": True or False, # True if invalid data should be rejected.
+                      "inputMessage": "A String", # A message to show the user when adding data to the cell.
+                      "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
+                          # BooleanConditions are used by conditional formatting,
+                          # data validation, and the criteria in filters.
+                        "type": "A String", # The type of condition.
+                        "values": [ # The values of the condition. The number of supported values depends
+                            # on the condition type.  Some support zero values,
+                            # others one or two values,
+                            # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                          { # The value of the condition.
+                            "relativeDate": "A String", # A relative date (based on the current date).
+                                # Valid only if the type is
+                                # DATE_BEFORE,
+                                # DATE_AFTER,
+                                # DATE_ON_OR_BEFORE or
+                                # DATE_ON_OR_AFTER.
+                                #
+                                # Relative dates are not supported in data validation.
+                                # They are supported only in conditional formatting and
+                                # conditional filters.
+                            "userEnteredValue": "A String", # A value the condition is based on.
+                                # The value will be parsed as if the user typed into a cell.
+                                # Formulas are supported (and must begin with an `=`).
+                          },
+                        ],
                       },
-                      "width": 42, # The width of the border, in pixels.
-                          # Deprecated; the width is determined by the "style" field.
-                      "style": "A String", # The style of the border.
                     },
-                    "left": { # A border along a cell. # The left border of the cell.
-                      "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                          # for simplicity of conversion to/from color representations in various
-                          # languages over compactness; for example, the fields of this representation
-                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                          # method in iOS; and, with just a little work, it can be easily formatted into
-                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                          #
-                          # Example (Java):
-                          #
-                          #      import com.google.type.Color;
-                          #
-                          #      // ...
-                          #      public static java.awt.Color fromProto(Color protocolor) {
-                          #        float alpha = protocolor.hasAlpha()
-                          #            ? protocolor.getAlpha().getValue()
-                          #            : 1.0;
-                          #
-                          #        return new java.awt.Color(
-                          #            protocolor.getRed(),
-                          #            protocolor.getGreen(),
-                          #            protocolor.getBlue(),
-                          #            alpha);
-                          #      }
-                          #
-                          #      public static Color toProto(java.awt.Color color) {
-                          #        float red = (float) color.getRed();
-                          #        float green = (float) color.getGreen();
-                          #        float blue = (float) color.getBlue();
-                          #        float denominator = 255.0;
-                          #        Color.Builder resultBuilder =
-                          #            Color
-                          #                .newBuilder()
-                          #                .setRed(red / denominator)
-                          #                .setGreen(green / denominator)
-                          #                .setBlue(blue / denominator);
-                          #        int alpha = color.getAlpha();
-                          #        if (alpha != 255) {
-                          #          result.setAlpha(
-                          #              FloatValue
-                          #                  .newBuilder()
-                          #                  .setValue(((float) alpha) / denominator)
-                          #                  .build());
-                          #        }
-                          #        return resultBuilder.build();
-                          #      }
-                          #      // ...
-                          #
-                          # Example (iOS / Obj-C):
-                          #
-                          #      // ...
-                          #      static UIColor* fromProto(Color* protocolor) {
-                          #         float red = [protocolor red];
-                          #         float green = [protocolor green];
-                          #         float blue = [protocolor blue];
-                          #         FloatValue* alpha_wrapper = [protocolor alpha];
-                          #         float alpha = 1.0;
-                          #         if (alpha_wrapper != nil) {
-                          #           alpha = [alpha_wrapper value];
-                          #         }
-                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                          #      }
-                          #
-                          #      static Color* toProto(UIColor* color) {
-                          #          CGFloat red, green, blue, alpha;
-                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                          #            return nil;
-                          #          }
-                          #          Color* result = [Color alloc] init];
-                          #          [result setRed:red];
-                          #          [result setGreen:green];
-                          #          [result setBlue:blue];
-                          #          if (alpha <= 0.9999) {
-                          #            [result setAlpha:floatWrapperWithValue(alpha)];
-                          #          }
-                          #          [result autorelease];
-                          #          return result;
-                          #     }
-                          #     // ...
-                          #
-                          #  Example (JavaScript):
-                          #
-                          #     // ...
-                          #
-                          #     var protoToCssColor = function(rgb_color) {
-                          #        var redFrac = rgb_color.red || 0.0;
-                          #        var greenFrac = rgb_color.green || 0.0;
-                          #        var blueFrac = rgb_color.blue || 0.0;
-                          #        var red = Math.floor(redFrac * 255);
-                          #        var green = Math.floor(greenFrac * 255);
-                          #        var blue = Math.floor(blueFrac * 255);
-                          #
-                          #        if (!('alpha' in rgb_color)) {
-                          #           return rgbToCssColor_(red, green, blue);
-                          #        }
-                          #
-                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                          #        var rgbParams = [red, green, blue].join(',');
-                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                          #     };
-                          #
-                          #     var rgbToCssColor_ = function(red, green, blue) {
-                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                          #       var hexString = rgbNumber.toString(16);
-                          #       var missingZeros = 6 - hexString.length;
-                          #       var resultBuilder = ['#'];
-                          #       for (var i = 0; i < missingZeros; i++) {
-                          #          resultBuilder.push('0');
-                          #       }
-                          #       resultBuilder.push(hexString);
-                          #       return resultBuilder.join('');
-                          #     };
-                          #
-                          #     // ...
-                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                            # the final pixel color is defined by the equation:
-                            #
-                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                            #
-                            # This means that a value of 1.0 corresponds to a solid color, whereas
-                            # a value of 0.0 corresponds to a completely transparent color. This
-                            # uses a wrapper message rather than a simple float scalar so that it is
-                            # possible to distinguish between a default value and the value being unset.
-                            # If omitted, this color object is to be rendered as a solid color
-                            # (as if the alpha value had been explicitly given with a value of 1.0).
-                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    "textFormatRuns": [ # Runs of rich text applied to subsections of the cell.  Runs are only valid
+                        # on user entered strings, not formulas, bools, or numbers.
+                        # Runs start at specific indexes in the text and continue until the next
+                        # run. Properties of a run will continue unless explicitly changed
+                        # in a subsequent run (and properties of the first run will continue
+                        # the properties of the cell unless explicitly changed).
+                        #
+                        # When writing, the new runs will overwrite any prior runs.  When writing a
+                        # new user_entered_value, previous runs will be erased.
+                      { # A run of a text format. The format of this run continues until the start
+                          # index of the next run.
+                          # When updating, all fields must be set.
+                        "startIndex": 42, # The character index where this run starts.
+                        "format": { # The format of a run of text in a cell. # The format of this run.  Absent values inherit the cell's format.
+                            # Absent values indicate that the field isn't specified.
+                          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "bold": True or False, # True if the text is bold.
+                          "strikethrough": True or False, # True if the text has a strikethrough.
+                          "fontFamily": "A String", # The font family.
+                          "fontSize": 42, # The size of the font.
+                          "italic": True or False, # True if the text is italicized.
+                          "underline": True or False, # True if the text is underlined.
+                        },
                       },
-                      "width": 42, # The width of the border, in pixels.
-                          # Deprecated; the width is determined by the "style" field.
-                      "style": "A String", # The style of the border.
-                    },
+                    ],
+                  },
+                ],
+              },
+            ],
+          },
+        ],
+        "properties": { # Properties of a sheet. # The properties of the sheet.
+          "sheetType": "A String", # The type of sheet. Defaults to GRID.
+              # This field cannot be changed once set.
+          "index": 42, # The index of the sheet within the spreadsheet.
+              # When adding or updating sheet properties, if this field
+              # is excluded then the sheet will be added or moved to the end
+              # of the sheet list. When updating sheet indices or inserting
+              # sheets, movement is considered in "before the move" indexes.
+              # For example, if there were 3 sheets (S1, S2, S3) in order to
+              # move S1 ahead of S2 the index would have to be set to 2. A sheet
+              # index update request will be ignored if the requested index is
+              # identical to the sheets current index or if the requested new
+              # index is equal to the current sheet index + 1.
+          "title": "A String", # The name of the sheet.
+          "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
+              # (If the sheet is an object sheet, containing a chart or image, then
+              # this field will be absent.)
+              # When writing it is an error to set any grid properties on non-grid sheets.
+            "columnCount": 42, # The number of columns in the grid.
+            "rowCount": 42, # The number of rows in the grid.
+            "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
+            "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
+            "frozenRowCount": 42, # The number of rows that are frozen in the grid.
+          },
+          "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
+          "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
+              # for simplicity of conversion to/from color representations in various
+              # languages over compactness; for example, the fields of this representation
+              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+              # method in iOS; and, with just a little work, it can be easily formatted into
+              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+              #
+              # Example (Java):
+              #
+              #      import com.google.type.Color;
+              #
+              #      // ...
+              #      public static java.awt.Color fromProto(Color protocolor) {
+              #        float alpha = protocolor.hasAlpha()
+              #            ? protocolor.getAlpha().getValue()
+              #            : 1.0;
+              #
+              #        return new java.awt.Color(
+              #            protocolor.getRed(),
+              #            protocolor.getGreen(),
+              #            protocolor.getBlue(),
+              #            alpha);
+              #      }
+              #
+              #      public static Color toProto(java.awt.Color color) {
+              #        float red = (float) color.getRed();
+              #        float green = (float) color.getGreen();
+              #        float blue = (float) color.getBlue();
+              #        float denominator = 255.0;
+              #        Color.Builder resultBuilder =
+              #            Color
+              #                .newBuilder()
+              #                .setRed(red / denominator)
+              #                .setGreen(green / denominator)
+              #                .setBlue(blue / denominator);
+              #        int alpha = color.getAlpha();
+              #        if (alpha != 255) {
+              #          result.setAlpha(
+              #              FloatValue
+              #                  .newBuilder()
+              #                  .setValue(((float) alpha) / denominator)
+              #                  .build());
+              #        }
+              #        return resultBuilder.build();
+              #      }
+              #      // ...
+              #
+              # Example (iOS / Obj-C):
+              #
+              #      // ...
+              #      static UIColor* fromProto(Color* protocolor) {
+              #         float red = [protocolor red];
+              #         float green = [protocolor green];
+              #         float blue = [protocolor blue];
+              #         FloatValue* alpha_wrapper = [protocolor alpha];
+              #         float alpha = 1.0;
+              #         if (alpha_wrapper != nil) {
+              #           alpha = [alpha_wrapper value];
+              #         }
+              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+              #      }
+              #
+              #      static Color* toProto(UIColor* color) {
+              #          CGFloat red, green, blue, alpha;
+              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+              #            return nil;
+              #          }
+              #          Color* result = [Color alloc] init];
+              #          [result setRed:red];
+              #          [result setGreen:green];
+              #          [result setBlue:blue];
+              #          if (alpha <= 0.9999) {
+              #            [result setAlpha:floatWrapperWithValue(alpha)];
+              #          }
+              #          [result autorelease];
+              #          return result;
+              #     }
+              #     // ...
+              #
+              #  Example (JavaScript):
+              #
+              #     // ...
+              #
+              #     var protoToCssColor = function(rgb_color) {
+              #        var redFrac = rgb_color.red || 0.0;
+              #        var greenFrac = rgb_color.green || 0.0;
+              #        var blueFrac = rgb_color.blue || 0.0;
+              #        var red = Math.floor(redFrac * 255);
+              #        var green = Math.floor(greenFrac * 255);
+              #        var blue = Math.floor(blueFrac * 255);
+              #
+              #        if (!('alpha' in rgb_color)) {
+              #           return rgbToCssColor_(red, green, blue);
+              #        }
+              #
+              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+              #        var rgbParams = [red, green, blue].join(',');
+              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+              #     };
+              #
+              #     var rgbToCssColor_ = function(red, green, blue) {
+              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+              #       var hexString = rgbNumber.toString(16);
+              #       var missingZeros = 6 - hexString.length;
+              #       var resultBuilder = ['#'];
+              #       for (var i = 0; i < missingZeros; i++) {
+              #          resultBuilder.push('0');
+              #       }
+              #       resultBuilder.push(hexString);
+              #       return resultBuilder.join('');
+              #     };
+              #
+              #     // ...
+            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                # the final pixel color is defined by the equation:
+                #
+                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                #
+                # This means that a value of 1.0 corresponds to a solid color, whereas
+                # a value of 0.0 corresponds to a completely transparent color. This
+                # uses a wrapper message rather than a simple float scalar so that it is
+                # possible to distinguish between a default value and the value being unset.
+                # If omitted, this color object is to be rendered as a solid color
+                # (as if the alpha value had been explicitly given with a value of 1.0).
+            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+          },
+          "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
+          "sheetId": 42, # The ID of the sheet. Must be non-negative.
+              # This field cannot be changed once set.
+        },
+      },
+    ],
+    "spreadsheetUrl": "A String", # The url of the spreadsheet.
+        # This field is read-only.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(spreadsheetId, ranges=None, x__xgafv=None, includeGridData=None)</code>
+  <pre>Returns the spreadsheet at the given ID.
+The caller must specify the spreadsheet ID.
+
+By default, data within grids will not be returned.
+You can include grid data one of two ways:
+
+* Specify a field mask listing your desired fields using the `fields` URL
+parameter in HTTP
+
+* Set the includeGridData
+URL parameter to true.  If a field mask is set, the `includeGridData`
+parameter is ignored
+
+For large spreadsheets, it is recommended to retrieve only the specific
+fields of the spreadsheet that you want.
+
+To retrieve only subsets of the spreadsheet, use the
+ranges URL parameter.
+Multiple ranges can be specified.  Limiting the range will
+return only the portions of the spreadsheet that intersect the requested
+ranges. Ranges are specified using A1 notation.
+
+Args:
+  spreadsheetId: string, The spreadsheet to request. (required)
+  ranges: string, The ranges to retrieve from the spreadsheet. (repeated)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+  includeGridData: boolean, True if grid data should be returned.
+This parameter is ignored if a field mask was set in the request.
+
+Returns:
+  An object of the form:
+
+    { # Resource that represents a spreadsheet.
+    "spreadsheetId": "A String", # The ID of the spreadsheet.
+        # This field is read-only.
+    "namedRanges": [ # The named ranges defined in a spreadsheet.
+      { # A named range.
+        "namedRangeId": "A String", # The ID of the named range.
+        "range": { # A range on a sheet. # The range this represents.
+            # All indexes are zero-based.
+            # Indexes are half open, e.g the start index is inclusive
+            # and the end index is exclusive -- [start_index, end_index).
+            # Missing indexes indicate the range is unbounded on that side.
+            #
+            # For example, if `"Sheet1"` is sheet ID 0, then:
+            #
+            #   `Sheet1!A1:A1 == sheet_id: 0,
+            #                   start_row_index: 0, end_row_index: 1,
+            #                   start_column_index: 0, end_column_index: 1`
+            #
+            #   `Sheet1!A3:B4 == sheet_id: 0,
+            #                   start_row_index: 2, end_row_index: 4,
+            #                   start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1!A:B == sheet_id: 0,
+            #                 start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1!A5:B == sheet_id: 0,
+            #                  start_row_index: 4,
+            #                  start_column_index: 0, end_column_index: 2`
+            #
+            #   `Sheet1 == sheet_id:0`
+            #
+            # The start index must always be less than or equal to the end index.
+            # If the start index equals the end index, then the range is empty.
+            # Empty ranges are typically not meaningful and are usually rendered in the
+            # UI as `#REF!`.
+          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+          "sheetId": 42, # The sheet this range is on.
+          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+        },
+        "name": "A String", # The name of the named range.
+      },
+    ],
+    "properties": { # Properties of a spreadsheet. # Overall properties of a spreadsheet.
+      "locale": "A String", # The locale of the spreadsheet in one of the following formats:
+          #
+          # * an ISO 639-1 language code such as `en`
+          #
+          # * an ISO 639-2 language code such as `fil`, if no 639-1 code exists
+          #
+          # * a combination of the ISO language code and country code, such as `en_US`
+          #
+          # Note: when updating this field, not all locales/languages are supported.
+      "timeZone": "A String", # The time zone of the spreadsheet, in CLDR format such as
+          # `America/New_York`. If the time zone isn't recognized, this may
+          # be a custom time zone such as `GMT-07:00`.
+      "autoRecalc": "A String", # The amount of time to wait before volatile functions are recalculated.
+      "defaultFormat": { # The format of a cell. # The default format of all cells in the spreadsheet.
+          # CellData.effectiveFormat will not be set if the
+          # cell's format is equal to this default format.
+          # This field is read-only.
+        "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+          "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+              # the user's locale will be used if necessary for the given type.
+              # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+              # information about the supported patterns.
+          "type": "A String", # The type of the number format.
+              # When writing, this field must be set.
+        },
+        "textDirection": "A String", # The direction of the text in the cell.
+        "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+            # When updating padding, every field must be specified.
+          "top": 42, # The top padding of the cell.
+          "right": 42, # The right padding of the cell.
+          "bottom": 42, # The bottom padding of the cell.
+          "left": 42, # The left padding of the cell.
+        },
+        "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+        "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+            # for simplicity of conversion to/from color representations in various
+            # languages over compactness; for example, the fields of this representation
+            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+            # method in iOS; and, with just a little work, it can be easily formatted into
+            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+            #
+            # Example (Java):
+            #
+            #      import com.google.type.Color;
+            #
+            #      // ...
+            #      public static java.awt.Color fromProto(Color protocolor) {
+            #        float alpha = protocolor.hasAlpha()
+            #            ? protocolor.getAlpha().getValue()
+            #            : 1.0;
+            #
+            #        return new java.awt.Color(
+            #            protocolor.getRed(),
+            #            protocolor.getGreen(),
+            #            protocolor.getBlue(),
+            #            alpha);
+            #      }
+            #
+            #      public static Color toProto(java.awt.Color color) {
+            #        float red = (float) color.getRed();
+            #        float green = (float) color.getGreen();
+            #        float blue = (float) color.getBlue();
+            #        float denominator = 255.0;
+            #        Color.Builder resultBuilder =
+            #            Color
+            #                .newBuilder()
+            #                .setRed(red / denominator)
+            #                .setGreen(green / denominator)
+            #                .setBlue(blue / denominator);
+            #        int alpha = color.getAlpha();
+            #        if (alpha != 255) {
+            #          result.setAlpha(
+            #              FloatValue
+            #                  .newBuilder()
+            #                  .setValue(((float) alpha) / denominator)
+            #                  .build());
+            #        }
+            #        return resultBuilder.build();
+            #      }
+            #      // ...
+            #
+            # Example (iOS / Obj-C):
+            #
+            #      // ...
+            #      static UIColor* fromProto(Color* protocolor) {
+            #         float red = [protocolor red];
+            #         float green = [protocolor green];
+            #         float blue = [protocolor blue];
+            #         FloatValue* alpha_wrapper = [protocolor alpha];
+            #         float alpha = 1.0;
+            #         if (alpha_wrapper != nil) {
+            #           alpha = [alpha_wrapper value];
+            #         }
+            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+            #      }
+            #
+            #      static Color* toProto(UIColor* color) {
+            #          CGFloat red, green, blue, alpha;
+            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+            #            return nil;
+            #          }
+            #          Color* result = [Color alloc] init];
+            #          [result setRed:red];
+            #          [result setGreen:green];
+            #          [result setBlue:blue];
+            #          if (alpha <= 0.9999) {
+            #            [result setAlpha:floatWrapperWithValue(alpha)];
+            #          }
+            #          [result autorelease];
+            #          return result;
+            #     }
+            #     // ...
+            #
+            #  Example (JavaScript):
+            #
+            #     // ...
+            #
+            #     var protoToCssColor = function(rgb_color) {
+            #        var redFrac = rgb_color.red || 0.0;
+            #        var greenFrac = rgb_color.green || 0.0;
+            #        var blueFrac = rgb_color.blue || 0.0;
+            #        var red = Math.floor(redFrac * 255);
+            #        var green = Math.floor(greenFrac * 255);
+            #        var blue = Math.floor(blueFrac * 255);
+            #
+            #        if (!('alpha' in rgb_color)) {
+            #           return rgbToCssColor_(red, green, blue);
+            #        }
+            #
+            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+            #        var rgbParams = [red, green, blue].join(',');
+            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+            #     };
+            #
+            #     var rgbToCssColor_ = function(red, green, blue) {
+            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+            #       var hexString = rgbNumber.toString(16);
+            #       var missingZeros = 6 - hexString.length;
+            #       var resultBuilder = ['#'];
+            #       for (var i = 0; i < missingZeros; i++) {
+            #          resultBuilder.push('0');
+            #       }
+            #       resultBuilder.push(hexString);
+            #       return resultBuilder.join('');
+            #     };
+            #
+            #     // ...
+          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+              # the final pixel color is defined by the equation:
+              #
+              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+              #
+              # This means that a value of 1.0 corresponds to a solid color, whereas
+              # a value of 0.0 corresponds to a completely transparent color. This
+              # uses a wrapper message rather than a simple float scalar so that it is
+              # possible to distinguish between a default value and the value being unset.
+              # If omitted, this color object is to be rendered as a solid color
+              # (as if the alpha value had been explicitly given with a value of 1.0).
+          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+        },
+        "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+        "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+            # Absent values indicate that the field isn't specified.
+          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+              # for simplicity of conversion to/from color representations in various
+              # languages over compactness; for example, the fields of this representation
+              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+              # method in iOS; and, with just a little work, it can be easily formatted into
+              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+              #
+              # Example (Java):
+              #
+              #      import com.google.type.Color;
+              #
+              #      // ...
+              #      public static java.awt.Color fromProto(Color protocolor) {
+              #        float alpha = protocolor.hasAlpha()
+              #            ? protocolor.getAlpha().getValue()
+              #            : 1.0;
+              #
+              #        return new java.awt.Color(
+              #            protocolor.getRed(),
+              #            protocolor.getGreen(),
+              #            protocolor.getBlue(),
+              #            alpha);
+              #      }
+              #
+              #      public static Color toProto(java.awt.Color color) {
+              #        float red = (float) color.getRed();
+              #        float green = (float) color.getGreen();
+              #        float blue = (float) color.getBlue();
+              #        float denominator = 255.0;
+              #        Color.Builder resultBuilder =
+              #            Color
+              #                .newBuilder()
+              #                .setRed(red / denominator)
+              #                .setGreen(green / denominator)
+              #                .setBlue(blue / denominator);
+              #        int alpha = color.getAlpha();
+              #        if (alpha != 255) {
+              #          result.setAlpha(
+              #              FloatValue
+              #                  .newBuilder()
+              #                  .setValue(((float) alpha) / denominator)
+              #                  .build());
+              #        }
+              #        return resultBuilder.build();
+              #      }
+              #      // ...
+              #
+              # Example (iOS / Obj-C):
+              #
+              #      // ...
+              #      static UIColor* fromProto(Color* protocolor) {
+              #         float red = [protocolor red];
+              #         float green = [protocolor green];
+              #         float blue = [protocolor blue];
+              #         FloatValue* alpha_wrapper = [protocolor alpha];
+              #         float alpha = 1.0;
+              #         if (alpha_wrapper != nil) {
+              #           alpha = [alpha_wrapper value];
+              #         }
+              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+              #      }
+              #
+              #      static Color* toProto(UIColor* color) {
+              #          CGFloat red, green, blue, alpha;
+              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+              #            return nil;
+              #          }
+              #          Color* result = [Color alloc] init];
+              #          [result setRed:red];
+              #          [result setGreen:green];
+              #          [result setBlue:blue];
+              #          if (alpha <= 0.9999) {
+              #            [result setAlpha:floatWrapperWithValue(alpha)];
+              #          }
+              #          [result autorelease];
+              #          return result;
+              #     }
+              #     // ...
+              #
+              #  Example (JavaScript):
+              #
+              #     // ...
+              #
+              #     var protoToCssColor = function(rgb_color) {
+              #        var redFrac = rgb_color.red || 0.0;
+              #        var greenFrac = rgb_color.green || 0.0;
+              #        var blueFrac = rgb_color.blue || 0.0;
+              #        var red = Math.floor(redFrac * 255);
+              #        var green = Math.floor(greenFrac * 255);
+              #        var blue = Math.floor(blueFrac * 255);
+              #
+              #        if (!('alpha' in rgb_color)) {
+              #           return rgbToCssColor_(red, green, blue);
+              #        }
+              #
+              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+              #        var rgbParams = [red, green, blue].join(',');
+              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+              #     };
+              #
+              #     var rgbToCssColor_ = function(red, green, blue) {
+              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+              #       var hexString = rgbNumber.toString(16);
+              #       var missingZeros = 6 - hexString.length;
+              #       var resultBuilder = ['#'];
+              #       for (var i = 0; i < missingZeros; i++) {
+              #          resultBuilder.push('0');
+              #       }
+              #       resultBuilder.push(hexString);
+              #       return resultBuilder.join('');
+              #     };
+              #
+              #     // ...
+            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                # the final pixel color is defined by the equation:
+                #
+                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                #
+                # This means that a value of 1.0 corresponds to a solid color, whereas
+                # a value of 0.0 corresponds to a completely transparent color. This
+                # uses a wrapper message rather than a simple float scalar so that it is
+                # possible to distinguish between a default value and the value being unset.
+                # If omitted, this color object is to be rendered as a solid color
+                # (as if the alpha value had been explicitly given with a value of 1.0).
+            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+          },
+          "bold": True or False, # True if the text is bold.
+          "strikethrough": True or False, # True if the text has a strikethrough.
+          "fontFamily": "A String", # The font family.
+          "fontSize": 42, # The size of the font.
+          "italic": True or False, # True if the text is italicized.
+          "underline": True or False, # True if the text is underlined.
+        },
+        "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+        "borders": { # The borders of the cell. # The borders of the cell.
+          "top": { # A border along a cell. # The top border of the cell.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+          "right": { # A border along a cell. # The right border of the cell.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+          "bottom": { # A border along a cell. # The bottom border of the cell.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+          "left": { # A border along a cell. # The left border of the cell.
+            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                # for simplicity of conversion to/from color representations in various
+                # languages over compactness; for example, the fields of this representation
+                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                # method in iOS; and, with just a little work, it can be easily formatted into
+                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                #
+                # Example (Java):
+                #
+                #      import com.google.type.Color;
+                #
+                #      // ...
+                #      public static java.awt.Color fromProto(Color protocolor) {
+                #        float alpha = protocolor.hasAlpha()
+                #            ? protocolor.getAlpha().getValue()
+                #            : 1.0;
+                #
+                #        return new java.awt.Color(
+                #            protocolor.getRed(),
+                #            protocolor.getGreen(),
+                #            protocolor.getBlue(),
+                #            alpha);
+                #      }
+                #
+                #      public static Color toProto(java.awt.Color color) {
+                #        float red = (float) color.getRed();
+                #        float green = (float) color.getGreen();
+                #        float blue = (float) color.getBlue();
+                #        float denominator = 255.0;
+                #        Color.Builder resultBuilder =
+                #            Color
+                #                .newBuilder()
+                #                .setRed(red / denominator)
+                #                .setGreen(green / denominator)
+                #                .setBlue(blue / denominator);
+                #        int alpha = color.getAlpha();
+                #        if (alpha != 255) {
+                #          result.setAlpha(
+                #              FloatValue
+                #                  .newBuilder()
+                #                  .setValue(((float) alpha) / denominator)
+                #                  .build());
+                #        }
+                #        return resultBuilder.build();
+                #      }
+                #      // ...
+                #
+                # Example (iOS / Obj-C):
+                #
+                #      // ...
+                #      static UIColor* fromProto(Color* protocolor) {
+                #         float red = [protocolor red];
+                #         float green = [protocolor green];
+                #         float blue = [protocolor blue];
+                #         FloatValue* alpha_wrapper = [protocolor alpha];
+                #         float alpha = 1.0;
+                #         if (alpha_wrapper != nil) {
+                #           alpha = [alpha_wrapper value];
+                #         }
+                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                #      }
+                #
+                #      static Color* toProto(UIColor* color) {
+                #          CGFloat red, green, blue, alpha;
+                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                #            return nil;
+                #          }
+                #          Color* result = [Color alloc] init];
+                #          [result setRed:red];
+                #          [result setGreen:green];
+                #          [result setBlue:blue];
+                #          if (alpha <= 0.9999) {
+                #            [result setAlpha:floatWrapperWithValue(alpha)];
+                #          }
+                #          [result autorelease];
+                #          return result;
+                #     }
+                #     // ...
+                #
+                #  Example (JavaScript):
+                #
+                #     // ...
+                #
+                #     var protoToCssColor = function(rgb_color) {
+                #        var redFrac = rgb_color.red || 0.0;
+                #        var greenFrac = rgb_color.green || 0.0;
+                #        var blueFrac = rgb_color.blue || 0.0;
+                #        var red = Math.floor(redFrac * 255);
+                #        var green = Math.floor(greenFrac * 255);
+                #        var blue = Math.floor(blueFrac * 255);
+                #
+                #        if (!('alpha' in rgb_color)) {
+                #           return rgbToCssColor_(red, green, blue);
+                #        }
+                #
+                #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                #        var rgbParams = [red, green, blue].join(',');
+                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                #     };
+                #
+                #     var rgbToCssColor_ = function(red, green, blue) {
+                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                #       var hexString = rgbNumber.toString(16);
+                #       var missingZeros = 6 - hexString.length;
+                #       var resultBuilder = ['#'];
+                #       for (var i = 0; i < missingZeros; i++) {
+                #          resultBuilder.push('0');
+                #       }
+                #       resultBuilder.push(hexString);
+                #       return resultBuilder.join('');
+                #     };
+                #
+                #     // ...
+              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                  # the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color. This
+                  # uses a wrapper message rather than a simple float scalar so that it is
+                  # possible to distinguish between a default value and the value being unset.
+                  # If omitted, this color object is to be rendered as a solid color
+                  # (as if the alpha value had been explicitly given with a value of 1.0).
+              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+            },
+            "width": 42, # The width of the border, in pixels.
+                # Deprecated; the width is determined by the "style" field.
+            "style": "A String", # The style of the border.
+          },
+        },
+        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+      },
+      "title": "A String", # The title of the spreadsheet.
+    },
+    "sheets": [ # The sheets that are part of a spreadsheet.
+      { # A sheet in a spreadsheet.
+        "conditionalFormats": [ # The conditional format rules in this sheet.
+          { # A rule describing a conditional format.
+            "ranges": [ # The ranges that will be formatted if the condition is true.
+                # All the ranges must be on the same grid.
+              { # A range on a sheet.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+            ],
+            "booleanRule": { # A rule that may or may not match, depending on the condition. # The formatting is either "on" or "off" according to the rule.
+              "condition": { # A condition that can evaluate to true or false. # The condition of the rule. If the condition evaluates to true,
+                  # the format will be applied.
+                  # BooleanConditions are used by conditional formatting,
+                  # data validation, and the criteria in filters.
+                "type": "A String", # The type of condition.
+                "values": [ # The values of the condition. The number of supported values depends
+                    # on the condition type.  Some support zero values,
+                    # others one or two values,
+                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                  { # The value of the condition.
+                    "relativeDate": "A String", # A relative date (based on the current date).
+                        # Valid only if the type is
+                        # DATE_BEFORE,
+                        # DATE_AFTER,
+                        # DATE_ON_OR_BEFORE or
+                        # DATE_ON_OR_AFTER.
+                        #
+                        # Relative dates are not supported in data validation.
+                        # They are supported only in conditional formatting and
+                        # conditional filters.
+                    "userEnteredValue": "A String", # A value the condition is based on.
+                        # The value will be parsed as if the user typed into a cell.
+                        # Formulas are supported (and must begin with an `=`).
                   },
-                  "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-                },
+                ],
               },
-              "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
-                  # the interpolation points listed. The format of a cell will vary
-                  # based on its contents as compared to the values of the interpolation
-                  # points.
-                "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
-                    # These pin the gradient color scale according to the color,
-                    # type and value chosen.
-                  "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                      # for simplicity of conversion to/from color representations in various
-                      # languages over compactness; for example, the fields of this representation
-                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                      # method in iOS; and, with just a little work, it can be easily formatted into
-                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                      #
-                      # Example (Java):
-                      #
-                      #      import com.google.type.Color;
-                      #
-                      #      // ...
-                      #      public static java.awt.Color fromProto(Color protocolor) {
-                      #        float alpha = protocolor.hasAlpha()
-                      #            ? protocolor.getAlpha().getValue()
-                      #            : 1.0;
-                      #
-                      #        return new java.awt.Color(
-                      #            protocolor.getRed(),
-                      #            protocolor.getGreen(),
-                      #            protocolor.getBlue(),
-                      #            alpha);
-                      #      }
-                      #
-                      #      public static Color toProto(java.awt.Color color) {
-                      #        float red = (float) color.getRed();
-                      #        float green = (float) color.getGreen();
-                      #        float blue = (float) color.getBlue();
-                      #        float denominator = 255.0;
-                      #        Color.Builder resultBuilder =
-                      #            Color
-                      #                .newBuilder()
-                      #                .setRed(red / denominator)
-                      #                .setGreen(green / denominator)
-                      #                .setBlue(blue / denominator);
-                      #        int alpha = color.getAlpha();
-                      #        if (alpha != 255) {
-                      #          result.setAlpha(
-                      #              FloatValue
-                      #                  .newBuilder()
-                      #                  .setValue(((float) alpha) / denominator)
-                      #                  .build());
-                      #        }
-                      #        return resultBuilder.build();
-                      #      }
-                      #      // ...
-                      #
-                      # Example (iOS / Obj-C):
-                      #
-                      #      // ...
-                      #      static UIColor* fromProto(Color* protocolor) {
-                      #         float red = [protocolor red];
-                      #         float green = [protocolor green];
-                      #         float blue = [protocolor blue];
-                      #         FloatValue* alpha_wrapper = [protocolor alpha];
-                      #         float alpha = 1.0;
-                      #         if (alpha_wrapper != nil) {
-                      #           alpha = [alpha_wrapper value];
-                      #         }
-                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                      #      }
-                      #
-                      #      static Color* toProto(UIColor* color) {
-                      #          CGFloat red, green, blue, alpha;
-                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                      #            return nil;
-                      #          }
-                      #          Color* result = [Color alloc] init];
-                      #          [result setRed:red];
-                      #          [result setGreen:green];
-                      #          [result setBlue:blue];
-                      #          if (alpha <= 0.9999) {
-                      #            [result setAlpha:floatWrapperWithValue(alpha)];
-                      #          }
-                      #          [result autorelease];
-                      #          return result;
-                      #     }
-                      #     // ...
-                      #
-                      #  Example (JavaScript):
-                      #
-                      #     // ...
-                      #
-                      #     var protoToCssColor = function(rgb_color) {
-                      #        var redFrac = rgb_color.red || 0.0;
-                      #        var greenFrac = rgb_color.green || 0.0;
-                      #        var blueFrac = rgb_color.blue || 0.0;
-                      #        var red = Math.floor(redFrac * 255);
-                      #        var green = Math.floor(greenFrac * 255);
-                      #        var blue = Math.floor(blueFrac * 255);
-                      #
-                      #        if (!('alpha' in rgb_color)) {
-                      #           return rgbToCssColor_(red, green, blue);
-                      #        }
-                      #
-                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                      #        var rgbParams = [red, green, blue].join(',');
-                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                      #     };
-                      #
-                      #     var rgbToCssColor_ = function(red, green, blue) {
-                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                      #       var hexString = rgbNumber.toString(16);
-                      #       var missingZeros = 6 - hexString.length;
-                      #       var resultBuilder = ['#'];
-                      #       for (var i = 0; i < missingZeros; i++) {
-                      #          resultBuilder.push('0');
-                      #       }
-                      #       resultBuilder.push(hexString);
-                      #       return resultBuilder.join('');
-                      #     };
+              "format": { # The format of a cell. # The format to apply.
+                  # Conditional formatting can only apply a subset of formatting:
+                  # bold, italic,
+                  # strikethrough,
+                  # foreground color &
+                  # background color.
+                "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                  "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                      # the user's locale will be used if necessary for the given type.
+                      # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                      # information about the supported patterns.
+                  "type": "A String", # The type of the number format.
+                      # When writing, this field must be set.
+                },
+                "textDirection": "A String", # The direction of the text in the cell.
+                "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                    # When updating padding, every field must be specified.
+                  "top": 42, # The top padding of the cell.
+                  "right": 42, # The right padding of the cell.
+                  "bottom": 42, # The bottom padding of the cell.
+                  "left": 42, # The left padding of the cell.
+                },
+                "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      #     // ...
-                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                        # the final pixel color is defined by the equation:
-                        #
-                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                        #
-                        # This means that a value of 1.0 corresponds to a solid color, whereas
-                        # a value of 0.0 corresponds to a completely transparent color. This
-                        # uses a wrapper message rather than a simple float scalar so that it is
-                        # possible to distinguish between a default value and the value being unset.
-                        # If omitted, this color object is to be rendered as a solid color
-                        # (as if the alpha value had been explicitly given with a value of 1.0).
-                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                  },
-                  "type": "A String", # How the value should be interpreted.
-                  "value": "A String", # The value this interpolation point uses.  May be a formula.
-                      # Unused if type is MIN or
-                      # MAX.
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                 },
-                "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
-                    # These pin the gradient color scale according to the color,
-                    # type and value chosen.
-                  "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                    # Absent values indicate that the field isn't specified.
+                  "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
                       # for simplicity of conversion to/from color representations in various
                       # languages over compactness; for example, the fields of this representation
                       # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -31160,2066 +42404,3311 @@ <h3>Method Details</h3>
                     "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                     "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                   },
-                  "type": "A String", # How the value should be interpreted.
-                  "value": "A String", # The value this interpolation point uses.  May be a formula.
-                      # Unused if type is MIN or
-                      # MAX.
+                  "bold": True or False, # True if the text is bold.
+                  "strikethrough": True or False, # True if the text has a strikethrough.
+                  "fontFamily": "A String", # The font family.
+                  "fontSize": 42, # The size of the font.
+                  "italic": True or False, # True if the text is italicized.
+                  "underline": True or False, # True if the text is underlined.
                 },
-                "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
-                    # These pin the gradient color scale according to the color,
-                    # type and value chosen.
-                  "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
-                      # for simplicity of conversion to/from color representations in various
-                      # languages over compactness; for example, the fields of this representation
-                      # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                      # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                      # method in iOS; and, with just a little work, it can be easily formatted into
-                      # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                      #
-                      # Example (Java):
-                      #
-                      #      import com.google.type.Color;
-                      #
-                      #      // ...
-                      #      public static java.awt.Color fromProto(Color protocolor) {
-                      #        float alpha = protocolor.hasAlpha()
-                      #            ? protocolor.getAlpha().getValue()
-                      #            : 1.0;
-                      #
-                      #        return new java.awt.Color(
-                      #            protocolor.getRed(),
-                      #            protocolor.getGreen(),
-                      #            protocolor.getBlue(),
-                      #            alpha);
-                      #      }
-                      #
-                      #      public static Color toProto(java.awt.Color color) {
-                      #        float red = (float) color.getRed();
-                      #        float green = (float) color.getGreen();
-                      #        float blue = (float) color.getBlue();
-                      #        float denominator = 255.0;
-                      #        Color.Builder resultBuilder =
-                      #            Color
-                      #                .newBuilder()
-                      #                .setRed(red / denominator)
-                      #                .setGreen(green / denominator)
-                      #                .setBlue(blue / denominator);
-                      #        int alpha = color.getAlpha();
-                      #        if (alpha != 255) {
-                      #          result.setAlpha(
-                      #              FloatValue
-                      #                  .newBuilder()
-                      #                  .setValue(((float) alpha) / denominator)
-                      #                  .build());
-                      #        }
-                      #        return resultBuilder.build();
-                      #      }
-                      #      // ...
-                      #
-                      # Example (iOS / Obj-C):
-                      #
-                      #      // ...
-                      #      static UIColor* fromProto(Color* protocolor) {
-                      #         float red = [protocolor red];
-                      #         float green = [protocolor green];
-                      #         float blue = [protocolor blue];
-                      #         FloatValue* alpha_wrapper = [protocolor alpha];
-                      #         float alpha = 1.0;
-                      #         if (alpha_wrapper != nil) {
-                      #           alpha = [alpha_wrapper value];
-                      #         }
-                      #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                      #      }
-                      #
-                      #      static Color* toProto(UIColor* color) {
-                      #          CGFloat red, green, blue, alpha;
-                      #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                      #            return nil;
-                      #          }
-                      #          Color* result = [Color alloc] init];
-                      #          [result setRed:red];
-                      #          [result setGreen:green];
-                      #          [result setBlue:blue];
-                      #          if (alpha <= 0.9999) {
-                      #            [result setAlpha:floatWrapperWithValue(alpha)];
-                      #          }
-                      #          [result autorelease];
-                      #          return result;
-                      #     }
-                      #     // ...
-                      #
-                      #  Example (JavaScript):
-                      #
-                      #     // ...
-                      #
-                      #     var protoToCssColor = function(rgb_color) {
-                      #        var redFrac = rgb_color.red || 0.0;
-                      #        var greenFrac = rgb_color.green || 0.0;
-                      #        var blueFrac = rgb_color.blue || 0.0;
-                      #        var red = Math.floor(redFrac * 255);
-                      #        var green = Math.floor(greenFrac * 255);
-                      #        var blue = Math.floor(blueFrac * 255);
-                      #
-                      #        if (!('alpha' in rgb_color)) {
-                      #           return rgbToCssColor_(red, green, blue);
-                      #        }
-                      #
-                      #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                      #        var rgbParams = [red, green, blue].join(',');
-                      #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                      #     };
-                      #
-                      #     var rgbToCssColor_ = function(red, green, blue) {
-                      #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                      #       var hexString = rgbNumber.toString(16);
-                      #       var missingZeros = 6 - hexString.length;
-                      #       var resultBuilder = ['#'];
-                      #       for (var i = 0; i < missingZeros; i++) {
-                      #          resultBuilder.push('0');
-                      #       }
-                      #       resultBuilder.push(hexString);
-                      #       return resultBuilder.join('');
-                      #     };
-                      #
-                      #     // ...
-                    "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                    "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                        # the final pixel color is defined by the equation:
+                "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                "borders": { # The borders of the cell. # The borders of the cell.
+                  "top": { # A border along a cell. # The top border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                         #
-                        #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                        # Example (Java):
                         #
-                        # This means that a value of 1.0 corresponds to a solid color, whereas
-                        # a value of 0.0 corresponds to a completely transparent color. This
-                        # uses a wrapper message rather than a simple float scalar so that it is
-                        # possible to distinguish between a default value and the value being unset.
-                        # If omitted, this color object is to be rendered as a solid color
-                        # (as if the alpha value had been explicitly given with a value of 1.0).
-                    "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                    "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                    },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
                   },
-                  "type": "A String", # How the value should be interpreted.
-                  "value": "A String", # The value this interpolation point uses.  May be a formula.
-                      # Unused if type is MIN or
-                      # MAX.
-                },
-              },
-            },
-          ],
-          "merges": [ # The ranges that are merged together.
-            { # A range on a sheet.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-          ],
-          "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any.
-            "range": { # A range on a sheet. # The range the filter covers.
-                # All indexes are zero-based.
-                # Indexes are half open, e.g the start index is inclusive
-                # and the end index is exclusive -- [start_index, end_index).
-                # Missing indexes indicate the range is unbounded on that side.
-                #
-                # For example, if `"Sheet1"` is sheet ID 0, then:
-                #
-                #   `Sheet1!A1:A1 == sheet_id: 0,
-                #                   start_row_index: 0, end_row_index: 1,
-                #                   start_column_index: 0, end_column_index: 1`
-                #
-                #   `Sheet1!A3:B4 == sheet_id: 0,
-                #                   start_row_index: 2, end_row_index: 4,
-                #                   start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A:B == sheet_id: 0,
-                #                 start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1!A5:B == sheet_id: 0,
-                #                  start_row_index: 4,
-                #                  start_column_index: 0, end_column_index: 2`
-                #
-                #   `Sheet1 == sheet_id:0`
-                #
-                # The start index must always be less than or equal to the end index.
-                # If the start index equals the end index, then the range is empty.
-                # Empty ranges are typically not meaningful and are usually rendered in the
-                # UI as `#REF!`.
-              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-              "sheetId": 42, # The sheet this range is on.
-              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-            },
-            "sortSpecs": [ # The sort order per column. Later specifications are used when values
-                # are equal in the earlier specifications.
-              { # A sort order associated with a specific column or row.
-                "sortOrder": "A String", # The order data should be sorted.
-                "dimensionIndex": 42, # The dimension the sort should be applied to.
-              },
-            ],
-            "criteria": { # The criteria for showing/hiding values per column.
-                # The map's key is the column index, and the value is the criteria for
-                # that column.
-              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
-                "hiddenValues": [ # Values that should be hidden.
-                  "A String",
-                ],
-                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
-                    # (This does not override hiddenValues -- if a value is listed there,
-                    #  it will still be hidden.)
-                    # BooleanConditions are used by conditional formatting,
-                    # data validation, and the criteria in filters.
-                  "type": "A String", # The type of condition.
-                  "values": [ # The values of the condition. The number of supported values depends
-                      # on the condition type.  Some support zero values,
-                      # others one or two values,
-                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                    { # The value of the condition.
-                      "relativeDate": "A String", # A relative date (based on the current date).
-                          # Valid only if the type is
-                          # DATE_BEFORE,
-                          # DATE_AFTER,
-                          # DATE_ON_OR_BEFORE or
-                          # DATE_ON_OR_AFTER.
+                  "right": { # A border along a cell. # The right border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
                           #
-                          # Relative dates are not supported in data validation.
-                          # They are supported only in conditional formatting and
-                          # conditional filters.
-                      "userEnteredValue": "A String", # A value the condition is based on.
-                          # The value will be parsed as if the user typed into a cell.
-                          # Formulas are supported (and must begin with an `=`).
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                     },
-                  ],
-                },
-              },
-            },
-          },
-          "charts": [ # The specifications of every chart on this sheet.
-            { # A chart embedded in a sheet.
-              "chartId": 42, # The ID of the chart.
-              "position": { # The position of an embedded object such as a chart. # The position of the chart.
-                "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
-                    # is chosen for you. Used only when writing.
-                "sheetId": 42, # The sheet this is on. Set only if the embedded object
-                    # is on its own sheet. Must be non-negative.
-                "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
-                  "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
-                      # All indexes are zero-based.
-                    "rowIndex": 42, # The row index of the coordinate.
-                    "columnIndex": 42, # The column index of the coordinate.
-                    "sheetId": 42, # The sheet this coordinate is on.
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
                   },
-                  "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
-                      # from the anchor cell.
-                  "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
-                  "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
-                      # from the anchor cell.
-                  "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
-                },
-              },
-              "spec": { # The specifications of a chart. # The specification of the chart.
-                "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
-                "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
-                  "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
-                    "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                      "sources": [ # The ranges of data for a series or domain.
-                          # Exactly one dimension must have a length of 1,
-                          # and all sources in the list must have the same dimension
-                          # with length 1.
-                          # The domain (if it exists) & all series must have the same number
-                          # of source ranges. If using more than one source range, then the source
-                          # range at a given offset must be contiguous across the domain and series.
-                          #
-                          # For example, these are valid configurations:
+                  "bottom": { # A border along a cell. # The bottom border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
                           #
-                          #     domain sources: A1:A5
-                          #     series1 sources: B1:B5
-                          #     series2 sources: D6:D10
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                           #
-                          #     domain sources: A1:A5, C10:C12
-                          #     series1 sources: B1:B5, D10:D12
-                          #     series2 sources: C1:C5, E10:E12
-                        { # A range on a sheet.
-                            # All indexes are zero-based.
-                            # Indexes are half open, e.g the start index is inclusive
-                            # and the end index is exclusive -- [start_index, end_index).
-                            # Missing indexes indicate the range is unbounded on that side.
-                            #
-                            # For example, if `"Sheet1"` is sheet ID 0, then:
-                            #
-                            #   `Sheet1!A1:A1 == sheet_id: 0,
-                            #                   start_row_index: 0, end_row_index: 1,
-                            #                   start_column_index: 0, end_column_index: 1`
-                            #
-                            #   `Sheet1!A3:B4 == sheet_id: 0,
-                            #                   start_row_index: 2, end_row_index: 4,
-                            #                   start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A:B == sheet_id: 0,
-                            #                 start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A5:B == sheet_id: 0,
-                            #                  start_row_index: 4,
-                            #                  start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1 == sheet_id:0`
-                            #
-                            # The start index must always be less than or equal to the end index.
-                            # If the start index equals the end index, then the range is empty.
-                            # Empty ranges are typically not meaningful and are usually rendered in the
-                            # UI as `#REF!`.
-                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                          "sheetId": 42, # The sheet this range is on.
-                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                        },
-                      ],
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                     },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
                   },
-                  "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
-                    "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                      "sources": [ # The ranges of data for a series or domain.
-                          # Exactly one dimension must have a length of 1,
-                          # and all sources in the list must have the same dimension
-                          # with length 1.
-                          # The domain (if it exists) & all series must have the same number
-                          # of source ranges. If using more than one source range, then the source
-                          # range at a given offset must be contiguous across the domain and series.
-                          #
-                          # For example, these are valid configurations:
+                  "left": { # A border along a cell. # The left border of the cell.
+                    "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                        # for simplicity of conversion to/from color representations in various
+                        # languages over compactness; for example, the fields of this representation
+                        # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                        # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                        # method in iOS; and, with just a little work, it can be easily formatted into
+                        # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                        #
+                        # Example (Java):
+                        #
+                        #      import com.google.type.Color;
+                        #
+                        #      // ...
+                        #      public static java.awt.Color fromProto(Color protocolor) {
+                        #        float alpha = protocolor.hasAlpha()
+                        #            ? protocolor.getAlpha().getValue()
+                        #            : 1.0;
+                        #
+                        #        return new java.awt.Color(
+                        #            protocolor.getRed(),
+                        #            protocolor.getGreen(),
+                        #            protocolor.getBlue(),
+                        #            alpha);
+                        #      }
+                        #
+                        #      public static Color toProto(java.awt.Color color) {
+                        #        float red = (float) color.getRed();
+                        #        float green = (float) color.getGreen();
+                        #        float blue = (float) color.getBlue();
+                        #        float denominator = 255.0;
+                        #        Color.Builder resultBuilder =
+                        #            Color
+                        #                .newBuilder()
+                        #                .setRed(red / denominator)
+                        #                .setGreen(green / denominator)
+                        #                .setBlue(blue / denominator);
+                        #        int alpha = color.getAlpha();
+                        #        if (alpha != 255) {
+                        #          result.setAlpha(
+                        #              FloatValue
+                        #                  .newBuilder()
+                        #                  .setValue(((float) alpha) / denominator)
+                        #                  .build());
+                        #        }
+                        #        return resultBuilder.build();
+                        #      }
+                        #      // ...
+                        #
+                        # Example (iOS / Obj-C):
+                        #
+                        #      // ...
+                        #      static UIColor* fromProto(Color* protocolor) {
+                        #         float red = [protocolor red];
+                        #         float green = [protocolor green];
+                        #         float blue = [protocolor blue];
+                        #         FloatValue* alpha_wrapper = [protocolor alpha];
+                        #         float alpha = 1.0;
+                        #         if (alpha_wrapper != nil) {
+                        #           alpha = [alpha_wrapper value];
+                        #         }
+                        #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                        #      }
+                        #
+                        #      static Color* toProto(UIColor* color) {
+                        #          CGFloat red, green, blue, alpha;
+                        #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                        #            return nil;
+                        #          }
+                        #          Color* result = [Color alloc] init];
+                        #          [result setRed:red];
+                        #          [result setGreen:green];
+                        #          [result setBlue:blue];
+                        #          if (alpha <= 0.9999) {
+                        #            [result setAlpha:floatWrapperWithValue(alpha)];
+                        #          }
+                        #          [result autorelease];
+                        #          return result;
+                        #     }
+                        #     // ...
+                        #
+                        #  Example (JavaScript):
+                        #
+                        #     // ...
+                        #
+                        #     var protoToCssColor = function(rgb_color) {
+                        #        var redFrac = rgb_color.red || 0.0;
+                        #        var greenFrac = rgb_color.green || 0.0;
+                        #        var blueFrac = rgb_color.blue || 0.0;
+                        #        var red = Math.floor(redFrac * 255);
+                        #        var green = Math.floor(greenFrac * 255);
+                        #        var blue = Math.floor(blueFrac * 255);
+                        #
+                        #        if (!('alpha' in rgb_color)) {
+                        #           return rgbToCssColor_(red, green, blue);
+                        #        }
+                        #
+                        #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                        #        var rgbParams = [red, green, blue].join(',');
+                        #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                        #     };
+                        #
+                        #     var rgbToCssColor_ = function(red, green, blue) {
+                        #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                        #       var hexString = rgbNumber.toString(16);
+                        #       var missingZeros = 6 - hexString.length;
+                        #       var resultBuilder = ['#'];
+                        #       for (var i = 0; i < missingZeros; i++) {
+                        #          resultBuilder.push('0');
+                        #       }
+                        #       resultBuilder.push(hexString);
+                        #       return resultBuilder.join('');
+                        #     };
+                        #
+                        #     // ...
+                      "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                      "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                          # the final pixel color is defined by the equation:
                           #
-                          #     domain sources: A1:A5
-                          #     series1 sources: B1:B5
-                          #     series2 sources: D6:D10
+                          #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                           #
-                          #     domain sources: A1:A5, C10:C12
-                          #     series1 sources: B1:B5, D10:D12
-                          #     series2 sources: C1:C5, E10:E12
-                        { # A range on a sheet.
-                            # All indexes are zero-based.
-                            # Indexes are half open, e.g the start index is inclusive
-                            # and the end index is exclusive -- [start_index, end_index).
-                            # Missing indexes indicate the range is unbounded on that side.
-                            #
-                            # For example, if `"Sheet1"` is sheet ID 0, then:
-                            #
-                            #   `Sheet1!A1:A1 == sheet_id: 0,
-                            #                   start_row_index: 0, end_row_index: 1,
-                            #                   start_column_index: 0, end_column_index: 1`
-                            #
-                            #   `Sheet1!A3:B4 == sheet_id: 0,
-                            #                   start_row_index: 2, end_row_index: 4,
-                            #                   start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A:B == sheet_id: 0,
-                            #                 start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A5:B == sheet_id: 0,
-                            #                  start_row_index: 4,
-                            #                  start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1 == sheet_id:0`
-                            #
-                            # The start index must always be less than or equal to the end index.
-                            # If the start index equals the end index, then the range is empty.
-                            # Empty ranges are typically not meaningful and are usually rendered in the
-                            # UI as `#REF!`.
-                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                          "sheetId": 42, # The sheet this range is on.
-                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                        },
-                      ],
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color. This
+                          # uses a wrapper message rather than a simple float scalar so that it is
+                          # possible to distinguish between a default value and the value being unset.
+                          # If omitted, this color object is to be rendered as a solid color
+                          # (as if the alpha value had been explicitly given with a value of 1.0).
+                      "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                      "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                     },
+                    "width": 42, # The width of the border, in pixels.
+                        # Deprecated; the width is determined by the "style" field.
+                    "style": "A String", # The style of the border.
                   },
-                  "threeDimensional": True or False, # True if the pie is three dimensional.
-                  "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
-                  "pieHole": 3.14, # The size of the hole in the pie chart.
                 },
-                "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
-                    # See BasicChartType for the list of all
-                    # charts this supports.
-                    # of charts this supports.
-                  "headerCount": 42, # The number of rows or columns in the data that are "headers".
-                      # If not set, Google Sheets will guess how many rows are headers based
-                      # on the data.
+                "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+              },
+            },
+            "gradientRule": { # A rule that applies a gradient color scale format, based on # The formatting will vary based on the gradients in the rule.
+                # the interpolation points listed. The format of a cell will vary
+                # based on its contents as compared to the values of the interpolation
+                # points.
+              "maxpoint": { # A single interpolation point on a gradient conditional format. # The final interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "midpoint": { # A single interpolation point on a gradient conditional format. # An optional midway interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
                       #
-                      # (Note that BasicChartAxis.title may override the axis title
-                      #  inferred from the header values.)
-                  "series": [ # The data this chart is visualizing.
-                    { # A single series of data in a chart.
-                        # For example, if charting stock prices over time, multiple series may exist,
-                        # one for the "Open Price", "High Price", "Low Price" and "Close Price".
-                      "series": { # The data included in a domain or series. # The data being visualized in this chart series.
-                        "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                          "sources": [ # The ranges of data for a series or domain.
-                              # Exactly one dimension must have a length of 1,
-                              # and all sources in the list must have the same dimension
-                              # with length 1.
-                              # The domain (if it exists) & all series must have the same number
-                              # of source ranges. If using more than one source range, then the source
-                              # range at a given offset must be contiguous across the domain and series.
-                              #
-                              # For example, these are valid configurations:
-                              #
-                              #     domain sources: A1:A5
-                              #     series1 sources: B1:B5
-                              #     series2 sources: D6:D10
-                              #
-                              #     domain sources: A1:A5, C10:C12
-                              #     series1 sources: B1:B5, D10:D12
-                              #     series2 sources: C1:C5, E10:E12
-                            { # A range on a sheet.
-                                # All indexes are zero-based.
-                                # Indexes are half open, e.g the start index is inclusive
-                                # and the end index is exclusive -- [start_index, end_index).
-                                # Missing indexes indicate the range is unbounded on that side.
-                                #
-                                # For example, if `"Sheet1"` is sheet ID 0, then:
-                                #
-                                #   `Sheet1!A1:A1 == sheet_id: 0,
-                                #                   start_row_index: 0, end_row_index: 1,
-                                #                   start_column_index: 0, end_column_index: 1`
-                                #
-                                #   `Sheet1!A3:B4 == sheet_id: 0,
-                                #                   start_row_index: 2, end_row_index: 4,
-                                #                   start_column_index: 0, end_column_index: 2`
-                                #
-                                #   `Sheet1!A:B == sheet_id: 0,
-                                #                 start_column_index: 0, end_column_index: 2`
-                                #
-                                #   `Sheet1!A5:B == sheet_id: 0,
-                                #                  start_row_index: 4,
-                                #                  start_column_index: 0, end_column_index: 2`
-                                #
-                                #   `Sheet1 == sheet_id:0`
-                                #
-                                # The start index must always be less than or equal to the end index.
-                                # If the start index equals the end index, then the range is empty.
-                                # Empty ranges are typically not meaningful and are usually rendered in the
-                                # UI as `#REF!`.
-                              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                              "sheetId": 42, # The sheet this range is on.
-                              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                            },
-                          ],
-                        },
-                      },
-                      "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
-                          # For example, if charting stocks over time, the "Volume" series
-                          # may want to be pinned to the right with the prices pinned to the left,
-                          # because the scale of trading volume is different than the scale of
-                          # prices.
-                          # It is an error to specify an axis that isn't a valid minor axis
-                          # for the chart's type.
-                      "type": "A String", # The type of this series. Valid only if the
-                          # chartType is
-                          # COMBO.
-                          # Different types will change the way the series is visualized.
-                          # Only LINE, AREA,
-                          # and COLUMN are supported.
-                    },
-                  ],
-                  "legendPosition": "A String", # The position of the chart legend.
-                  "domains": [ # The domain of data this is charting.
-                      # Only a single domain is currently supported.
-                    { # The domain of a chart.
-                        # For example, if charting stock prices over time, this would be the date.
-                      "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
-                          # this is the data representing the dates.
-                        "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
-                          "sources": [ # The ranges of data for a series or domain.
-                              # Exactly one dimension must have a length of 1,
-                              # and all sources in the list must have the same dimension
-                              # with length 1.
-                              # The domain (if it exists) & all series must have the same number
-                              # of source ranges. If using more than one source range, then the source
-                              # range at a given offset must be contiguous across the domain and series.
-                              #
-                              # For example, these are valid configurations:
-                              #
-                              #     domain sources: A1:A5
-                              #     series1 sources: B1:B5
-                              #     series2 sources: D6:D10
-                              #
-                              #     domain sources: A1:A5, C10:C12
-                              #     series1 sources: B1:B5, D10:D12
-                              #     series2 sources: C1:C5, E10:E12
-                            { # A range on a sheet.
-                                # All indexes are zero-based.
-                                # Indexes are half open, e.g the start index is inclusive
-                                # and the end index is exclusive -- [start_index, end_index).
-                                # Missing indexes indicate the range is unbounded on that side.
-                                #
-                                # For example, if `"Sheet1"` is sheet ID 0, then:
-                                #
-                                #   `Sheet1!A1:A1 == sheet_id: 0,
-                                #                   start_row_index: 0, end_row_index: 1,
-                                #                   start_column_index: 0, end_column_index: 1`
-                                #
-                                #   `Sheet1!A3:B4 == sheet_id: 0,
-                                #                   start_row_index: 2, end_row_index: 4,
-                                #                   start_column_index: 0, end_column_index: 2`
-                                #
-                                #   `Sheet1!A:B == sheet_id: 0,
-                                #                 start_column_index: 0, end_column_index: 2`
-                                #
-                                #   `Sheet1!A5:B == sheet_id: 0,
-                                #                  start_row_index: 4,
-                                #                  start_column_index: 0, end_column_index: 2`
-                                #
-                                #   `Sheet1 == sheet_id:0`
-                                #
-                                # The start index must always be less than or equal to the end index.
-                                # If the start index equals the end index, then the range is empty.
-                                # Empty ranges are typically not meaningful and are usually rendered in the
-                                # UI as `#REF!`.
-                              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                              "sheetId": 42, # The sheet this range is on.
-                              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                            },
-                          ],
-                        },
-                      },
-                    },
-                  ],
-                  "chartType": "A String", # The type of the chart.
-                  "axis": [ # The axis on the chart.
-                    { # An axis of the chart.
-                        # A chart may not have more than one axis per
-                        # axis position.
-                      "position": "A String", # The position of this axis.
-                      "format": { # The format of a run of text in a cell. # The format of the title.
-                          # Only valid if the axis is not associated with the domain.
-                          # Absent values indicate that the field isn't specified.
-                        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                            # for simplicity of conversion to/from color representations in various
-                            # languages over compactness; for example, the fields of this representation
-                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                            # method in iOS; and, with just a little work, it can be easily formatted into
-                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                            #
-                            # Example (Java):
-                            #
-                            #      import com.google.type.Color;
-                            #
-                            #      // ...
-                            #      public static java.awt.Color fromProto(Color protocolor) {
-                            #        float alpha = protocolor.hasAlpha()
-                            #            ? protocolor.getAlpha().getValue()
-                            #            : 1.0;
-                            #
-                            #        return new java.awt.Color(
-                            #            protocolor.getRed(),
-                            #            protocolor.getGreen(),
-                            #            protocolor.getBlue(),
-                            #            alpha);
-                            #      }
-                            #
-                            #      public static Color toProto(java.awt.Color color) {
-                            #        float red = (float) color.getRed();
-                            #        float green = (float) color.getGreen();
-                            #        float blue = (float) color.getBlue();
-                            #        float denominator = 255.0;
-                            #        Color.Builder resultBuilder =
-                            #            Color
-                            #                .newBuilder()
-                            #                .setRed(red / denominator)
-                            #                .setGreen(green / denominator)
-                            #                .setBlue(blue / denominator);
-                            #        int alpha = color.getAlpha();
-                            #        if (alpha != 255) {
-                            #          result.setAlpha(
-                            #              FloatValue
-                            #                  .newBuilder()
-                            #                  .setValue(((float) alpha) / denominator)
-                            #                  .build());
-                            #        }
-                            #        return resultBuilder.build();
-                            #      }
-                            #      // ...
-                            #
-                            # Example (iOS / Obj-C):
-                            #
-                            #      // ...
-                            #      static UIColor* fromProto(Color* protocolor) {
-                            #         float red = [protocolor red];
-                            #         float green = [protocolor green];
-                            #         float blue = [protocolor blue];
-                            #         FloatValue* alpha_wrapper = [protocolor alpha];
-                            #         float alpha = 1.0;
-                            #         if (alpha_wrapper != nil) {
-                            #           alpha = [alpha_wrapper value];
-                            #         }
-                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                            #      }
-                            #
-                            #      static Color* toProto(UIColor* color) {
-                            #          CGFloat red, green, blue, alpha;
-                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                            #            return nil;
-                            #          }
-                            #          Color* result = [Color alloc] init];
-                            #          [result setRed:red];
-                            #          [result setGreen:green];
-                            #          [result setBlue:blue];
-                            #          if (alpha <= 0.9999) {
-                            #            [result setAlpha:floatWrapperWithValue(alpha)];
-                            #          }
-                            #          [result autorelease];
-                            #          return result;
-                            #     }
-                            #     // ...
-                            #
-                            #  Example (JavaScript):
-                            #
-                            #     // ...
-                            #
-                            #     var protoToCssColor = function(rgb_color) {
-                            #        var redFrac = rgb_color.red || 0.0;
-                            #        var greenFrac = rgb_color.green || 0.0;
-                            #        var blueFrac = rgb_color.blue || 0.0;
-                            #        var red = Math.floor(redFrac * 255);
-                            #        var green = Math.floor(greenFrac * 255);
-                            #        var blue = Math.floor(blueFrac * 255);
-                            #
-                            #        if (!('alpha' in rgb_color)) {
-                            #           return rgbToCssColor_(red, green, blue);
-                            #        }
-                            #
-                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                            #        var rgbParams = [red, green, blue].join(',');
-                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                            #     };
-                            #
-                            #     var rgbToCssColor_ = function(red, green, blue) {
-                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                            #       var hexString = rgbNumber.toString(16);
-                            #       var missingZeros = 6 - hexString.length;
-                            #       var resultBuilder = ['#'];
-                            #       for (var i = 0; i < missingZeros; i++) {
-                            #          resultBuilder.push('0');
-                            #       }
-                            #       resultBuilder.push(hexString);
-                            #       return resultBuilder.join('');
-                            #     };
-                            #
-                            #     // ...
-                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                              # the final pixel color is defined by the equation:
-                              #
-                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                              #
-                              # This means that a value of 1.0 corresponds to a solid color, whereas
-                              # a value of 0.0 corresponds to a completely transparent color. This
-                              # uses a wrapper message rather than a simple float scalar so that it is
-                              # possible to distinguish between a default value and the value being unset.
-                              # If omitted, this color object is to be rendered as a solid color
-                              # (as if the alpha value had been explicitly given with a value of 1.0).
-                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                        },
-                        "bold": True or False, # True if the text is bold.
-                        "strikethrough": True or False, # True if the text has a strikethrough.
-                        "fontFamily": "A String", # The font family.
-                        "fontSize": 42, # The size of the font.
-                        "italic": True or False, # True if the text is italicized.
-                        "underline": True or False, # True if the text is underlined.
-                      },
-                      "title": "A String", # The title of this axis. If set, this overrides any title inferred
-                          # from headers of the data.
-                    },
-                  ],
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                },
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+              "minpoint": { # A single interpolation point on a gradient conditional format. # The starting interpolation point.
+                  # These pin the gradient color scale according to the color,
+                  # type and value chosen.
+                "color": { # Represents a color in the RGBA color space. This representation is designed # The color this interpolation point should use.
+                    # for simplicity of conversion to/from color representations in various
+                    # languages over compactness; for example, the fields of this representation
+                    # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                    # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                    # method in iOS; and, with just a little work, it can be easily formatted into
+                    # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                    #
+                    # Example (Java):
+                    #
+                    #      import com.google.type.Color;
+                    #
+                    #      // ...
+                    #      public static java.awt.Color fromProto(Color protocolor) {
+                    #        float alpha = protocolor.hasAlpha()
+                    #            ? protocolor.getAlpha().getValue()
+                    #            : 1.0;
+                    #
+                    #        return new java.awt.Color(
+                    #            protocolor.getRed(),
+                    #            protocolor.getGreen(),
+                    #            protocolor.getBlue(),
+                    #            alpha);
+                    #      }
+                    #
+                    #      public static Color toProto(java.awt.Color color) {
+                    #        float red = (float) color.getRed();
+                    #        float green = (float) color.getGreen();
+                    #        float blue = (float) color.getBlue();
+                    #        float denominator = 255.0;
+                    #        Color.Builder resultBuilder =
+                    #            Color
+                    #                .newBuilder()
+                    #                .setRed(red / denominator)
+                    #                .setGreen(green / denominator)
+                    #                .setBlue(blue / denominator);
+                    #        int alpha = color.getAlpha();
+                    #        if (alpha != 255) {
+                    #          result.setAlpha(
+                    #              FloatValue
+                    #                  .newBuilder()
+                    #                  .setValue(((float) alpha) / denominator)
+                    #                  .build());
+                    #        }
+                    #        return resultBuilder.build();
+                    #      }
+                    #      // ...
+                    #
+                    # Example (iOS / Obj-C):
+                    #
+                    #      // ...
+                    #      static UIColor* fromProto(Color* protocolor) {
+                    #         float red = [protocolor red];
+                    #         float green = [protocolor green];
+                    #         float blue = [protocolor blue];
+                    #         FloatValue* alpha_wrapper = [protocolor alpha];
+                    #         float alpha = 1.0;
+                    #         if (alpha_wrapper != nil) {
+                    #           alpha = [alpha_wrapper value];
+                    #         }
+                    #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                    #      }
+                    #
+                    #      static Color* toProto(UIColor* color) {
+                    #          CGFloat red, green, blue, alpha;
+                    #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                    #            return nil;
+                    #          }
+                    #          Color* result = [Color alloc] init];
+                    #          [result setRed:red];
+                    #          [result setGreen:green];
+                    #          [result setBlue:blue];
+                    #          if (alpha <= 0.9999) {
+                    #            [result setAlpha:floatWrapperWithValue(alpha)];
+                    #          }
+                    #          [result autorelease];
+                    #          return result;
+                    #     }
+                    #     // ...
+                    #
+                    #  Example (JavaScript):
+                    #
+                    #     // ...
+                    #
+                    #     var protoToCssColor = function(rgb_color) {
+                    #        var redFrac = rgb_color.red || 0.0;
+                    #        var greenFrac = rgb_color.green || 0.0;
+                    #        var blueFrac = rgb_color.blue || 0.0;
+                    #        var red = Math.floor(redFrac * 255);
+                    #        var green = Math.floor(greenFrac * 255);
+                    #        var blue = Math.floor(blueFrac * 255);
+                    #
+                    #        if (!('alpha' in rgb_color)) {
+                    #           return rgbToCssColor_(red, green, blue);
+                    #        }
+                    #
+                    #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                    #        var rgbParams = [red, green, blue].join(',');
+                    #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                    #     };
+                    #
+                    #     var rgbToCssColor_ = function(red, green, blue) {
+                    #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                    #       var hexString = rgbNumber.toString(16);
+                    #       var missingZeros = 6 - hexString.length;
+                    #       var resultBuilder = ['#'];
+                    #       for (var i = 0; i < missingZeros; i++) {
+                    #          resultBuilder.push('0');
+                    #       }
+                    #       resultBuilder.push(hexString);
+                    #       return resultBuilder.join('');
+                    #     };
+                    #
+                    #     // ...
+                  "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                  "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                      # the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color. This
+                      # uses a wrapper message rather than a simple float scalar so that it is
+                      # possible to distinguish between a default value and the value being unset.
+                      # If omitted, this color object is to be rendered as a solid color
+                      # (as if the alpha value had been explicitly given with a value of 1.0).
+                  "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                  "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                 },
-                "title": "A String", # The title of the chart.
+                "type": "A String", # How the value should be interpreted.
+                "value": "A String", # The value this interpolation point uses.  May be a formula.
+                    # Unused if type is MIN or
+                    # MAX.
+              },
+            },
+          },
+        ],
+        "bandedRanges": [ # The banded (i.e. alternating colors) ranges on this sheet.
+          { # A banded (alternating colors) range in a sheet.
+            "range": { # A range on a sheet. # The range over which these properties are applied.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "columnProperties": { # Properties referring a single dimension (either row or column). If both # Properties for column bands. These properties will be applied on a column-
+                # by-column basis throughout all the columns in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
             },
-          ],
-          "filterViews": [ # The filter views in this sheet.
-            { # A filter view.
-              "title": "A String", # The name of the filter view.
-              "namedRangeId": "A String", # The named range this filter view is backed by, if any.
+            "rowProperties": { # Properties referring a single dimension (either row or column). If both # Properties for row bands. These properties will be applied on a row-by-row
+                # basis throughout all the rows in the range. At least one of
+                # row_properties or column_properties must be specified.
+                # BandedRange.row_properties and BandedRange.column_properties are
+                # set, the fill colors are applied to cells according to the following rules:
+                #
+                # * header_color and footer_color take priority over band colors.
+                # * first_band_color takes priority over second_band_color.
+                # * row_properties takes priority over column_properties.
+                #
+                # For example, the first row color takes priority over the first column
+                # color, but the first column color takes priority over the second row color.
+                # Similarly, the row header takes priority over the column header in the
+                # top left cell, but the column header takes priority over the first row
+                # color if the row header is not set.
+              "secondBandColor": { # Represents a color in the RGBA color space. This representation is designed # The second color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                   #
-                  # When writing, only one of range or named_range_id
-                  # may be set.
-              "filterViewId": 42, # The ID of the filter view.
-              "range": { # A range on a sheet. # The range this filter view covers.
+                  # Example (Java):
                   #
-                  # When writing, only one of range or named_range_id
-                  # may be set.
-                  # All indexes are zero-based.
-                  # Indexes are half open, e.g the start index is inclusive
-                  # and the end index is exclusive -- [start_index, end_index).
-                  # Missing indexes indicate the range is unbounded on that side.
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "headerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the first row or column. If this field is set, the first
+                  # row or column will be filled with this color and the colors will
+                  # alternate between first_band_color and second_band_color starting
+                  # from the second row or column. Otherwise, the first row or column will be
+                  # filled with first_band_color and the colors will proceed to alternate
+                  # as they normally would.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+              "footerColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the last row or column. If this field is not set, the last
+                  # row or column will be filled with either first_band_color or
+                  # second_band_color, depending on the color of the previous row or
+                  # column.
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                  #
+                  # Example (Java):
+                  #
+                  #      import com.google.type.Color;
+                  #
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
+                  #
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
+                  #
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
                   #
-                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #  Example (JavaScript):
                   #
-                  #   `Sheet1!A1:A1 == sheet_id: 0,
-                  #                   start_row_index: 0, end_row_index: 1,
-                  #                   start_column_index: 0, end_column_index: 1`
+                  #     // ...
                   #
-                  #   `Sheet1!A3:B4 == sheet_id: 0,
-                  #                   start_row_index: 2, end_row_index: 4,
-                  #                   start_column_index: 0, end_column_index: 2`
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
                   #
-                  #   `Sheet1!A:B == sheet_id: 0,
-                  #                 start_column_index: 0, end_column_index: 2`
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
                   #
-                  #   `Sheet1!A5:B == sheet_id: 0,
-                  #                  start_row_index: 4,
-                  #                  start_column_index: 0, end_column_index: 2`
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
                   #
-                  #   `Sheet1 == sheet_id:0`
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
                   #
-                  # The start index must always be less than or equal to the end index.
-                  # If the start index equals the end index, then the range is empty.
-                  # Empty ranges are typically not meaningful and are usually rendered in the
-                  # UI as `#REF!`.
-                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                "sheetId": 42, # The sheet this range is on.
-                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-              },
-              "sortSpecs": [ # The sort order per column. Later specifications are used when values
-                  # are equal in the earlier specifications.
-                { # A sort order associated with a specific column or row.
-                  "sortOrder": "A String", # The order data should be sorted.
-                  "dimensionIndex": 42, # The dimension the sort should be applied to.
-                },
-              ],
-              "criteria": { # The criteria for showing/hiding values per column.
-                  # The map's key is the column index, and the value is the criteria for
-                  # that column.
-                "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
-                  "hiddenValues": [ # Values that should be hidden.
-                    "A String",
-                  ],
-                  "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
-                      # (This does not override hiddenValues -- if a value is listed there,
-                      #  it will still be hidden.)
-                      # BooleanConditions are used by conditional formatting,
-                      # data validation, and the criteria in filters.
-                    "type": "A String", # The type of condition.
-                    "values": [ # The values of the condition. The number of supported values depends
-                        # on the condition type.  Some support zero values,
-                        # others one or two values,
-                        # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                      { # The value of the condition.
-                        "relativeDate": "A String", # A relative date (based on the current date).
-                            # Valid only if the type is
-                            # DATE_BEFORE,
-                            # DATE_AFTER,
-                            # DATE_ON_OR_BEFORE or
-                            # DATE_ON_OR_AFTER.
-                            #
-                            # Relative dates are not supported in data validation.
-                            # They are supported only in conditional formatting and
-                            # conditional filters.
-                        "userEnteredValue": "A String", # A value the condition is based on.
-                            # The value will be parsed as if the user typed into a cell.
-                            # Formulas are supported (and must begin with an `=`).
-                      },
-                    ],
-                  },
-                },
-              },
-            },
-          ],
-          "protectedRanges": [ # The protected ranges in this sheet.
-            { # A protected range.
-              "unprotectedRanges": [ # The list of unprotected ranges within a protected sheet.
-                  # Unprotected ranges are only supported on protected sheets.
-                { # A range on a sheet.
-                    # All indexes are zero-based.
-                    # Indexes are half open, e.g the start index is inclusive
-                    # and the end index is exclusive -- [start_index, end_index).
-                    # Missing indexes indicate the range is unbounded on that side.
-                    #
-                    # For example, if `"Sheet1"` is sheet ID 0, then:
-                    #
-                    #   `Sheet1!A1:A1 == sheet_id: 0,
-                    #                   start_row_index: 0, end_row_index: 1,
-                    #                   start_column_index: 0, end_column_index: 1`
-                    #
-                    #   `Sheet1!A3:B4 == sheet_id: 0,
-                    #                   start_row_index: 2, end_row_index: 4,
-                    #                   start_column_index: 0, end_column_index: 2`
-                    #
-                    #   `Sheet1!A:B == sheet_id: 0,
-                    #                 start_column_index: 0, end_column_index: 2`
-                    #
-                    #   `Sheet1!A5:B == sheet_id: 0,
-                    #                  start_row_index: 4,
-                    #                  start_column_index: 0, end_column_index: 2`
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
                     #
-                    #   `Sheet1 == sheet_id:0`
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                     #
-                    # The start index must always be less than or equal to the end index.
-                    # If the start index equals the end index, then the range is empty.
-                    # Empty ranges are typically not meaningful and are usually rendered in the
-                    # UI as `#REF!`.
-                  "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                  "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                  "sheetId": 42, # The sheet this range is on.
-                  "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                  "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                },
-              ],
-              "requestingUserCanEdit": True or False, # True if the user who requested this protected range can edit the
-                  # protected area.
-                  # This field is read-only.
-              "description": "A String", # The description of this protected range.
-              "namedRangeId": "A String", # The named range this protected range is backed by, if any.
-                  #
-                  # When writing, only one of range or named_range_id
-                  # may be set.
-              "editors": { # The editors of a protected range. # The users and groups with edit access to the protected range.
-                  # This field is only visible to users with edit access to the protected
-                  # range and the document.
-                  # Editors are not supported with warning_only protection.
-                "domainUsersCanEdit": True or False, # True if anyone in the document's domain has edit access to the protected
-                    # range.  Domain protection is only supported on documents within a domain.
-                "users": [ # The email addresses of users with edit access to the protected range.
-                  "A String",
-                ],
-                "groups": [ # The email addresses of groups with edit access to the protected range.
-                  "A String",
-                ],
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
               },
-              "protectedRangeId": 42, # The ID of the protected range.
-                  # This field is read-only.
-              "warningOnly": True or False, # True if this protected range will show a warning when editing.
-                  # Warning-based protection means that every user can edit data in the
-                  # protected range, except editing will prompt a warning asking the user
-                  # to confirm the edit.
-                  #
-                  # When writing: if this field is true, then editors is ignored.
-                  # Additionally, if this field is changed from true to false and the
-                  # `editors` field is not set (nor included in the field mask), then
-                  # the editors will be set to all the editors in the document.
-              "range": { # A range on a sheet. # The range that is being protected.
-                  # The range may be fully unbounded, in which case this is considered
-                  # a protected sheet.
-                  #
-                  # When writing, only one of range or named_range_id
-                  # may be set.
-                  # All indexes are zero-based.
-                  # Indexes are half open, e.g the start index is inclusive
-                  # and the end index is exclusive -- [start_index, end_index).
-                  # Missing indexes indicate the range is unbounded on that side.
-                  #
-                  # For example, if `"Sheet1"` is sheet ID 0, then:
-                  #
-                  #   `Sheet1!A1:A1 == sheet_id: 0,
-                  #                   start_row_index: 0, end_row_index: 1,
-                  #                   start_column_index: 0, end_column_index: 1`
+              "firstBandColor": { # Represents a color in the RGBA color space. This representation is designed # The first color that is alternating. (Required)
+                  # for simplicity of conversion to/from color representations in various
+                  # languages over compactness; for example, the fields of this representation
+                  # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                  # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                  # method in iOS; and, with just a little work, it can be easily formatted into
+                  # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
                   #
-                  #   `Sheet1!A3:B4 == sheet_id: 0,
-                  #                   start_row_index: 2, end_row_index: 4,
-                  #                   start_column_index: 0, end_column_index: 2`
+                  # Example (Java):
                   #
-                  #   `Sheet1!A:B == sheet_id: 0,
-                  #                 start_column_index: 0, end_column_index: 2`
+                  #      import com.google.type.Color;
                   #
-                  #   `Sheet1!A5:B == sheet_id: 0,
-                  #                  start_row_index: 4,
-                  #                  start_column_index: 0, end_column_index: 2`
+                  #      // ...
+                  #      public static java.awt.Color fromProto(Color protocolor) {
+                  #        float alpha = protocolor.hasAlpha()
+                  #            ? protocolor.getAlpha().getValue()
+                  #            : 1.0;
                   #
-                  #   `Sheet1 == sheet_id:0`
+                  #        return new java.awt.Color(
+                  #            protocolor.getRed(),
+                  #            protocolor.getGreen(),
+                  #            protocolor.getBlue(),
+                  #            alpha);
+                  #      }
                   #
-                  # The start index must always be less than or equal to the end index.
-                  # If the start index equals the end index, then the range is empty.
-                  # Empty ranges are typically not meaningful and are usually rendered in the
-                  # UI as `#REF!`.
-                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                "sheetId": 42, # The sheet this range is on.
-                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-              },
-            },
-          ],
-          "data": [ # Data in the grid, if this is a grid sheet.
-              # The number of GridData objects returned is dependent on the number of
-              # ranges requested on this sheet. For example, if this is representing
-              # `Sheet1`, and the spreadsheet was requested with ranges
-              # `Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will have a
-              # startRow/startColumn of `0`,
-              # while the second one will have `startRow 14` (zero-based row 15),
-              # and `startColumn 3` (zero-based column D).
-            { # Data in the grid, as well as metadata about the dimensions.
-              "startRow": 42, # The first row this GridData refers to, zero-based.
-              "rowMetadata": [ # Metadata about the requested rows in the grid, starting with the row
-                  # in start_row.
-                { # Properties about a dimension.
-                  "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
-                  "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
-                  "hiddenByFilter": True or False, # True if this dimension is being filtered.
-                      # This field is read-only.
-                },
-              ],
-              "startColumn": 42, # The first column this GridData refers to, zero-based.
-              "columnMetadata": [ # Metadata about the requested columns in the grid, starting with the column
-                  # in start_column.
-                { # Properties about a dimension.
-                  "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
-                  "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
-                  "hiddenByFilter": True or False, # True if this dimension is being filtered.
-                      # This field is read-only.
-                },
-              ],
-              "rowData": [ # The data in the grid, one entry per row,
-                  # starting with the row in startRow.
-                  # The values in RowData will correspond to columns starting
-                  # at start_column.
-                { # Data about each cell in a row.
-                  "values": [ # The values in the row, one per column.
-                    { # Data about a specific cell.
-                      "pivotTable": { # A pivot table. # A pivot table anchored at this cell. The size of pivot table itself
-                          # is computed dynamically based on its data, grouping, filters, values,
-                          # etc. Only the top-left cell of the pivot table contains the pivot table
-                          # definition. The other cells will contain the calculated values of the
-                          # results of the pivot in their effective_value fields.
-                        "valueLayout": "A String", # Whether values should be listed horizontally (as columns)
-                            # or vertically (as rows).
-                        "rows": [ # Each row grouping in the pivot table.
-                          { # A single grouping (either row or column) in a pivot table.
-                            "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
-                            "valueMetadata": [ # Metadata about values in the grouping.
-                              { # Metadata about a value in a pivot grouping.
-                                "collapsed": True or False, # True if the data corresponding to the value is collapsed.
-                                "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
-                                    # (Note that formulaValue is not valid,
-                                    #  because the values will be calculated.)
-                                  "numberValue": 3.14, # Represents a double value.
-                                      # Note: Dates, Times and DateTimes are represented as doubles in
-                                      # "serial number" format.
-                                  "boolValue": True or False, # Represents a boolean value.
-                                  "formulaValue": "A String", # Represents a formula.
-                                  "stringValue": "A String", # Represents a string value.
-                                      # Leading single quotes are not included. For example, if the user typed
-                                      # `'123` into the UI, this would be represented as a `stringValue` of
-                                      # `"123"`.
-                                  "errorValue": { # An error in a cell. # Represents an error.
-                                      # This field is read-only.
-                                    "message": "A String", # A message with more information about the error
-                                        # (in the spreadsheet's locale).
-                                    "type": "A String", # The type of error.
-                                  },
-                                },
-                              },
-                            ],
-                            "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
-                                # If not specified, sorting is alphabetical by this group's values.
-                              "buckets": [ # Determines the bucket from which values are chosen to sort.
-                                  #
-                                  # For example, in a pivot table with one row group & two column groups,
-                                  # the row group can list up to two values. The first value corresponds
-                                  # to a value within the first column group, and the second value
-                                  # corresponds to a value in the second column group.  If no values
-                                  # are listed, this would indicate that the row should be sorted according
-                                  # to the "Grand Total" over the column groups. If a single value is listed,
-                                  # this would correspond to using the "Total" of that bucket.
-                                { # The kinds of value that a cell in a spreadsheet can have.
-                                  "numberValue": 3.14, # Represents a double value.
-                                      # Note: Dates, Times and DateTimes are represented as doubles in
-                                      # "serial number" format.
-                                  "boolValue": True or False, # Represents a boolean value.
-                                  "formulaValue": "A String", # Represents a formula.
-                                  "stringValue": "A String", # Represents a string value.
-                                      # Leading single quotes are not included. For example, if the user typed
-                                      # `'123` into the UI, this would be represented as a `stringValue` of
-                                      # `"123"`.
-                                  "errorValue": { # An error in a cell. # Represents an error.
-                                      # This field is read-only.
-                                    "message": "A String", # A message with more information about the error
-                                        # (in the spreadsheet's locale).
-                                    "type": "A String", # The type of error.
-                                  },
-                                },
-                              ],
-                              "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
-                                  # grouping should be sorted by.
-                            },
-                            "sortOrder": "A String", # The order the values in this group should be sorted.
-                            "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
-                                #
-                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                                # means this group refers to column `C`, whereas the offset `1` would refer
-                                # to column `D`.
-                          },
-                        ],
-                        "source": { # A range on a sheet. # The range the pivot table is reading data from.
-                            # All indexes are zero-based.
-                            # Indexes are half open, e.g the start index is inclusive
-                            # and the end index is exclusive -- [start_index, end_index).
-                            # Missing indexes indicate the range is unbounded on that side.
-                            #
-                            # For example, if `"Sheet1"` is sheet ID 0, then:
-                            #
-                            #   `Sheet1!A1:A1 == sheet_id: 0,
-                            #                   start_row_index: 0, end_row_index: 1,
-                            #                   start_column_index: 0, end_column_index: 1`
-                            #
-                            #   `Sheet1!A3:B4 == sheet_id: 0,
-                            #                   start_row_index: 2, end_row_index: 4,
-                            #                   start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A:B == sheet_id: 0,
-                            #                 start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1!A5:B == sheet_id: 0,
-                            #                  start_row_index: 4,
-                            #                  start_column_index: 0, end_column_index: 2`
-                            #
-                            #   `Sheet1 == sheet_id:0`
-                            #
-                            # The start index must always be less than or equal to the end index.
-                            # If the start index equals the end index, then the range is empty.
-                            # Empty ranges are typically not meaningful and are usually rendered in the
-                            # UI as `#REF!`.
-                          "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
-                          "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
-                          "sheetId": 42, # The sheet this range is on.
-                          "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
-                          "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
-                        },
-                        "values": [ # A list of values to include in the pivot table.
-                          { # The definition of how a value in a pivot table should be calculated.
-                            "formula": "A String", # A custom formula to calculate the value.  The formula must start
-                                # with an `=` character.
-                            "summarizeFunction": "A String", # A function to summarize the value.
-                                # If formula is set, the only supported values are
-                                # SUM and
-                                # CUSTOM.
-                                # If sourceColumnOffset is set, then `CUSTOM`
-                                # is not supported.
-                            "sourceColumnOffset": 42, # The column offset of the source range that this value reads from.
-                                #
-                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                                # means this value refers to column `C`, whereas the offset `1` would
-                                # refer to column `D`.
-                            "name": "A String", # A name to use for the value. This is only used if formula was set.
-                                # Otherwise, the column name is used.
-                          },
-                        ],
-                        "criteria": { # An optional mapping of filters per source column offset.
-                            #
-                            # The filters will be applied before aggregating data into the pivot table.
-                            # The map's key is the column offset of the source range that you want to
-                            # filter, and the value is the criteria for that column.
-                            #
-                            # For example, if the source was `C10:E15`, a key of `0` will have the filter
-                            # for column `C`, whereas the key `1` is for column `D`.
-                          "a_key": { # Criteria for showing/hiding rows in a pivot table.
-                            "visibleValues": [ # Values that should be included.  Values not listed here are excluded.
-                              "A String",
-                            ],
-                          },
-                        },
-                        "columns": [ # Each column grouping in the pivot table.
-                          { # A single grouping (either row or column) in a pivot table.
-                            "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
-                            "valueMetadata": [ # Metadata about values in the grouping.
-                              { # Metadata about a value in a pivot grouping.
-                                "collapsed": True or False, # True if the data corresponding to the value is collapsed.
-                                "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
-                                    # (Note that formulaValue is not valid,
-                                    #  because the values will be calculated.)
-                                  "numberValue": 3.14, # Represents a double value.
-                                      # Note: Dates, Times and DateTimes are represented as doubles in
-                                      # "serial number" format.
-                                  "boolValue": True or False, # Represents a boolean value.
-                                  "formulaValue": "A String", # Represents a formula.
-                                  "stringValue": "A String", # Represents a string value.
-                                      # Leading single quotes are not included. For example, if the user typed
-                                      # `'123` into the UI, this would be represented as a `stringValue` of
-                                      # `"123"`.
-                                  "errorValue": { # An error in a cell. # Represents an error.
-                                      # This field is read-only.
-                                    "message": "A String", # A message with more information about the error
-                                        # (in the spreadsheet's locale).
-                                    "type": "A String", # The type of error.
-                                  },
-                                },
-                              },
-                            ],
-                            "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
-                                # If not specified, sorting is alphabetical by this group's values.
-                              "buckets": [ # Determines the bucket from which values are chosen to sort.
-                                  #
-                                  # For example, in a pivot table with one row group & two column groups,
-                                  # the row group can list up to two values. The first value corresponds
-                                  # to a value within the first column group, and the second value
-                                  # corresponds to a value in the second column group.  If no values
-                                  # are listed, this would indicate that the row should be sorted according
-                                  # to the "Grand Total" over the column groups. If a single value is listed,
-                                  # this would correspond to using the "Total" of that bucket.
-                                { # The kinds of value that a cell in a spreadsheet can have.
-                                  "numberValue": 3.14, # Represents a double value.
-                                      # Note: Dates, Times and DateTimes are represented as doubles in
-                                      # "serial number" format.
-                                  "boolValue": True or False, # Represents a boolean value.
-                                  "formulaValue": "A String", # Represents a formula.
-                                  "stringValue": "A String", # Represents a string value.
-                                      # Leading single quotes are not included. For example, if the user typed
-                                      # `'123` into the UI, this would be represented as a `stringValue` of
-                                      # `"123"`.
-                                  "errorValue": { # An error in a cell. # Represents an error.
-                                      # This field is read-only.
-                                    "message": "A String", # A message with more information about the error
-                                        # (in the spreadsheet's locale).
-                                    "type": "A String", # The type of error.
-                                  },
-                                },
-                              ],
-                              "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
-                                  # grouping should be sorted by.
-                            },
-                            "sortOrder": "A String", # The order the values in this group should be sorted.
-                            "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
-                                #
-                                # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
-                                # means this group refers to column `C`, whereas the offset `1` would refer
-                                # to column `D`.
-                          },
-                        ],
-                      },
-                      "hyperlink": "A String", # A hyperlink this cell points to, if any.
-                          # This field is read-only.  (To set it, use a `=HYPERLINK` formula.)
-                      "effectiveValue": { # The kinds of value that a cell in a spreadsheet can have. # The effective value of the cell. For cells with formulas, this will be
-                          # the calculated value.  For cells with literals, this will be
-                          # the same as the user_entered_value.
-                          # This field is read-only.
-                        "numberValue": 3.14, # Represents a double value.
-                            # Note: Dates, Times and DateTimes are represented as doubles in
-                            # "serial number" format.
-                        "boolValue": True or False, # Represents a boolean value.
-                        "formulaValue": "A String", # Represents a formula.
-                        "stringValue": "A String", # Represents a string value.
-                            # Leading single quotes are not included. For example, if the user typed
-                            # `'123` into the UI, this would be represented as a `stringValue` of
-                            # `"123"`.
-                        "errorValue": { # An error in a cell. # Represents an error.
-                            # This field is read-only.
-                          "message": "A String", # A message with more information about the error
-                              # (in the spreadsheet's locale).
-                          "type": "A String", # The type of error.
-                        },
+                  #      public static Color toProto(java.awt.Color color) {
+                  #        float red = (float) color.getRed();
+                  #        float green = (float) color.getGreen();
+                  #        float blue = (float) color.getBlue();
+                  #        float denominator = 255.0;
+                  #        Color.Builder resultBuilder =
+                  #            Color
+                  #                .newBuilder()
+                  #                .setRed(red / denominator)
+                  #                .setGreen(green / denominator)
+                  #                .setBlue(blue / denominator);
+                  #        int alpha = color.getAlpha();
+                  #        if (alpha != 255) {
+                  #          result.setAlpha(
+                  #              FloatValue
+                  #                  .newBuilder()
+                  #                  .setValue(((float) alpha) / denominator)
+                  #                  .build());
+                  #        }
+                  #        return resultBuilder.build();
+                  #      }
+                  #      // ...
+                  #
+                  # Example (iOS / Obj-C):
+                  #
+                  #      // ...
+                  #      static UIColor* fromProto(Color* protocolor) {
+                  #         float red = [protocolor red];
+                  #         float green = [protocolor green];
+                  #         float blue = [protocolor blue];
+                  #         FloatValue* alpha_wrapper = [protocolor alpha];
+                  #         float alpha = 1.0;
+                  #         if (alpha_wrapper != nil) {
+                  #           alpha = [alpha_wrapper value];
+                  #         }
+                  #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                  #      }
+                  #
+                  #      static Color* toProto(UIColor* color) {
+                  #          CGFloat red, green, blue, alpha;
+                  #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                  #            return nil;
+                  #          }
+                  #          Color* result = [Color alloc] init];
+                  #          [result setRed:red];
+                  #          [result setGreen:green];
+                  #          [result setBlue:blue];
+                  #          if (alpha <= 0.9999) {
+                  #            [result setAlpha:floatWrapperWithValue(alpha)];
+                  #          }
+                  #          [result autorelease];
+                  #          return result;
+                  #     }
+                  #     // ...
+                  #
+                  #  Example (JavaScript):
+                  #
+                  #     // ...
+                  #
+                  #     var protoToCssColor = function(rgb_color) {
+                  #        var redFrac = rgb_color.red || 0.0;
+                  #        var greenFrac = rgb_color.green || 0.0;
+                  #        var blueFrac = rgb_color.blue || 0.0;
+                  #        var red = Math.floor(redFrac * 255);
+                  #        var green = Math.floor(greenFrac * 255);
+                  #        var blue = Math.floor(blueFrac * 255);
+                  #
+                  #        if (!('alpha' in rgb_color)) {
+                  #           return rgbToCssColor_(red, green, blue);
+                  #        }
+                  #
+                  #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                  #        var rgbParams = [red, green, blue].join(',');
+                  #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                  #     };
+                  #
+                  #     var rgbToCssColor_ = function(red, green, blue) {
+                  #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                  #       var hexString = rgbNumber.toString(16);
+                  #       var missingZeros = 6 - hexString.length;
+                  #       var resultBuilder = ['#'];
+                  #       for (var i = 0; i < missingZeros; i++) {
+                  #          resultBuilder.push('0');
+                  #       }
+                  #       resultBuilder.push(hexString);
+                  #       return resultBuilder.join('');
+                  #     };
+                  #
+                  #     // ...
+                "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                    # the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color. This
+                    # uses a wrapper message rather than a simple float scalar so that it is
+                    # possible to distinguish between a default value and the value being unset.
+                    # If omitted, this color object is to be rendered as a solid color
+                    # (as if the alpha value had been explicitly given with a value of 1.0).
+                "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+              },
+            },
+            "bandedRangeId": 42, # The id of the banded range.
+          },
+        ],
+        "merges": [ # The ranges that are merged together.
+          { # A range on a sheet.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+        ],
+        "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any.
+          "range": { # A range on a sheet. # The range the filter covers.
+              # All indexes are zero-based.
+              # Indexes are half open, e.g the start index is inclusive
+              # and the end index is exclusive -- [start_index, end_index).
+              # Missing indexes indicate the range is unbounded on that side.
+              #
+              # For example, if `"Sheet1"` is sheet ID 0, then:
+              #
+              #   `Sheet1!A1:A1 == sheet_id: 0,
+              #                   start_row_index: 0, end_row_index: 1,
+              #                   start_column_index: 0, end_column_index: 1`
+              #
+              #   `Sheet1!A3:B4 == sheet_id: 0,
+              #                   start_row_index: 2, end_row_index: 4,
+              #                   start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A:B == sheet_id: 0,
+              #                 start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1!A5:B == sheet_id: 0,
+              #                  start_row_index: 4,
+              #                  start_column_index: 0, end_column_index: 2`
+              #
+              #   `Sheet1 == sheet_id:0`
+              #
+              # The start index must always be less than or equal to the end index.
+              # If the start index equals the end index, then the range is empty.
+              # Empty ranges are typically not meaningful and are usually rendered in the
+              # UI as `#REF!`.
+            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+            "sheetId": 42, # The sheet this range is on.
+            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+          },
+          "sortSpecs": [ # The sort order per column. Later specifications are used when values
+              # are equal in the earlier specifications.
+            { # A sort order associated with a specific column or row.
+              "sortOrder": "A String", # The order data should be sorted.
+              "dimensionIndex": 42, # The dimension the sort should be applied to.
+            },
+          ],
+          "criteria": { # The criteria for showing/hiding values per column.
+              # The map's key is the column index, and the value is the criteria for
+              # that column.
+            "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+              "hiddenValues": [ # Values that should be hidden.
+                "A String",
+              ],
+              "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                  # (This does not override hiddenValues -- if a value is listed there,
+                  #  it will still be hidden.)
+                  # BooleanConditions are used by conditional formatting,
+                  # data validation, and the criteria in filters.
+                "type": "A String", # The type of condition.
+                "values": [ # The values of the condition. The number of supported values depends
+                    # on the condition type.  Some support zero values,
+                    # others one or two values,
+                    # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                  { # The value of the condition.
+                    "relativeDate": "A String", # A relative date (based on the current date).
+                        # Valid only if the type is
+                        # DATE_BEFORE,
+                        # DATE_AFTER,
+                        # DATE_ON_OR_BEFORE or
+                        # DATE_ON_OR_AFTER.
+                        #
+                        # Relative dates are not supported in data validation.
+                        # They are supported only in conditional formatting and
+                        # conditional filters.
+                    "userEnteredValue": "A String", # A value the condition is based on.
+                        # The value will be parsed as if the user typed into a cell.
+                        # Formulas are supported (and must begin with an `=`).
+                  },
+                ],
+              },
+            },
+          },
+        },
+        "charts": [ # The specifications of every chart on this sheet.
+          { # A chart embedded in a sheet.
+            "chartId": 42, # The ID of the chart.
+            "position": { # The position of an embedded object such as a chart. # The position of the chart.
+              "newSheet": True or False, # If true, the embedded object will be put on a new sheet whose ID
+                  # is chosen for you. Used only when writing.
+              "sheetId": 42, # The sheet this is on. Set only if the embedded object
+                  # is on its own sheet. Must be non-negative.
+              "overlayPosition": { # The location an object is overlaid on top of a grid. # The position at which the object is overlaid on top of a grid.
+                "anchorCell": { # A coordinate in a sheet. # The cell the object is anchored to.
+                    # All indexes are zero-based.
+                  "rowIndex": 42, # The row index of the coordinate.
+                  "columnIndex": 42, # The column index of the coordinate.
+                  "sheetId": 42, # The sheet this coordinate is on.
+                },
+                "offsetYPixels": 42, # The vertical offset, in pixels, that the object is offset
+                    # from the anchor cell.
+                "widthPixels": 42, # The width of the object, in pixels. Defaults to 600.
+                "offsetXPixels": 42, # The horizontal offset, in pixels, that the object is offset
+                    # from the anchor cell.
+                "heightPixels": 42, # The height of the object, in pixels. Defaults to 371.
+              },
+            },
+            "spec": { # The specifications of a chart. # The specification of the chart.
+              "hiddenDimensionStrategy": "A String", # Determines how the charts will use hidden rows or columns.
+              "pieChart": { # A <a href="/chart/interactive/docs/gallery/piechart">pie chart</a>. # A pie chart specification.
+                "series": { # The data included in a domain or series. # The data that covers the one and only series of the pie chart.
+                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                    "sources": [ # The ranges of data for a series or domain.
+                        # Exactly one dimension must have a length of 1,
+                        # and all sources in the list must have the same dimension
+                        # with length 1.
+                        # The domain (if it exists) & all series must have the same number
+                        # of source ranges. If using more than one source range, then the source
+                        # range at a given offset must be contiguous across the domain and series.
+                        #
+                        # For example, these are valid configurations:
+                        #
+                        #     domain sources: A1:A5
+                        #     series1 sources: B1:B5
+                        #     series2 sources: D6:D10
+                        #
+                        #     domain sources: A1:A5, C10:C12
+                        #     series1 sources: B1:B5, D10:D12
+                        #     series2 sources: C1:C5, E10:E12
+                      { # A range on a sheet.
+                          # All indexes are zero-based.
+                          # Indexes are half open, e.g the start index is inclusive
+                          # and the end index is exclusive -- [start_index, end_index).
+                          # Missing indexes indicate the range is unbounded on that side.
+                          #
+                          # For example, if `"Sheet1"` is sheet ID 0, then:
+                          #
+                          #   `Sheet1!A1:A1 == sheet_id: 0,
+                          #                   start_row_index: 0, end_row_index: 1,
+                          #                   start_column_index: 0, end_column_index: 1`
+                          #
+                          #   `Sheet1!A3:B4 == sheet_id: 0,
+                          #                   start_row_index: 2, end_row_index: 4,
+                          #                   start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A:B == sheet_id: 0,
+                          #                 start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A5:B == sheet_id: 0,
+                          #                  start_row_index: 4,
+                          #                  start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1 == sheet_id:0`
+                          #
+                          # The start index must always be less than or equal to the end index.
+                          # If the start index equals the end index, then the range is empty.
+                          # Empty ranges are typically not meaningful and are usually rendered in the
+                          # UI as `#REF!`.
+                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                        "sheetId": 42, # The sheet this range is on.
+                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
                       },
-                      "formattedValue": "A String", # The formatted value of the cell.
-                          # This is the value as it's shown to the user.
-                          # This field is read-only.
-                      "userEnteredValue": { # The kinds of value that a cell in a spreadsheet can have. # The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`
-                          # Note: Dates, Times and DateTimes are represented as doubles in
-                          # serial number format.
-                        "numberValue": 3.14, # Represents a double value.
-                            # Note: Dates, Times and DateTimes are represented as doubles in
-                            # "serial number" format.
-                        "boolValue": True or False, # Represents a boolean value.
-                        "formulaValue": "A String", # Represents a formula.
-                        "stringValue": "A String", # Represents a string value.
-                            # Leading single quotes are not included. For example, if the user typed
-                            # `'123` into the UI, this would be represented as a `stringValue` of
-                            # `"123"`.
-                        "errorValue": { # An error in a cell. # Represents an error.
-                            # This field is read-only.
-                          "message": "A String", # A message with more information about the error
-                              # (in the spreadsheet's locale).
-                          "type": "A String", # The type of error.
-                        },
+                    ],
+                  },
+                },
+                "domain": { # The data included in a domain or series. # The data that covers the domain of the pie chart.
+                  "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                    "sources": [ # The ranges of data for a series or domain.
+                        # Exactly one dimension must have a length of 1,
+                        # and all sources in the list must have the same dimension
+                        # with length 1.
+                        # The domain (if it exists) & all series must have the same number
+                        # of source ranges. If using more than one source range, then the source
+                        # range at a given offset must be contiguous across the domain and series.
+                        #
+                        # For example, these are valid configurations:
+                        #
+                        #     domain sources: A1:A5
+                        #     series1 sources: B1:B5
+                        #     series2 sources: D6:D10
+                        #
+                        #     domain sources: A1:A5, C10:C12
+                        #     series1 sources: B1:B5, D10:D12
+                        #     series2 sources: C1:C5, E10:E12
+                      { # A range on a sheet.
+                          # All indexes are zero-based.
+                          # Indexes are half open, e.g the start index is inclusive
+                          # and the end index is exclusive -- [start_index, end_index).
+                          # Missing indexes indicate the range is unbounded on that side.
+                          #
+                          # For example, if `"Sheet1"` is sheet ID 0, then:
+                          #
+                          #   `Sheet1!A1:A1 == sheet_id: 0,
+                          #                   start_row_index: 0, end_row_index: 1,
+                          #                   start_column_index: 0, end_column_index: 1`
+                          #
+                          #   `Sheet1!A3:B4 == sheet_id: 0,
+                          #                   start_row_index: 2, end_row_index: 4,
+                          #                   start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A:B == sheet_id: 0,
+                          #                 start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A5:B == sheet_id: 0,
+                          #                  start_row_index: 4,
+                          #                  start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1 == sheet_id:0`
+                          #
+                          # The start index must always be less than or equal to the end index.
+                          # If the start index equals the end index, then the range is empty.
+                          # Empty ranges are typically not meaningful and are usually rendered in the
+                          # UI as `#REF!`.
+                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                        "sheetId": 42, # The sheet this range is on.
+                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
                       },
-                      "note": "A String", # Any note on the cell.
-                      "effectiveFormat": { # The format of a cell. # The effective format being used by the cell.
-                          # This includes the results of applying any conditional formatting and,
-                          # if the cell contains a formula, the computed number format.
-                          # If the effective format is the default format, effective format will
-                          # not be written.
-                          # This field is read-only.
-                        "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                          "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                              # the user's locale will be used if necessary for the given type.
-                              # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                              # information about the supported patterns.
-                          "type": "A String", # The type of the number format.
-                              # When writing, this field must be set.
-                        },
-                        "textDirection": "A String", # The direction of the text in the cell.
-                        "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                            # When updating padding, every field must be specified.
-                          "top": 42, # The top padding of the cell.
-                          "right": 42, # The right padding of the cell.
-                          "bottom": 42, # The bottom padding of the cell.
-                          "left": 42, # The left padding of the cell.
-                        },
-                        "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                        "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
-                            # for simplicity of conversion to/from color representations in various
-                            # languages over compactness; for example, the fields of this representation
-                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                            # method in iOS; and, with just a little work, it can be easily formatted into
-                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                            #
-                            # Example (Java):
-                            #
-                            #      import com.google.type.Color;
-                            #
-                            #      // ...
-                            #      public static java.awt.Color fromProto(Color protocolor) {
-                            #        float alpha = protocolor.hasAlpha()
-                            #            ? protocolor.getAlpha().getValue()
-                            #            : 1.0;
-                            #
-                            #        return new java.awt.Color(
-                            #            protocolor.getRed(),
-                            #            protocolor.getGreen(),
-                            #            protocolor.getBlue(),
-                            #            alpha);
-                            #      }
-                            #
-                            #      public static Color toProto(java.awt.Color color) {
-                            #        float red = (float) color.getRed();
-                            #        float green = (float) color.getGreen();
-                            #        float blue = (float) color.getBlue();
-                            #        float denominator = 255.0;
-                            #        Color.Builder resultBuilder =
-                            #            Color
-                            #                .newBuilder()
-                            #                .setRed(red / denominator)
-                            #                .setGreen(green / denominator)
-                            #                .setBlue(blue / denominator);
-                            #        int alpha = color.getAlpha();
-                            #        if (alpha != 255) {
-                            #          result.setAlpha(
-                            #              FloatValue
-                            #                  .newBuilder()
-                            #                  .setValue(((float) alpha) / denominator)
-                            #                  .build());
-                            #        }
-                            #        return resultBuilder.build();
-                            #      }
-                            #      // ...
-                            #
-                            # Example (iOS / Obj-C):
-                            #
-                            #      // ...
-                            #      static UIColor* fromProto(Color* protocolor) {
-                            #         float red = [protocolor red];
-                            #         float green = [protocolor green];
-                            #         float blue = [protocolor blue];
-                            #         FloatValue* alpha_wrapper = [protocolor alpha];
-                            #         float alpha = 1.0;
-                            #         if (alpha_wrapper != nil) {
-                            #           alpha = [alpha_wrapper value];
-                            #         }
-                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                            #      }
-                            #
-                            #      static Color* toProto(UIColor* color) {
-                            #          CGFloat red, green, blue, alpha;
-                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                            #            return nil;
-                            #          }
-                            #          Color* result = [Color alloc] init];
-                            #          [result setRed:red];
-                            #          [result setGreen:green];
-                            #          [result setBlue:blue];
-                            #          if (alpha <= 0.9999) {
-                            #            [result setAlpha:floatWrapperWithValue(alpha)];
-                            #          }
-                            #          [result autorelease];
-                            #          return result;
-                            #     }
-                            #     // ...
-                            #
-                            #  Example (JavaScript):
-                            #
-                            #     // ...
-                            #
-                            #     var protoToCssColor = function(rgb_color) {
-                            #        var redFrac = rgb_color.red || 0.0;
-                            #        var greenFrac = rgb_color.green || 0.0;
-                            #        var blueFrac = rgb_color.blue || 0.0;
-                            #        var red = Math.floor(redFrac * 255);
-                            #        var green = Math.floor(greenFrac * 255);
-                            #        var blue = Math.floor(blueFrac * 255);
-                            #
-                            #        if (!('alpha' in rgb_color)) {
-                            #           return rgbToCssColor_(red, green, blue);
-                            #        }
+                    ],
+                  },
+                },
+                "threeDimensional": True or False, # True if the pie is three dimensional.
+                "legendPosition": "A String", # Where the legend of the pie chart should be drawn.
+                "pieHole": 3.14, # The size of the hole in the pie chart.
+              },
+              "basicChart": { # The specification for a basic chart.  See BasicChartType for the list # A basic chart specification, can be one of many kinds of charts.
+                  # See BasicChartType for the list of all
+                  # charts this supports.
+                  # of charts this supports.
+                "headerCount": 42, # The number of rows or columns in the data that are "headers".
+                    # If not set, Google Sheets will guess how many rows are headers based
+                    # on the data.
+                    #
+                    # (Note that BasicChartAxis.title may override the axis title
+                    #  inferred from the header values.)
+                "series": [ # The data this chart is visualizing.
+                  { # A single series of data in a chart.
+                      # For example, if charting stock prices over time, multiple series may exist,
+                      # one for the "Open Price", "High Price", "Low Price" and "Close Price".
+                    "series": { # The data included in a domain or series. # The data being visualized in this chart series.
+                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                        "sources": [ # The ranges of data for a series or domain.
+                            # Exactly one dimension must have a length of 1,
+                            # and all sources in the list must have the same dimension
+                            # with length 1.
+                            # The domain (if it exists) & all series must have the same number
+                            # of source ranges. If using more than one source range, then the source
+                            # range at a given offset must be contiguous across the domain and series.
                             #
-                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                            #        var rgbParams = [red, green, blue].join(',');
-                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                            #     };
+                            # For example, these are valid configurations:
                             #
-                            #     var rgbToCssColor_ = function(red, green, blue) {
-                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                            #       var hexString = rgbNumber.toString(16);
-                            #       var missingZeros = 6 - hexString.length;
-                            #       var resultBuilder = ['#'];
-                            #       for (var i = 0; i < missingZeros; i++) {
-                            #          resultBuilder.push('0');
-                            #       }
-                            #       resultBuilder.push(hexString);
-                            #       return resultBuilder.join('');
-                            #     };
+                            #     domain sources: A1:A5
+                            #     series1 sources: B1:B5
+                            #     series2 sources: D6:D10
                             #
-                            #     // ...
-                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                              # the final pixel color is defined by the equation:
-                              #
-                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                              #
-                              # This means that a value of 1.0 corresponds to a solid color, whereas
-                              # a value of 0.0 corresponds to a completely transparent color. This
-                              # uses a wrapper message rather than a simple float scalar so that it is
-                              # possible to distinguish between a default value and the value being unset.
-                              # If omitted, this color object is to be rendered as a solid color
-                              # (as if the alpha value had been explicitly given with a value of 1.0).
-                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                        },
-                        "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                        "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                            # Absent values indicate that the field isn't specified.
-                          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                              # for simplicity of conversion to/from color representations in various
-                              # languages over compactness; for example, the fields of this representation
-                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                              # method in iOS; and, with just a little work, it can be easily formatted into
-                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                              #
-                              # Example (Java):
-                              #
-                              #      import com.google.type.Color;
-                              #
-                              #      // ...
-                              #      public static java.awt.Color fromProto(Color protocolor) {
-                              #        float alpha = protocolor.hasAlpha()
-                              #            ? protocolor.getAlpha().getValue()
-                              #            : 1.0;
-                              #
-                              #        return new java.awt.Color(
-                              #            protocolor.getRed(),
-                              #            protocolor.getGreen(),
-                              #            protocolor.getBlue(),
-                              #            alpha);
-                              #      }
-                              #
-                              #      public static Color toProto(java.awt.Color color) {
-                              #        float red = (float) color.getRed();
-                              #        float green = (float) color.getGreen();
-                              #        float blue = (float) color.getBlue();
-                              #        float denominator = 255.0;
-                              #        Color.Builder resultBuilder =
-                              #            Color
-                              #                .newBuilder()
-                              #                .setRed(red / denominator)
-                              #                .setGreen(green / denominator)
-                              #                .setBlue(blue / denominator);
-                              #        int alpha = color.getAlpha();
-                              #        if (alpha != 255) {
-                              #          result.setAlpha(
-                              #              FloatValue
-                              #                  .newBuilder()
-                              #                  .setValue(((float) alpha) / denominator)
-                              #                  .build());
-                              #        }
-                              #        return resultBuilder.build();
-                              #      }
-                              #      // ...
-                              #
-                              # Example (iOS / Obj-C):
-                              #
-                              #      // ...
-                              #      static UIColor* fromProto(Color* protocolor) {
-                              #         float red = [protocolor red];
-                              #         float green = [protocolor green];
-                              #         float blue = [protocolor blue];
-                              #         FloatValue* alpha_wrapper = [protocolor alpha];
-                              #         float alpha = 1.0;
-                              #         if (alpha_wrapper != nil) {
-                              #           alpha = [alpha_wrapper value];
-                              #         }
-                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                              #      }
-                              #
-                              #      static Color* toProto(UIColor* color) {
-                              #          CGFloat red, green, blue, alpha;
-                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                              #            return nil;
-                              #          }
-                              #          Color* result = [Color alloc] init];
-                              #          [result setRed:red];
-                              #          [result setGreen:green];
-                              #          [result setBlue:blue];
-                              #          if (alpha <= 0.9999) {
-                              #            [result setAlpha:floatWrapperWithValue(alpha)];
-                              #          }
-                              #          [result autorelease];
-                              #          return result;
-                              #     }
-                              #     // ...
+                            #     domain sources: A1:A5, C10:C12
+                            #     series1 sources: B1:B5, D10:D12
+                            #     series2 sources: C1:C5, E10:E12
+                          { # A range on a sheet.
+                              # All indexes are zero-based.
+                              # Indexes are half open, e.g the start index is inclusive
+                              # and the end index is exclusive -- [start_index, end_index).
+                              # Missing indexes indicate the range is unbounded on that side.
                               #
-                              #  Example (JavaScript):
+                              # For example, if `"Sheet1"` is sheet ID 0, then:
                               #
-                              #     // ...
+                              #   `Sheet1!A1:A1 == sheet_id: 0,
+                              #                   start_row_index: 0, end_row_index: 1,
+                              #                   start_column_index: 0, end_column_index: 1`
                               #
-                              #     var protoToCssColor = function(rgb_color) {
-                              #        var redFrac = rgb_color.red || 0.0;
-                              #        var greenFrac = rgb_color.green || 0.0;
-                              #        var blueFrac = rgb_color.blue || 0.0;
-                              #        var red = Math.floor(redFrac * 255);
-                              #        var green = Math.floor(greenFrac * 255);
-                              #        var blue = Math.floor(blueFrac * 255);
+                              #   `Sheet1!A3:B4 == sheet_id: 0,
+                              #                   start_row_index: 2, end_row_index: 4,
+                              #                   start_column_index: 0, end_column_index: 2`
                               #
-                              #        if (!('alpha' in rgb_color)) {
-                              #           return rgbToCssColor_(red, green, blue);
-                              #        }
+                              #   `Sheet1!A:B == sheet_id: 0,
+                              #                 start_column_index: 0, end_column_index: 2`
                               #
-                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                              #        var rgbParams = [red, green, blue].join(',');
-                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                              #     };
+                              #   `Sheet1!A5:B == sheet_id: 0,
+                              #                  start_row_index: 4,
+                              #                  start_column_index: 0, end_column_index: 2`
                               #
-                              #     var rgbToCssColor_ = function(red, green, blue) {
-                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                              #       var hexString = rgbNumber.toString(16);
-                              #       var missingZeros = 6 - hexString.length;
-                              #       var resultBuilder = ['#'];
-                              #       for (var i = 0; i < missingZeros; i++) {
-                              #          resultBuilder.push('0');
-                              #       }
-                              #       resultBuilder.push(hexString);
-                              #       return resultBuilder.join('');
-                              #     };
+                              #   `Sheet1 == sheet_id:0`
                               #
-                              #     // ...
-                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                # the final pixel color is defined by the equation:
-                                #
-                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                #
-                                # This means that a value of 1.0 corresponds to a solid color, whereas
-                                # a value of 0.0 corresponds to a completely transparent color. This
-                                # uses a wrapper message rather than a simple float scalar so that it is
-                                # possible to distinguish between a default value and the value being unset.
-                                # If omitted, this color object is to be rendered as a solid color
-                                # (as if the alpha value had been explicitly given with a value of 1.0).
-                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                          },
-                          "bold": True or False, # True if the text is bold.
-                          "strikethrough": True or False, # True if the text has a strikethrough.
-                          "fontFamily": "A String", # The font family.
-                          "fontSize": 42, # The size of the font.
-                          "italic": True or False, # True if the text is italicized.
-                          "underline": True or False, # True if the text is underlined.
-                        },
-                        "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                        "borders": { # The borders of the cell. # The borders of the cell.
-                          "top": { # A border along a cell. # The top border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
+                              # The start index must always be less than or equal to the end index.
+                              # If the start index equals the end index, then the range is empty.
+                              # Empty ranges are typically not meaningful and are usually rendered in the
+                              # UI as `#REF!`.
+                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                            "sheetId": 42, # The sheet this range is on.
+                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
                           },
-                          "right": { # A border along a cell. # The right border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
+                        ],
+                      },
+                    },
+                    "targetAxis": "A String", # The minor axis that will specify the range of values for this series.
+                        # For example, if charting stocks over time, the "Volume" series
+                        # may want to be pinned to the right with the prices pinned to the left,
+                        # because the scale of trading volume is different than the scale of
+                        # prices.
+                        # It is an error to specify an axis that isn't a valid minor axis
+                        # for the chart's type.
+                    "type": "A String", # The type of this series. Valid only if the
+                        # chartType is
+                        # COMBO.
+                        # Different types will change the way the series is visualized.
+                        # Only LINE, AREA,
+                        # and COLUMN are supported.
+                  },
+                ],
+                "legendPosition": "A String", # The position of the chart legend.
+                "domains": [ # The domain of data this is charting.
+                    # Only a single domain is currently supported.
+                  { # The domain of a chart.
+                      # For example, if charting stock prices over time, this would be the date.
+                    "domain": { # The data included in a domain or series. # The data of the domain. For example, if charting stock prices over time,
+                        # this is the data representing the dates.
+                      "sourceRange": { # Source ranges for a chart. # The source ranges of the data.
+                        "sources": [ # The ranges of data for a series or domain.
+                            # Exactly one dimension must have a length of 1,
+                            # and all sources in the list must have the same dimension
+                            # with length 1.
+                            # The domain (if it exists) & all series must have the same number
+                            # of source ranges. If using more than one source range, then the source
+                            # range at a given offset must be contiguous across the domain and series.
+                            #
+                            # For example, these are valid configurations:
+                            #
+                            #     domain sources: A1:A5
+                            #     series1 sources: B1:B5
+                            #     series2 sources: D6:D10
+                            #
+                            #     domain sources: A1:A5, C10:C12
+                            #     series1 sources: B1:B5, D10:D12
+                            #     series2 sources: C1:C5, E10:E12
+                          { # A range on a sheet.
+                              # All indexes are zero-based.
+                              # Indexes are half open, e.g the start index is inclusive
+                              # and the end index is exclusive -- [start_index, end_index).
+                              # Missing indexes indicate the range is unbounded on that side.
+                              #
+                              # For example, if `"Sheet1"` is sheet ID 0, then:
+                              #
+                              #   `Sheet1!A1:A1 == sheet_id: 0,
+                              #                   start_row_index: 0, end_row_index: 1,
+                              #                   start_column_index: 0, end_column_index: 1`
+                              #
+                              #   `Sheet1!A3:B4 == sheet_id: 0,
+                              #                   start_row_index: 2, end_row_index: 4,
+                              #                   start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A:B == sheet_id: 0,
+                              #                 start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1!A5:B == sheet_id: 0,
+                              #                  start_row_index: 4,
+                              #                  start_column_index: 0, end_column_index: 2`
+                              #
+                              #   `Sheet1 == sheet_id:0`
+                              #
+                              # The start index must always be less than or equal to the end index.
+                              # If the start index equals the end index, then the range is empty.
+                              # Empty ranges are typically not meaningful and are usually rendered in the
+                              # UI as `#REF!`.
+                            "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                            "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                            "sheetId": 42, # The sheet this range is on.
+                            "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                            "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
                           },
-                          "bottom": { # A border along a cell. # The bottom border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        ],
+                      },
+                    },
+                  },
+                ],
+                "chartType": "A String", # The type of the chart.
+                "axis": [ # The axis on the chart.
+                  { # An axis of the chart.
+                      # A chart may not have more than one axis per
+                      # axis position.
+                    "position": "A String", # The position of this axis.
+                    "format": { # The format of a run of text in a cell. # The format of the title.
+                        # Only valid if the axis is not associated with the domain.
+                        # Absent values indicate that the field isn't specified.
+                      "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                          # for simplicity of conversion to/from color representations in various
+                          # languages over compactness; for example, the fields of this representation
+                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                          # method in iOS; and, with just a little work, it can be easily formatted into
+                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                          #
+                          # Example (Java):
+                          #
+                          #      import com.google.type.Color;
+                          #
+                          #      // ...
+                          #      public static java.awt.Color fromProto(Color protocolor) {
+                          #        float alpha = protocolor.hasAlpha()
+                          #            ? protocolor.getAlpha().getValue()
+                          #            : 1.0;
+                          #
+                          #        return new java.awt.Color(
+                          #            protocolor.getRed(),
+                          #            protocolor.getGreen(),
+                          #            protocolor.getBlue(),
+                          #            alpha);
+                          #      }
+                          #
+                          #      public static Color toProto(java.awt.Color color) {
+                          #        float red = (float) color.getRed();
+                          #        float green = (float) color.getGreen();
+                          #        float blue = (float) color.getBlue();
+                          #        float denominator = 255.0;
+                          #        Color.Builder resultBuilder =
+                          #            Color
+                          #                .newBuilder()
+                          #                .setRed(red / denominator)
+                          #                .setGreen(green / denominator)
+                          #                .setBlue(blue / denominator);
+                          #        int alpha = color.getAlpha();
+                          #        if (alpha != 255) {
+                          #          result.setAlpha(
+                          #              FloatValue
+                          #                  .newBuilder()
+                          #                  .setValue(((float) alpha) / denominator)
+                          #                  .build());
+                          #        }
+                          #        return resultBuilder.build();
+                          #      }
+                          #      // ...
+                          #
+                          # Example (iOS / Obj-C):
+                          #
+                          #      // ...
+                          #      static UIColor* fromProto(Color* protocolor) {
+                          #         float red = [protocolor red];
+                          #         float green = [protocolor green];
+                          #         float blue = [protocolor blue];
+                          #         FloatValue* alpha_wrapper = [protocolor alpha];
+                          #         float alpha = 1.0;
+                          #         if (alpha_wrapper != nil) {
+                          #           alpha = [alpha_wrapper value];
+                          #         }
+                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                          #      }
+                          #
+                          #      static Color* toProto(UIColor* color) {
+                          #          CGFloat red, green, blue, alpha;
+                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                          #            return nil;
+                          #          }
+                          #          Color* result = [Color alloc] init];
+                          #          [result setRed:red];
+                          #          [result setGreen:green];
+                          #          [result setBlue:blue];
+                          #          if (alpha <= 0.9999) {
+                          #            [result setAlpha:floatWrapperWithValue(alpha)];
+                          #          }
+                          #          [result autorelease];
+                          #          return result;
+                          #     }
+                          #     // ...
+                          #
+                          #  Example (JavaScript):
+                          #
+                          #     // ...
+                          #
+                          #     var protoToCssColor = function(rgb_color) {
+                          #        var redFrac = rgb_color.red || 0.0;
+                          #        var greenFrac = rgb_color.green || 0.0;
+                          #        var blueFrac = rgb_color.blue || 0.0;
+                          #        var red = Math.floor(redFrac * 255);
+                          #        var green = Math.floor(greenFrac * 255);
+                          #        var blue = Math.floor(blueFrac * 255);
+                          #
+                          #        if (!('alpha' in rgb_color)) {
+                          #           return rgbToCssColor_(red, green, blue);
+                          #        }
+                          #
+                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                          #        var rgbParams = [red, green, blue].join(',');
+                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                          #     };
+                          #
+                          #     var rgbToCssColor_ = function(red, green, blue) {
+                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                          #       var hexString = rgbNumber.toString(16);
+                          #       var missingZeros = 6 - hexString.length;
+                          #       var resultBuilder = ['#'];
+                          #       for (var i = 0; i < missingZeros; i++) {
+                          #          resultBuilder.push('0');
+                          #       }
+                          #       resultBuilder.push(hexString);
+                          #       return resultBuilder.join('');
+                          #     };
+                          #
+                          #     // ...
+                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                            # the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color. This
+                            # uses a wrapper message rather than a simple float scalar so that it is
+                            # possible to distinguish between a default value and the value being unset.
+                            # If omitted, this color object is to be rendered as a solid color
+                            # (as if the alpha value had been explicitly given with a value of 1.0).
+                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                      },
+                      "bold": True or False, # True if the text is bold.
+                      "strikethrough": True or False, # True if the text has a strikethrough.
+                      "fontFamily": "A String", # The font family.
+                      "fontSize": 42, # The size of the font.
+                      "italic": True or False, # True if the text is italicized.
+                      "underline": True or False, # True if the text is underlined.
+                    },
+                    "title": "A String", # The title of this axis. If set, this overrides any title inferred
+                        # from headers of the data.
+                  },
+                ],
+              },
+              "title": "A String", # The title of the chart.
+            },
+          },
+        ],
+        "filterViews": [ # The filter views in this sheet.
+          { # A filter view.
+            "title": "A String", # The name of the filter view.
+            "namedRangeId": "A String", # The named range this filter view is backed by, if any.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "filterViewId": 42, # The ID of the filter view.
+            "range": { # A range on a sheet. # The range this filter view covers.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+            "sortSpecs": [ # The sort order per column. Later specifications are used when values
+                # are equal in the earlier specifications.
+              { # A sort order associated with a specific column or row.
+                "sortOrder": "A String", # The order data should be sorted.
+                "dimensionIndex": 42, # The dimension the sort should be applied to.
+              },
+            ],
+            "criteria": { # The criteria for showing/hiding values per column.
+                # The map's key is the column index, and the value is the criteria for
+                # that column.
+              "a_key": { # Criteria for showing/hiding rows in a filter or filter view.
+                "hiddenValues": [ # Values that should be hidden.
+                  "A String",
+                ],
+                "condition": { # A condition that can evaluate to true or false. # A condition that must be true for values to be shown.
+                    # (This does not override hiddenValues -- if a value is listed there,
+                    #  it will still be hidden.)
+                    # BooleanConditions are used by conditional formatting,
+                    # data validation, and the criteria in filters.
+                  "type": "A String", # The type of condition.
+                  "values": [ # The values of the condition. The number of supported values depends
+                      # on the condition type.  Some support zero values,
+                      # others one or two values,
+                      # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                    { # The value of the condition.
+                      "relativeDate": "A String", # A relative date (based on the current date).
+                          # Valid only if the type is
+                          # DATE_BEFORE,
+                          # DATE_AFTER,
+                          # DATE_ON_OR_BEFORE or
+                          # DATE_ON_OR_AFTER.
+                          #
+                          # Relative dates are not supported in data validation.
+                          # They are supported only in conditional formatting and
+                          # conditional filters.
+                      "userEnteredValue": "A String", # A value the condition is based on.
+                          # The value will be parsed as if the user typed into a cell.
+                          # Formulas are supported (and must begin with an `=`).
+                    },
+                  ],
+                },
+              },
+            },
+          },
+        ],
+        "protectedRanges": [ # The protected ranges in this sheet.
+          { # A protected range.
+            "unprotectedRanges": [ # The list of unprotected ranges within a protected sheet.
+                # Unprotected ranges are only supported on protected sheets.
+              { # A range on a sheet.
+                  # All indexes are zero-based.
+                  # Indexes are half open, e.g the start index is inclusive
+                  # and the end index is exclusive -- [start_index, end_index).
+                  # Missing indexes indicate the range is unbounded on that side.
+                  #
+                  # For example, if `"Sheet1"` is sheet ID 0, then:
+                  #
+                  #   `Sheet1!A1:A1 == sheet_id: 0,
+                  #                   start_row_index: 0, end_row_index: 1,
+                  #                   start_column_index: 0, end_column_index: 1`
+                  #
+                  #   `Sheet1!A3:B4 == sheet_id: 0,
+                  #                   start_row_index: 2, end_row_index: 4,
+                  #                   start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A:B == sheet_id: 0,
+                  #                 start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1!A5:B == sheet_id: 0,
+                  #                  start_row_index: 4,
+                  #                  start_column_index: 0, end_column_index: 2`
+                  #
+                  #   `Sheet1 == sheet_id:0`
+                  #
+                  # The start index must always be less than or equal to the end index.
+                  # If the start index equals the end index, then the range is empty.
+                  # Empty ranges are typically not meaningful and are usually rendered in the
+                  # UI as `#REF!`.
+                "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                "sheetId": 42, # The sheet this range is on.
+                "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+              },
+            ],
+            "requestingUserCanEdit": True or False, # True if the user who requested this protected range can edit the
+                # protected area.
+                # This field is read-only.
+            "description": "A String", # The description of this protected range.
+            "namedRangeId": "A String", # The named range this protected range is backed by, if any.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+            "editors": { # The editors of a protected range. # The users and groups with edit access to the protected range.
+                # This field is only visible to users with edit access to the protected
+                # range and the document.
+                # Editors are not supported with warning_only protection.
+              "domainUsersCanEdit": True or False, # True if anyone in the document's domain has edit access to the protected
+                  # range.  Domain protection is only supported on documents within a domain.
+              "users": [ # The email addresses of users with edit access to the protected range.
+                "A String",
+              ],
+              "groups": [ # The email addresses of groups with edit access to the protected range.
+                "A String",
+              ],
+            },
+            "protectedRangeId": 42, # The ID of the protected range.
+                # This field is read-only.
+            "warningOnly": True or False, # True if this protected range will show a warning when editing.
+                # Warning-based protection means that every user can edit data in the
+                # protected range, except editing will prompt a warning asking the user
+                # to confirm the edit.
+                #
+                # When writing: if this field is true, then editors is ignored.
+                # Additionally, if this field is changed from true to false and the
+                # `editors` field is not set (nor included in the field mask), then
+                # the editors will be set to all the editors in the document.
+            "range": { # A range on a sheet. # The range that is being protected.
+                # The range may be fully unbounded, in which case this is considered
+                # a protected sheet.
+                #
+                # When writing, only one of range or named_range_id
+                # may be set.
+                # All indexes are zero-based.
+                # Indexes are half open, e.g the start index is inclusive
+                # and the end index is exclusive -- [start_index, end_index).
+                # Missing indexes indicate the range is unbounded on that side.
+                #
+                # For example, if `"Sheet1"` is sheet ID 0, then:
+                #
+                #   `Sheet1!A1:A1 == sheet_id: 0,
+                #                   start_row_index: 0, end_row_index: 1,
+                #                   start_column_index: 0, end_column_index: 1`
+                #
+                #   `Sheet1!A3:B4 == sheet_id: 0,
+                #                   start_row_index: 2, end_row_index: 4,
+                #                   start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A:B == sheet_id: 0,
+                #                 start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1!A5:B == sheet_id: 0,
+                #                  start_row_index: 4,
+                #                  start_column_index: 0, end_column_index: 2`
+                #
+                #   `Sheet1 == sheet_id:0`
+                #
+                # The start index must always be less than or equal to the end index.
+                # If the start index equals the end index, then the range is empty.
+                # Empty ranges are typically not meaningful and are usually rendered in the
+                # UI as `#REF!`.
+              "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+              "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+              "sheetId": 42, # The sheet this range is on.
+              "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+              "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+            },
+          },
+        ],
+        "data": [ # Data in the grid, if this is a grid sheet.
+            # The number of GridData objects returned is dependent on the number of
+            # ranges requested on this sheet. For example, if this is representing
+            # `Sheet1`, and the spreadsheet was requested with ranges
+            # `Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will have a
+            # startRow/startColumn of `0`,
+            # while the second one will have `startRow 14` (zero-based row 15),
+            # and `startColumn 3` (zero-based column D).
+          { # Data in the grid, as well as metadata about the dimensions.
+            "startRow": 42, # The first row this GridData refers to, zero-based.
+            "rowMetadata": [ # Metadata about the requested rows in the grid, starting with the row
+                # in start_row.
+              { # Properties about a dimension.
+                "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
+                "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
+                "hiddenByFilter": True or False, # True if this dimension is being filtered.
+                    # This field is read-only.
+              },
+            ],
+            "startColumn": 42, # The first column this GridData refers to, zero-based.
+            "columnMetadata": [ # Metadata about the requested columns in the grid, starting with the column
+                # in start_column.
+              { # Properties about a dimension.
+                "pixelSize": 42, # The height (if a row) or width (if a column) of the dimension in pixels.
+                "hiddenByUser": True or False, # True if this dimension is explicitly hidden.
+                "hiddenByFilter": True or False, # True if this dimension is being filtered.
+                    # This field is read-only.
+              },
+            ],
+            "rowData": [ # The data in the grid, one entry per row,
+                # starting with the row in startRow.
+                # The values in RowData will correspond to columns starting
+                # at start_column.
+              { # Data about each cell in a row.
+                "values": [ # The values in the row, one per column.
+                  { # Data about a specific cell.
+                    "pivotTable": { # A pivot table. # A pivot table anchored at this cell. The size of pivot table itself
+                        # is computed dynamically based on its data, grouping, filters, values,
+                        # etc. Only the top-left cell of the pivot table contains the pivot table
+                        # definition. The other cells will contain the calculated values of the
+                        # results of the pivot in their effective_value fields.
+                      "valueLayout": "A String", # Whether values should be listed horizontally (as columns)
+                          # or vertically (as rows).
+                      "rows": [ # Each row grouping in the pivot table.
+                        { # A single grouping (either row or column) in a pivot table.
+                          "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
+                          "valueMetadata": [ # Metadata about values in the grouping.
+                            { # Metadata about a value in a pivot grouping.
+                              "collapsed": True or False, # True if the data corresponding to the value is collapsed.
+                              "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
+                                  # (Note that formulaValue is not valid,
+                                  #  because the values will be calculated.)
+                                "numberValue": 3.14, # Represents a double value.
+                                    # Note: Dates, Times and DateTimes are represented as doubles in
+                                    # "serial number" format.
+                                "boolValue": True or False, # Represents a boolean value.
+                                "formulaValue": "A String", # Represents a formula.
+                                "stringValue": "A String", # Represents a string value.
+                                    # Leading single quotes are not included. For example, if the user typed
+                                    # `'123` into the UI, this would be represented as a `stringValue` of
+                                    # `"123"`.
+                                "errorValue": { # An error in a cell. # Represents an error.
+                                    # This field is read-only.
+                                  "message": "A String", # A message with more information about the error
+                                      # (in the spreadsheet's locale).
+                                  "type": "A String", # The type of error.
+                                },
+                              },
                             },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
-                          },
-                          "left": { # A border along a cell. # The left border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
+                          ],
+                          "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
+                              # If not specified, sorting is alphabetical by this group's values.
+                            "buckets": [ # Determines the bucket from which values are chosen to sort.
                                 #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                                # For example, in a pivot table with one row group & two column groups,
+                                # the row group can list up to two values. The first value corresponds
+                                # to a value within the first column group, and the second value
+                                # corresponds to a value in the second column group.  If no values
+                                # are listed, this would indicate that the row should be sorted according
+                                # to the "Grand Total" over the column groups. If a single value is listed,
+                                # this would correspond to using the "Total" of that bucket.
+                              { # The kinds of value that a cell in a spreadsheet can have.
+                                "numberValue": 3.14, # Represents a double value.
+                                    # Note: Dates, Times and DateTimes are represented as doubles in
+                                    # "serial number" format.
+                                "boolValue": True or False, # Represents a boolean value.
+                                "formulaValue": "A String", # Represents a formula.
+                                "stringValue": "A String", # Represents a string value.
+                                    # Leading single quotes are not included. For example, if the user typed
+                                    # `'123` into the UI, this would be represented as a `stringValue` of
+                                    # `"123"`.
+                                "errorValue": { # An error in a cell. # Represents an error.
+                                    # This field is read-only.
+                                  "message": "A String", # A message with more information about the error
+                                      # (in the spreadsheet's locale).
+                                  "type": "A String", # The type of error.
+                                },
+                              },
+                            ],
+                            "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
+                                # grouping should be sorted by.
+                          },
+                          "sortOrder": "A String", # The order the values in this group should be sorted.
+                          "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                              #
+                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                              # means this group refers to column `C`, whereas the offset `1` would refer
+                              # to column `D`.
+                        },
+                      ],
+                      "source": { # A range on a sheet. # The range the pivot table is reading data from.
+                          # All indexes are zero-based.
+                          # Indexes are half open, e.g the start index is inclusive
+                          # and the end index is exclusive -- [start_index, end_index).
+                          # Missing indexes indicate the range is unbounded on that side.
+                          #
+                          # For example, if `"Sheet1"` is sheet ID 0, then:
+                          #
+                          #   `Sheet1!A1:A1 == sheet_id: 0,
+                          #                   start_row_index: 0, end_row_index: 1,
+                          #                   start_column_index: 0, end_column_index: 1`
+                          #
+                          #   `Sheet1!A3:B4 == sheet_id: 0,
+                          #                   start_row_index: 2, end_row_index: 4,
+                          #                   start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A:B == sheet_id: 0,
+                          #                 start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1!A5:B == sheet_id: 0,
+                          #                  start_row_index: 4,
+                          #                  start_column_index: 0, end_column_index: 2`
+                          #
+                          #   `Sheet1 == sheet_id:0`
+                          #
+                          # The start index must always be less than or equal to the end index.
+                          # If the start index equals the end index, then the range is empty.
+                          # Empty ranges are typically not meaningful and are usually rendered in the
+                          # UI as `#REF!`.
+                        "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded.
+                        "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded.
+                        "sheetId": 42, # The sheet this range is on.
+                        "startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded.
+                        "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded.
+                      },
+                      "values": [ # A list of values to include in the pivot table.
+                        { # The definition of how a value in a pivot table should be calculated.
+                          "formula": "A String", # A custom formula to calculate the value.  The formula must start
+                              # with an `=` character.
+                          "summarizeFunction": "A String", # A function to summarize the value.
+                              # If formula is set, the only supported values are
+                              # SUM and
+                              # CUSTOM.
+                              # If sourceColumnOffset is set, then `CUSTOM`
+                              # is not supported.
+                          "sourceColumnOffset": 42, # The column offset of the source range that this value reads from.
+                              #
+                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                              # means this value refers to column `C`, whereas the offset `1` would
+                              # refer to column `D`.
+                          "name": "A String", # A name to use for the value. This is only used if formula was set.
+                              # Otherwise, the column name is used.
+                        },
+                      ],
+                      "criteria": { # An optional mapping of filters per source column offset.
+                          #
+                          # The filters will be applied before aggregating data into the pivot table.
+                          # The map's key is the column offset of the source range that you want to
+                          # filter, and the value is the criteria for that column.
+                          #
+                          # For example, if the source was `C10:E15`, a key of `0` will have the filter
+                          # for column `C`, whereas the key `1` is for column `D`.
+                        "a_key": { # Criteria for showing/hiding rows in a pivot table.
+                          "visibleValues": [ # Values that should be included.  Values not listed here are excluded.
+                            "A String",
+                          ],
+                        },
+                      },
+                      "columns": [ # Each column grouping in the pivot table.
+                        { # A single grouping (either row or column) in a pivot table.
+                          "showTotals": True or False, # True if the pivot table should include the totals for this grouping.
+                          "valueMetadata": [ # Metadata about values in the grouping.
+                            { # Metadata about a value in a pivot grouping.
+                              "collapsed": True or False, # True if the data corresponding to the value is collapsed.
+                              "value": { # The kinds of value that a cell in a spreadsheet can have. # The calculated value the metadata corresponds to.
+                                  # (Note that formulaValue is not valid,
+                                  #  because the values will be calculated.)
+                                "numberValue": 3.14, # Represents a double value.
+                                    # Note: Dates, Times and DateTimes are represented as doubles in
+                                    # "serial number" format.
+                                "boolValue": True or False, # Represents a boolean value.
+                                "formulaValue": "A String", # Represents a formula.
+                                "stringValue": "A String", # Represents a string value.
+                                    # Leading single quotes are not included. For example, if the user typed
+                                    # `'123` into the UI, this would be represented as a `stringValue` of
+                                    # `"123"`.
+                                "errorValue": { # An error in a cell. # Represents an error.
+                                    # This field is read-only.
+                                  "message": "A String", # A message with more information about the error
+                                      # (in the spreadsheet's locale).
+                                  "type": "A String", # The type of error.
+                                },
+                              },
                             },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
+                          ],
+                          "valueBucket": { # Information about which values in a pivot group should be used for sorting. # The bucket of the opposite pivot group to sort by.
+                              # If not specified, sorting is alphabetical by this group's values.
+                            "buckets": [ # Determines the bucket from which values are chosen to sort.
+                                #
+                                # For example, in a pivot table with one row group & two column groups,
+                                # the row group can list up to two values. The first value corresponds
+                                # to a value within the first column group, and the second value
+                                # corresponds to a value in the second column group.  If no values
+                                # are listed, this would indicate that the row should be sorted according
+                                # to the "Grand Total" over the column groups. If a single value is listed,
+                                # this would correspond to using the "Total" of that bucket.
+                              { # The kinds of value that a cell in a spreadsheet can have.
+                                "numberValue": 3.14, # Represents a double value.
+                                    # Note: Dates, Times and DateTimes are represented as doubles in
+                                    # "serial number" format.
+                                "boolValue": True or False, # Represents a boolean value.
+                                "formulaValue": "A String", # Represents a formula.
+                                "stringValue": "A String", # Represents a string value.
+                                    # Leading single quotes are not included. For example, if the user typed
+                                    # `'123` into the UI, this would be represented as a `stringValue` of
+                                    # `"123"`.
+                                "errorValue": { # An error in a cell. # Represents an error.
+                                    # This field is read-only.
+                                  "message": "A String", # A message with more information about the error
+                                      # (in the spreadsheet's locale).
+                                  "type": "A String", # The type of error.
+                                },
+                              },
+                            ],
+                            "valuesIndex": 42, # The offset in the PivotTable.values list which the values in this
+                                # grouping should be sorted by.
                           },
+                          "sortOrder": "A String", # The order the values in this group should be sorted.
+                          "sourceColumnOffset": 42, # The column offset of the source range that this grouping is based on.
+                              #
+                              # For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`
+                              # means this group refers to column `C`, whereas the offset `1` would refer
+                              # to column `D`.
                         },
-                        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+                      ],
+                    },
+                    "hyperlink": "A String", # A hyperlink this cell points to, if any.
+                        # This field is read-only.  (To set it, use a `=HYPERLINK` formula.)
+                    "effectiveValue": { # The kinds of value that a cell in a spreadsheet can have. # The effective value of the cell. For cells with formulas, this will be
+                        # the calculated value.  For cells with literals, this will be
+                        # the same as the user_entered_value.
+                        # This field is read-only.
+                      "numberValue": 3.14, # Represents a double value.
+                          # Note: Dates, Times and DateTimes are represented as doubles in
+                          # "serial number" format.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "formulaValue": "A String", # Represents a formula.
+                      "stringValue": "A String", # Represents a string value.
+                          # Leading single quotes are not included. For example, if the user typed
+                          # `'123` into the UI, this would be represented as a `stringValue` of
+                          # `"123"`.
+                      "errorValue": { # An error in a cell. # Represents an error.
+                          # This field is read-only.
+                        "message": "A String", # A message with more information about the error
+                            # (in the spreadsheet's locale).
+                        "type": "A String", # The type of error.
                       },
-                      "userEnteredFormat": { # The format of a cell. # The format the user entered for the cell.
+                    },
+                    "formattedValue": "A String", # The formatted value of the cell.
+                        # This is the value as it's shown to the user.
+                        # This field is read-only.
+                    "userEnteredValue": { # The kinds of value that a cell in a spreadsheet can have. # The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`
+                        # Note: Dates, Times and DateTimes are represented as doubles in
+                        # serial number format.
+                      "numberValue": 3.14, # Represents a double value.
+                          # Note: Dates, Times and DateTimes are represented as doubles in
+                          # "serial number" format.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "formulaValue": "A String", # Represents a formula.
+                      "stringValue": "A String", # Represents a string value.
+                          # Leading single quotes are not included. For example, if the user typed
+                          # `'123` into the UI, this would be represented as a `stringValue` of
+                          # `"123"`.
+                      "errorValue": { # An error in a cell. # Represents an error.
+                          # This field is read-only.
+                        "message": "A String", # A message with more information about the error
+                            # (in the spreadsheet's locale).
+                        "type": "A String", # The type of error.
+                      },
+                    },
+                    "note": "A String", # Any note on the cell.
+                    "effectiveFormat": { # The format of a cell. # The effective format being used by the cell.
+                        # This includes the results of applying any conditional formatting and,
+                        # if the cell contains a formula, the computed number format.
+                        # If the effective format is the default format, effective format will
+                        # not be written.
+                        # This field is read-only.
+                      "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                        "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                            # the user's locale will be used if necessary for the given type.
+                            # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                            # information about the supported patterns.
+                        "type": "A String", # The type of the number format.
+                            # When writing, this field must be set.
+                      },
+                      "textDirection": "A String", # The direction of the text in the cell.
+                      "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                          # When updating padding, every field must be specified.
+                        "top": 42, # The top padding of the cell.
+                        "right": 42, # The right padding of the cell.
+                        "bottom": 42, # The bottom padding of the cell.
+                        "left": 42, # The left padding of the cell.
+                      },
+                      "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                      "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                          # for simplicity of conversion to/from color representations in various
+                          # languages over compactness; for example, the fields of this representation
+                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                          # method in iOS; and, with just a little work, it can be easily formatted into
+                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                          #
+                          # Example (Java):
+                          #
+                          #      import com.google.type.Color;
+                          #
+                          #      // ...
+                          #      public static java.awt.Color fromProto(Color protocolor) {
+                          #        float alpha = protocolor.hasAlpha()
+                          #            ? protocolor.getAlpha().getValue()
+                          #            : 1.0;
+                          #
+                          #        return new java.awt.Color(
+                          #            protocolor.getRed(),
+                          #            protocolor.getGreen(),
+                          #            protocolor.getBlue(),
+                          #            alpha);
+                          #      }
+                          #
+                          #      public static Color toProto(java.awt.Color color) {
+                          #        float red = (float) color.getRed();
+                          #        float green = (float) color.getGreen();
+                          #        float blue = (float) color.getBlue();
+                          #        float denominator = 255.0;
+                          #        Color.Builder resultBuilder =
+                          #            Color
+                          #                .newBuilder()
+                          #                .setRed(red / denominator)
+                          #                .setGreen(green / denominator)
+                          #                .setBlue(blue / denominator);
+                          #        int alpha = color.getAlpha();
+                          #        if (alpha != 255) {
+                          #          result.setAlpha(
+                          #              FloatValue
+                          #                  .newBuilder()
+                          #                  .setValue(((float) alpha) / denominator)
+                          #                  .build());
+                          #        }
+                          #        return resultBuilder.build();
+                          #      }
+                          #      // ...
                           #
-                          # When writing, the new format will be merged with the existing format.
-                        "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
-                          "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
-                              # the user's locale will be used if necessary for the given type.
-                              # See the [Date and Number Formats guide](/sheets/guides/formats) for more
-                              # information about the supported patterns.
-                          "type": "A String", # The type of the number format.
-                              # When writing, this field must be set.
-                        },
-                        "textDirection": "A String", # The direction of the text in the cell.
-                        "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
-                            # When updating padding, every field must be specified.
-                          "top": 42, # The top padding of the cell.
-                          "right": 42, # The right padding of the cell.
-                          "bottom": 42, # The bottom padding of the cell.
-                          "left": 42, # The left padding of the cell.
-                        },
-                        "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
-                        "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                          # Example (iOS / Obj-C):
+                          #
+                          #      // ...
+                          #      static UIColor* fromProto(Color* protocolor) {
+                          #         float red = [protocolor red];
+                          #         float green = [protocolor green];
+                          #         float blue = [protocolor blue];
+                          #         FloatValue* alpha_wrapper = [protocolor alpha];
+                          #         float alpha = 1.0;
+                          #         if (alpha_wrapper != nil) {
+                          #           alpha = [alpha_wrapper value];
+                          #         }
+                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                          #      }
+                          #
+                          #      static Color* toProto(UIColor* color) {
+                          #          CGFloat red, green, blue, alpha;
+                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                          #            return nil;
+                          #          }
+                          #          Color* result = [Color alloc] init];
+                          #          [result setRed:red];
+                          #          [result setGreen:green];
+                          #          [result setBlue:blue];
+                          #          if (alpha <= 0.9999) {
+                          #            [result setAlpha:floatWrapperWithValue(alpha)];
+                          #          }
+                          #          [result autorelease];
+                          #          return result;
+                          #     }
+                          #     // ...
+                          #
+                          #  Example (JavaScript):
+                          #
+                          #     // ...
+                          #
+                          #     var protoToCssColor = function(rgb_color) {
+                          #        var redFrac = rgb_color.red || 0.0;
+                          #        var greenFrac = rgb_color.green || 0.0;
+                          #        var blueFrac = rgb_color.blue || 0.0;
+                          #        var red = Math.floor(redFrac * 255);
+                          #        var green = Math.floor(greenFrac * 255);
+                          #        var blue = Math.floor(blueFrac * 255);
+                          #
+                          #        if (!('alpha' in rgb_color)) {
+                          #           return rgbToCssColor_(red, green, blue);
+                          #        }
+                          #
+                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                          #        var rgbParams = [red, green, blue].join(',');
+                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                          #     };
+                          #
+                          #     var rgbToCssColor_ = function(red, green, blue) {
+                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                          #       var hexString = rgbNumber.toString(16);
+                          #       var missingZeros = 6 - hexString.length;
+                          #       var resultBuilder = ['#'];
+                          #       for (var i = 0; i < missingZeros; i++) {
+                          #          resultBuilder.push('0');
+                          #       }
+                          #       resultBuilder.push(hexString);
+                          #       return resultBuilder.join('');
+                          #     };
+                          #
+                          #     // ...
+                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                            # the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color. This
+                            # uses a wrapper message rather than a simple float scalar so that it is
+                            # possible to distinguish between a default value and the value being unset.
+                            # If omitted, this color object is to be rendered as a solid color
+                            # (as if the alpha value had been explicitly given with a value of 1.0).
+                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                      },
+                      "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                      "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                          # Absent values indicate that the field isn't specified.
+                        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
                             # for simplicity of conversion to/from color representations in various
                             # languages over compactness; for example, the fields of this representation
                             # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -33348,10 +45837,419 @@ <h3>Method Details</h3>
                           "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                           "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                         },
-                        "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
-                        "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
-                            # Absent values indicate that the field isn't specified.
-                          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                        "bold": True or False, # True if the text is bold.
+                        "strikethrough": True or False, # True if the text has a strikethrough.
+                        "fontFamily": "A String", # The font family.
+                        "fontSize": 42, # The size of the font.
+                        "italic": True or False, # True if the text is italicized.
+                        "underline": True or False, # True if the text is underlined.
+                      },
+                      "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                      "borders": { # The borders of the cell. # The borders of the cell.
+                        "top": { # A border along a cell. # The top border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "right": { # A border along a cell. # The right border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "bottom": { # A border along a cell. # The bottom border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "left": { # A border along a cell. # The left border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
                               # for simplicity of conversion to/from color representations in various
                               # languages over compactness; for example, the fields of this representation
                               # can be trivially provided to the constructor of "java.awt.Color" in Java; it
@@ -33480,901 +46378,1197 @@ <h3>Method Details</h3>
                             "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                             "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                           },
-                          "bold": True or False, # True if the text is bold.
-                          "strikethrough": True or False, # True if the text has a strikethrough.
-                          "fontFamily": "A String", # The font family.
-                          "fontSize": 42, # The size of the font.
-                          "italic": True or False, # True if the text is italicized.
-                          "underline": True or False, # True if the text is underlined.
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
                         },
-                        "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
-                        "borders": { # The borders of the cell. # The borders of the cell.
-                          "top": { # A border along a cell. # The top border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
-                          },
-                          "right": { # A border along a cell. # The right border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
-                                #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
-                                #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
-                          },
-                          "bottom": { # A border along a cell. # The bottom border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
-                                #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
+                      },
+                      "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+                    },
+                    "userEnteredFormat": { # The format of a cell. # The format the user entered for the cell.
+                        #
+                        # When writing, the new format will be merged with the existing format.
+                      "numberFormat": { # The number format of a cell. # A format describing how number values should be represented to the user.
+                        "pattern": "A String", # Pattern string used for formatting.  If not set, a default pattern based on
+                            # the user's locale will be used if necessary for the given type.
+                            # See the [Date and Number Formats guide](/sheets/guides/formats) for more
+                            # information about the supported patterns.
+                        "type": "A String", # The type of the number format.
+                            # When writing, this field must be set.
+                      },
+                      "textDirection": "A String", # The direction of the text in the cell.
+                      "padding": { # The amount of padding around the cell, in pixels. # The padding of the cell.
+                          # When updating padding, every field must be specified.
+                        "top": 42, # The top padding of the cell.
+                        "right": 42, # The right padding of the cell.
+                        "bottom": 42, # The bottom padding of the cell.
+                        "left": 42, # The left padding of the cell.
+                      },
+                      "horizontalAlignment": "A String", # The horizontal alignment of the value in the cell.
+                      "backgroundColor": { # Represents a color in the RGBA color space. This representation is designed # The background color of the cell.
+                          # for simplicity of conversion to/from color representations in various
+                          # languages over compactness; for example, the fields of this representation
+                          # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                          # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                          # method in iOS; and, with just a little work, it can be easily formatted into
+                          # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                          #
+                          # Example (Java):
+                          #
+                          #      import com.google.type.Color;
+                          #
+                          #      // ...
+                          #      public static java.awt.Color fromProto(Color protocolor) {
+                          #        float alpha = protocolor.hasAlpha()
+                          #            ? protocolor.getAlpha().getValue()
+                          #            : 1.0;
+                          #
+                          #        return new java.awt.Color(
+                          #            protocolor.getRed(),
+                          #            protocolor.getGreen(),
+                          #            protocolor.getBlue(),
+                          #            alpha);
+                          #      }
+                          #
+                          #      public static Color toProto(java.awt.Color color) {
+                          #        float red = (float) color.getRed();
+                          #        float green = (float) color.getGreen();
+                          #        float blue = (float) color.getBlue();
+                          #        float denominator = 255.0;
+                          #        Color.Builder resultBuilder =
+                          #            Color
+                          #                .newBuilder()
+                          #                .setRed(red / denominator)
+                          #                .setGreen(green / denominator)
+                          #                .setBlue(blue / denominator);
+                          #        int alpha = color.getAlpha();
+                          #        if (alpha != 255) {
+                          #          result.setAlpha(
+                          #              FloatValue
+                          #                  .newBuilder()
+                          #                  .setValue(((float) alpha) / denominator)
+                          #                  .build());
+                          #        }
+                          #        return resultBuilder.build();
+                          #      }
+                          #      // ...
+                          #
+                          # Example (iOS / Obj-C):
+                          #
+                          #      // ...
+                          #      static UIColor* fromProto(Color* protocolor) {
+                          #         float red = [protocolor red];
+                          #         float green = [protocolor green];
+                          #         float blue = [protocolor blue];
+                          #         FloatValue* alpha_wrapper = [protocolor alpha];
+                          #         float alpha = 1.0;
+                          #         if (alpha_wrapper != nil) {
+                          #           alpha = [alpha_wrapper value];
+                          #         }
+                          #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                          #      }
+                          #
+                          #      static Color* toProto(UIColor* color) {
+                          #          CGFloat red, green, blue, alpha;
+                          #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                          #            return nil;
+                          #          }
+                          #          Color* result = [Color alloc] init];
+                          #          [result setRed:red];
+                          #          [result setGreen:green];
+                          #          [result setBlue:blue];
+                          #          if (alpha <= 0.9999) {
+                          #            [result setAlpha:floatWrapperWithValue(alpha)];
+                          #          }
+                          #          [result autorelease];
+                          #          return result;
+                          #     }
+                          #     // ...
+                          #
+                          #  Example (JavaScript):
+                          #
+                          #     // ...
+                          #
+                          #     var protoToCssColor = function(rgb_color) {
+                          #        var redFrac = rgb_color.red || 0.0;
+                          #        var greenFrac = rgb_color.green || 0.0;
+                          #        var blueFrac = rgb_color.blue || 0.0;
+                          #        var red = Math.floor(redFrac * 255);
+                          #        var green = Math.floor(greenFrac * 255);
+                          #        var blue = Math.floor(blueFrac * 255);
+                          #
+                          #        if (!('alpha' in rgb_color)) {
+                          #           return rgbToCssColor_(red, green, blue);
+                          #        }
+                          #
+                          #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                          #        var rgbParams = [red, green, blue].join(',');
+                          #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                          #     };
+                          #
+                          #     var rgbToCssColor_ = function(red, green, blue) {
+                          #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                          #       var hexString = rgbNumber.toString(16);
+                          #       var missingZeros = 6 - hexString.length;
+                          #       var resultBuilder = ['#'];
+                          #       for (var i = 0; i < missingZeros; i++) {
+                          #          resultBuilder.push('0');
+                          #       }
+                          #       resultBuilder.push(hexString);
+                          #       return resultBuilder.join('');
+                          #     };
+                          #
+                          #     // ...
+                        "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                        "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                            # the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color. This
+                            # uses a wrapper message rather than a simple float scalar so that it is
+                            # possible to distinguish between a default value and the value being unset.
+                            # If omitted, this color object is to be rendered as a solid color
+                            # (as if the alpha value had been explicitly given with a value of 1.0).
+                        "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                        "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                      },
+                      "verticalAlignment": "A String", # The vertical alignment of the value in the cell.
+                      "textFormat": { # The format of a run of text in a cell. # The format of the text in the cell (unless overridden by a format run).
+                          # Absent values indicate that the field isn't specified.
+                        "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                            # for simplicity of conversion to/from color representations in various
+                            # languages over compactness; for example, the fields of this representation
+                            # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                            # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                            # method in iOS; and, with just a little work, it can be easily formatted into
+                            # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                            #
+                            # Example (Java):
+                            #
+                            #      import com.google.type.Color;
+                            #
+                            #      // ...
+                            #      public static java.awt.Color fromProto(Color protocolor) {
+                            #        float alpha = protocolor.hasAlpha()
+                            #            ? protocolor.getAlpha().getValue()
+                            #            : 1.0;
+                            #
+                            #        return new java.awt.Color(
+                            #            protocolor.getRed(),
+                            #            protocolor.getGreen(),
+                            #            protocolor.getBlue(),
+                            #            alpha);
+                            #      }
+                            #
+                            #      public static Color toProto(java.awt.Color color) {
+                            #        float red = (float) color.getRed();
+                            #        float green = (float) color.getGreen();
+                            #        float blue = (float) color.getBlue();
+                            #        float denominator = 255.0;
+                            #        Color.Builder resultBuilder =
+                            #            Color
+                            #                .newBuilder()
+                            #                .setRed(red / denominator)
+                            #                .setGreen(green / denominator)
+                            #                .setBlue(blue / denominator);
+                            #        int alpha = color.getAlpha();
+                            #        if (alpha != 255) {
+                            #          result.setAlpha(
+                            #              FloatValue
+                            #                  .newBuilder()
+                            #                  .setValue(((float) alpha) / denominator)
+                            #                  .build());
+                            #        }
+                            #        return resultBuilder.build();
+                            #      }
+                            #      // ...
+                            #
+                            # Example (iOS / Obj-C):
+                            #
+                            #      // ...
+                            #      static UIColor* fromProto(Color* protocolor) {
+                            #         float red = [protocolor red];
+                            #         float green = [protocolor green];
+                            #         float blue = [protocolor blue];
+                            #         FloatValue* alpha_wrapper = [protocolor alpha];
+                            #         float alpha = 1.0;
+                            #         if (alpha_wrapper != nil) {
+                            #           alpha = [alpha_wrapper value];
+                            #         }
+                            #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                            #      }
+                            #
+                            #      static Color* toProto(UIColor* color) {
+                            #          CGFloat red, green, blue, alpha;
+                            #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                            #            return nil;
+                            #          }
+                            #          Color* result = [Color alloc] init];
+                            #          [result setRed:red];
+                            #          [result setGreen:green];
+                            #          [result setBlue:blue];
+                            #          if (alpha <= 0.9999) {
+                            #            [result setAlpha:floatWrapperWithValue(alpha)];
+                            #          }
+                            #          [result autorelease];
+                            #          return result;
+                            #     }
+                            #     // ...
+                            #
+                            #  Example (JavaScript):
+                            #
+                            #     // ...
+                            #
+                            #     var protoToCssColor = function(rgb_color) {
+                            #        var redFrac = rgb_color.red || 0.0;
+                            #        var greenFrac = rgb_color.green || 0.0;
+                            #        var blueFrac = rgb_color.blue || 0.0;
+                            #        var red = Math.floor(redFrac * 255);
+                            #        var green = Math.floor(greenFrac * 255);
+                            #        var blue = Math.floor(blueFrac * 255);
+                            #
+                            #        if (!('alpha' in rgb_color)) {
+                            #           return rgbToCssColor_(red, green, blue);
+                            #        }
+                            #
+                            #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                            #        var rgbParams = [red, green, blue].join(',');
+                            #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                            #     };
+                            #
+                            #     var rgbToCssColor_ = function(red, green, blue) {
+                            #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                            #       var hexString = rgbNumber.toString(16);
+                            #       var missingZeros = 6 - hexString.length;
+                            #       var resultBuilder = ['#'];
+                            #       for (var i = 0; i < missingZeros; i++) {
+                            #          resultBuilder.push('0');
+                            #       }
+                            #       resultBuilder.push(hexString);
+                            #       return resultBuilder.join('');
+                            #     };
+                            #
+                            #     // ...
+                          "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                          "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                              # the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color. This
+                              # uses a wrapper message rather than a simple float scalar so that it is
+                              # possible to distinguish between a default value and the value being unset.
+                              # If omitted, this color object is to be rendered as a solid color
+                              # (as if the alpha value had been explicitly given with a value of 1.0).
+                          "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                          "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                        },
+                        "bold": True or False, # True if the text is bold.
+                        "strikethrough": True or False, # True if the text has a strikethrough.
+                        "fontFamily": "A String", # The font family.
+                        "fontSize": 42, # The size of the font.
+                        "italic": True or False, # True if the text is italicized.
+                        "underline": True or False, # True if the text is underlined.
+                      },
+                      "hyperlinkDisplayType": "A String", # How a hyperlink, if it exists, should be displayed in the cell.
+                      "borders": { # The borders of the cell. # The borders of the cell.
+                        "top": { # A border along a cell. # The top border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
                                 #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                                 #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                           },
-                          "left": { # A border along a cell. # The left border of the cell.
-                            "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "right": { # A border along a cell. # The right border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
                                 #
-                                #     // ...
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                                 #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "bottom": { # A border along a cell. # The bottom border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
                                 #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                                 #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+                          },
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
+                        },
+                        "left": { # A border along a cell. # The left border of the cell.
+                          "color": { # Represents a color in the RGBA color space. This representation is designed # The color of the border.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
                                 #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                                 #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "width": 42, # The width of the border, in pixels.
-                                # Deprecated; the width is determined by the "style" field.
-                            "style": "A String", # The style of the border.
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                           },
-                        },
-                        "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
-                      },
-                      "dataValidation": { # A data validation rule. # A data validation rule on the cell, if any.
-                          #
-                          # When writing, the new data validation rule will overwrite any prior rule.
-                        "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
-                            # If true, "List" conditions will show a dropdown.
-                        "strict": True or False, # True if invalid data should be rejected.
-                        "inputMessage": "A String", # A message to show the user when adding data to the cell.
-                        "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
-                            # BooleanConditions are used by conditional formatting,
-                            # data validation, and the criteria in filters.
-                          "type": "A String", # The type of condition.
-                          "values": [ # The values of the condition. The number of supported values depends
-                              # on the condition type.  Some support zero values,
-                              # others one or two values,
-                              # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
-                            { # The value of the condition.
-                              "relativeDate": "A String", # A relative date (based on the current date).
-                                  # Valid only if the type is
-                                  # DATE_BEFORE,
-                                  # DATE_AFTER,
-                                  # DATE_ON_OR_BEFORE or
-                                  # DATE_ON_OR_AFTER.
-                                  #
-                                  # Relative dates are not supported in data validation.
-                                  # They are supported only in conditional formatting and
-                                  # conditional filters.
-                              "userEnteredValue": "A String", # A value the condition is based on.
-                                  # The value will be parsed as if the user typed into a cell.
-                                  # Formulas are supported (and must begin with an `=`).
-                            },
-                          ],
+                          "width": 42, # The width of the border, in pixels.
+                              # Deprecated; the width is determined by the "style" field.
+                          "style": "A String", # The style of the border.
                         },
                       },
-                      "textFormatRuns": [ # Runs of rich text applied to subsections of the cell.  Runs are only valid
-                          # on user entered strings, not formulas, bools, or numbers.
-                          # Runs start at specific indexes in the text and continue until the next
-                          # run. Properties of a run will continue unless explicitly changed
-                          # in a subsequent run (and properties of the first run will continue
-                          # the properties of the cell unless explicitly changed).
-                          #
-                          # When writing, the new runs will overwrite any prior runs.  When writing a
-                          # new user_entered_value, previous runs will be erased.
-                        { # A run of a text format. The format of this run continues until the start
-                            # index of the next run.
-                            # When updating, all fields must be set.
-                          "startIndex": 42, # The character index where this run starts.
-                          "format": { # The format of a run of text in a cell. # The format of this run.  Absent values inherit the cell's format.
-                              # Absent values indicate that the field isn't specified.
-                            "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
-                                # for simplicity of conversion to/from color representations in various
-                                # languages over compactness; for example, the fields of this representation
-                                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                                # method in iOS; and, with just a little work, it can be easily formatted into
-                                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                                #
-                                # Example (Java):
-                                #
-                                #      import com.google.type.Color;
-                                #
-                                #      // ...
-                                #      public static java.awt.Color fromProto(Color protocolor) {
-                                #        float alpha = protocolor.hasAlpha()
-                                #            ? protocolor.getAlpha().getValue()
-                                #            : 1.0;
-                                #
-                                #        return new java.awt.Color(
-                                #            protocolor.getRed(),
-                                #            protocolor.getGreen(),
-                                #            protocolor.getBlue(),
-                                #            alpha);
-                                #      }
-                                #
-                                #      public static Color toProto(java.awt.Color color) {
-                                #        float red = (float) color.getRed();
-                                #        float green = (float) color.getGreen();
-                                #        float blue = (float) color.getBlue();
-                                #        float denominator = 255.0;
-                                #        Color.Builder resultBuilder =
-                                #            Color
-                                #                .newBuilder()
-                                #                .setRed(red / denominator)
-                                #                .setGreen(green / denominator)
-                                #                .setBlue(blue / denominator);
-                                #        int alpha = color.getAlpha();
-                                #        if (alpha != 255) {
-                                #          result.setAlpha(
-                                #              FloatValue
-                                #                  .newBuilder()
-                                #                  .setValue(((float) alpha) / denominator)
-                                #                  .build());
-                                #        }
-                                #        return resultBuilder.build();
-                                #      }
-                                #      // ...
-                                #
-                                # Example (iOS / Obj-C):
-                                #
-                                #      // ...
-                                #      static UIColor* fromProto(Color* protocolor) {
-                                #         float red = [protocolor red];
-                                #         float green = [protocolor green];
-                                #         float blue = [protocolor blue];
-                                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                                #         float alpha = 1.0;
-                                #         if (alpha_wrapper != nil) {
-                                #           alpha = [alpha_wrapper value];
-                                #         }
-                                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                                #      }
-                                #
-                                #      static Color* toProto(UIColor* color) {
-                                #          CGFloat red, green, blue, alpha;
-                                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                                #            return nil;
-                                #          }
-                                #          Color* result = [Color alloc] init];
-                                #          [result setRed:red];
-                                #          [result setGreen:green];
-                                #          [result setBlue:blue];
-                                #          if (alpha <= 0.9999) {
-                                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                                #          }
-                                #          [result autorelease];
-                                #          return result;
-                                #     }
-                                #     // ...
-                                #
-                                #  Example (JavaScript):
-                                #
-                                #     // ...
-                                #
-                                #     var protoToCssColor = function(rgb_color) {
-                                #        var redFrac = rgb_color.red || 0.0;
-                                #        var greenFrac = rgb_color.green || 0.0;
-                                #        var blueFrac = rgb_color.blue || 0.0;
-                                #        var red = Math.floor(redFrac * 255);
-                                #        var green = Math.floor(greenFrac * 255);
-                                #        var blue = Math.floor(blueFrac * 255);
-                                #
-                                #        if (!('alpha' in rgb_color)) {
-                                #           return rgbToCssColor_(red, green, blue);
-                                #        }
+                      "wrapStrategy": "A String", # The wrap strategy for the value in the cell.
+                    },
+                    "dataValidation": { # A data validation rule. # A data validation rule on the cell, if any.
+                        #
+                        # When writing, the new data validation rule will overwrite any prior rule.
+                      "showCustomUi": True or False, # True if the UI should be customized based on the kind of condition.
+                          # If true, "List" conditions will show a dropdown.
+                      "strict": True or False, # True if invalid data should be rejected.
+                      "inputMessage": "A String", # A message to show the user when adding data to the cell.
+                      "condition": { # A condition that can evaluate to true or false. # The condition that data in the cell must match.
+                          # BooleanConditions are used by conditional formatting,
+                          # data validation, and the criteria in filters.
+                        "type": "A String", # The type of condition.
+                        "values": [ # The values of the condition. The number of supported values depends
+                            # on the condition type.  Some support zero values,
+                            # others one or two values,
+                            # and ConditionType.ONE_OF_LIST supports an arbitrary number of values.
+                          { # The value of the condition.
+                            "relativeDate": "A String", # A relative date (based on the current date).
+                                # Valid only if the type is
+                                # DATE_BEFORE,
+                                # DATE_AFTER,
+                                # DATE_ON_OR_BEFORE or
+                                # DATE_ON_OR_AFTER.
                                 #
-                                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                                #        var rgbParams = [red, green, blue].join(',');
-                                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                                #     };
+                                # Relative dates are not supported in data validation.
+                                # They are supported only in conditional formatting and
+                                # conditional filters.
+                            "userEnteredValue": "A String", # A value the condition is based on.
+                                # The value will be parsed as if the user typed into a cell.
+                                # Formulas are supported (and must begin with an `=`).
+                          },
+                        ],
+                      },
+                    },
+                    "textFormatRuns": [ # Runs of rich text applied to subsections of the cell.  Runs are only valid
+                        # on user entered strings, not formulas, bools, or numbers.
+                        # Runs start at specific indexes in the text and continue until the next
+                        # run. Properties of a run will continue unless explicitly changed
+                        # in a subsequent run (and properties of the first run will continue
+                        # the properties of the cell unless explicitly changed).
+                        #
+                        # When writing, the new runs will overwrite any prior runs.  When writing a
+                        # new user_entered_value, previous runs will be erased.
+                      { # A run of a text format. The format of this run continues until the start
+                          # index of the next run.
+                          # When updating, all fields must be set.
+                        "startIndex": 42, # The character index where this run starts.
+                        "format": { # The format of a run of text in a cell. # The format of this run.  Absent values inherit the cell's format.
+                            # Absent values indicate that the field isn't specified.
+                          "foregroundColor": { # Represents a color in the RGBA color space. This representation is designed # The foreground color of the text.
+                              # for simplicity of conversion to/from color representations in various
+                              # languages over compactness; for example, the fields of this representation
+                              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+                              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+                              # method in iOS; and, with just a little work, it can be easily formatted into
+                              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+                              #
+                              # Example (Java):
+                              #
+                              #      import com.google.type.Color;
+                              #
+                              #      // ...
+                              #      public static java.awt.Color fromProto(Color protocolor) {
+                              #        float alpha = protocolor.hasAlpha()
+                              #            ? protocolor.getAlpha().getValue()
+                              #            : 1.0;
+                              #
+                              #        return new java.awt.Color(
+                              #            protocolor.getRed(),
+                              #            protocolor.getGreen(),
+                              #            protocolor.getBlue(),
+                              #            alpha);
+                              #      }
+                              #
+                              #      public static Color toProto(java.awt.Color color) {
+                              #        float red = (float) color.getRed();
+                              #        float green = (float) color.getGreen();
+                              #        float blue = (float) color.getBlue();
+                              #        float denominator = 255.0;
+                              #        Color.Builder resultBuilder =
+                              #            Color
+                              #                .newBuilder()
+                              #                .setRed(red / denominator)
+                              #                .setGreen(green / denominator)
+                              #                .setBlue(blue / denominator);
+                              #        int alpha = color.getAlpha();
+                              #        if (alpha != 255) {
+                              #          result.setAlpha(
+                              #              FloatValue
+                              #                  .newBuilder()
+                              #                  .setValue(((float) alpha) / denominator)
+                              #                  .build());
+                              #        }
+                              #        return resultBuilder.build();
+                              #      }
+                              #      // ...
+                              #
+                              # Example (iOS / Obj-C):
+                              #
+                              #      // ...
+                              #      static UIColor* fromProto(Color* protocolor) {
+                              #         float red = [protocolor red];
+                              #         float green = [protocolor green];
+                              #         float blue = [protocolor blue];
+                              #         FloatValue* alpha_wrapper = [protocolor alpha];
+                              #         float alpha = 1.0;
+                              #         if (alpha_wrapper != nil) {
+                              #           alpha = [alpha_wrapper value];
+                              #         }
+                              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+                              #      }
+                              #
+                              #      static Color* toProto(UIColor* color) {
+                              #          CGFloat red, green, blue, alpha;
+                              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+                              #            return nil;
+                              #          }
+                              #          Color* result = [Color alloc] init];
+                              #          [result setRed:red];
+                              #          [result setGreen:green];
+                              #          [result setBlue:blue];
+                              #          if (alpha <= 0.9999) {
+                              #            [result setAlpha:floatWrapperWithValue(alpha)];
+                              #          }
+                              #          [result autorelease];
+                              #          return result;
+                              #     }
+                              #     // ...
+                              #
+                              #  Example (JavaScript):
+                              #
+                              #     // ...
+                              #
+                              #     var protoToCssColor = function(rgb_color) {
+                              #        var redFrac = rgb_color.red || 0.0;
+                              #        var greenFrac = rgb_color.green || 0.0;
+                              #        var blueFrac = rgb_color.blue || 0.0;
+                              #        var red = Math.floor(redFrac * 255);
+                              #        var green = Math.floor(greenFrac * 255);
+                              #        var blue = Math.floor(blueFrac * 255);
+                              #
+                              #        if (!('alpha' in rgb_color)) {
+                              #           return rgbToCssColor_(red, green, blue);
+                              #        }
+                              #
+                              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+                              #        var rgbParams = [red, green, blue].join(',');
+                              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+                              #     };
+                              #
+                              #     var rgbToCssColor_ = function(red, green, blue) {
+                              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+                              #       var hexString = rgbNumber.toString(16);
+                              #       var missingZeros = 6 - hexString.length;
+                              #       var resultBuilder = ['#'];
+                              #       for (var i = 0; i < missingZeros; i++) {
+                              #          resultBuilder.push('0');
+                              #       }
+                              #       resultBuilder.push(hexString);
+                              #       return resultBuilder.join('');
+                              #     };
+                              #
+                              #     // ...
+                            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+                            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                                # the final pixel color is defined by the equation:
                                 #
-                                #     var rgbToCssColor_ = function(red, green, blue) {
-                                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                                #       var hexString = rgbNumber.toString(16);
-                                #       var missingZeros = 6 - hexString.length;
-                                #       var resultBuilder = ['#'];
-                                #       for (var i = 0; i < missingZeros; i++) {
-                                #          resultBuilder.push('0');
-                                #       }
-                                #       resultBuilder.push(hexString);
-                                #       return resultBuilder.join('');
-                                #     };
+                                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                                 #
-                                #     // ...
-                              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-                              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                                  # the final pixel color is defined by the equation:
-                                  #
-                                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                                  #
-                                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                                  # a value of 0.0 corresponds to a completely transparent color. This
-                                  # uses a wrapper message rather than a simple float scalar so that it is
-                                  # possible to distinguish between a default value and the value being unset.
-                                  # If omitted, this color object is to be rendered as a solid color
-                                  # (as if the alpha value had been explicitly given with a value of 1.0).
-                              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-                              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-                            },
-                            "bold": True or False, # True if the text is bold.
-                            "strikethrough": True or False, # True if the text has a strikethrough.
-                            "fontFamily": "A String", # The font family.
-                            "fontSize": 42, # The size of the font.
-                            "italic": True or False, # True if the text is italicized.
-                            "underline": True or False, # True if the text is underlined.
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color. This
+                                # uses a wrapper message rather than a simple float scalar so that it is
+                                # possible to distinguish between a default value and the value being unset.
+                                # If omitted, this color object is to be rendered as a solid color
+                                # (as if the alpha value had been explicitly given with a value of 1.0).
+                            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+                            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                           },
+                          "bold": True or False, # True if the text is bold.
+                          "strikethrough": True or False, # True if the text has a strikethrough.
+                          "fontFamily": "A String", # The font family.
+                          "fontSize": 42, # The size of the font.
+                          "italic": True or False, # True if the text is italicized.
+                          "underline": True or False, # True if the text is underlined.
                         },
-                      ],
-                    },
-                  ],
-                },
-              ],
-            },
-          ],
-          "properties": { # Properties of a sheet. # The properties of the sheet.
-            "sheetType": "A String", # The type of sheet. Defaults to GRID.
-                # This field cannot be changed once set.
-            "index": 42, # The index of the sheet within the spreadsheet.
-                # When adding or updating sheet properties, if this field
-                # is excluded then the sheet will be added or moved to the end
-                # of the sheet list.
-            "title": "A String", # The name of the sheet.
-            "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
-                # (If the sheet is an object sheet, containing a chart or image, then
-                # this field will be absent.)
-                # When writing it is an error to set any grid properties on non-grid sheets.
-              "columnCount": 42, # The number of columns in the grid.
-              "rowCount": 42, # The number of rows in the grid.
-              "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
-              "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
-              "frozenRowCount": 42, # The number of rows that are frozen in the grid.
-            },
-            "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
-            "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
-                # for simplicity of conversion to/from color representations in various
-                # languages over compactness; for example, the fields of this representation
-                # can be trivially provided to the constructor of "java.awt.Color" in Java; it
-                # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
-                # method in iOS; and, with just a little work, it can be easily formatted into
-                # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
-                #
-                # Example (Java):
-                #
-                #      import com.google.type.Color;
-                #
-                #      // ...
-                #      public static java.awt.Color fromProto(Color protocolor) {
-                #        float alpha = protocolor.hasAlpha()
-                #            ? protocolor.getAlpha().getValue()
-                #            : 1.0;
-                #
-                #        return new java.awt.Color(
-                #            protocolor.getRed(),
-                #            protocolor.getGreen(),
-                #            protocolor.getBlue(),
-                #            alpha);
-                #      }
-                #
-                #      public static Color toProto(java.awt.Color color) {
-                #        float red = (float) color.getRed();
-                #        float green = (float) color.getGreen();
-                #        float blue = (float) color.getBlue();
-                #        float denominator = 255.0;
-                #        Color.Builder resultBuilder =
-                #            Color
-                #                .newBuilder()
-                #                .setRed(red / denominator)
-                #                .setGreen(green / denominator)
-                #                .setBlue(blue / denominator);
-                #        int alpha = color.getAlpha();
-                #        if (alpha != 255) {
-                #          result.setAlpha(
-                #              FloatValue
-                #                  .newBuilder()
-                #                  .setValue(((float) alpha) / denominator)
-                #                  .build());
-                #        }
-                #        return resultBuilder.build();
-                #      }
-                #      // ...
-                #
-                # Example (iOS / Obj-C):
-                #
-                #      // ...
-                #      static UIColor* fromProto(Color* protocolor) {
-                #         float red = [protocolor red];
-                #         float green = [protocolor green];
-                #         float blue = [protocolor blue];
-                #         FloatValue* alpha_wrapper = [protocolor alpha];
-                #         float alpha = 1.0;
-                #         if (alpha_wrapper != nil) {
-                #           alpha = [alpha_wrapper value];
-                #         }
-                #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
-                #      }
-                #
-                #      static Color* toProto(UIColor* color) {
-                #          CGFloat red, green, blue, alpha;
-                #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-                #            return nil;
-                #          }
-                #          Color* result = [Color alloc] init];
-                #          [result setRed:red];
-                #          [result setGreen:green];
-                #          [result setBlue:blue];
-                #          if (alpha <= 0.9999) {
-                #            [result setAlpha:floatWrapperWithValue(alpha)];
-                #          }
-                #          [result autorelease];
-                #          return result;
-                #     }
-                #     // ...
-                #
-                #  Example (JavaScript):
-                #
-                #     // ...
-                #
-                #     var protoToCssColor = function(rgb_color) {
-                #        var redFrac = rgb_color.red || 0.0;
-                #        var greenFrac = rgb_color.green || 0.0;
-                #        var blueFrac = rgb_color.blue || 0.0;
-                #        var red = Math.floor(redFrac * 255);
-                #        var green = Math.floor(greenFrac * 255);
-                #        var blue = Math.floor(blueFrac * 255);
-                #
-                #        if (!('alpha' in rgb_color)) {
-                #           return rgbToCssColor_(red, green, blue);
-                #        }
-                #
-                #        var alphaFrac = rgb_color.alpha.value || 0.0;
-                #        var rgbParams = [red, green, blue].join(',');
-                #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
-                #     };
+                      },
+                    ],
+                  },
+                ],
+              },
+            ],
+          },
+        ],
+        "properties": { # Properties of a sheet. # The properties of the sheet.
+          "sheetType": "A String", # The type of sheet. Defaults to GRID.
+              # This field cannot be changed once set.
+          "index": 42, # The index of the sheet within the spreadsheet.
+              # When adding or updating sheet properties, if this field
+              # is excluded then the sheet will be added or moved to the end
+              # of the sheet list. When updating sheet indices or inserting
+              # sheets, movement is considered in "before the move" indexes.
+              # For example, if there were 3 sheets (S1, S2, S3) in order to
+              # move S1 ahead of S2 the index would have to be set to 2. A sheet
+              # index update request will be ignored if the requested index is
+              # identical to the sheets current index or if the requested new
+              # index is equal to the current sheet index + 1.
+          "title": "A String", # The name of the sheet.
+          "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
+              # (If the sheet is an object sheet, containing a chart or image, then
+              # this field will be absent.)
+              # When writing it is an error to set any grid properties on non-grid sheets.
+            "columnCount": 42, # The number of columns in the grid.
+            "rowCount": 42, # The number of rows in the grid.
+            "frozenColumnCount": 42, # The number of columns that are frozen in the grid.
+            "hideGridlines": True or False, # True if the grid isn't showing gridlines in the UI.
+            "frozenRowCount": 42, # The number of rows that are frozen in the grid.
+          },
+          "rightToLeft": True or False, # True if the sheet is an RTL sheet instead of an LTR sheet.
+          "tabColor": { # Represents a color in the RGBA color space. This representation is designed # The color of the tab in the UI.
+              # for simplicity of conversion to/from color representations in various
+              # languages over compactness; for example, the fields of this representation
+              # can be trivially provided to the constructor of "java.awt.Color" in Java; it
+              # can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+              # method in iOS; and, with just a little work, it can be easily formatted into
+              # a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+              #
+              # Example (Java):
+              #
+              #      import com.google.type.Color;
+              #
+              #      // ...
+              #      public static java.awt.Color fromProto(Color protocolor) {
+              #        float alpha = protocolor.hasAlpha()
+              #            ? protocolor.getAlpha().getValue()
+              #            : 1.0;
+              #
+              #        return new java.awt.Color(
+              #            protocolor.getRed(),
+              #            protocolor.getGreen(),
+              #            protocolor.getBlue(),
+              #            alpha);
+              #      }
+              #
+              #      public static Color toProto(java.awt.Color color) {
+              #        float red = (float) color.getRed();
+              #        float green = (float) color.getGreen();
+              #        float blue = (float) color.getBlue();
+              #        float denominator = 255.0;
+              #        Color.Builder resultBuilder =
+              #            Color
+              #                .newBuilder()
+              #                .setRed(red / denominator)
+              #                .setGreen(green / denominator)
+              #                .setBlue(blue / denominator);
+              #        int alpha = color.getAlpha();
+              #        if (alpha != 255) {
+              #          result.setAlpha(
+              #              FloatValue
+              #                  .newBuilder()
+              #                  .setValue(((float) alpha) / denominator)
+              #                  .build());
+              #        }
+              #        return resultBuilder.build();
+              #      }
+              #      // ...
+              #
+              # Example (iOS / Obj-C):
+              #
+              #      // ...
+              #      static UIColor* fromProto(Color* protocolor) {
+              #         float red = [protocolor red];
+              #         float green = [protocolor green];
+              #         float blue = [protocolor blue];
+              #         FloatValue* alpha_wrapper = [protocolor alpha];
+              #         float alpha = 1.0;
+              #         if (alpha_wrapper != nil) {
+              #           alpha = [alpha_wrapper value];
+              #         }
+              #         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+              #      }
+              #
+              #      static Color* toProto(UIColor* color) {
+              #          CGFloat red, green, blue, alpha;
+              #          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+              #            return nil;
+              #          }
+              #          Color* result = [Color alloc] init];
+              #          [result setRed:red];
+              #          [result setGreen:green];
+              #          [result setBlue:blue];
+              #          if (alpha <= 0.9999) {
+              #            [result setAlpha:floatWrapperWithValue(alpha)];
+              #          }
+              #          [result autorelease];
+              #          return result;
+              #     }
+              #     // ...
+              #
+              #  Example (JavaScript):
+              #
+              #     // ...
+              #
+              #     var protoToCssColor = function(rgb_color) {
+              #        var redFrac = rgb_color.red || 0.0;
+              #        var greenFrac = rgb_color.green || 0.0;
+              #        var blueFrac = rgb_color.blue || 0.0;
+              #        var red = Math.floor(redFrac * 255);
+              #        var green = Math.floor(greenFrac * 255);
+              #        var blue = Math.floor(blueFrac * 255);
+              #
+              #        if (!('alpha' in rgb_color)) {
+              #           return rgbToCssColor_(red, green, blue);
+              #        }
+              #
+              #        var alphaFrac = rgb_color.alpha.value || 0.0;
+              #        var rgbParams = [red, green, blue].join(',');
+              #        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+              #     };
+              #
+              #     var rgbToCssColor_ = function(red, green, blue) {
+              #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+              #       var hexString = rgbNumber.toString(16);
+              #       var missingZeros = 6 - hexString.length;
+              #       var resultBuilder = ['#'];
+              #       for (var i = 0; i < missingZeros; i++) {
+              #          resultBuilder.push('0');
+              #       }
+              #       resultBuilder.push(hexString);
+              #       return resultBuilder.join('');
+              #     };
+              #
+              #     // ...
+            "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+            "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
+                # the final pixel color is defined by the equation:
                 #
-                #     var rgbToCssColor_ = function(red, green, blue) {
-                #       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
-                #       var hexString = rgbNumber.toString(16);
-                #       var missingZeros = 6 - hexString.length;
-                #       var resultBuilder = ['#'];
-                #       for (var i = 0; i < missingZeros; i++) {
-                #          resultBuilder.push('0');
-                #       }
-                #       resultBuilder.push(hexString);
-                #       return resultBuilder.join('');
-                #     };
+                #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
                 #
-                #     // ...
-              "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
-              "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,
-                  # the final pixel color is defined by the equation:
-                  #
-                  #   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
-                  #
-                  # This means that a value of 1.0 corresponds to a solid color, whereas
-                  # a value of 0.0 corresponds to a completely transparent color. This
-                  # uses a wrapper message rather than a simple float scalar so that it is
-                  # possible to distinguish between a default value and the value being unset.
-                  # If omitted, this color object is to be rendered as a solid color
-                  # (as if the alpha value had been explicitly given with a value of 1.0).
-              "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
-              "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
-            },
-            "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
-            "sheetId": 42, # The ID of the sheet. Must be non-negative.
-                # This field cannot be changed once set.
+                # This means that a value of 1.0 corresponds to a solid color, whereas
+                # a value of 0.0 corresponds to a completely transparent color. This
+                # uses a wrapper message rather than a simple float scalar so that it is
+                # possible to distinguish between a default value and the value being unset.
+                # If omitted, this color object is to be rendered as a solid color
+                # (as if the alpha value had been explicitly given with a value of 1.0).
+            "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+            "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
           },
+          "hidden": True or False, # True if the sheet is hidden in the UI, false if it's visible.
+          "sheetId": 42, # The ID of the sheet. Must be non-negative.
+              # This field cannot be changed once set.
         },
-      ],
-    }</pre>
+      },
+    ],
+    "spreadsheetUrl": "A String", # The url of the spreadsheet.
+        # This field is read-only.
+  }</pre>
 </div>
 
 </body></html>
\ No newline at end of file
diff --git a/docs/dyn/sheets_v4.spreadsheets.sheets.html b/docs/dyn/sheets_v4.spreadsheets.sheets.html
index 871f6a45be9..885d5cb2194 100644
--- a/docs/dyn/sheets_v4.spreadsheets.sheets.html
+++ b/docs/dyn/sheets_v4.spreadsheets.sheets.html
@@ -107,7 +107,13 @@ <h3>Method Details</h3>
     "index": 42, # The index of the sheet within the spreadsheet.
         # When adding or updating sheet properties, if this field
         # is excluded then the sheet will be added or moved to the end
-        # of the sheet list.
+        # of the sheet list. When updating sheet indices or inserting
+        # sheets, movement is considered in "before the move" indexes.
+        # For example, if there were 3 sheets (S1, S2, S3) in order to
+        # move S1 ahead of S2 the index would have to be set to 2. A sheet
+        # index update request will be ignored if the requested index is
+        # identical to the sheets current index or if the requested new
+        # index is equal to the current sheet index + 1.
     "title": "A String", # The name of the sheet.
     "gridProperties": { # Properties of a grid. # Additional properties of the sheet if this sheet is a grid.
         # (If the sheet is an object sheet, containing a chart or image, then
diff --git a/docs/dyn/sheets_v4.spreadsheets.values.html b/docs/dyn/sheets_v4.spreadsheets.values.html
index f8d20f26d1d..3817cd9bfb0 100644
--- a/docs/dyn/sheets_v4.spreadsheets.values.html
+++ b/docs/dyn/sheets_v4.spreadsheets.values.html
@@ -75,7 +75,7 @@
 <h1><a href="sheets_v4.html">Google Sheets API</a> . <a href="sheets_v4.spreadsheets.html">spreadsheets</a> . <a href="sheets_v4.spreadsheets.values.html">values</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#append">append(spreadsheetId, range=None, body, insertDataOption=None, valueInputOption=None, x__xgafv=None)</a></code></p>
+  <code><a href="#append">append(spreadsheetId, range=None, body, valueInputOption=None, x__xgafv=None, responseValueRenderOption=None, insertDataOption=None, includeValuesInResponse=None, responseDateTimeRenderOption=None)</a></code></p>
 <p class="firstline">Appends values to a spreadsheet. The input range is used to search for</p>
 <p class="toc_element">
   <code><a href="#batchClear">batchClear(spreadsheetId, body, x__xgafv=None)</a></code></p>
@@ -93,11 +93,11 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(spreadsheetId, range, valueRenderOption=None, majorDimension=None, dateTimeRenderOption=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns a range of values from a spreadsheet.</p>
 <p class="toc_element">
-  <code><a href="#update">update(spreadsheetId, range, body, valueInputOption=None, x__xgafv=None)</a></code></p>
+  <code><a href="#update">update(spreadsheetId, range, body, valueInputOption=None, x__xgafv=None, responseValueRenderOption=None, includeValuesInResponse=None, responseDateTimeRenderOption=None)</a></code></p>
 <p class="firstline">Sets values in a range of a spreadsheet.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="append">append(spreadsheetId, range=None, body, insertDataOption=None, valueInputOption=None, x__xgafv=None)</code>
+    <code class="details" id="append">append(spreadsheetId, range=None, body, valueInputOption=None, x__xgafv=None, responseValueRenderOption=None, insertDataOption=None, includeValuesInResponse=None, responseDateTimeRenderOption=None)</code>
   <pre>Appends values to a spreadsheet. The input range is used to search for
 existing data and find a "table" within that range. Values will be
 appended to the next row of the table, starting with the first column of
@@ -155,12 +155,21 @@ <h3>Method Details</h3>
       # When writing, if this field is not set, it defaults to ROWS.
 }
 
-  insertDataOption: string, How the input data should be inserted.
   valueInputOption: string, How the input data should be interpreted.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
+  responseValueRenderOption: string, Determines how values in the response should be rendered.
+The default render option is ValueRenderOption.FORMATTED_VALUE.
+  insertDataOption: string, How the input data should be inserted.
+  includeValuesInResponse: boolean, Determines if the update response should include the values
+of the cells that were appended. By default, responses
+do not include the updated values.
+  responseDateTimeRenderOption: string, Determines how dates, times, and durations in the response should be
+rendered. This is ignored if response_value_render_option is
+FORMATTED_VALUE.
+The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].
 
 Returns:
   An object of the form:
@@ -171,11 +180,47 @@ <h3>Method Details</h3>
         # (before the values were appended).
         # Empty if no table was found.
     "updates": { # The response when updating a range of values in a spreadsheet. # Information about the updates that were applied.
-      "updatedRange": "A String", # The range (in A1 notation) that updates were applied to.
       "updatedColumns": 42, # The number of columns where at least one cell in the column was updated.
-      "updatedCells": 42, # The number of cells updated.
+      "updatedRange": "A String", # The range (in A1 notation) that updates were applied to.
       "updatedRows": 42, # The number of rows where at least one cell in the row was updated.
+      "updatedData": { # Data within a range of the spreadsheet. # The values of the cells after updates were applied.
+          # This is only included if the request's `includeValuesInResponse` field
+          # was `true`.
+        "range": "A String", # The range the values cover, in A1 notation.
+            # For output, this range indicates the entire requested range,
+            # even though the values will exclude trailing rows and columns.
+            # When appending values, this field represents the range to search for a
+            # table, after which values will be appended.
+        "values": [ # The data that was read or to be written.  This is an array of arrays,
+            # the outer array representing all the data and each inner array
+            # representing a major dimension. Each item in the inner array
+            # corresponds with one cell.
+            #
+            # For output, empty trailing rows and columns will not be included.
+            #
+            # For input, supported value types are: bool, string, and double.
+            # Null values will be skipped.
+            # To set a cell to an empty value, set the string value to an empty string.
+          [
+            "",
+          ],
+        ],
+        "majorDimension": "A String", # The major dimension of the values.
+            #
+            # For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,
+            # then requesting `range=A1:B2,majorDimension=ROWS` will return
+            # `[[1,2],[3,4]]`,
+            # whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return
+            # `[[1,3],[2,4]]`.
+            #
+            # For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]`
+            # will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS`
+            # then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`.
+            #
+            # When writing, if this field is not set, it defaults to ROWS.
+      },
       "spreadsheetId": "A String", # The spreadsheet the updates were applied to.
+      "updatedCells": 42, # The number of cells updated.
     },
   }</pre>
 </div>
@@ -225,6 +270,7 @@ <h3>Method Details</h3>
 Args:
   spreadsheetId: string, The ID of the spreadsheet to retrieve data from. (required)
   valueRenderOption: string, How values should be represented in the output.
+The default render option is ValueRenderOption.FORMATTED_VALUE.
   majorDimension: string, The major dimension that results should use.
 
 For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,
@@ -236,6 +282,7 @@ <h3>Method Details</h3>
   dateTimeRenderOption: string, How dates, times, and durations should be represented in the output.
 This is ignored if value_render_option is
 FORMATTED_VALUE.
+The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -299,6 +346,13 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The request for updating more than one range of values in a spreadsheet.
+    "includeValuesInResponse": True or False, # Determines if the update response should include the values
+        # of the cells that were updated. By default, responses
+        # do not include the updated values. The `updatedData` field within
+        # each of the BatchUpdateValuesResponse.responses will contain
+        # the updated values. If the range to write was larger than than the range
+        # actually written, the response will include all values in the requested
+        # range (excluding trailing empty rows and columns).
     "data": [ # The new values to apply to the spreadsheet.
       { # Data within a range of the spreadsheet.
         "range": "A String", # The range the values cover, in A1 notation.
@@ -335,7 +389,13 @@ <h3>Method Details</h3>
             # When writing, if this field is not set, it defaults to ROWS.
       },
     ],
+    "responseValueRenderOption": "A String", # Determines how values in the response should be rendered.
+        # The default render option is ValueRenderOption.FORMATTED_VALUE.
     "valueInputOption": "A String", # How the input data should be interpreted.
+    "responseDateTimeRenderOption": "A String", # Determines how dates, times, and durations in the response should be
+        # rendered. This is ignored if response_value_render_option is
+        # FORMATTED_VALUE.
+        # The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].
   }
 
   x__xgafv: string, V1 error format.
@@ -350,11 +410,47 @@ <h3>Method Details</h3>
     "responses": [ # One UpdateValuesResponse per requested range, in the same order as
         # the requests appeared.
       { # The response when updating a range of values in a spreadsheet.
-        "updatedRange": "A String", # The range (in A1 notation) that updates were applied to.
         "updatedColumns": 42, # The number of columns where at least one cell in the column was updated.
-        "updatedCells": 42, # The number of cells updated.
+        "updatedRange": "A String", # The range (in A1 notation) that updates were applied to.
         "updatedRows": 42, # The number of rows where at least one cell in the row was updated.
+        "updatedData": { # Data within a range of the spreadsheet. # The values of the cells after updates were applied.
+            # This is only included if the request's `includeValuesInResponse` field
+            # was `true`.
+          "range": "A String", # The range the values cover, in A1 notation.
+              # For output, this range indicates the entire requested range,
+              # even though the values will exclude trailing rows and columns.
+              # When appending values, this field represents the range to search for a
+              # table, after which values will be appended.
+          "values": [ # The data that was read or to be written.  This is an array of arrays,
+              # the outer array representing all the data and each inner array
+              # representing a major dimension. Each item in the inner array
+              # corresponds with one cell.
+              #
+              # For output, empty trailing rows and columns will not be included.
+              #
+              # For input, supported value types are: bool, string, and double.
+              # Null values will be skipped.
+              # To set a cell to an empty value, set the string value to an empty string.
+            [
+              "",
+            ],
+          ],
+          "majorDimension": "A String", # The major dimension of the values.
+              #
+              # For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,
+              # then requesting `range=A1:B2,majorDimension=ROWS` will return
+              # `[[1,2],[3,4]]`,
+              # whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return
+              # `[[1,3],[2,4]]`.
+              #
+              # For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]`
+              # will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS`
+              # then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`.
+              #
+              # When writing, if this field is not set, it defaults to ROWS.
+        },
         "spreadsheetId": "A String", # The spreadsheet the updates were applied to.
+        "updatedCells": 42, # The number of cells updated.
       },
     ],
     "totalUpdatedCells": 42, # The total number of cells updated.
@@ -409,6 +505,7 @@ <h3>Method Details</h3>
   spreadsheetId: string, The ID of the spreadsheet to retrieve data from. (required)
   range: string, The A1 notation of the values to retrieve. (required)
   valueRenderOption: string, How values should be represented in the output.
+The default render option is ValueRenderOption.FORMATTED_VALUE.
   majorDimension: string, The major dimension that results should use.
 
 For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,
@@ -419,6 +516,7 @@ <h3>Method Details</h3>
   dateTimeRenderOption: string, How dates, times, and durations should be represented in the output.
 This is ignored if value_render_option is
 FORMATTED_VALUE.
+The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -464,7 +562,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(spreadsheetId, range, body, valueInputOption=None, x__xgafv=None)</code>
+    <code class="details" id="update">update(spreadsheetId, range, body, valueInputOption=None, x__xgafv=None, responseValueRenderOption=None, includeValuesInResponse=None, responseDateTimeRenderOption=None)</code>
   <pre>Sets values in a range of a spreadsheet.
 The caller must specify the spreadsheet ID, range, and
 a valueInputOption.
@@ -515,16 +613,64 @@ <h3>Method Details</h3>
     Allowed values
       1 - v1 error format
       2 - v2 error format
+  responseValueRenderOption: string, Determines how values in the response should be rendered.
+The default render option is ValueRenderOption.FORMATTED_VALUE.
+  includeValuesInResponse: boolean, Determines if the update response should include the values
+of the cells that were updated. By default, responses
+do not include the updated values.
+If the range to write was larger than than the range actually written,
+the response will include all values in the requested range (excluding
+trailing empty rows and columns).
+  responseDateTimeRenderOption: string, Determines how dates, times, and durations in the response should be
+rendered. This is ignored if response_value_render_option is
+FORMATTED_VALUE.
+The default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].
 
 Returns:
   An object of the form:
 
     { # The response when updating a range of values in a spreadsheet.
-    "updatedRange": "A String", # The range (in A1 notation) that updates were applied to.
     "updatedColumns": 42, # The number of columns where at least one cell in the column was updated.
-    "updatedCells": 42, # The number of cells updated.
+    "updatedRange": "A String", # The range (in A1 notation) that updates were applied to.
     "updatedRows": 42, # The number of rows where at least one cell in the row was updated.
+    "updatedData": { # Data within a range of the spreadsheet. # The values of the cells after updates were applied.
+        # This is only included if the request's `includeValuesInResponse` field
+        # was `true`.
+      "range": "A String", # The range the values cover, in A1 notation.
+          # For output, this range indicates the entire requested range,
+          # even though the values will exclude trailing rows and columns.
+          # When appending values, this field represents the range to search for a
+          # table, after which values will be appended.
+      "values": [ # The data that was read or to be written.  This is an array of arrays,
+          # the outer array representing all the data and each inner array
+          # representing a major dimension. Each item in the inner array
+          # corresponds with one cell.
+          #
+          # For output, empty trailing rows and columns will not be included.
+          #
+          # For input, supported value types are: bool, string, and double.
+          # Null values will be skipped.
+          # To set a cell to an empty value, set the string value to an empty string.
+        [
+          "",
+        ],
+      ],
+      "majorDimension": "A String", # The major dimension of the values.
+          #
+          # For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,
+          # then requesting `range=A1:B2,majorDimension=ROWS` will return
+          # `[[1,2],[3,4]]`,
+          # whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return
+          # `[[1,3],[2,4]]`.
+          #
+          # For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]`
+          # will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS`
+          # then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`.
+          #
+          # When writing, if this field is not set, it defaults to ROWS.
+    },
     "spreadsheetId": "A String", # The spreadsheet the updates were applied to.
+    "updatedCells": 42, # The number of cells updated.
   }</pre>
 </div>
 
diff --git a/docs/dyn/slides_v1.html b/docs/dyn/slides_v1.html
new file mode 100644
index 00000000000..d6fb5a75634
--- /dev/null
+++ b/docs/dyn/slides_v1.html
@@ -0,0 +1,103 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="slides_v1.html">Google Slides API</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="slides_v1.presentations.html">presentations()</a></code>
+</p>
+<p class="firstline">Returns the presentations Resource.</p>
+
+<p class="toc_element">
+  <code><a href="#new_batch_http_request">new_batch_http_request()</a></code></p>
+<p class="firstline">Create a BatchHttpRequest object based on the discovery document.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="new_batch_http_request">new_batch_http_request()</code>
+  <pre>Create a BatchHttpRequest object based on the discovery document.
+
+        Args:
+          callback: callable, A callback to be called for each response, of the
+            form callback(id, response, exception). The first parameter is the
+            request id, and the second is the deserialized response object. The
+            third is an apiclient.errors.HttpError exception object if an HTTP
+            error occurred while processing the request, or None if no error
+            occurred.
+
+        Returns:
+          A BatchHttpRequest object based on the discovery document.
+        </pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/slides_v1.presentations.html b/docs/dyn/slides_v1.presentations.html
new file mode 100644
index 00000000000..95b1c7b11e6
--- /dev/null
+++ b/docs/dyn/slides_v1.presentations.html
@@ -0,0 +1,17934 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="slides_v1.html">Google Slides API</a> . <a href="slides_v1.presentations.html">presentations</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="slides_v1.presentations.pages.html">pages()</a></code>
+</p>
+<p class="firstline">Returns the pages Resource.</p>
+
+<p class="toc_element">
+  <code><a href="#batchUpdate">batchUpdate(presentationId, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Applies one or more updates to the presentation.</p>
+<p class="toc_element">
+  <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a new presentation using the title given in the request. Other</p>
+<p class="toc_element">
+  <code><a href="#get">get(presentationId, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the latest version of the specified presentation.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="batchUpdate">batchUpdate(presentationId, body, x__xgafv=None)</code>
+  <pre>Applies one or more updates to the presentation.
+
+Each request is validated before
+being applied. If any request is not valid, then the entire request will
+fail and nothing will be applied.
+
+Some requests have replies to
+give you some information about how they are applied. Other requests do
+not need to return information; these each return an empty reply.
+The order of replies matches that of the requests.
+
+For example, suppose you call batchUpdate with four updates, and only the
+third one returns information. The response would have two empty replies:
+the reply to the third request, and another empty reply, in that order.
+
+Because other users may be editing the presentation, the presentation
+might not exactly reflect your changes: your changes may
+be altered with respect to collaborator changes. If there are no
+collaborators, the presentation should reflect your changes. In any case,
+the updates in your request are guaranteed to be applied together
+atomically.
+
+Args:
+  presentationId: string, The presentation to apply the updates to. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Request message for PresentationsService.BatchUpdatePresentation.
+    "requests": [ # A list of updates to apply to the presentation.
+      { # A single kind of update to apply to a presentation.
+        "insertText": { # Inserts text into a shape or a table cell. # Inserts text into a shape or table cell.
+          "text": "A String", # The text to be inserted.
+              #
+              # Inserting a newline character will implicitly create a new
+              # ParagraphMarker at that index.
+              # The paragraph style of the new paragraph will be copied from the paragraph
+              # at the current insertion index, including lists and bullets.
+              #
+              # Text styles for inserted text will be determined automatically, generally
+              # preserving the styling of neighboring text. In most cases, the text will be
+              # added to the TextRun that exists at the
+              # insertion index.
+              #
+              # Some control characters (U+0000-U+0008, U+000C-U+001F) and characters
+              # from the Unicode Basic Multilingual Plane Private Use Area (U+E000-U+F8FF)
+              # will be stripped out of the inserted text.
+          "cellLocation": { # A location of a single table cell within a table. # The optional table cell location if the text is to be inserted into a table
+              # cell. If present, the object_id must refer to a table.
+            "rowIndex": 42, # The 0-based row index.
+            "columnIndex": 42, # The 0-based column index.
+          },
+          "objectId": "A String", # The object ID of the shape or table where the text will be inserted.
+          "insertionIndex": 42, # The index where the text will be inserted, in Unicode code units, based
+              # on TextElement indexes.
+              #
+              # The index is zero-based and is computed from the start of the string.
+              # The index may be adjusted to prevent insertions inside Unicode grapheme
+              # clusters. In these cases, the text will be inserted immediately after the
+              # grapheme cluster.
+        },
+        "insertTableRows": { # Inserts rows into a table. # Inserts rows into a table.
+          "number": 42, # The number of rows to be inserted. Maximum 20 per request.
+          "insertBelow": True or False, # Whether to insert new rows below the reference cell location.
+              #
+              # - `True`: insert below the cell.
+              # - `False`: insert above the cell.
+          "cellLocation": { # A location of a single table cell within a table. # The reference table cell location from which rows will be inserted.
+              #
+              # A new row will be inserted above (or below) the row where the reference
+              # cell is. If the reference cell is a merged cell, a new row will be
+              # inserted above (or below) the merged cell.
+            "rowIndex": 42, # The 0-based row index.
+            "columnIndex": 42, # The 0-based column index.
+          },
+          "tableObjectId": "A String", # The table to insert rows into.
+        },
+        "createVideo": { # Creates a video. # Creates a video.
+          "source": "A String", # The video source.
+          "elementProperties": { # Common properties for a page element. # The element properties for the video.
+              #
+              # Note: When you initially create a
+              # PageElement, the API may modify
+              # the values of both `size` and `transform`, but the
+              # visual size will be unchanged.
+            "pageObjectId": "A String", # The object ID of the page where the element is located.
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform for the element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "size": { # A width and height. # The size of the element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "objectId": "A String", # A user-supplied object ID.
+              #
+              # If you specify an ID, it must be unique among all pages and page elements
+              # in the presentation. The ID must start with an alphanumeric character or an
+              # underscore (matches regex `[a-zA-Z0-9_]`); remaining characters
+              # may include those as well as a hyphen or colon (matches regex
+              # `[a-zA-Z0-9_-:]`).
+              # The length of the ID must not be less than 5 or greater than 50.
+              #
+              # If you don't specify an ID, a unique one is generated.
+          "id": "A String", # The video source's unique identifier for this video.
+              #
+              # e.g. For YouTube video https://www.youtube.com/watch?v=7U3axjORYZ0,
+              # the ID is 7U3axjORYZ0.
+        },
+        "deleteTableRow": { # Deletes a row from a table. # Deletes a row from a table.
+          "cellLocation": { # A location of a single table cell within a table. # The reference table cell location from which a row will be deleted.
+              #
+              # The row this cell spans will be deleted. If this is a merged cell, multiple
+              # rows will be deleted. If no rows remain in the table after this deletion,
+              # the whole table is deleted.
+            "rowIndex": 42, # The 0-based row index.
+            "columnIndex": 42, # The 0-based column index.
+          },
+          "tableObjectId": "A String", # The table to delete rows from.
+        },
+        "updateImageProperties": { # Update the properties of an Image. # Updates the properties of an Image.
+          "fields": "A String", # The fields that should be updated.
+              #
+              # At least one field must be specified. The root `imageProperties` is
+              # implied and should not be specified. A single `"*"` can be used as
+              # short-hand for listing every field.
+              #
+              # For example to update the image outline color, set `fields` to
+              # `"outline.outlineFill.solidFill.color"`.
+              #
+              # To reset a property to its default value, include its field name in the
+              # field mask but leave the field itself unset.
+          "imageProperties": { # The properties of the Image. # The image properties to update.
+            "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "dashStyle": "A String", # The dash style of the outline.
+              "propertyState": "A String", # The outline property state.
+                  #
+                  # Updating the the outline on a page element will implicitly update this
+                  # field to`RENDERED`, unless another value is specified in the same request.
+                  # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                  # this case, any other outline fields set in the same request will be
+                  # ignored.
+              "outlineFill": { # The fill of the outline. # The fill of the outline.
+                "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                    # specified color value.
+                    #
+                    # If any field is unset, its value may be inherited from a parent placeholder
+                    # if it exists.
+                  "color": { # A themeable solid color value. # The color value of the solid fill.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                      # That is, the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color.
+                },
+              },
+              "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+            "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+            "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                # This property is read-only.
+              "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                  # stops. This property is read-only.
+                { # A color and position in a gradient band.
+                  "color": { # A themeable solid color value. # The color of the gradient stop.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "position": 3.14, # The relative position of the color stop in the gradient band measured
+                      # in percentage. The value should be in the interval [0.0, 1.0].
+                  "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                      # fully opaque.
+                },
+              ],
+            },
+            "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                  # presentation with this ID. A page with this ID may not exist.
+              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                  # in the presentation. There may not be a slide at this index.
+              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                  # addressed by its position.
+            },
+            "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                # This property is read-only.
+            "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                # This property is read-only.
+                # Image.
+                #
+                # The crop properties is represented by the offsets of four edges which define
+                # a crop rectangle. The offsets are measured in percentage from the
+                # corresponding edges of the object's original bounding rectangle towards
+                # inside, relative to the object's original dimensions.
+                #
+                # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                # rectangle is positioned inside of the object's original bounding rectangle.
+                # - If the offset is negative or greater than 1, the corresponding edge of crop
+                # rectangle is positioned outside of the object's original bounding rectangle.
+                # - If the left edge of the crop rectangle is on the right side of its right
+                # edge, the object will be flipped horizontally.
+                # - If the top edge of the crop rectangle is below its bottom edge, the object
+                # will be flipped vertically.
+                # - If all offsets and rotation angle is 0, the object is not cropped.
+                #
+                # After cropping, the content in the crop rectangle will be stretched to fit
+                # its container.
+              "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                  # the right of the original bounding rectangle left edge, relative to the
+                  # object's original width.
+              "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                  # Rotation angle is applied after the offset.
+              "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                  # above the original bounding rectangle bottom edge, relative to the object's
+                  # original height.
+              "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                  # to the left of the original bounding rectangle right edge, relative to the
+                  # object's original width.
+              "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                  # below the original bounding rectangle top edge, relative to the object's
+                  # original height.
+            },
+            "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                # is read-only.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "color": { # A themeable solid color value. # The shadow color value.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                  # relative to the alignment position.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "propertyState": "A String", # The shadow property state.
+                  #
+                  # Updating the the shadow on a page element will implicitly update this field
+                  # to `RENDERED`, unless another value is specified in the same request. To
+                  # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                  # case, any other shadow fields set in the same request will be ignored.
+              "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                  # shadow becomes.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+              "type": "A String", # The type of the shadow.
+              "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                  # scale and skew of the shadow.
+              "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+            },
+            "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+          },
+          "objectId": "A String", # The object ID of the image the updates are applied to.
+        },
+        "createLine": { # Creates a line. # Creates a line.
+          "lineCategory": "A String", # The category of line to be created.
+          "elementProperties": { # Common properties for a page element. # The element properties for the line.
+              #
+              # Note: When you initially create a
+              # PageElement, the API may modify
+              # the values of both `size` and `transform`, but the
+              # visual size will be unchanged.
+            "pageObjectId": "A String", # The object ID of the page where the element is located.
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform for the element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "size": { # A width and height. # The size of the element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "objectId": "A String", # A user-supplied object ID.
+              #
+              # If you specify an ID, it must be unique among all pages and page elements
+              # in the presentation. The ID must start with an alphanumeric character or an
+              # underscore (matches regex `[a-zA-Z0-9_]`); remaining characters
+              # may include those as well as a hyphen or colon (matches regex
+              # `[a-zA-Z0-9_-:]`).
+              # The length of the ID must not be less than 5 or greater than 50.
+              #
+              # If you don't specify an ID, a unique one is generated.
+        },
+        "createImage": { # Creates an image. # Creates an image.
+          "url": "A String", # The image URL.
+              #
+              # The image is fetched once at insertion time and a copy is stored for
+              # display inside the presentation. Images must be less than 50MB in size,
+              # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+              # format.
+          "elementProperties": { # Common properties for a page element. # The element properties for the image.
+              #
+              # When the aspect ratio of the provided size does not match the image aspect
+              # ratio, the image is scaled and centered with respect to the size in order
+              # to maintain aspect ratio. The provided transform is applied after this
+              # operation.
+              #
+              # Note: When you initially create a
+              # PageElement, the API may modify
+              # the values of both `size` and `transform`, but the
+              # visual size will be unchanged.
+            "pageObjectId": "A String", # The object ID of the page where the element is located.
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform for the element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "size": { # A width and height. # The size of the element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "objectId": "A String", # A user-supplied object ID.
+              #
+              # If you specify an ID, it must be unique among all pages and page elements
+              # in the presentation. The ID must start with an alphanumeric character or an
+              # underscore (matches regex `[a-zA-Z0-9_]`); remaining characters
+              # may include those as well as a hyphen or colon (matches regex
+              # `[a-zA-Z0-9_-:]`).
+              # The length of the ID must not be less than 5 or greater than 50.
+              #
+              # If you don't specify an ID, a unique one is generated.
+        },
+        "updateVideoProperties": { # Update the properties of a Video. # Updates the properties of a Video.
+          "videoProperties": { # The properties of the Video. # The video properties to update.
+            "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                # videos created in the Slides editor.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "dashStyle": "A String", # The dash style of the outline.
+              "propertyState": "A String", # The outline property state.
+                  #
+                  # Updating the the outline on a page element will implicitly update this
+                  # field to`RENDERED`, unless another value is specified in the same request.
+                  # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                  # this case, any other outline fields set in the same request will be
+                  # ignored.
+              "outlineFill": { # The fill of the outline. # The fill of the outline.
+                "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                    # specified color value.
+                    #
+                    # If any field is unset, its value may be inherited from a parent placeholder
+                    # if it exists.
+                  "color": { # A themeable solid color value. # The color value of the solid fill.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                      # That is, the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color.
+                },
+              },
+              "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "objectId": "A String", # The object ID of the video the updates are applied to.
+          "fields": "A String", # The fields that should be updated.
+              #
+              # At least one field must be specified. The root `videoProperties` is
+              # implied and should not be specified. A single `"*"` can be used as
+              # short-hand for listing every field.
+              #
+              # For example to update the video outline color, set `fields` to
+              # `"outline.outlineFill.solidFill.color"`.
+              #
+              # To reset a property to its default value, include its field name in the
+              # field mask but leave the field itself unset.
+        },
+        "updateLineProperties": { # Updates the properties of a Line. # Updates the properties of a Line.
+          "fields": "A String", # The fields that should be updated.
+              #
+              # At least one field must be specified. The root `lineProperties` is
+              # implied and should not be specified. A single `"*"` can be used as
+              # short-hand for listing every field.
+              #
+              # For example to update the line solid fill color, set `fields` to
+              # `"lineFill.solidFill.color"`.
+              #
+              # To reset a property to its default value, include its field name in the
+              # field mask but leave the field itself unset.
+          "lineProperties": { # The properties of the Line. # The line properties to update.
+              #
+              # When unset, these fields default to values that match the appearance of
+              # new lines created in the Slides editor.
+            "dashStyle": "A String", # The dash style of the line.
+            "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+              "magnitude": 3.14, # The magnitude.
+              "unit": "A String", # The units for magnitude.
+            },
+            "endArrow": "A String", # The style of the arrow at the end of the line.
+            "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                  # presentation with this ID. A page with this ID may not exist.
+              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                  # in the presentation. There may not be a slide at this index.
+              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                  # addressed by its position.
+            },
+            "startArrow": "A String", # The style of the arrow at the beginning of the line.
+            "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                # lines created in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+            },
+          },
+          "objectId": "A String", # The object ID of the line the update is applied to.
+        },
+        "deleteText": { # Deletes text from a shape or a table cell. # Deletes text from a shape or a table cell.
+          "textRange": { # Specifies a contiguous range of an indexed collection, such as characters in # The range of text to delete, based on TextElement indexes.
+              #
+              # There is always an implicit newline character at the end of a shape's or
+              # table cell's text that cannot be deleted. `Range.Type.ALL` will use the
+              # correct bounds, but care must be taken when specifying explicit bounds for
+              # range types `FROM_START_INDEX` and `FIXED_RANGE`. For example, if the text
+              # is "ABC", followed by an implicit newline, then the maximum value is 2 for
+              # `text_range.start_index` and 3 for `text_range.end_index`.
+              #
+              # Deleting text that crosses a paragraph boundary may result in changes
+              # to paragraph styles and lists as the two paragraphs are merged.
+              #
+              # Ranges that include only one code unit of a surrogate pair are expanded to
+              # include both code units.
+              # text.
+            "endIndex": 42, # The optional zero-based index of the end of the collection.
+                # Required for `SPECIFIC_RANGE` delete mode.
+            "startIndex": 42, # The optional zero-based index of the beginning of the collection.
+                # Required for `SPECIFIC_RANGE` and `FROM_START_INDEX` ranges.
+            "type": "A String", # The type of range.
+          },
+          "objectId": "A String", # The object ID of the shape or table from which the text will be deleted.
+          "cellLocation": { # A location of a single table cell within a table. # The optional table cell location if the text is to be deleted from a table
+              # cell. If present, the object_id must refer to a table.
+            "rowIndex": 42, # The 0-based row index.
+            "columnIndex": 42, # The 0-based column index.
+          },
+        },
+        "updatePageProperties": { # Updates the properties of a Page. # Updates the properties of a Page.
+          "pageProperties": { # The properties of the Page. # The page properties to update.
+              #
+              # The page will inherit properties from the parent page. Depending on the page
+              # type the hierarchy is defined in either
+              # SlideProperties or
+              # LayoutProperties.
+            "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+                # from a parent page if it exists. If the page has no parent, then the
+                # background fill defaults to the corresponding fill in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a page will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+              "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                  # the specified picture. The picture is stretched to fit its container.
+                "contentUrl": "A String", # Reading the content_url:
+                    #
+                    # An URL to a picture with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the picture as the original requester. Access to the
+                    # picture may be lost if the presentation's sharing settings change.
+                    #
+                    # Writing the content_url:
+                    #
+                    # The picture is fetched once at insertion time and a copy is stored for
+                    # display inside the presentation. Pictures must be less than 50MB in size,
+                    # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                    # format.
+                "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                  "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+            },
+            "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+                # a parent page. If the page has no parent, the color scheme uses a default
+                # Slides color scheme. This field is read-only.
+              "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+                { # A pair mapping a theme color type to the concrete color it represents.
+                  "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                  "type": "A String", # The type of the theme color.
+                },
+              ],
+            },
+          },
+          "fields": "A String", # The fields that should be updated.
+              #
+              # At least one field must be specified. The root `pageProperties` is
+              # implied and should not be specified. A single `"*"` can be used as
+              # short-hand for listing every field.
+              #
+              # For example to update the page background solid fill color, set `fields`
+              # to `"pageBackgroundFill.solidFill.color"`.
+              #
+              # To reset a property to its default value, include its field name in the
+              # field mask but leave the field itself unset.
+          "objectId": "A String", # The object ID of the page the update is applied to.
+        },
+        "updateTextStyle": { # Update the styling of text in a Shape or # Updates the styling of text within a Shape or Table.
+            # Table.
+          "fields": "A String", # The fields that should be updated.
+              #
+              # At least one field must be specified. The root `style` is implied and
+              # should not be specified. A single `"*"` can be used as short-hand for
+              # listing every field.
+              #
+              # For example to update the text style to bold, set `fields` to `"bold"`.
+              #
+              # To reset a property to its default value,
+              # include its field name in the field mask but leave the field itself unset.
+          "style": { # Represents the styling that can be applied to a TextRun. # The style(s) to set on the text.
+              #
+              # If the value for a particular style matches that of the parent, that style
+              # will be set to inherit.
+              #
+              # Certain text style changes may cause other changes meant to mirror the
+              # behavior of the Slides editor. See the documentation of
+              # TextStyle for more information.
+              #
+              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+              # inherited from the parent. Which text styles are inherited depend on the
+              # nesting level of lists:
+              #
+              # * A text run in a paragraph that is not in a list will inherit its text style
+              #   from the the newline character in the paragraph at the 0 nesting level of
+              #   the list inside the parent placeholder.
+              # * A text run in a paragraph that is in a list will inherit its text style
+              #   from the newline character in the paragraph at its corresponding nesting
+              #   level of the list inside the parent placeholder.
+              #
+              # Inherited text styles are represented as unset fields in this message. If
+              # text is contained in a shape without a parent placeholder, unsetting these
+              # fields will revert the style to a value matching the defaults in the Slides
+              # editor.
+            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                # transparent, depending on if the `opaque_color` field in it is set.
+              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                  # a transparent color.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+            },
+            "bold": True or False, # Whether or not the text is bold.
+            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                #
+                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                # rendered in a smaller font size, computed based on the `font_size` field.
+                # The `font_size` itself is not affected by changes in this field.
+            "strikethrough": True or False, # Whether or not the text is struck through.
+            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+            "fontFamily": "A String", # The font family of the text.
+                #
+                # The font family can be any font from the Font menu in Slides or from
+                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                # unrecognized, the text is rendered in `Arial`.
+                #
+                # Some fonts can affect the weight of the text. If an update request
+                # specifies values for both `font_family` and `bold`, the explicitly-set
+                # `bold` value is used.
+            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                # are not inherited from parent text.
+                #
+                # Changing the link in an update request causes some other changes to the
+                # text style of the range:
+                #
+                # * When setting a link, the text foreground color will be set to
+                #   ThemeColorType.HYPERLINK and the text will
+                #   be underlined. If these fields are modified in the same
+                #   request, those values will be used instead of the link defaults.
+                # * Setting a link on a text range that overlaps with an existing link will
+                #   also update the existing link to point to the new URL.
+                # * Links are not settable on newline characters. As a result, setting a link
+                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                #   will separate the newline character(s) into their own text runs. The
+                #   link will be applied separately to the runs before and after the newline.
+                # * Removing a link will update the text style of the range to match the
+                #   style of the preceding text (or the default text styles if the preceding
+                #   text is another link) unless different styles are being set in the same
+                #   request.
+              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                  # presentation with this ID. A page with this ID may not exist.
+              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                  # in the presentation. There may not be a slide at this index.
+              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                  # addressed by its position.
+            },
+            "italic": True or False, # Whether or not the text is italicized.
+            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                # points.
+              "magnitude": 3.14, # The magnitude.
+              "unit": "A String", # The units for magnitude.
+            },
+            "underline": True or False, # Whether or not the text is underlined.
+            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                # transparent, depending on if the `opaque_color` field in it is set.
+              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                  # a transparent color.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+            },
+          },
+          "textRange": { # Specifies a contiguous range of an indexed collection, such as characters in # The range of text to style.
+              #
+              # The range may be extended to include adjacent newlines.
+              #
+              # If the range fully contains a paragraph belonging to a list, the
+              # paragraph's bullet is also updated with the matching text style.
+              # text.
+            "endIndex": 42, # The optional zero-based index of the end of the collection.
+                # Required for `SPECIFIC_RANGE` delete mode.
+            "startIndex": 42, # The optional zero-based index of the beginning of the collection.
+                # Required for `SPECIFIC_RANGE` and `FROM_START_INDEX` ranges.
+            "type": "A String", # The type of range.
+          },
+          "objectId": "A String", # The object ID of the shape or table with the text to be styled.
+          "cellLocation": { # A location of a single table cell within a table. # The optional table cell location if the text to be styled is in a table
+              # cell. If present, the object_id must refer to a table.
+            "rowIndex": 42, # The 0-based row index.
+            "columnIndex": 42, # The 0-based column index.
+          },
+        },
+        "updateTableCellProperties": { # Update the properties of a TableCell. # Updates the properties of a TableCell.
+          "tableRange": { # A table range represents a reference to a subset of a table. # The table range representing the subset of the table to which the updates
+              # are applied. If a table range is not specified, the updates will apply to
+              # the entire table.
+              #
+              # It's important to note that the cells specified by a table range do not
+              # necessarily form a rectangle. For example, let's say we have a 3 x 3 table
+              # where all the cells of the last row are merged together. The table looks
+              # like this:
+              #
+              #
+              #   [             ]
+              #
+              # A table range with location = (0, 0), row span = 3 and column span = 2
+              # specifies the following cells:
+              #
+              #    x     x
+              #   [      x      ]
+            "rowSpan": 42, # The row span of the table range.
+            "columnSpan": 42, # The column span of the table range.
+            "location": { # A location of a single table cell within a table. # The starting location of the table range.
+              "rowIndex": 42, # The 0-based row index.
+              "columnIndex": 42, # The 0-based column index.
+            },
+          },
+          "tableCellProperties": { # The properties of the TableCell. # The table cell properties to update.
+            "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                # for newly created table cells in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a table cell will implicitly update this field
+                  # to `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                  # case, any other fill fields set in the same request will be ignored.
+            },
+          },
+          "objectId": "A String", # The object ID of the table.
+          "fields": "A String", # The fields that should be updated.
+              #
+              # At least one field must be specified. The root `tableCellProperties` is
+              # implied and should not be specified. A single `"*"` can be used as
+              # short-hand for listing every field.
+              #
+              # For example to update the table cell background solid fill color, set
+              # `fields` to `"tableCellBackgroundFill.solidFill.color"`.
+              #
+              # To reset a property to its default value, include its field name in the
+              # field mask but leave the field itself unset.
+        },
+        "replaceAllShapesWithImage": { # Replaces all shapes that match the given criteria with the provided image. # Replaces all shapes matching some criteria with an image.
+          "containsText": { # A criteria that matches a specific string of text in a shape or table. # If set, this request will replace all of the shapes that contain the
+              # given text.
+            "text": "A String", # The text to search for in the shape or table.
+            "matchCase": True or False, # Indicates whether the search should respect case:
+                #
+                # - `True`: the search is case sensitive.
+                # - `False`: the search is case insensitive.
+          },
+          "imageUrl": "A String", # The image URL.
+              #
+              # The image is fetched once at insertion time and a copy is stored for
+              # display inside the presentation. Images must be less than 50MB in size,
+              # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+              # format.
+          "replaceMethod": "A String", # The replace method.
+        },
+        "updateSlidesPosition": { # Updates the position of slides in the presentation. # Updates the position of a set of slides in the presentation.
+          "slideObjectIds": [ # The IDs of the slides in the presentation that should be moved.
+              # The slides in this list must be in existing presentation order, without
+              # duplicates.
+            "A String",
+          ],
+          "insertionIndex": 42, # The index where the slides should be inserted, based on the slide
+              # arrangement before the move takes place. Must be between zero and the
+              # number of slides in the presentation, inclusive.
+        },
+        "duplicateObject": { # Duplicates a slide or page element. # Duplicates a slide or page element.
+            #
+            # When duplicating a slide, the duplicate slide will be created immediately
+            # following the specified slide. When duplicating a page element, the duplicate
+            # will be placed on the same page at the same position as the original.
+          "objectIds": { # The object being duplicated may contain other objects, for example when
+              # duplicating a slide or a group page element. This map defines how the IDs
+              # of duplicated objects are generated: the keys are the IDs of the original
+              # objects and its values are the IDs that will be assigned to the
+              # corresponding duplicate object. The ID of the source object's duplicate
+              # may be specified in this map as well, using the same value of the
+              # `object_id` field as a key and the newly desired ID as the value.
+              #
+              # All keys must correspond to existing IDs in the presentation. All values
+              # must be unique in the presentation and must start with an alphanumeric
+              # character or an underscore (matches regex `[a-zA-Z0-9_]`); remaining
+              # characters may include those as well as a hyphen or colon (matches regex
+              # `[a-zA-Z0-9_-:]`). The length of the new ID must not be less than 5 or
+              # greater than 50.
+              #
+              # If any IDs of source objects are omitted from the map, a new random ID will
+              # be assigned. If the map is empty or unset, all duplicate objects will
+              # receive a new random ID.
+            "a_key": "A String",
+          },
+          "objectId": "A String", # The ID of the object to duplicate.
+        },
+        "refreshSheetsChart": { # Refreshes an embedded Google Sheets chart by replacing it with the latest # Refreshes a Google Sheets chart.
+            # version of the chart from Google Sheets.
+            #
+            # NOTE: Refreshing charts requires  at least one of the spreadsheets.readonly,
+            # spreadsheets, drive.readonly, or drive OAuth scopes.
+          "objectId": "A String", # The object ID of the chart to refresh.
+        },
+        "replaceAllText": { # Replaces all instances of text matching a criteria with replace text. # Replaces all instances of specified text.
+          "containsText": { # A criteria that matches a specific string of text in a shape or table. # Finds text in a shape matching this substring.
+            "text": "A String", # The text to search for in the shape or table.
+            "matchCase": True or False, # Indicates whether the search should respect case:
+                #
+                # - `True`: the search is case sensitive.
+                # - `False`: the search is case insensitive.
+          },
+          "replaceText": "A String", # The text that will replace the matched text.
+        },
+        "createSheetsChart": { # Creates an embedded Google Sheets chart. # Creates an embedded Google Sheets chart.
+            #
+            # NOTE: Chart creation requires  at least one of the spreadsheets.readonly,
+            # spreadsheets, drive.readonly, or drive OAuth scopes.
+          "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet.
+          "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the chart.
+          "linkingMode": "A String", # The mode with which the chart is linked to the source spreadsheet. When
+              # not specified, the chart will be an image that is not linked.
+          "elementProperties": { # Common properties for a page element. # The element properties for the chart.
+              #
+              # When the aspect ratio of the provided size does not match the chart aspect
+              # ratio, the chart is scaled and centered with respect to the size in order
+              # to maintain aspect ratio. The provided transform is applied after this
+              # operation.
+              #
+              # Note: When you initially create a
+              # PageElement, the API may modify
+              # the values of both `size` and `transform`, but the
+              # visual size will be unchanged.
+            "pageObjectId": "A String", # The object ID of the page where the element is located.
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform for the element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "size": { # A width and height. # The size of the element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "objectId": "A String", # A user-supplied object ID.
+              #
+              # If specified, the ID must be unique among all pages and page elements in
+              # the presentation. The ID should start with a word character [a-zA-Z0-9_]
+              # and then followed by any number of the following characters [a-zA-Z0-9_-:].
+              # The length of the ID should not be less than 5 or greater than 50.
+              # If empty, a unique identifier will be generated.
+        },
+        "createSlide": { # Creates a new slide. # Creates a new slide.
+          "slideLayoutReference": { # Slide layout reference. This may reference either: # Layout reference of the slide to be inserted, based on the *current
+              # master*, which is one of the following:
+              #
+              # - The master of the previous slide index.
+              # - The master of the first slide, if the insertion_index is zero.
+              # - The first master in the presentation, if there are no slides.
+              #
+              # If the LayoutReference is not found in the current master, a 400 bad
+              # request error is returned.
+              #
+              # If you don't specify a layout reference, then the new slide will use the
+              # predefined layout `BLANK`.
+              #
+              # - A predefined layout
+              # - One of the layouts in the presentation.
+            "predefinedLayout": "A String", # Predefined layout.
+            "layoutId": "A String", # Layout ID: the object ID of one of the layouts in the presentation.
+          },
+          "objectId": "A String", # A user-supplied object ID.
+              #
+              # If you specify an ID, it must be unique among all pages and page elements
+              # in the presentation. The ID must start with an alphanumeric character or an
+              # underscore (matches regex `[a-zA-Z0-9_]`); remaining characters
+              # may include those as well as a hyphen or colon (matches regex
+              # `[a-zA-Z0-9_-:]`).
+              # The length of the ID must not be less than 5 or greater than 50.
+              #
+              # If you don't specify an ID, a unique one is generated.
+          "insertionIndex": 42, # The optional zero-based index indicating where to insert the slides.
+              #
+              # If you don't specify an index, the new slide is created at the end.
+        },
+        "deleteObject": { # Deletes an object, either pages or # Deletes a page or page element from the presentation.
+            # page elements, from the
+            # presentation.
+          "objectId": "A String", # The object ID of the page or page element to delete.
+              #
+              # If after a delete operation a group contains
+              # only 1 or no page elements, the group is also deleted.
+              #
+              # If a placeholder is deleted on a layout, any empty inheriting shapes are
+              # also deleted.
+        },
+        "updateShapeProperties": { # Update the properties of a Shape. # Updates the properties of a Shape.
+          "fields": "A String", # The fields that should be updated.
+              #
+              # At least one field must be specified. The root `shapeProperties` is
+              # implied and should not be specified. A single `"*"` can be used as
+              # short-hand for listing every field.
+              #
+              # For example to update the shape background solid fill color, set `fields`
+              # to `"shapeBackgroundFill.solidFill.color"`.
+              #
+              # To reset a property to its default value, include its field name in the
+              # field mask but leave the field itself unset.
+          "shapeProperties": { # The properties of a Shape. # The shape properties to update.
+              #
+              # If the shape is a placeholder shape as determined by the
+              # placeholder field, then these
+              # properties may be inherited from a parent placeholder shape.
+              # Determining the rendered value of the property depends on the corresponding
+              # property_state field value.
+            "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                # a parent placeholder if it exists. If the shape has no parent, then the
+                # default shadow matches the defaults for new shapes created in the Slides
+                # editor. This property is read-only.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "color": { # A themeable solid color value. # The shadow color value.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                  # relative to the alignment position.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "propertyState": "A String", # The shadow property state.
+                  #
+                  # Updating the the shadow on a page element will implicitly update this field
+                  # to `RENDERED`, unless another value is specified in the same request. To
+                  # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                  # case, any other shadow fields set in the same request will be ignored.
+              "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                  # shadow becomes.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+              "type": "A String", # The type of the shadow.
+              "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                  # scale and skew of the shadow.
+              "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+            },
+            "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                # inherited from a parent placeholder if it exists. If the shape has no
+                # parent, then the default background fill depends on the shape type,
+                # matching the defaults for new shapes created in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a shape will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+            },
+            "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                # are not inherited from parent placeholders.
+              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                  # presentation with this ID. A page with this ID may not exist.
+              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                  # in the presentation. There may not be a slide at this index.
+              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                  # addressed by its position.
+            },
+            "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                # parent placeholder if it exists. If the shape has no parent, then the
+                # default outline depends on the shape type, matching the defaults for
+                # new shapes created in the Slides editor.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "dashStyle": "A String", # The dash style of the outline.
+              "propertyState": "A String", # The outline property state.
+                  #
+                  # Updating the the outline on a page element will implicitly update this
+                  # field to`RENDERED`, unless another value is specified in the same request.
+                  # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                  # this case, any other outline fields set in the same request will be
+                  # ignored.
+              "outlineFill": { # The fill of the outline. # The fill of the outline.
+                "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                    # specified color value.
+                    #
+                    # If any field is unset, its value may be inherited from a parent placeholder
+                    # if it exists.
+                  "color": { # A themeable solid color value. # The color value of the solid fill.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                      # That is, the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color.
+                },
+              },
+              "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "objectId": "A String", # The object ID of the shape the updates are applied to.
+        },
+        "createShape": { # Creates a new shape. # Creates a new shape.
+          "elementProperties": { # Common properties for a page element. # The element properties for the shape.
+              #
+              # Note: When you initially create a
+              # PageElement, the API may modify
+              # the values of both `size` and `transform`, but the
+              # visual size will be unchanged.
+            "pageObjectId": "A String", # The object ID of the page where the element is located.
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform for the element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "size": { # A width and height. # The size of the element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "shapeType": "A String", # The shape type.
+          "objectId": "A String", # A user-supplied object ID.
+              #
+              # If you specify an ID, it must be unique among all pages and page elements
+              # in the presentation. The ID must start with an alphanumeric character or an
+              # underscore (matches regex `[a-zA-Z0-9_]`); remaining characters
+              # may include those as well as a hyphen or colon (matches regex
+              # `[a-zA-Z0-9_-:]`).
+              # The length of the ID must not be less than 5 or greater than 50.
+              # If empty, a unique identifier will be generated.
+        },
+        "insertTableColumns": { # Inserts columns into a table. # Inserts columns into a table.
+            #
+            # Other columns in the table will be resized to fit the new column.
+          "number": 42, # The number of columns to be inserted. Maximum 20 per request.
+          "insertRight": True or False, # Whether to insert new columns to the right of the reference cell location.
+              #
+              # - `True`: insert to the right.
+              # - `False`: insert to the left.
+          "cellLocation": { # A location of a single table cell within a table. # The reference table cell location from which columns will be inserted.
+              #
+              # A new column will be inserted to the left (or right) of the column where
+              # the reference cell is. If the reference cell is a merged cell, a new
+              # column will be inserted to the left (or right) of the merged cell.
+            "rowIndex": 42, # The 0-based row index.
+            "columnIndex": 42, # The 0-based column index.
+          },
+          "tableObjectId": "A String", # The table to insert columns into.
+        },
+        "createParagraphBullets": { # Creates bullets for all of the paragraphs that overlap with the given # Creates bullets for paragraphs.
+            # text index range.
+            #
+            # The nesting level of each paragraph will be determined by counting leading
+            # tabs in front of each paragraph. To avoid excess space between the bullet and
+            # the corresponding paragraph, these leading tabs are removed by this request.
+            # This may change the indices of parts of the text.
+            #
+            # If the paragraph immediately before paragraphs being updated is in a list
+            # with a matching preset, the paragraphs being updated are added to that
+            # preceding list.
+          "bulletPreset": "A String", # The kinds of bullet glyphs to be used. Defaults to the
+              # `BULLET_DISC_CIRCLE_SQUARE` preset.
+          "textRange": { # Specifies a contiguous range of an indexed collection, such as characters in # The range of text to apply the bullet presets to, based on TextElement indexes.
+              # text.
+            "endIndex": 42, # The optional zero-based index of the end of the collection.
+                # Required for `SPECIFIC_RANGE` delete mode.
+            "startIndex": 42, # The optional zero-based index of the beginning of the collection.
+                # Required for `SPECIFIC_RANGE` and `FROM_START_INDEX` ranges.
+            "type": "A String", # The type of range.
+          },
+          "objectId": "A String", # The object ID of the shape or table containing the text to add bullets to.
+          "cellLocation": { # A location of a single table cell within a table. # The optional table cell location if the text to be modified is in a table
+              # cell. If present, the object_id must refer to a table.
+            "rowIndex": 42, # The 0-based row index.
+            "columnIndex": 42, # The 0-based column index.
+          },
+        },
+        "createTable": { # Creates a new table. # Creates a new table.
+          "rows": 42, # Number of rows in the table.
+          "elementProperties": { # Common properties for a page element. # The element properties for the table.
+              #
+              # The table will be created at the provided size, subject to a minimum size.
+              # If no size is provided, the table will be automatically sized.
+              #
+              # Table transforms must have a scale of 1 and no shear components. If no
+              # transform is provided, the table will be centered on the page.
+              #
+              # Note: When you initially create a
+              # PageElement, the API may modify
+              # the values of both `size` and `transform`, but the
+              # visual size will be unchanged.
+            "pageObjectId": "A String", # The object ID of the page where the element is located.
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform for the element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "size": { # A width and height. # The size of the element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "objectId": "A String", # A user-supplied object ID.
+              #
+              # If you specify an ID, it must be unique among all pages and page elements
+              # in the presentation. The ID must start with an alphanumeric character or an
+              # underscore (matches regex `[a-zA-Z0-9_]`); remaining characters
+              # may include those as well as a hyphen or colon (matches regex
+              # `[a-zA-Z0-9_-:]`).
+              # The length of the ID must not be less than 5 or greater than 50.
+              #
+              # If you don't specify an ID, a unique one is generated.
+          "columns": 42, # Number of columns in the table.
+        },
+        "deleteTableColumn": { # Deletes a column from a table. # Deletes a column from a table.
+          "cellLocation": { # A location of a single table cell within a table. # The reference table cell location from which a column will be deleted.
+              #
+              # The column this cell spans will be deleted. If this is a merged cell,
+              # multiple columns will be deleted. If no columns remain in the table after
+              # this deletion, the whole table is deleted.
+            "rowIndex": 42, # The 0-based row index.
+            "columnIndex": 42, # The 0-based column index.
+          },
+          "tableObjectId": "A String", # The table to delete columns from.
+        },
+        "updatePageElementTransform": { # Updates the transform of a page element. # Updates the transform of a page element.
+          "applyMode": "A String", # The apply mode of the transform update.
+          "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The input transform matrix used to update the page element.
+              # to transform source coordinates (x,y) into destination coordinates (x', y')
+              # according to:
+              #
+              #       x'  x  =   shear_y  scale_y  translate_y
+              #       1  [ 1 ]
+              #
+              # After transformation,
+              #
+              #      x' = scale_x * x + shear_x * y + translate_x;
+              #      y' = scale_y * y + shear_y * x + translate_y;
+              #
+              # This message is therefore composed of these six matrix elements.
+            "translateX": 3.14, # The X coordinate translation element.
+            "translateY": 3.14, # The Y coordinate translation element.
+            "scaleX": 3.14, # The X coordinate scaling element.
+            "scaleY": 3.14, # The Y coordinate scaling element.
+            "shearY": 3.14, # The Y coordinate shearing element.
+            "shearX": 3.14, # The X coordinate shearing element.
+            "unit": "A String", # The units for translate elements.
+          },
+          "objectId": "A String", # The object ID of the page element to update.
+        },
+      },
+    ],
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message from a batch update.
+    "presentationId": "A String", # The presentation the updates were applied to.
+    "replies": [ # The reply of the updates.  This maps 1:1 with the updates, although
+        # replies to some requests may be empty.
+      { # A single response from an update.
+        "createImage": { # The result of creating an image. # The result of creating an image.
+          "objectId": "A String", # The object ID of the created image.
+        },
+        "replaceAllShapesWithImage": { # The result of replacing shapes with an image. # The result of replacing all shapes containing the specified text with
+            # an image.
+          "occurrencesChanged": 42, # The number of shapes replaced with images.
+        },
+        "duplicateObject": { # The response of duplicating an object. # The result of duplicating an object.
+          "objectId": "A String", # The ID of the new duplicate object.
+        },
+        "createShape": { # The result of creating a shape. # The result of creating a shape.
+          "objectId": "A String", # The object ID of the created shape.
+        },
+        "replaceAllText": { # The result of replacing text. # The result of replacing text.
+          "occurrencesChanged": 42, # The number of occurrences changed by replacing all text.
+        },
+        "createSheetsChart": { # The result of creating an embedded Google Sheets chart. # The result of creating a Google Sheets chart.
+          "objectId": "A String", # The object ID of the created chart.
+        },
+        "createVideo": { # The result of creating a video. # The result of creating a video.
+          "objectId": "A String", # The object ID of the created video.
+        },
+        "createSlide": { # The result of creating a slide. # The result of creating a slide.
+          "objectId": "A String", # The object ID of the created slide.
+        },
+        "createTable": { # The result of creating a table. # The result of creating a table.
+          "objectId": "A String", # The object ID of the created table.
+        },
+        "createLine": { # The result of creating a line. # The result of creating a line.
+          "objectId": "A String", # The object ID of the created line.
+        },
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="create">create(body, x__xgafv=None)</code>
+  <pre>Creates a new presentation using the title given in the request. Other
+fields in the request are ignored.
+Returns the created presentation.
+
+Args:
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # A Google Slides presentation.
+    "presentationId": "A String", # The ID of the presentation.
+    "masters": [ # The slide masters in the presentation. A slide master contains all common
+        # page elements and the common properties for a set of layouts. They serve
+        # three purposes:
+        # 
+        # - Placeholder shapes on a master contain the default text styles and shape
+        #   properties of all placeholder shapes on pages that use that master.
+        # - The master page properties define the common page properties inherited by
+        #   its layouts.
+        # - Any other shapes on the master slide will appear on all slides using that
+        #   master, regardless of their layout.
+      { # A page in a presentation.
+        "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+            # relevant for pages with page_type LAYOUT.
+          "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+          "name": "A String", # The name of the layout.
+          "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+        },
+        "pageElements": [ # The page elements rendered on the page.
+          { # A visual element rendered on a page.
+            "wordArt": { # A PageElement kind representing # A word art page element.
+                # word art.
+              "renderedText": "A String", # The text rendered as word art.
+            },
+            "description": "A String", # The description of the page element. Combined with title to display alt
+                # text.
+            "objectId": "A String", # The object ID for this page element. Object IDs used by
+                # google.apps.slides.v1.Page and
+                # google.apps.slides.v1.PageElement share the same namespace.
+            "title": "A String", # The title of the page element. Combined with description to display alt
+                # text.
+            "image": { # A PageElement kind representing an # An image page element.
+                # image.
+              "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                  # This URL is tagged with the account of the requester. Anyone with the URL
+                  # effectively accesses the image as the original requester. Access to the
+                  # image may be lost if the presentation's sharing settings change.
+              "imageProperties": { # The properties of the Image. # The properties of the image.
+                "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+                "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                    # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                    # This property is read-only.
+                  "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                      # stops. This property is read-only.
+                    { # A color and position in a gradient band.
+                      "color": { # A themeable solid color value. # The color of the gradient stop.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "position": 3.14, # The relative position of the color stop in the gradient band measured
+                          # in percentage. The value should be in the interval [0.0, 1.0].
+                      "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                          # fully opaque.
+                    },
+                  ],
+                },
+                "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                    # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                    # This property is read-only.
+                "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                    # This property is read-only.
+                    # Image.
+                    #
+                    # The crop properties is represented by the offsets of four edges which define
+                    # a crop rectangle. The offsets are measured in percentage from the
+                    # corresponding edges of the object's original bounding rectangle towards
+                    # inside, relative to the object's original dimensions.
+                    #
+                    # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                    # rectangle is positioned inside of the object's original bounding rectangle.
+                    # - If the offset is negative or greater than 1, the corresponding edge of crop
+                    # rectangle is positioned outside of the object's original bounding rectangle.
+                    # - If the left edge of the crop rectangle is on the right side of its right
+                    # edge, the object will be flipped horizontally.
+                    # - If the top edge of the crop rectangle is below its bottom edge, the object
+                    # will be flipped vertically.
+                    # - If all offsets and rotation angle is 0, the object is not cropped.
+                    #
+                    # After cropping, the content in the crop rectangle will be stretched to fit
+                    # its container.
+                  "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                      # the right of the original bounding rectangle left edge, relative to the
+                      # object's original width.
+                  "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                      # Rotation angle is applied after the offset.
+                  "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                      # above the original bounding rectangle bottom edge, relative to the object's
+                      # original height.
+                  "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                      # to the left of the original bounding rectangle right edge, relative to the
+                      # object's original width.
+                  "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                      # below the original bounding rectangle top edge, relative to the object's
+                      # original height.
+                },
+                "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                    # is read-only.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "color": { # A themeable solid color value. # The shadow color value.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                      # relative to the alignment position.
+                      # to transform source coordinates (x,y) into destination coordinates (x', y')
+                      # according to:
+                      #
+                      #       x'  x  =   shear_y  scale_y  translate_y
+                      #       1  [ 1 ]
+                      #
+                      # After transformation,
+                      #
+                      #      x' = scale_x * x + shear_x * y + translate_x;
+                      #      y' = scale_y * y + shear_y * x + translate_y;
+                      #
+                      # This message is therefore composed of these six matrix elements.
+                    "translateX": 3.14, # The X coordinate translation element.
+                    "translateY": 3.14, # The Y coordinate translation element.
+                    "scaleX": 3.14, # The X coordinate scaling element.
+                    "scaleY": 3.14, # The Y coordinate scaling element.
+                    "shearY": 3.14, # The Y coordinate shearing element.
+                    "shearX": 3.14, # The X coordinate shearing element.
+                    "unit": "A String", # The units for translate elements.
+                  },
+                  "propertyState": "A String", # The shadow property state.
+                      #
+                      # Updating the the shadow on a page element will implicitly update this field
+                      # to `RENDERED`, unless another value is specified in the same request. To
+                      # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                      # case, any other shadow fields set in the same request will be ignored.
+                  "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                      # shadow becomes.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                  "type": "A String", # The type of the shadow.
+                  "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                      # scale and skew of the shadow.
+                  "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                },
+                "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                    # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+              },
+            },
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "shape": { # A PageElement kind representing a # A generic shape.
+                # generic shape that does not have a more specific classification.
+              "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                  # text box or rectangle) or a table cell in a page.
+                "textElements": [ # The text contents broken down into its component parts, including styling
+                    # information. This property is read-only.
+                  { # A TextElement describes the content of a range of indices in the text content
+                      # of a Shape or TableCell.
+                    "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                        # replaced with content that can change over time.
+                      "content": "A String", # The rendered content of this auto text, if available.
+                      "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                          # inherited from the parent. Which text styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A text run in a paragraph that is not in a list will inherit its text style
+                          #   from the the newline character in the paragraph at the 0 nesting level of
+                          #   the list inside the parent placeholder.
+                          # * A text run in a paragraph that is in a list will inherit its text style
+                          #   from the newline character in the paragraph at its corresponding nesting
+                          #   level of the list inside the parent placeholder.
+                          #
+                          # Inherited text styles are represented as unset fields in this message. If
+                          # text is contained in a shape without a parent placeholder, unsetting these
+                          # fields will revert the style to a value matching the defaults in the Slides
+                          # editor.
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "bold": True or False, # Whether or not the text is bold.
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                            #
+                            # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                            # rendered in a smaller font size, computed based on the `font_size` field.
+                            # The `font_size` itself is not affected by changes in this field.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "fontFamily": "A String", # The font family of the text.
+                            #
+                            # The font family can be any font from the Font menu in Slides or from
+                            # [Google Fonts] (https://fonts.google.com/). If the font name is
+                            # unrecognized, the text is rendered in `Arial`.
+                            #
+                            # Some fonts can affect the weight of the text. If an update request
+                            # specifies values for both `font_family` and `bold`, the explicitly-set
+                            # `bold` value is used.
+                        "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                            # are not inherited from parent text.
+                            #
+                            # Changing the link in an update request causes some other changes to the
+                            # text style of the range:
+                            #
+                            # * When setting a link, the text foreground color will be set to
+                            #   ThemeColorType.HYPERLINK and the text will
+                            #   be underlined. If these fields are modified in the same
+                            #   request, those values will be used instead of the link defaults.
+                            # * Setting a link on a text range that overlaps with an existing link will
+                            #   also update the existing link to point to the new URL.
+                            # * Links are not settable on newline characters. As a result, setting a link
+                            #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                            #   will separate the newline character(s) into their own text runs. The
+                            #   link will be applied separately to the runs before and after the newline.
+                            # * Removing a link will update the text style of the range to match the
+                            #   style of the preceding text (or the default text styles if the preceding
+                            #   text is another link) unless different styles are being set in the same
+                            #   request.
+                          "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                          "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                              # presentation with this ID. A page with this ID may not exist.
+                          "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                              # in the presentation. There may not be a slide at this index.
+                          "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                              # addressed by its position.
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                            # points.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                      },
+                      "type": "A String", # The type of this auto text.
+                    },
+                    "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                        # units.
+                    "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                    "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                        #
+                        # The `start_index` and `end_index` of this TextElement represent the
+                        # range of the paragraph. Other TextElements with an index range contained
+                        # inside this paragraph's range are considered to be part of this
+                        # paragraph. The range of indices of two separate paragraphs will never
+                        # overlap.
+                      "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                          # inherited from the parent. Which paragraph styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A paragraph not in a list will inherit its paragraph style from the
+                          #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                          # * A paragraph in a list will inherit its paragraph style from the paragraph
+                          #   at its corresponding nesting level of the list inside the parent
+                          #   placeholder.
+                          #
+                          # Inherited paragraph styles are represented as unset fields in this message.
+                        "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                        "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                        "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                            # inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                            # is represented as 100.0. If unset, the value is inherited from the parent.
+                            # This property is read-only.
+                        "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                            # the start of the text, based on the current text direction. If unset, the
+                            # value is inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                            # inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                            # the end of the text, based on the current text direction. If unset, the
+                            # value is inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                            # If unset, the value is inherited from the parent. This property is
+                            # read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                      },
+                      "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                          # belong to a list.
+                        "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                        "listId": "A String", # The ID of the list this paragraph belongs to.
+                        "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                      },
+                    },
+                    "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                        # in the run have the same TextStyle.
+                        #
+                        # The `start_index` and `end_index` of TextRuns will always be fully
+                        # contained in the index range of a single `paragraph_marker` TextElement.
+                        # In other words, a TextRun will never span multiple paragraphs.
+                        # styling.
+                      "content": "A String", # The text of this run.
+                      "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                          # inherited from the parent. Which text styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A text run in a paragraph that is not in a list will inherit its text style
+                          #   from the the newline character in the paragraph at the 0 nesting level of
+                          #   the list inside the parent placeholder.
+                          # * A text run in a paragraph that is in a list will inherit its text style
+                          #   from the newline character in the paragraph at its corresponding nesting
+                          #   level of the list inside the parent placeholder.
+                          #
+                          # Inherited text styles are represented as unset fields in this message. If
+                          # text is contained in a shape without a parent placeholder, unsetting these
+                          # fields will revert the style to a value matching the defaults in the Slides
+                          # editor.
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "bold": True or False, # Whether or not the text is bold.
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                            #
+                            # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                            # rendered in a smaller font size, computed based on the `font_size` field.
+                            # The `font_size` itself is not affected by changes in this field.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "fontFamily": "A String", # The font family of the text.
+                            #
+                            # The font family can be any font from the Font menu in Slides or from
+                            # [Google Fonts] (https://fonts.google.com/). If the font name is
+                            # unrecognized, the text is rendered in `Arial`.
+                            #
+                            # Some fonts can affect the weight of the text. If an update request
+                            # specifies values for both `font_family` and `bold`, the explicitly-set
+                            # `bold` value is used.
+                        "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                            # are not inherited from parent text.
+                            #
+                            # Changing the link in an update request causes some other changes to the
+                            # text style of the range:
+                            #
+                            # * When setting a link, the text foreground color will be set to
+                            #   ThemeColorType.HYPERLINK and the text will
+                            #   be underlined. If these fields are modified in the same
+                            #   request, those values will be used instead of the link defaults.
+                            # * Setting a link on a text range that overlaps with an existing link will
+                            #   also update the existing link to point to the new URL.
+                            # * Links are not settable on newline characters. As a result, setting a link
+                            #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                            #   will separate the newline character(s) into their own text runs. The
+                            #   link will be applied separately to the runs before and after the newline.
+                            # * Removing a link will update the text style of the range to match the
+                            #   style of the preceding text (or the default text styles if the preceding
+                            #   text is another link) unless different styles are being set in the same
+                            #   request.
+                          "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                          "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                              # presentation with this ID. A page with this ID may not exist.
+                          "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                              # in the presentation. There may not be a slide at this index.
+                          "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                              # addressed by its position.
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                            # points.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                      },
+                    },
+                  },
+                ],
+                "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                  "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                      # associated with a list. A paragraph that is part of a list has an implicit
+                      # reference to that list's ID.
+                    "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                        # level. A list has at most nine levels of nesting, so the possible values
+                        # for the keys of this map are 0 through 8, inclusive.
+                      "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                          # level of nesting.
+                        "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                    "listId": "A String", # The ID of the list.
+                  },
+                },
+              },
+              "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                  #
+                  # If the shape is a placeholder shape as determined by the
+                  # placeholder field, then these
+                  # properties may be inherited from a parent placeholder shape.
+                  # Determining the rendered value of the property depends on the corresponding
+                  # property_state field value.
+                "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                    # a parent placeholder if it exists. If the shape has no parent, then the
+                    # default shadow matches the defaults for new shapes created in the Slides
+                    # editor. This property is read-only.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "color": { # A themeable solid color value. # The shadow color value.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                      # relative to the alignment position.
+                      # to transform source coordinates (x,y) into destination coordinates (x', y')
+                      # according to:
+                      #
+                      #       x'  x  =   shear_y  scale_y  translate_y
+                      #       1  [ 1 ]
+                      #
+                      # After transformation,
+                      #
+                      #      x' = scale_x * x + shear_x * y + translate_x;
+                      #      y' = scale_y * y + shear_y * x + translate_y;
+                      #
+                      # This message is therefore composed of these six matrix elements.
+                    "translateX": 3.14, # The X coordinate translation element.
+                    "translateY": 3.14, # The Y coordinate translation element.
+                    "scaleX": 3.14, # The X coordinate scaling element.
+                    "scaleY": 3.14, # The Y coordinate scaling element.
+                    "shearY": 3.14, # The Y coordinate shearing element.
+                    "shearX": 3.14, # The X coordinate shearing element.
+                    "unit": "A String", # The units for translate elements.
+                  },
+                  "propertyState": "A String", # The shadow property state.
+                      #
+                      # Updating the the shadow on a page element will implicitly update this field
+                      # to `RENDERED`, unless another value is specified in the same request. To
+                      # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                      # case, any other shadow fields set in the same request will be ignored.
+                  "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                      # shadow becomes.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                  "type": "A String", # The type of the shadow.
+                  "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                      # scale and skew of the shadow.
+                  "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                },
+                "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                    # inherited from a parent placeholder if it exists. If the shape has no
+                    # parent, then the default background fill depends on the shape type,
+                    # matching the defaults for new shapes created in the Slides editor.
+                  "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                      # specified color value.
+                      #
+                      # If any field is unset, its value may be inherited from a parent placeholder
+                      # if it exists.
+                    "color": { # A themeable solid color value. # The color value of the solid fill.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                        # That is, the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color.
+                  },
+                  "propertyState": "A String", # The background fill property state.
+                      #
+                      # Updating the the fill on a shape will implicitly update this field to
+                      # `RENDERED`, unless another value is specified in the same request. To
+                      # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                      # any other fill fields set in the same request will be ignored.
+                },
+                "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                    # are not inherited from parent placeholders.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                    # parent placeholder if it exists. If the shape has no parent, then the
+                    # default outline depends on the shape type, matching the defaults for
+                    # new shapes created in the Slides editor.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+              "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                  # layouts and masters.
+                  #
+                  # If set, the shape is a placeholder shape and any inherited properties
+                  # can be resolved by looking at the parent placeholder identified by the
+                  # Placeholder.parent_object_id field.
+                "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                    # If unset, the parent placeholder shape does not exist, so the shape does
+                    # not inherit properties from any other shape.
+                "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                    # in the same page, they would have different index values.
+                "type": "A String", # The type of the placeholder.
+              },
+              "shapeType": "A String", # The type of the shape.
+            },
+            "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                # represented as images.
+                # a linked chart embedded from Google Sheets.
+              "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                  # embedded.
+              "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+              "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                  # minutes. This URL is tagged with the account of the requester. Anyone with
+                  # the URL effectively accesses the image as the original requester. Access to
+                  # the image may be lost if the presentation's sharing settings change.
+            },
+            "video": { # A PageElement kind representing a # A video page element.
+                # video.
+              "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                  # exists and sharing settings do not change.
+              "videoProperties": { # The properties of the Video. # The properties of the video.
+                "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                    # videos created in the Slides editor.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+              "id": "A String", # The video source's unique identifier for this video.
+              "source": "A String", # The video source.
+            },
+            "table": { # A PageElement kind representing a # A table page element.
+                # table.
+              "tableColumns": [ # Properties of each column.
+                { # Properties of each column in a table.
+                  "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              ],
+              "tableRows": [ # Properties and contents of each row.
+                  #
+                  # Cells that span multiple rows are contained in only one of these rows and
+                  # have a row_span greater
+                  # than 1.
+                { # Properties and contents of each row in a table.
+                  "tableCells": [ # Properties and contents of each cell.
+                      #
+                      # Cells that span multiple columns are represented only once with a
+                      # column_span greater
+                      # than 1. As a result, the length of this collection does not always match
+                      # the number of columns of the entire table.
+                    { # Properties and contents of each table cell.
+                      "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                          # text box or rectangle) or a table cell in a page.
+                        "textElements": [ # The text contents broken down into its component parts, including styling
+                            # information. This property is read-only.
+                          { # A TextElement describes the content of a range of indices in the text content
+                              # of a Shape or TableCell.
+                            "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                # replaced with content that can change over time.
+                              "content": "A String", # The rendered content of this auto text, if available.
+                              "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                  # inherited from the parent. Which text styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A text run in a paragraph that is not in a list will inherit its text style
+                                  #   from the the newline character in the paragraph at the 0 nesting level of
+                                  #   the list inside the parent placeholder.
+                                  # * A text run in a paragraph that is in a list will inherit its text style
+                                  #   from the newline character in the paragraph at its corresponding nesting
+                                  #   level of the list inside the parent placeholder.
+                                  #
+                                  # Inherited text styles are represented as unset fields in this message. If
+                                  # text is contained in a shape without a parent placeholder, unsetting these
+                                  # fields will revert the style to a value matching the defaults in the Slides
+                                  # editor.
+                                "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                                "bold": True or False, # Whether or not the text is bold.
+                                "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                    #
+                                    # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                    # rendered in a smaller font size, computed based on the `font_size` field.
+                                    # The `font_size` itself is not affected by changes in this field.
+                                "strikethrough": True or False, # Whether or not the text is struck through.
+                                "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                "fontFamily": "A String", # The font family of the text.
+                                    #
+                                    # The font family can be any font from the Font menu in Slides or from
+                                    # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                    # unrecognized, the text is rendered in `Arial`.
+                                    #
+                                    # Some fonts can affect the weight of the text. If an update request
+                                    # specifies values for both `font_family` and `bold`, the explicitly-set
+                                    # `bold` value is used.
+                                "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                    # are not inherited from parent text.
+                                    #
+                                    # Changing the link in an update request causes some other changes to the
+                                    # text style of the range:
+                                    #
+                                    # * When setting a link, the text foreground color will be set to
+                                    #   ThemeColorType.HYPERLINK and the text will
+                                    #   be underlined. If these fields are modified in the same
+                                    #   request, those values will be used instead of the link defaults.
+                                    # * Setting a link on a text range that overlaps with an existing link will
+                                    #   also update the existing link to point to the new URL.
+                                    # * Links are not settable on newline characters. As a result, setting a link
+                                    #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                    #   will separate the newline character(s) into their own text runs. The
+                                    #   link will be applied separately to the runs before and after the newline.
+                                    # * Removing a link will update the text style of the range to match the
+                                    #   style of the preceding text (or the default text styles if the preceding
+                                    #   text is another link) unless different styles are being set in the same
+                                    #   request.
+                                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                      # presentation with this ID. A page with this ID may not exist.
+                                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                      # in the presentation. There may not be a slide at this index.
+                                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                      # addressed by its position.
+                                },
+                                "italic": True or False, # Whether or not the text is italicized.
+                                "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                    # points.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "underline": True or False, # Whether or not the text is underlined.
+                                "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                              },
+                              "type": "A String", # The type of this auto text.
+                            },
+                            "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                # units.
+                            "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                            "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                #
+                                # The `start_index` and `end_index` of this TextElement represent the
+                                # range of the paragraph. Other TextElements with an index range contained
+                                # inside this paragraph's range are considered to be part of this
+                                # paragraph. The range of indices of two separate paragraphs will never
+                                # overlap.
+                              "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                  # inherited from the parent. Which paragraph styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A paragraph not in a list will inherit its paragraph style from the
+                                  #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                  # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                  #   at its corresponding nesting level of the list inside the parent
+                                  #   placeholder.
+                                  #
+                                  # Inherited paragraph styles are represented as unset fields in this message.
+                                "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                    # inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                    # is represented as 100.0. If unset, the value is inherited from the parent.
+                                    # This property is read-only.
+                                "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                    # the start of the text, based on the current text direction. If unset, the
+                                    # value is inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                    # inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                    # the end of the text, based on the current text direction. If unset, the
+                                    # value is inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                    # If unset, the value is inherited from the parent. This property is
+                                    # read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                              },
+                              "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                  # belong to a list.
+                                "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                "listId": "A String", # The ID of the list this paragraph belongs to.
+                                "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                              },
+                            },
+                            "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                # in the run have the same TextStyle.
+                                #
+                                # The `start_index` and `end_index` of TextRuns will always be fully
+                                # contained in the index range of a single `paragraph_marker` TextElement.
+                                # In other words, a TextRun will never span multiple paragraphs.
+                                # styling.
+                              "content": "A String", # The text of this run.
+                              "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                  # inherited from the parent. Which text styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A text run in a paragraph that is not in a list will inherit its text style
+                                  #   from the the newline character in the paragraph at the 0 nesting level of
+                                  #   the list inside the parent placeholder.
+                                  # * A text run in a paragraph that is in a list will inherit its text style
+                                  #   from the newline character in the paragraph at its corresponding nesting
+                                  #   level of the list inside the parent placeholder.
+                                  #
+                                  # Inherited text styles are represented as unset fields in this message. If
+                                  # text is contained in a shape without a parent placeholder, unsetting these
+                                  # fields will revert the style to a value matching the defaults in the Slides
+                                  # editor.
+                                "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                                "bold": True or False, # Whether or not the text is bold.
+                                "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                    #
+                                    # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                    # rendered in a smaller font size, computed based on the `font_size` field.
+                                    # The `font_size` itself is not affected by changes in this field.
+                                "strikethrough": True or False, # Whether or not the text is struck through.
+                                "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                "fontFamily": "A String", # The font family of the text.
+                                    #
+                                    # The font family can be any font from the Font menu in Slides or from
+                                    # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                    # unrecognized, the text is rendered in `Arial`.
+                                    #
+                                    # Some fonts can affect the weight of the text. If an update request
+                                    # specifies values for both `font_family` and `bold`, the explicitly-set
+                                    # `bold` value is used.
+                                "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                    # are not inherited from parent text.
+                                    #
+                                    # Changing the link in an update request causes some other changes to the
+                                    # text style of the range:
+                                    #
+                                    # * When setting a link, the text foreground color will be set to
+                                    #   ThemeColorType.HYPERLINK and the text will
+                                    #   be underlined. If these fields are modified in the same
+                                    #   request, those values will be used instead of the link defaults.
+                                    # * Setting a link on a text range that overlaps with an existing link will
+                                    #   also update the existing link to point to the new URL.
+                                    # * Links are not settable on newline characters. As a result, setting a link
+                                    #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                    #   will separate the newline character(s) into their own text runs. The
+                                    #   link will be applied separately to the runs before and after the newline.
+                                    # * Removing a link will update the text style of the range to match the
+                                    #   style of the preceding text (or the default text styles if the preceding
+                                    #   text is another link) unless different styles are being set in the same
+                                    #   request.
+                                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                      # presentation with this ID. A page with this ID may not exist.
+                                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                      # in the presentation. There may not be a slide at this index.
+                                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                      # addressed by its position.
+                                },
+                                "italic": True or False, # Whether or not the text is italicized.
+                                "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                    # points.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "underline": True or False, # Whether or not the text is underlined.
+                                "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          },
+                        ],
+                        "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                          "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                              # associated with a list. A paragraph that is part of a list has an implicit
+                              # reference to that list's ID.
+                            "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                # level. A list has at most nine levels of nesting, so the possible values
+                                # for the keys of this map are 0 through 8, inclusive.
+                              "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                  # level of nesting.
+                                "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                            "listId": "A String", # The ID of the list.
+                          },
+                        },
+                      },
+                      "rowSpan": 42, # Row span of the cell.
+                      "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                        "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                            # for newly created table cells in the Slides editor.
+                          "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                              # specified color value.
+                              #
+                              # If any field is unset, its value may be inherited from a parent placeholder
+                              # if it exists.
+                            "color": { # A themeable solid color value. # The color value of the solid fill.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                            "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                # That is, the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color.
+                          },
+                          "propertyState": "A String", # The background fill property state.
+                              #
+                              # Updating the the fill on a table cell will implicitly update this field
+                              # to `RENDERED`, unless another value is specified in the same request. To
+                              # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                              # case, any other fill fields set in the same request will be ignored.
+                        },
+                      },
+                      "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                        "rowIndex": 42, # The 0-based row index.
+                        "columnIndex": 42, # The 0-based column index.
+                      },
+                      "columnSpan": 42, # Column span of the cell.
+                    },
+                  ],
+                  "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              ],
+              "rows": 42, # Number of rows in the table.
+              "columns": 42, # Number of columns in the table.
+            },
+            "line": { # A PageElement kind representing a # A line page element.
+                # line, curved connector, or bent connector.
+              "lineProperties": { # The properties of the Line. # The properties of the line.
+                  #
+                  # When unset, these fields default to values that match the appearance of
+                  # new lines created in the Slides editor.
+                "dashStyle": "A String", # The dash style of the line.
+                "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "endArrow": "A String", # The style of the arrow at the end of the line.
+                "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                    # lines created in the Slides editor.
+                  "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                      # specified color value.
+                      #
+                      # If any field is unset, its value may be inherited from a parent placeholder
+                      # if it exists.
+                    "color": { # A themeable solid color value. # The color value of the solid fill.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                        # That is, the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color.
+                  },
+                },
+              },
+              "lineType": "A String", # The type of the line.
+            },
+            "size": { # A width and height. # The size of the page element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+            "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                # joined collection of PageElements.
+              "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                # Object with schema name: PageElement
+              ],
+            },
+          },
+        ],
+        "objectId": "A String", # The object ID for this page. Object IDs used by
+            # Page and
+            # PageElement share the same namespace.
+        "pageProperties": { # The properties of the Page. # The properties of the page.
+            #
+            # The page will inherit properties from the parent page. Depending on the page
+            # type the hierarchy is defined in either
+            # SlideProperties or
+            # LayoutProperties.
+          "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+              # from a parent page if it exists. If the page has no parent, then the
+              # background fill defaults to the corresponding fill in the Slides editor.
+            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                # specified color value.
+                #
+                # If any field is unset, its value may be inherited from a parent placeholder
+                # if it exists.
+              "color": { # A themeable solid color value. # The color value of the solid fill.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                  # That is, the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color.
+            },
+            "propertyState": "A String", # The background fill property state.
+                #
+                # Updating the the fill on a page will implicitly update this field to
+                # `RENDERED`, unless another value is specified in the same request. To
+                # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                # any other fill fields set in the same request will be ignored.
+            "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                # the specified picture. The picture is stretched to fit its container.
+              "contentUrl": "A String", # Reading the content_url:
+                  #
+                  # An URL to a picture with a default lifetime of 30 minutes.
+                  # This URL is tagged with the account of the requester. Anyone with the URL
+                  # effectively accesses the picture as the original requester. Access to the
+                  # picture may be lost if the presentation's sharing settings change.
+                  #
+                  # Writing the content_url:
+                  #
+                  # The picture is fetched once at insertion time and a copy is stored for
+                  # display inside the presentation. Pictures must be less than 50MB in size,
+                  # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                  # format.
+              "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+            },
+          },
+          "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+              # a parent page. If the page has no parent, the color scheme uses a default
+              # Slides color scheme. This field is read-only.
+            "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+              { # A pair mapping a theme color type to the concrete color it represents.
+                "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+                "type": "A String", # The type of the theme color.
+              },
+            ],
+          },
+        },
+        "pageType": "A String", # The type of the page.
+        "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+            # relevant for pages with page_type SLIDE.
+          "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+          "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+        },
+      },
+    ],
+    "pageSize": { # A width and height. # The size of pages in the presentation.
+      "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+        "magnitude": 3.14, # The magnitude.
+        "unit": "A String", # The units for magnitude.
+      },
+      "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+        "magnitude": 3.14, # The magnitude.
+        "unit": "A String", # The units for magnitude.
+      },
+    },
+    "title": "A String", # The title of the presentation.
+    "locale": "A String", # The locale of the presentation, as an IETF BCP 47 language tag.
+    "slides": [ # The slides in the presentation.
+        # A slide inherits properties from a slide layout.
+      { # A page in a presentation.
+        "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+            # relevant for pages with page_type LAYOUT.
+          "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+          "name": "A String", # The name of the layout.
+          "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+        },
+        "pageElements": [ # The page elements rendered on the page.
+          { # A visual element rendered on a page.
+            "wordArt": { # A PageElement kind representing # A word art page element.
+                # word art.
+              "renderedText": "A String", # The text rendered as word art.
+            },
+            "description": "A String", # The description of the page element. Combined with title to display alt
+                # text.
+            "objectId": "A String", # The object ID for this page element. Object IDs used by
+                # google.apps.slides.v1.Page and
+                # google.apps.slides.v1.PageElement share the same namespace.
+            "title": "A String", # The title of the page element. Combined with description to display alt
+                # text.
+            "image": { # A PageElement kind representing an # An image page element.
+                # image.
+              "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                  # This URL is tagged with the account of the requester. Anyone with the URL
+                  # effectively accesses the image as the original requester. Access to the
+                  # image may be lost if the presentation's sharing settings change.
+              "imageProperties": { # The properties of the Image. # The properties of the image.
+                "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+                "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                    # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                    # This property is read-only.
+                  "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                      # stops. This property is read-only.
+                    { # A color and position in a gradient band.
+                      "color": { # A themeable solid color value. # The color of the gradient stop.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "position": 3.14, # The relative position of the color stop in the gradient band measured
+                          # in percentage. The value should be in the interval [0.0, 1.0].
+                      "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                          # fully opaque.
+                    },
+                  ],
+                },
+                "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                    # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                    # This property is read-only.
+                "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                    # This property is read-only.
+                    # Image.
+                    #
+                    # The crop properties is represented by the offsets of four edges which define
+                    # a crop rectangle. The offsets are measured in percentage from the
+                    # corresponding edges of the object's original bounding rectangle towards
+                    # inside, relative to the object's original dimensions.
+                    #
+                    # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                    # rectangle is positioned inside of the object's original bounding rectangle.
+                    # - If the offset is negative or greater than 1, the corresponding edge of crop
+                    # rectangle is positioned outside of the object's original bounding rectangle.
+                    # - If the left edge of the crop rectangle is on the right side of its right
+                    # edge, the object will be flipped horizontally.
+                    # - If the top edge of the crop rectangle is below its bottom edge, the object
+                    # will be flipped vertically.
+                    # - If all offsets and rotation angle is 0, the object is not cropped.
+                    #
+                    # After cropping, the content in the crop rectangle will be stretched to fit
+                    # its container.
+                  "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                      # the right of the original bounding rectangle left edge, relative to the
+                      # object's original width.
+                  "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                      # Rotation angle is applied after the offset.
+                  "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                      # above the original bounding rectangle bottom edge, relative to the object's
+                      # original height.
+                  "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                      # to the left of the original bounding rectangle right edge, relative to the
+                      # object's original width.
+                  "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                      # below the original bounding rectangle top edge, relative to the object's
+                      # original height.
+                },
+                "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                    # is read-only.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "color": { # A themeable solid color value. # The shadow color value.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                      # relative to the alignment position.
+                      # to transform source coordinates (x,y) into destination coordinates (x', y')
+                      # according to:
+                      #
+                      #       x'  x  =   shear_y  scale_y  translate_y
+                      #       1  [ 1 ]
+                      #
+                      # After transformation,
+                      #
+                      #      x' = scale_x * x + shear_x * y + translate_x;
+                      #      y' = scale_y * y + shear_y * x + translate_y;
+                      #
+                      # This message is therefore composed of these six matrix elements.
+                    "translateX": 3.14, # The X coordinate translation element.
+                    "translateY": 3.14, # The Y coordinate translation element.
+                    "scaleX": 3.14, # The X coordinate scaling element.
+                    "scaleY": 3.14, # The Y coordinate scaling element.
+                    "shearY": 3.14, # The Y coordinate shearing element.
+                    "shearX": 3.14, # The X coordinate shearing element.
+                    "unit": "A String", # The units for translate elements.
+                  },
+                  "propertyState": "A String", # The shadow property state.
+                      #
+                      # Updating the the shadow on a page element will implicitly update this field
+                      # to `RENDERED`, unless another value is specified in the same request. To
+                      # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                      # case, any other shadow fields set in the same request will be ignored.
+                  "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                      # shadow becomes.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                  "type": "A String", # The type of the shadow.
+                  "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                      # scale and skew of the shadow.
+                  "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                },
+                "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                    # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+              },
+            },
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "shape": { # A PageElement kind representing a # A generic shape.
+                # generic shape that does not have a more specific classification.
+              "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                  # text box or rectangle) or a table cell in a page.
+                "textElements": [ # The text contents broken down into its component parts, including styling
+                    # information. This property is read-only.
+                  { # A TextElement describes the content of a range of indices in the text content
+                      # of a Shape or TableCell.
+                    "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                        # replaced with content that can change over time.
+                      "content": "A String", # The rendered content of this auto text, if available.
+                      "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                          # inherited from the parent. Which text styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A text run in a paragraph that is not in a list will inherit its text style
+                          #   from the the newline character in the paragraph at the 0 nesting level of
+                          #   the list inside the parent placeholder.
+                          # * A text run in a paragraph that is in a list will inherit its text style
+                          #   from the newline character in the paragraph at its corresponding nesting
+                          #   level of the list inside the parent placeholder.
+                          #
+                          # Inherited text styles are represented as unset fields in this message. If
+                          # text is contained in a shape without a parent placeholder, unsetting these
+                          # fields will revert the style to a value matching the defaults in the Slides
+                          # editor.
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "bold": True or False, # Whether or not the text is bold.
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                            #
+                            # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                            # rendered in a smaller font size, computed based on the `font_size` field.
+                            # The `font_size` itself is not affected by changes in this field.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "fontFamily": "A String", # The font family of the text.
+                            #
+                            # The font family can be any font from the Font menu in Slides or from
+                            # [Google Fonts] (https://fonts.google.com/). If the font name is
+                            # unrecognized, the text is rendered in `Arial`.
+                            #
+                            # Some fonts can affect the weight of the text. If an update request
+                            # specifies values for both `font_family` and `bold`, the explicitly-set
+                            # `bold` value is used.
+                        "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                            # are not inherited from parent text.
+                            #
+                            # Changing the link in an update request causes some other changes to the
+                            # text style of the range:
+                            #
+                            # * When setting a link, the text foreground color will be set to
+                            #   ThemeColorType.HYPERLINK and the text will
+                            #   be underlined. If these fields are modified in the same
+                            #   request, those values will be used instead of the link defaults.
+                            # * Setting a link on a text range that overlaps with an existing link will
+                            #   also update the existing link to point to the new URL.
+                            # * Links are not settable on newline characters. As a result, setting a link
+                            #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                            #   will separate the newline character(s) into their own text runs. The
+                            #   link will be applied separately to the runs before and after the newline.
+                            # * Removing a link will update the text style of the range to match the
+                            #   style of the preceding text (or the default text styles if the preceding
+                            #   text is another link) unless different styles are being set in the same
+                            #   request.
+                          "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                          "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                              # presentation with this ID. A page with this ID may not exist.
+                          "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                              # in the presentation. There may not be a slide at this index.
+                          "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                              # addressed by its position.
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                            # points.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                      },
+                      "type": "A String", # The type of this auto text.
+                    },
+                    "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                        # units.
+                    "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                    "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                        #
+                        # The `start_index` and `end_index` of this TextElement represent the
+                        # range of the paragraph. Other TextElements with an index range contained
+                        # inside this paragraph's range are considered to be part of this
+                        # paragraph. The range of indices of two separate paragraphs will never
+                        # overlap.
+                      "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                          # inherited from the parent. Which paragraph styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A paragraph not in a list will inherit its paragraph style from the
+                          #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                          # * A paragraph in a list will inherit its paragraph style from the paragraph
+                          #   at its corresponding nesting level of the list inside the parent
+                          #   placeholder.
+                          #
+                          # Inherited paragraph styles are represented as unset fields in this message.
+                        "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                        "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                        "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                            # inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                            # is represented as 100.0. If unset, the value is inherited from the parent.
+                            # This property is read-only.
+                        "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                            # the start of the text, based on the current text direction. If unset, the
+                            # value is inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                            # inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                            # the end of the text, based on the current text direction. If unset, the
+                            # value is inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                            # If unset, the value is inherited from the parent. This property is
+                            # read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                      },
+                      "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                          # belong to a list.
+                        "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                        "listId": "A String", # The ID of the list this paragraph belongs to.
+                        "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                      },
+                    },
+                    "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                        # in the run have the same TextStyle.
+                        #
+                        # The `start_index` and `end_index` of TextRuns will always be fully
+                        # contained in the index range of a single `paragraph_marker` TextElement.
+                        # In other words, a TextRun will never span multiple paragraphs.
+                        # styling.
+                      "content": "A String", # The text of this run.
+                      "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                          # inherited from the parent. Which text styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A text run in a paragraph that is not in a list will inherit its text style
+                          #   from the the newline character in the paragraph at the 0 nesting level of
+                          #   the list inside the parent placeholder.
+                          # * A text run in a paragraph that is in a list will inherit its text style
+                          #   from the newline character in the paragraph at its corresponding nesting
+                          #   level of the list inside the parent placeholder.
+                          #
+                          # Inherited text styles are represented as unset fields in this message. If
+                          # text is contained in a shape without a parent placeholder, unsetting these
+                          # fields will revert the style to a value matching the defaults in the Slides
+                          # editor.
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "bold": True or False, # Whether or not the text is bold.
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                            #
+                            # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                            # rendered in a smaller font size, computed based on the `font_size` field.
+                            # The `font_size` itself is not affected by changes in this field.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "fontFamily": "A String", # The font family of the text.
+                            #
+                            # The font family can be any font from the Font menu in Slides or from
+                            # [Google Fonts] (https://fonts.google.com/). If the font name is
+                            # unrecognized, the text is rendered in `Arial`.
+                            #
+                            # Some fonts can affect the weight of the text. If an update request
+                            # specifies values for both `font_family` and `bold`, the explicitly-set
+                            # `bold` value is used.
+                        "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                            # are not inherited from parent text.
+                            #
+                            # Changing the link in an update request causes some other changes to the
+                            # text style of the range:
+                            #
+                            # * When setting a link, the text foreground color will be set to
+                            #   ThemeColorType.HYPERLINK and the text will
+                            #   be underlined. If these fields are modified in the same
+                            #   request, those values will be used instead of the link defaults.
+                            # * Setting a link on a text range that overlaps with an existing link will
+                            #   also update the existing link to point to the new URL.
+                            # * Links are not settable on newline characters. As a result, setting a link
+                            #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                            #   will separate the newline character(s) into their own text runs. The
+                            #   link will be applied separately to the runs before and after the newline.
+                            # * Removing a link will update the text style of the range to match the
+                            #   style of the preceding text (or the default text styles if the preceding
+                            #   text is another link) unless different styles are being set in the same
+                            #   request.
+                          "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                          "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                              # presentation with this ID. A page with this ID may not exist.
+                          "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                              # in the presentation. There may not be a slide at this index.
+                          "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                              # addressed by its position.
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                            # points.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                      },
+                    },
+                  },
+                ],
+                "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                  "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                      # associated with a list. A paragraph that is part of a list has an implicit
+                      # reference to that list's ID.
+                    "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                        # level. A list has at most nine levels of nesting, so the possible values
+                        # for the keys of this map are 0 through 8, inclusive.
+                      "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                          # level of nesting.
+                        "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                    "listId": "A String", # The ID of the list.
+                  },
+                },
+              },
+              "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                  #
+                  # If the shape is a placeholder shape as determined by the
+                  # placeholder field, then these
+                  # properties may be inherited from a parent placeholder shape.
+                  # Determining the rendered value of the property depends on the corresponding
+                  # property_state field value.
+                "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                    # a parent placeholder if it exists. If the shape has no parent, then the
+                    # default shadow matches the defaults for new shapes created in the Slides
+                    # editor. This property is read-only.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "color": { # A themeable solid color value. # The shadow color value.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                      # relative to the alignment position.
+                      # to transform source coordinates (x,y) into destination coordinates (x', y')
+                      # according to:
+                      #
+                      #       x'  x  =   shear_y  scale_y  translate_y
+                      #       1  [ 1 ]
+                      #
+                      # After transformation,
+                      #
+                      #      x' = scale_x * x + shear_x * y + translate_x;
+                      #      y' = scale_y * y + shear_y * x + translate_y;
+                      #
+                      # This message is therefore composed of these six matrix elements.
+                    "translateX": 3.14, # The X coordinate translation element.
+                    "translateY": 3.14, # The Y coordinate translation element.
+                    "scaleX": 3.14, # The X coordinate scaling element.
+                    "scaleY": 3.14, # The Y coordinate scaling element.
+                    "shearY": 3.14, # The Y coordinate shearing element.
+                    "shearX": 3.14, # The X coordinate shearing element.
+                    "unit": "A String", # The units for translate elements.
+                  },
+                  "propertyState": "A String", # The shadow property state.
+                      #
+                      # Updating the the shadow on a page element will implicitly update this field
+                      # to `RENDERED`, unless another value is specified in the same request. To
+                      # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                      # case, any other shadow fields set in the same request will be ignored.
+                  "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                      # shadow becomes.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                  "type": "A String", # The type of the shadow.
+                  "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                      # scale and skew of the shadow.
+                  "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                },
+                "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                    # inherited from a parent placeholder if it exists. If the shape has no
+                    # parent, then the default background fill depends on the shape type,
+                    # matching the defaults for new shapes created in the Slides editor.
+                  "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                      # specified color value.
+                      #
+                      # If any field is unset, its value may be inherited from a parent placeholder
+                      # if it exists.
+                    "color": { # A themeable solid color value. # The color value of the solid fill.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                        # That is, the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color.
+                  },
+                  "propertyState": "A String", # The background fill property state.
+                      #
+                      # Updating the the fill on a shape will implicitly update this field to
+                      # `RENDERED`, unless another value is specified in the same request. To
+                      # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                      # any other fill fields set in the same request will be ignored.
+                },
+                "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                    # are not inherited from parent placeholders.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                    # parent placeholder if it exists. If the shape has no parent, then the
+                    # default outline depends on the shape type, matching the defaults for
+                    # new shapes created in the Slides editor.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+              "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                  # layouts and masters.
+                  #
+                  # If set, the shape is a placeholder shape and any inherited properties
+                  # can be resolved by looking at the parent placeholder identified by the
+                  # Placeholder.parent_object_id field.
+                "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                    # If unset, the parent placeholder shape does not exist, so the shape does
+                    # not inherit properties from any other shape.
+                "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                    # in the same page, they would have different index values.
+                "type": "A String", # The type of the placeholder.
+              },
+              "shapeType": "A String", # The type of the shape.
+            },
+            "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                # represented as images.
+                # a linked chart embedded from Google Sheets.
+              "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                  # embedded.
+              "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+              "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                  # minutes. This URL is tagged with the account of the requester. Anyone with
+                  # the URL effectively accesses the image as the original requester. Access to
+                  # the image may be lost if the presentation's sharing settings change.
+            },
+            "video": { # A PageElement kind representing a # A video page element.
+                # video.
+              "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                  # exists and sharing settings do not change.
+              "videoProperties": { # The properties of the Video. # The properties of the video.
+                "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                    # videos created in the Slides editor.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+              "id": "A String", # The video source's unique identifier for this video.
+              "source": "A String", # The video source.
+            },
+            "table": { # A PageElement kind representing a # A table page element.
+                # table.
+              "tableColumns": [ # Properties of each column.
+                { # Properties of each column in a table.
+                  "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              ],
+              "tableRows": [ # Properties and contents of each row.
+                  #
+                  # Cells that span multiple rows are contained in only one of these rows and
+                  # have a row_span greater
+                  # than 1.
+                { # Properties and contents of each row in a table.
+                  "tableCells": [ # Properties and contents of each cell.
+                      #
+                      # Cells that span multiple columns are represented only once with a
+                      # column_span greater
+                      # than 1. As a result, the length of this collection does not always match
+                      # the number of columns of the entire table.
+                    { # Properties and contents of each table cell.
+                      "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                          # text box or rectangle) or a table cell in a page.
+                        "textElements": [ # The text contents broken down into its component parts, including styling
+                            # information. This property is read-only.
+                          { # A TextElement describes the content of a range of indices in the text content
+                              # of a Shape or TableCell.
+                            "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                # replaced with content that can change over time.
+                              "content": "A String", # The rendered content of this auto text, if available.
+                              "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                  # inherited from the parent. Which text styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A text run in a paragraph that is not in a list will inherit its text style
+                                  #   from the the newline character in the paragraph at the 0 nesting level of
+                                  #   the list inside the parent placeholder.
+                                  # * A text run in a paragraph that is in a list will inherit its text style
+                                  #   from the newline character in the paragraph at its corresponding nesting
+                                  #   level of the list inside the parent placeholder.
+                                  #
+                                  # Inherited text styles are represented as unset fields in this message. If
+                                  # text is contained in a shape without a parent placeholder, unsetting these
+                                  # fields will revert the style to a value matching the defaults in the Slides
+                                  # editor.
+                                "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                                "bold": True or False, # Whether or not the text is bold.
+                                "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                    #
+                                    # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                    # rendered in a smaller font size, computed based on the `font_size` field.
+                                    # The `font_size` itself is not affected by changes in this field.
+                                "strikethrough": True or False, # Whether or not the text is struck through.
+                                "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                "fontFamily": "A String", # The font family of the text.
+                                    #
+                                    # The font family can be any font from the Font menu in Slides or from
+                                    # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                    # unrecognized, the text is rendered in `Arial`.
+                                    #
+                                    # Some fonts can affect the weight of the text. If an update request
+                                    # specifies values for both `font_family` and `bold`, the explicitly-set
+                                    # `bold` value is used.
+                                "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                    # are not inherited from parent text.
+                                    #
+                                    # Changing the link in an update request causes some other changes to the
+                                    # text style of the range:
+                                    #
+                                    # * When setting a link, the text foreground color will be set to
+                                    #   ThemeColorType.HYPERLINK and the text will
+                                    #   be underlined. If these fields are modified in the same
+                                    #   request, those values will be used instead of the link defaults.
+                                    # * Setting a link on a text range that overlaps with an existing link will
+                                    #   also update the existing link to point to the new URL.
+                                    # * Links are not settable on newline characters. As a result, setting a link
+                                    #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                    #   will separate the newline character(s) into their own text runs. The
+                                    #   link will be applied separately to the runs before and after the newline.
+                                    # * Removing a link will update the text style of the range to match the
+                                    #   style of the preceding text (or the default text styles if the preceding
+                                    #   text is another link) unless different styles are being set in the same
+                                    #   request.
+                                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                      # presentation with this ID. A page with this ID may not exist.
+                                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                      # in the presentation. There may not be a slide at this index.
+                                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                      # addressed by its position.
+                                },
+                                "italic": True or False, # Whether or not the text is italicized.
+                                "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                    # points.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "underline": True or False, # Whether or not the text is underlined.
+                                "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                              },
+                              "type": "A String", # The type of this auto text.
+                            },
+                            "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                # units.
+                            "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                            "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                #
+                                # The `start_index` and `end_index` of this TextElement represent the
+                                # range of the paragraph. Other TextElements with an index range contained
+                                # inside this paragraph's range are considered to be part of this
+                                # paragraph. The range of indices of two separate paragraphs will never
+                                # overlap.
+                              "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                  # inherited from the parent. Which paragraph styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A paragraph not in a list will inherit its paragraph style from the
+                                  #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                  # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                  #   at its corresponding nesting level of the list inside the parent
+                                  #   placeholder.
+                                  #
+                                  # Inherited paragraph styles are represented as unset fields in this message.
+                                "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                    # inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                    # is represented as 100.0. If unset, the value is inherited from the parent.
+                                    # This property is read-only.
+                                "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                    # the start of the text, based on the current text direction. If unset, the
+                                    # value is inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                    # inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                    # the end of the text, based on the current text direction. If unset, the
+                                    # value is inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                    # If unset, the value is inherited from the parent. This property is
+                                    # read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                              },
+                              "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                  # belong to a list.
+                                "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                "listId": "A String", # The ID of the list this paragraph belongs to.
+                                "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                              },
+                            },
+                            "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                # in the run have the same TextStyle.
+                                #
+                                # The `start_index` and `end_index` of TextRuns will always be fully
+                                # contained in the index range of a single `paragraph_marker` TextElement.
+                                # In other words, a TextRun will never span multiple paragraphs.
+                                # styling.
+                              "content": "A String", # The text of this run.
+                              "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                  # inherited from the parent. Which text styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A text run in a paragraph that is not in a list will inherit its text style
+                                  #   from the the newline character in the paragraph at the 0 nesting level of
+                                  #   the list inside the parent placeholder.
+                                  # * A text run in a paragraph that is in a list will inherit its text style
+                                  #   from the newline character in the paragraph at its corresponding nesting
+                                  #   level of the list inside the parent placeholder.
+                                  #
+                                  # Inherited text styles are represented as unset fields in this message. If
+                                  # text is contained in a shape without a parent placeholder, unsetting these
+                                  # fields will revert the style to a value matching the defaults in the Slides
+                                  # editor.
+                                "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                                "bold": True or False, # Whether or not the text is bold.
+                                "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                    #
+                                    # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                    # rendered in a smaller font size, computed based on the `font_size` field.
+                                    # The `font_size` itself is not affected by changes in this field.
+                                "strikethrough": True or False, # Whether or not the text is struck through.
+                                "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                "fontFamily": "A String", # The font family of the text.
+                                    #
+                                    # The font family can be any font from the Font menu in Slides or from
+                                    # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                    # unrecognized, the text is rendered in `Arial`.
+                                    #
+                                    # Some fonts can affect the weight of the text. If an update request
+                                    # specifies values for both `font_family` and `bold`, the explicitly-set
+                                    # `bold` value is used.
+                                "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                    # are not inherited from parent text.
+                                    #
+                                    # Changing the link in an update request causes some other changes to the
+                                    # text style of the range:
+                                    #
+                                    # * When setting a link, the text foreground color will be set to
+                                    #   ThemeColorType.HYPERLINK and the text will
+                                    #   be underlined. If these fields are modified in the same
+                                    #   request, those values will be used instead of the link defaults.
+                                    # * Setting a link on a text range that overlaps with an existing link will
+                                    #   also update the existing link to point to the new URL.
+                                    # * Links are not settable on newline characters. As a result, setting a link
+                                    #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                    #   will separate the newline character(s) into their own text runs. The
+                                    #   link will be applied separately to the runs before and after the newline.
+                                    # * Removing a link will update the text style of the range to match the
+                                    #   style of the preceding text (or the default text styles if the preceding
+                                    #   text is another link) unless different styles are being set in the same
+                                    #   request.
+                                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                      # presentation with this ID. A page with this ID may not exist.
+                                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                      # in the presentation. There may not be a slide at this index.
+                                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                      # addressed by its position.
+                                },
+                                "italic": True or False, # Whether or not the text is italicized.
+                                "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                    # points.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "underline": True or False, # Whether or not the text is underlined.
+                                "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          },
+                        ],
+                        "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                          "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                              # associated with a list. A paragraph that is part of a list has an implicit
+                              # reference to that list's ID.
+                            "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                # level. A list has at most nine levels of nesting, so the possible values
+                                # for the keys of this map are 0 through 8, inclusive.
+                              "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                  # level of nesting.
+                                "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                            "listId": "A String", # The ID of the list.
+                          },
+                        },
+                      },
+                      "rowSpan": 42, # Row span of the cell.
+                      "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                        "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                            # for newly created table cells in the Slides editor.
+                          "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                              # specified color value.
+                              #
+                              # If any field is unset, its value may be inherited from a parent placeholder
+                              # if it exists.
+                            "color": { # A themeable solid color value. # The color value of the solid fill.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                            "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                # That is, the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color.
+                          },
+                          "propertyState": "A String", # The background fill property state.
+                              #
+                              # Updating the the fill on a table cell will implicitly update this field
+                              # to `RENDERED`, unless another value is specified in the same request. To
+                              # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                              # case, any other fill fields set in the same request will be ignored.
+                        },
+                      },
+                      "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                        "rowIndex": 42, # The 0-based row index.
+                        "columnIndex": 42, # The 0-based column index.
+                      },
+                      "columnSpan": 42, # Column span of the cell.
+                    },
+                  ],
+                  "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              ],
+              "rows": 42, # Number of rows in the table.
+              "columns": 42, # Number of columns in the table.
+            },
+            "line": { # A PageElement kind representing a # A line page element.
+                # line, curved connector, or bent connector.
+              "lineProperties": { # The properties of the Line. # The properties of the line.
+                  #
+                  # When unset, these fields default to values that match the appearance of
+                  # new lines created in the Slides editor.
+                "dashStyle": "A String", # The dash style of the line.
+                "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "endArrow": "A String", # The style of the arrow at the end of the line.
+                "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                    # lines created in the Slides editor.
+                  "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                      # specified color value.
+                      #
+                      # If any field is unset, its value may be inherited from a parent placeholder
+                      # if it exists.
+                    "color": { # A themeable solid color value. # The color value of the solid fill.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                        # That is, the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color.
+                  },
+                },
+              },
+              "lineType": "A String", # The type of the line.
+            },
+            "size": { # A width and height. # The size of the page element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+            "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                # joined collection of PageElements.
+              "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                # Object with schema name: PageElement
+              ],
+            },
+          },
+        ],
+        "objectId": "A String", # The object ID for this page. Object IDs used by
+            # Page and
+            # PageElement share the same namespace.
+        "pageProperties": { # The properties of the Page. # The properties of the page.
+            #
+            # The page will inherit properties from the parent page. Depending on the page
+            # type the hierarchy is defined in either
+            # SlideProperties or
+            # LayoutProperties.
+          "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+              # from a parent page if it exists. If the page has no parent, then the
+              # background fill defaults to the corresponding fill in the Slides editor.
+            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                # specified color value.
+                #
+                # If any field is unset, its value may be inherited from a parent placeholder
+                # if it exists.
+              "color": { # A themeable solid color value. # The color value of the solid fill.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                  # That is, the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color.
+            },
+            "propertyState": "A String", # The background fill property state.
+                #
+                # Updating the the fill on a page will implicitly update this field to
+                # `RENDERED`, unless another value is specified in the same request. To
+                # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                # any other fill fields set in the same request will be ignored.
+            "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                # the specified picture. The picture is stretched to fit its container.
+              "contentUrl": "A String", # Reading the content_url:
+                  #
+                  # An URL to a picture with a default lifetime of 30 minutes.
+                  # This URL is tagged with the account of the requester. Anyone with the URL
+                  # effectively accesses the picture as the original requester. Access to the
+                  # picture may be lost if the presentation's sharing settings change.
+                  #
+                  # Writing the content_url:
+                  #
+                  # The picture is fetched once at insertion time and a copy is stored for
+                  # display inside the presentation. Pictures must be less than 50MB in size,
+                  # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                  # format.
+              "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+            },
+          },
+          "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+              # a parent page. If the page has no parent, the color scheme uses a default
+              # Slides color scheme. This field is read-only.
+            "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+              { # A pair mapping a theme color type to the concrete color it represents.
+                "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+                "type": "A String", # The type of the theme color.
+              },
+            ],
+          },
+        },
+        "pageType": "A String", # The type of the page.
+        "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+            # relevant for pages with page_type SLIDE.
+          "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+          "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+        },
+      },
+    ],
+    "layouts": [ # The layouts in the presentation. A layout is a template that determines
+        # how content is arranged and styled on the slides that inherit from that
+        # layout.
+      { # A page in a presentation.
+        "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+            # relevant for pages with page_type LAYOUT.
+          "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+          "name": "A String", # The name of the layout.
+          "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+        },
+        "pageElements": [ # The page elements rendered on the page.
+          { # A visual element rendered on a page.
+            "wordArt": { # A PageElement kind representing # A word art page element.
+                # word art.
+              "renderedText": "A String", # The text rendered as word art.
+            },
+            "description": "A String", # The description of the page element. Combined with title to display alt
+                # text.
+            "objectId": "A String", # The object ID for this page element. Object IDs used by
+                # google.apps.slides.v1.Page and
+                # google.apps.slides.v1.PageElement share the same namespace.
+            "title": "A String", # The title of the page element. Combined with description to display alt
+                # text.
+            "image": { # A PageElement kind representing an # An image page element.
+                # image.
+              "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                  # This URL is tagged with the account of the requester. Anyone with the URL
+                  # effectively accesses the image as the original requester. Access to the
+                  # image may be lost if the presentation's sharing settings change.
+              "imageProperties": { # The properties of the Image. # The properties of the image.
+                "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+                "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                    # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                    # This property is read-only.
+                  "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                      # stops. This property is read-only.
+                    { # A color and position in a gradient band.
+                      "color": { # A themeable solid color value. # The color of the gradient stop.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "position": 3.14, # The relative position of the color stop in the gradient band measured
+                          # in percentage. The value should be in the interval [0.0, 1.0].
+                      "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                          # fully opaque.
+                    },
+                  ],
+                },
+                "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                    # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                    # This property is read-only.
+                "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                    # This property is read-only.
+                    # Image.
+                    #
+                    # The crop properties is represented by the offsets of four edges which define
+                    # a crop rectangle. The offsets are measured in percentage from the
+                    # corresponding edges of the object's original bounding rectangle towards
+                    # inside, relative to the object's original dimensions.
+                    #
+                    # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                    # rectangle is positioned inside of the object's original bounding rectangle.
+                    # - If the offset is negative or greater than 1, the corresponding edge of crop
+                    # rectangle is positioned outside of the object's original bounding rectangle.
+                    # - If the left edge of the crop rectangle is on the right side of its right
+                    # edge, the object will be flipped horizontally.
+                    # - If the top edge of the crop rectangle is below its bottom edge, the object
+                    # will be flipped vertically.
+                    # - If all offsets and rotation angle is 0, the object is not cropped.
+                    #
+                    # After cropping, the content in the crop rectangle will be stretched to fit
+                    # its container.
+                  "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                      # the right of the original bounding rectangle left edge, relative to the
+                      # object's original width.
+                  "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                      # Rotation angle is applied after the offset.
+                  "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                      # above the original bounding rectangle bottom edge, relative to the object's
+                      # original height.
+                  "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                      # to the left of the original bounding rectangle right edge, relative to the
+                      # object's original width.
+                  "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                      # below the original bounding rectangle top edge, relative to the object's
+                      # original height.
+                },
+                "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                    # is read-only.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "color": { # A themeable solid color value. # The shadow color value.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                      # relative to the alignment position.
+                      # to transform source coordinates (x,y) into destination coordinates (x', y')
+                      # according to:
+                      #
+                      #       x'  x  =   shear_y  scale_y  translate_y
+                      #       1  [ 1 ]
+                      #
+                      # After transformation,
+                      #
+                      #      x' = scale_x * x + shear_x * y + translate_x;
+                      #      y' = scale_y * y + shear_y * x + translate_y;
+                      #
+                      # This message is therefore composed of these six matrix elements.
+                    "translateX": 3.14, # The X coordinate translation element.
+                    "translateY": 3.14, # The Y coordinate translation element.
+                    "scaleX": 3.14, # The X coordinate scaling element.
+                    "scaleY": 3.14, # The Y coordinate scaling element.
+                    "shearY": 3.14, # The Y coordinate shearing element.
+                    "shearX": 3.14, # The X coordinate shearing element.
+                    "unit": "A String", # The units for translate elements.
+                  },
+                  "propertyState": "A String", # The shadow property state.
+                      #
+                      # Updating the the shadow on a page element will implicitly update this field
+                      # to `RENDERED`, unless another value is specified in the same request. To
+                      # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                      # case, any other shadow fields set in the same request will be ignored.
+                  "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                      # shadow becomes.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                  "type": "A String", # The type of the shadow.
+                  "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                      # scale and skew of the shadow.
+                  "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                },
+                "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                    # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+              },
+            },
+            "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                # to transform source coordinates (x,y) into destination coordinates (x', y')
+                # according to:
+                #
+                #       x'  x  =   shear_y  scale_y  translate_y
+                #       1  [ 1 ]
+                #
+                # After transformation,
+                #
+                #      x' = scale_x * x + shear_x * y + translate_x;
+                #      y' = scale_y * y + shear_y * x + translate_y;
+                #
+                # This message is therefore composed of these six matrix elements.
+              "translateX": 3.14, # The X coordinate translation element.
+              "translateY": 3.14, # The Y coordinate translation element.
+              "scaleX": 3.14, # The X coordinate scaling element.
+              "scaleY": 3.14, # The Y coordinate scaling element.
+              "shearY": 3.14, # The Y coordinate shearing element.
+              "shearX": 3.14, # The X coordinate shearing element.
+              "unit": "A String", # The units for translate elements.
+            },
+            "shape": { # A PageElement kind representing a # A generic shape.
+                # generic shape that does not have a more specific classification.
+              "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                  # text box or rectangle) or a table cell in a page.
+                "textElements": [ # The text contents broken down into its component parts, including styling
+                    # information. This property is read-only.
+                  { # A TextElement describes the content of a range of indices in the text content
+                      # of a Shape or TableCell.
+                    "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                        # replaced with content that can change over time.
+                      "content": "A String", # The rendered content of this auto text, if available.
+                      "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                          # inherited from the parent. Which text styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A text run in a paragraph that is not in a list will inherit its text style
+                          #   from the the newline character in the paragraph at the 0 nesting level of
+                          #   the list inside the parent placeholder.
+                          # * A text run in a paragraph that is in a list will inherit its text style
+                          #   from the newline character in the paragraph at its corresponding nesting
+                          #   level of the list inside the parent placeholder.
+                          #
+                          # Inherited text styles are represented as unset fields in this message. If
+                          # text is contained in a shape without a parent placeholder, unsetting these
+                          # fields will revert the style to a value matching the defaults in the Slides
+                          # editor.
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "bold": True or False, # Whether or not the text is bold.
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                            #
+                            # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                            # rendered in a smaller font size, computed based on the `font_size` field.
+                            # The `font_size` itself is not affected by changes in this field.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "fontFamily": "A String", # The font family of the text.
+                            #
+                            # The font family can be any font from the Font menu in Slides or from
+                            # [Google Fonts] (https://fonts.google.com/). If the font name is
+                            # unrecognized, the text is rendered in `Arial`.
+                            #
+                            # Some fonts can affect the weight of the text. If an update request
+                            # specifies values for both `font_family` and `bold`, the explicitly-set
+                            # `bold` value is used.
+                        "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                            # are not inherited from parent text.
+                            #
+                            # Changing the link in an update request causes some other changes to the
+                            # text style of the range:
+                            #
+                            # * When setting a link, the text foreground color will be set to
+                            #   ThemeColorType.HYPERLINK and the text will
+                            #   be underlined. If these fields are modified in the same
+                            #   request, those values will be used instead of the link defaults.
+                            # * Setting a link on a text range that overlaps with an existing link will
+                            #   also update the existing link to point to the new URL.
+                            # * Links are not settable on newline characters. As a result, setting a link
+                            #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                            #   will separate the newline character(s) into their own text runs. The
+                            #   link will be applied separately to the runs before and after the newline.
+                            # * Removing a link will update the text style of the range to match the
+                            #   style of the preceding text (or the default text styles if the preceding
+                            #   text is another link) unless different styles are being set in the same
+                            #   request.
+                          "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                          "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                              # presentation with this ID. A page with this ID may not exist.
+                          "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                              # in the presentation. There may not be a slide at this index.
+                          "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                              # addressed by its position.
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                            # points.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                      },
+                      "type": "A String", # The type of this auto text.
+                    },
+                    "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                        # units.
+                    "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                    "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                        #
+                        # The `start_index` and `end_index` of this TextElement represent the
+                        # range of the paragraph. Other TextElements with an index range contained
+                        # inside this paragraph's range are considered to be part of this
+                        # paragraph. The range of indices of two separate paragraphs will never
+                        # overlap.
+                      "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                          # inherited from the parent. Which paragraph styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A paragraph not in a list will inherit its paragraph style from the
+                          #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                          # * A paragraph in a list will inherit its paragraph style from the paragraph
+                          #   at its corresponding nesting level of the list inside the parent
+                          #   placeholder.
+                          #
+                          # Inherited paragraph styles are represented as unset fields in this message.
+                        "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                        "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                        "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                            # inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                            # is represented as 100.0. If unset, the value is inherited from the parent.
+                            # This property is read-only.
+                        "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                            # the start of the text, based on the current text direction. If unset, the
+                            # value is inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                            # inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                            # the end of the text, based on the current text direction. If unset, the
+                            # value is inherited from the parent. This property is read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                            # If unset, the value is inherited from the parent. This property is
+                            # read-only.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                      },
+                      "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                          # belong to a list.
+                        "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                        "listId": "A String", # The ID of the list this paragraph belongs to.
+                        "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                      },
+                    },
+                    "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                        # in the run have the same TextStyle.
+                        #
+                        # The `start_index` and `end_index` of TextRuns will always be fully
+                        # contained in the index range of a single `paragraph_marker` TextElement.
+                        # In other words, a TextRun will never span multiple paragraphs.
+                        # styling.
+                      "content": "A String", # The text of this run.
+                      "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                          #
+                          # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                          # inherited from the parent. Which text styles are inherited depend on the
+                          # nesting level of lists:
+                          #
+                          # * A text run in a paragraph that is not in a list will inherit its text style
+                          #   from the the newline character in the paragraph at the 0 nesting level of
+                          #   the list inside the parent placeholder.
+                          # * A text run in a paragraph that is in a list will inherit its text style
+                          #   from the newline character in the paragraph at its corresponding nesting
+                          #   level of the list inside the parent placeholder.
+                          #
+                          # Inherited text styles are represented as unset fields in this message. If
+                          # text is contained in a shape without a parent placeholder, unsetting these
+                          # fields will revert the style to a value matching the defaults in the Slides
+                          # editor.
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "bold": True or False, # Whether or not the text is bold.
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                            #
+                            # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                            # rendered in a smaller font size, computed based on the `font_size` field.
+                            # The `font_size` itself is not affected by changes in this field.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "fontFamily": "A String", # The font family of the text.
+                            #
+                            # The font family can be any font from the Font menu in Slides or from
+                            # [Google Fonts] (https://fonts.google.com/). If the font name is
+                            # unrecognized, the text is rendered in `Arial`.
+                            #
+                            # Some fonts can affect the weight of the text. If an update request
+                            # specifies values for both `font_family` and `bold`, the explicitly-set
+                            # `bold` value is used.
+                        "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                            # are not inherited from parent text.
+                            #
+                            # Changing the link in an update request causes some other changes to the
+                            # text style of the range:
+                            #
+                            # * When setting a link, the text foreground color will be set to
+                            #   ThemeColorType.HYPERLINK and the text will
+                            #   be underlined. If these fields are modified in the same
+                            #   request, those values will be used instead of the link defaults.
+                            # * Setting a link on a text range that overlaps with an existing link will
+                            #   also update the existing link to point to the new URL.
+                            # * Links are not settable on newline characters. As a result, setting a link
+                            #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                            #   will separate the newline character(s) into their own text runs. The
+                            #   link will be applied separately to the runs before and after the newline.
+                            # * Removing a link will update the text style of the range to match the
+                            #   style of the preceding text (or the default text styles if the preceding
+                            #   text is another link) unless different styles are being set in the same
+                            #   request.
+                          "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                          "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                              # presentation with this ID. A page with this ID may not exist.
+                          "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                              # in the presentation. There may not be a slide at this index.
+                          "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                              # addressed by its position.
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                            # points.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                            # transparent, depending on if the `opaque_color` field in it is set.
+                          "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                              # a transparent color.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                      },
+                    },
+                  },
+                ],
+                "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                  "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                      # associated with a list. A paragraph that is part of a list has an implicit
+                      # reference to that list's ID.
+                    "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                        # level. A list has at most nine levels of nesting, so the possible values
+                        # for the keys of this map are 0 through 8, inclusive.
+                      "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                          # level of nesting.
+                        "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                    "listId": "A String", # The ID of the list.
+                  },
+                },
+              },
+              "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                  #
+                  # If the shape is a placeholder shape as determined by the
+                  # placeholder field, then these
+                  # properties may be inherited from a parent placeholder shape.
+                  # Determining the rendered value of the property depends on the corresponding
+                  # property_state field value.
+                "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                    # a parent placeholder if it exists. If the shape has no parent, then the
+                    # default shadow matches the defaults for new shapes created in the Slides
+                    # editor. This property is read-only.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "color": { # A themeable solid color value. # The shadow color value.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                      # relative to the alignment position.
+                      # to transform source coordinates (x,y) into destination coordinates (x', y')
+                      # according to:
+                      #
+                      #       x'  x  =   shear_y  scale_y  translate_y
+                      #       1  [ 1 ]
+                      #
+                      # After transformation,
+                      #
+                      #      x' = scale_x * x + shear_x * y + translate_x;
+                      #      y' = scale_y * y + shear_y * x + translate_y;
+                      #
+                      # This message is therefore composed of these six matrix elements.
+                    "translateX": 3.14, # The X coordinate translation element.
+                    "translateY": 3.14, # The Y coordinate translation element.
+                    "scaleX": 3.14, # The X coordinate scaling element.
+                    "scaleY": 3.14, # The Y coordinate scaling element.
+                    "shearY": 3.14, # The Y coordinate shearing element.
+                    "shearX": 3.14, # The X coordinate shearing element.
+                    "unit": "A String", # The units for translate elements.
+                  },
+                  "propertyState": "A String", # The shadow property state.
+                      #
+                      # Updating the the shadow on a page element will implicitly update this field
+                      # to `RENDERED`, unless another value is specified in the same request. To
+                      # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                      # case, any other shadow fields set in the same request will be ignored.
+                  "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                      # shadow becomes.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                  "type": "A String", # The type of the shadow.
+                  "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                      # scale and skew of the shadow.
+                  "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                },
+                "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                    # inherited from a parent placeholder if it exists. If the shape has no
+                    # parent, then the default background fill depends on the shape type,
+                    # matching the defaults for new shapes created in the Slides editor.
+                  "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                      # specified color value.
+                      #
+                      # If any field is unset, its value may be inherited from a parent placeholder
+                      # if it exists.
+                    "color": { # A themeable solid color value. # The color value of the solid fill.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                        # That is, the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color.
+                  },
+                  "propertyState": "A String", # The background fill property state.
+                      #
+                      # Updating the the fill on a shape will implicitly update this field to
+                      # `RENDERED`, unless another value is specified in the same request. To
+                      # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                      # any other fill fields set in the same request will be ignored.
+                },
+                "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                    # are not inherited from parent placeholders.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                    # parent placeholder if it exists. If the shape has no parent, then the
+                    # default outline depends on the shape type, matching the defaults for
+                    # new shapes created in the Slides editor.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+              "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                  # layouts and masters.
+                  #
+                  # If set, the shape is a placeholder shape and any inherited properties
+                  # can be resolved by looking at the parent placeholder identified by the
+                  # Placeholder.parent_object_id field.
+                "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                    # If unset, the parent placeholder shape does not exist, so the shape does
+                    # not inherit properties from any other shape.
+                "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                    # in the same page, they would have different index values.
+                "type": "A String", # The type of the placeholder.
+              },
+              "shapeType": "A String", # The type of the shape.
+            },
+            "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                # represented as images.
+                # a linked chart embedded from Google Sheets.
+              "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                  # embedded.
+              "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+              "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                  # minutes. This URL is tagged with the account of the requester. Anyone with
+                  # the URL effectively accesses the image as the original requester. Access to
+                  # the image may be lost if the presentation's sharing settings change.
+            },
+            "video": { # A PageElement kind representing a # A video page element.
+                # video.
+              "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                  # exists and sharing settings do not change.
+              "videoProperties": { # The properties of the Video. # The properties of the video.
+                "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                    # videos created in the Slides editor.
+                    #
+                    # If these fields are unset, they may be inherited from a parent placeholder
+                    # if it exists. If there is no parent, the fields will default to the value
+                    # used for new page elements created in the Slides editor, which may depend on
+                    # the page element kind.
+                  "dashStyle": "A String", # The dash style of the outline.
+                  "propertyState": "A String", # The outline property state.
+                      #
+                      # Updating the the outline on a page element will implicitly update this
+                      # field to`RENDERED`, unless another value is specified in the same request.
+                      # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                      # this case, any other outline fields set in the same request will be
+                      # ignored.
+                  "outlineFill": { # The fill of the outline. # The fill of the outline.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+              "id": "A String", # The video source's unique identifier for this video.
+              "source": "A String", # The video source.
+            },
+            "table": { # A PageElement kind representing a # A table page element.
+                # table.
+              "tableColumns": [ # Properties of each column.
+                { # Properties of each column in a table.
+                  "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              ],
+              "tableRows": [ # Properties and contents of each row.
+                  #
+                  # Cells that span multiple rows are contained in only one of these rows and
+                  # have a row_span greater
+                  # than 1.
+                { # Properties and contents of each row in a table.
+                  "tableCells": [ # Properties and contents of each cell.
+                      #
+                      # Cells that span multiple columns are represented only once with a
+                      # column_span greater
+                      # than 1. As a result, the length of this collection does not always match
+                      # the number of columns of the entire table.
+                    { # Properties and contents of each table cell.
+                      "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                          # text box or rectangle) or a table cell in a page.
+                        "textElements": [ # The text contents broken down into its component parts, including styling
+                            # information. This property is read-only.
+                          { # A TextElement describes the content of a range of indices in the text content
+                              # of a Shape or TableCell.
+                            "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                # replaced with content that can change over time.
+                              "content": "A String", # The rendered content of this auto text, if available.
+                              "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                  # inherited from the parent. Which text styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A text run in a paragraph that is not in a list will inherit its text style
+                                  #   from the the newline character in the paragraph at the 0 nesting level of
+                                  #   the list inside the parent placeholder.
+                                  # * A text run in a paragraph that is in a list will inherit its text style
+                                  #   from the newline character in the paragraph at its corresponding nesting
+                                  #   level of the list inside the parent placeholder.
+                                  #
+                                  # Inherited text styles are represented as unset fields in this message. If
+                                  # text is contained in a shape without a parent placeholder, unsetting these
+                                  # fields will revert the style to a value matching the defaults in the Slides
+                                  # editor.
+                                "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                                "bold": True or False, # Whether or not the text is bold.
+                                "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                    #
+                                    # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                    # rendered in a smaller font size, computed based on the `font_size` field.
+                                    # The `font_size` itself is not affected by changes in this field.
+                                "strikethrough": True or False, # Whether or not the text is struck through.
+                                "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                "fontFamily": "A String", # The font family of the text.
+                                    #
+                                    # The font family can be any font from the Font menu in Slides or from
+                                    # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                    # unrecognized, the text is rendered in `Arial`.
+                                    #
+                                    # Some fonts can affect the weight of the text. If an update request
+                                    # specifies values for both `font_family` and `bold`, the explicitly-set
+                                    # `bold` value is used.
+                                "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                    # are not inherited from parent text.
+                                    #
+                                    # Changing the link in an update request causes some other changes to the
+                                    # text style of the range:
+                                    #
+                                    # * When setting a link, the text foreground color will be set to
+                                    #   ThemeColorType.HYPERLINK and the text will
+                                    #   be underlined. If these fields are modified in the same
+                                    #   request, those values will be used instead of the link defaults.
+                                    # * Setting a link on a text range that overlaps with an existing link will
+                                    #   also update the existing link to point to the new URL.
+                                    # * Links are not settable on newline characters. As a result, setting a link
+                                    #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                    #   will separate the newline character(s) into their own text runs. The
+                                    #   link will be applied separately to the runs before and after the newline.
+                                    # * Removing a link will update the text style of the range to match the
+                                    #   style of the preceding text (or the default text styles if the preceding
+                                    #   text is another link) unless different styles are being set in the same
+                                    #   request.
+                                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                      # presentation with this ID. A page with this ID may not exist.
+                                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                      # in the presentation. There may not be a slide at this index.
+                                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                      # addressed by its position.
+                                },
+                                "italic": True or False, # Whether or not the text is italicized.
+                                "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                    # points.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "underline": True or False, # Whether or not the text is underlined.
+                                "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                              },
+                              "type": "A String", # The type of this auto text.
+                            },
+                            "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                # units.
+                            "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                            "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                #
+                                # The `start_index` and `end_index` of this TextElement represent the
+                                # range of the paragraph. Other TextElements with an index range contained
+                                # inside this paragraph's range are considered to be part of this
+                                # paragraph. The range of indices of two separate paragraphs will never
+                                # overlap.
+                              "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                  # inherited from the parent. Which paragraph styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A paragraph not in a list will inherit its paragraph style from the
+                                  #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                  # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                  #   at its corresponding nesting level of the list inside the parent
+                                  #   placeholder.
+                                  #
+                                  # Inherited paragraph styles are represented as unset fields in this message.
+                                "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                    # inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                    # is represented as 100.0. If unset, the value is inherited from the parent.
+                                    # This property is read-only.
+                                "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                    # the start of the text, based on the current text direction. If unset, the
+                                    # value is inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                    # inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                    # the end of the text, based on the current text direction. If unset, the
+                                    # value is inherited from the parent. This property is read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                    # If unset, the value is inherited from the parent. This property is
+                                    # read-only.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                              },
+                              "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                  # belong to a list.
+                                "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                "listId": "A String", # The ID of the list this paragraph belongs to.
+                                "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                              },
+                            },
+                            "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                # in the run have the same TextStyle.
+                                #
+                                # The `start_index` and `end_index` of TextRuns will always be fully
+                                # contained in the index range of a single `paragraph_marker` TextElement.
+                                # In other words, a TextRun will never span multiple paragraphs.
+                                # styling.
+                              "content": "A String", # The text of this run.
+                              "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                  #
+                                  # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                  # inherited from the parent. Which text styles are inherited depend on the
+                                  # nesting level of lists:
+                                  #
+                                  # * A text run in a paragraph that is not in a list will inherit its text style
+                                  #   from the the newline character in the paragraph at the 0 nesting level of
+                                  #   the list inside the parent placeholder.
+                                  # * A text run in a paragraph that is in a list will inherit its text style
+                                  #   from the newline character in the paragraph at its corresponding nesting
+                                  #   level of the list inside the parent placeholder.
+                                  #
+                                  # Inherited text styles are represented as unset fields in this message. If
+                                  # text is contained in a shape without a parent placeholder, unsetting these
+                                  # fields will revert the style to a value matching the defaults in the Slides
+                                  # editor.
+                                "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                                "bold": True or False, # Whether or not the text is bold.
+                                "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                    #
+                                    # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                    # rendered in a smaller font size, computed based on the `font_size` field.
+                                    # The `font_size` itself is not affected by changes in this field.
+                                "strikethrough": True or False, # Whether or not the text is struck through.
+                                "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                "fontFamily": "A String", # The font family of the text.
+                                    #
+                                    # The font family can be any font from the Font menu in Slides or from
+                                    # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                    # unrecognized, the text is rendered in `Arial`.
+                                    #
+                                    # Some fonts can affect the weight of the text. If an update request
+                                    # specifies values for both `font_family` and `bold`, the explicitly-set
+                                    # `bold` value is used.
+                                "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                    # are not inherited from parent text.
+                                    #
+                                    # Changing the link in an update request causes some other changes to the
+                                    # text style of the range:
+                                    #
+                                    # * When setting a link, the text foreground color will be set to
+                                    #   ThemeColorType.HYPERLINK and the text will
+                                    #   be underlined. If these fields are modified in the same
+                                    #   request, those values will be used instead of the link defaults.
+                                    # * Setting a link on a text range that overlaps with an existing link will
+                                    #   also update the existing link to point to the new URL.
+                                    # * Links are not settable on newline characters. As a result, setting a link
+                                    #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                    #   will separate the newline character(s) into their own text runs. The
+                                    #   link will be applied separately to the runs before and after the newline.
+                                    # * Removing a link will update the text style of the range to match the
+                                    #   style of the preceding text (or the default text styles if the preceding
+                                    #   text is another link) unless different styles are being set in the same
+                                    #   request.
+                                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                      # presentation with this ID. A page with this ID may not exist.
+                                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                      # in the presentation. There may not be a slide at this index.
+                                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                      # addressed by its position.
+                                },
+                                "italic": True or False, # Whether or not the text is italicized.
+                                "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                    # points.
+                                  "magnitude": 3.14, # The magnitude.
+                                  "unit": "A String", # The units for magnitude.
+                                },
+                                "underline": True or False, # Whether or not the text is underlined.
+                                "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                    # transparent, depending on if the `opaque_color` field in it is set.
+                                  "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                      # a transparent color.
+                                    "themeColor": "A String", # An opaque theme color.
+                                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          },
+                        ],
+                        "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                          "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                              # associated with a list. A paragraph that is part of a list has an implicit
+                              # reference to that list's ID.
+                            "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                # level. A list has at most nine levels of nesting, so the possible values
+                                # for the keys of this map are 0 through 8, inclusive.
+                              "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                  # level of nesting.
+                                "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                            "listId": "A String", # The ID of the list.
+                          },
+                        },
+                      },
+                      "rowSpan": 42, # Row span of the cell.
+                      "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                        "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                            # for newly created table cells in the Slides editor.
+                          "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                              # specified color value.
+                              #
+                              # If any field is unset, its value may be inherited from a parent placeholder
+                              # if it exists.
+                            "color": { # A themeable solid color value. # The color value of the solid fill.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                            "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                # That is, the final pixel color is defined by the equation:
+                                #
+                                #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                #
+                                # This means that a value of 1.0 corresponds to a solid color, whereas
+                                # a value of 0.0 corresponds to a completely transparent color.
+                          },
+                          "propertyState": "A String", # The background fill property state.
+                              #
+                              # Updating the the fill on a table cell will implicitly update this field
+                              # to `RENDERED`, unless another value is specified in the same request. To
+                              # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                              # case, any other fill fields set in the same request will be ignored.
+                        },
+                      },
+                      "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                        "rowIndex": 42, # The 0-based row index.
+                        "columnIndex": 42, # The 0-based column index.
+                      },
+                      "columnSpan": 42, # Column span of the cell.
+                    },
+                  ],
+                  "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              ],
+              "rows": 42, # Number of rows in the table.
+              "columns": 42, # Number of columns in the table.
+            },
+            "line": { # A PageElement kind representing a # A line page element.
+                # line, curved connector, or bent connector.
+              "lineProperties": { # The properties of the Line. # The properties of the line.
+                  #
+                  # When unset, these fields default to values that match the appearance of
+                  # new lines created in the Slides editor.
+                "dashStyle": "A String", # The dash style of the line.
+                "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "endArrow": "A String", # The style of the arrow at the end of the line.
+                "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                  "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                  "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                      # presentation with this ID. A page with this ID may not exist.
+                  "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                      # in the presentation. There may not be a slide at this index.
+                  "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                      # addressed by its position.
+                },
+                "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                    # lines created in the Slides editor.
+                  "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                      # specified color value.
+                      #
+                      # If any field is unset, its value may be inherited from a parent placeholder
+                      # if it exists.
+                    "color": { # A themeable solid color value. # The color value of the solid fill.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                        # That is, the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color.
+                  },
+                },
+              },
+              "lineType": "A String", # The type of the line.
+            },
+            "size": { # A width and height. # The size of the page element.
+              "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+            "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                # joined collection of PageElements.
+              "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                # Object with schema name: PageElement
+              ],
+            },
+          },
+        ],
+        "objectId": "A String", # The object ID for this page. Object IDs used by
+            # Page and
+            # PageElement share the same namespace.
+        "pageProperties": { # The properties of the Page. # The properties of the page.
+            #
+            # The page will inherit properties from the parent page. Depending on the page
+            # type the hierarchy is defined in either
+            # SlideProperties or
+            # LayoutProperties.
+          "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+              # from a parent page if it exists. If the page has no parent, then the
+              # background fill defaults to the corresponding fill in the Slides editor.
+            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                # specified color value.
+                #
+                # If any field is unset, its value may be inherited from a parent placeholder
+                # if it exists.
+              "color": { # A themeable solid color value. # The color value of the solid fill.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                  # That is, the final pixel color is defined by the equation:
+                  #
+                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                  #
+                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                  # a value of 0.0 corresponds to a completely transparent color.
+            },
+            "propertyState": "A String", # The background fill property state.
+                #
+                # Updating the the fill on a page will implicitly update this field to
+                # `RENDERED`, unless another value is specified in the same request. To
+                # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                # any other fill fields set in the same request will be ignored.
+            "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                # the specified picture. The picture is stretched to fit its container.
+              "contentUrl": "A String", # Reading the content_url:
+                  #
+                  # An URL to a picture with a default lifetime of 30 minutes.
+                  # This URL is tagged with the account of the requester. Anyone with the URL
+                  # effectively accesses the picture as the original requester. Access to the
+                  # picture may be lost if the presentation's sharing settings change.
+                  #
+                  # Writing the content_url:
+                  #
+                  # The picture is fetched once at insertion time and a copy is stored for
+                  # display inside the presentation. Pictures must be less than 50MB in size,
+                  # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                  # format.
+              "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+            },
+          },
+          "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+              # a parent page. If the page has no parent, the color scheme uses a default
+              # Slides color scheme. This field is read-only.
+            "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+              { # A pair mapping a theme color type to the concrete color it represents.
+                "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+                "type": "A String", # The type of the theme color.
+              },
+            ],
+          },
+        },
+        "pageType": "A String", # The type of the page.
+        "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+            # relevant for pages with page_type SLIDE.
+          "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+          "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+        },
+      },
+    ],
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A Google Slides presentation.
+      "presentationId": "A String", # The ID of the presentation.
+      "masters": [ # The slide masters in the presentation. A slide master contains all common
+          # page elements and the common properties for a set of layouts. They serve
+          # three purposes:
+          #
+          # - Placeholder shapes on a master contain the default text styles and shape
+          #   properties of all placeholder shapes on pages that use that master.
+          # - The master page properties define the common page properties inherited by
+          #   its layouts.
+          # - Any other shapes on the master slide will appear on all slides using that
+          #   master, regardless of their layout.
+        { # A page in a presentation.
+          "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+              # relevant for pages with page_type LAYOUT.
+            "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+            "name": "A String", # The name of the layout.
+            "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+          },
+          "pageElements": [ # The page elements rendered on the page.
+            { # A visual element rendered on a page.
+              "wordArt": { # A PageElement kind representing # A word art page element.
+                  # word art.
+                "renderedText": "A String", # The text rendered as word art.
+              },
+              "description": "A String", # The description of the page element. Combined with title to display alt
+                  # text.
+              "objectId": "A String", # The object ID for this page element. Object IDs used by
+                  # google.apps.slides.v1.Page and
+                  # google.apps.slides.v1.PageElement share the same namespace.
+              "title": "A String", # The title of the page element. Combined with description to display alt
+                  # text.
+              "image": { # A PageElement kind representing an # An image page element.
+                  # image.
+                "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the image as the original requester. Access to the
+                    # image may be lost if the presentation's sharing settings change.
+                "imageProperties": { # The properties of the Image. # The properties of the image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "shape": { # A PageElement kind representing a # A generic shape.
+                  # generic shape that does not have a more specific classification.
+                "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                    # text box or rectangle) or a table cell in a page.
+                  "textElements": [ # The text contents broken down into its component parts, including styling
+                      # information. This property is read-only.
+                    { # A TextElement describes the content of a range of indices in the text content
+                        # of a Shape or TableCell.
+                      "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                          # replaced with content that can change over time.
+                        "content": "A String", # The rendered content of this auto text, if available.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "type": "A String", # The type of this auto text.
+                      },
+                      "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                          # units.
+                      "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                      "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                          #
+                          # The `start_index` and `end_index` of this TextElement represent the
+                          # range of the paragraph. Other TextElements with an index range contained
+                          # inside this paragraph's range are considered to be part of this
+                          # paragraph. The range of indices of two separate paragraphs will never
+                          # overlap.
+                        "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                            # inherited from the parent. Which paragraph styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A paragraph not in a list will inherit its paragraph style from the
+                            #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                            # * A paragraph in a list will inherit its paragraph style from the paragraph
+                            #   at its corresponding nesting level of the list inside the parent
+                            #   placeholder.
+                            #
+                            # Inherited paragraph styles are represented as unset fields in this message.
+                          "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                          "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                          "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                              # is represented as 100.0. If unset, the value is inherited from the parent.
+                              # This property is read-only.
+                          "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the start of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the end of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                              # If unset, the value is inherited from the parent. This property is
+                              # read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                        },
+                        "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                            # belong to a list.
+                          "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                          "listId": "A String", # The ID of the list this paragraph belongs to.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                          "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                        },
+                      },
+                      "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                          # in the run have the same TextStyle.
+                          #
+                          # The `start_index` and `end_index` of TextRuns will always be fully
+                          # contained in the index range of a single `paragraph_marker` TextElement.
+                          # In other words, a TextRun will never span multiple paragraphs.
+                          # styling.
+                        "content": "A String", # The text of this run.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                  ],
+                  "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                    "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                        # associated with a list. A paragraph that is part of a list has an implicit
+                        # reference to that list's ID.
+                      "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                          # level. A list has at most nine levels of nesting, so the possible values
+                          # for the keys of this map are 0 through 8, inclusive.
+                        "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                            # level of nesting.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                        },
+                      },
+                      "listId": "A String", # The ID of the list.
+                    },
+                  },
+                },
+                "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                    #
+                    # If the shape is a placeholder shape as determined by the
+                    # placeholder field, then these
+                    # properties may be inherited from a parent placeholder shape.
+                    # Determining the rendered value of the property depends on the corresponding
+                    # property_state field value.
+                  "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                      # a parent placeholder if it exists. If the shape has no parent, then the
+                      # default shadow matches the defaults for new shapes created in the Slides
+                      # editor. This property is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                      # inherited from a parent placeholder if it exists. If the shape has no
+                      # parent, then the default background fill depends on the shape type,
+                      # matching the defaults for new shapes created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                    "propertyState": "A String", # The background fill property state.
+                        #
+                        # Updating the the fill on a shape will implicitly update this field to
+                        # `RENDERED`, unless another value is specified in the same request. To
+                        # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                        # any other fill fields set in the same request will be ignored.
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                      # are not inherited from parent placeholders.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                      # parent placeholder if it exists. If the shape has no parent, then the
+                      # default outline depends on the shape type, matching the defaults for
+                      # new shapes created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                    # layouts and masters.
+                    #
+                    # If set, the shape is a placeholder shape and any inherited properties
+                    # can be resolved by looking at the parent placeholder identified by the
+                    # Placeholder.parent_object_id field.
+                  "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                      # If unset, the parent placeholder shape does not exist, so the shape does
+                      # not inherit properties from any other shape.
+                  "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                      # in the same page, they would have different index values.
+                  "type": "A String", # The type of the placeholder.
+                },
+                "shapeType": "A String", # The type of the shape.
+              },
+              "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                  # represented as images.
+                  # a linked chart embedded from Google Sheets.
+                "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                    # embedded.
+                "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+                "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                  "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                    "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "dashStyle": "A String", # The dash style of the outline.
+                      "propertyState": "A String", # The outline property state.
+                          #
+                          # Updating the the outline on a page element will implicitly update this
+                          # field to`RENDERED`, unless another value is specified in the same request.
+                          # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                          # this case, any other outline fields set in the same request will be
+                          # ignored.
+                      "outlineFill": { # The fill of the outline. # The fill of the outline.
+                        "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                            # specified color value.
+                            #
+                            # If any field is unset, its value may be inherited from a parent placeholder
+                            # if it exists.
+                          "color": { # A themeable solid color value. # The color value of the solid fill.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                              # That is, the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color.
+                        },
+                      },
+                      "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                    },
+                    "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                    "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                        # This property is read-only.
+                      "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                          # stops. This property is read-only.
+                        { # A color and position in a gradient band.
+                          "color": { # A themeable solid color value. # The color of the gradient stop.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "position": 3.14, # The relative position of the color stop in the gradient band measured
+                              # in percentage. The value should be in the interval [0.0, 1.0].
+                          "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                              # fully opaque.
+                        },
+                      ],
+                    },
+                    "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                          # presentation with this ID. A page with this ID may not exist.
+                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                          # in the presentation. There may not be a slide at this index.
+                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                          # addressed by its position.
+                    },
+                    "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                        # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                        # This property is read-only.
+                    "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                        # This property is read-only.
+                        # Image.
+                        #
+                        # The crop properties is represented by the offsets of four edges which define
+                        # a crop rectangle. The offsets are measured in percentage from the
+                        # corresponding edges of the object's original bounding rectangle towards
+                        # inside, relative to the object's original dimensions.
+                        #
+                        # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                        # rectangle is positioned inside of the object's original bounding rectangle.
+                        # - If the offset is negative or greater than 1, the corresponding edge of crop
+                        # rectangle is positioned outside of the object's original bounding rectangle.
+                        # - If the left edge of the crop rectangle is on the right side of its right
+                        # edge, the object will be flipped horizontally.
+                        # - If the top edge of the crop rectangle is below its bottom edge, the object
+                        # will be flipped vertically.
+                        # - If all offsets and rotation angle is 0, the object is not cropped.
+                        #
+                        # After cropping, the content in the crop rectangle will be stretched to fit
+                        # its container.
+                      "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                          # the right of the original bounding rectangle left edge, relative to the
+                          # object's original width.
+                      "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                          # Rotation angle is applied after the offset.
+                      "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                          # above the original bounding rectangle bottom edge, relative to the object's
+                          # original height.
+                      "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                          # to the left of the original bounding rectangle right edge, relative to the
+                          # object's original width.
+                      "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                          # below the original bounding rectangle top edge, relative to the object's
+                          # original height.
+                    },
+                    "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                        # is read-only.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "color": { # A themeable solid color value. # The shadow color value.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                          # relative to the alignment position.
+                          # to transform source coordinates (x,y) into destination coordinates (x', y')
+                          # according to:
+                          #
+                          #       x'  x  =   shear_y  scale_y  translate_y
+                          #       1  [ 1 ]
+                          #
+                          # After transformation,
+                          #
+                          #      x' = scale_x * x + shear_x * y + translate_x;
+                          #      y' = scale_y * y + shear_y * x + translate_y;
+                          #
+                          # This message is therefore composed of these six matrix elements.
+                        "translateX": 3.14, # The X coordinate translation element.
+                        "translateY": 3.14, # The Y coordinate translation element.
+                        "scaleX": 3.14, # The X coordinate scaling element.
+                        "scaleY": 3.14, # The Y coordinate scaling element.
+                        "shearY": 3.14, # The Y coordinate shearing element.
+                        "shearX": 3.14, # The X coordinate shearing element.
+                        "unit": "A String", # The units for translate elements.
+                      },
+                      "propertyState": "A String", # The shadow property state.
+                          #
+                          # Updating the the shadow on a page element will implicitly update this field
+                          # to `RENDERED`, unless another value is specified in the same request. To
+                          # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                          # case, any other shadow fields set in the same request will be ignored.
+                      "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                          # shadow becomes.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                      "type": "A String", # The type of the shadow.
+                      "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                          # scale and skew of the shadow.
+                      "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                    },
+                    "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  },
+                },
+                "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                    # minutes. This URL is tagged with the account of the requester. Anyone with
+                    # the URL effectively accesses the image as the original requester. Access to
+                    # the image may be lost if the presentation's sharing settings change.
+              },
+              "video": { # A PageElement kind representing a # A video page element.
+                  # video.
+                "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                    # exists and sharing settings do not change.
+                "videoProperties": { # The properties of the Video. # The properties of the video.
+                  "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                      # videos created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "id": "A String", # The video source's unique identifier for this video.
+                "source": "A String", # The video source.
+              },
+              "table": { # A PageElement kind representing a # A table page element.
+                  # table.
+                "tableColumns": [ # Properties of each column.
+                  { # Properties of each column in a table.
+                    "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "tableRows": [ # Properties and contents of each row.
+                    #
+                    # Cells that span multiple rows are contained in only one of these rows and
+                    # have a row_span greater
+                    # than 1.
+                  { # Properties and contents of each row in a table.
+                    "tableCells": [ # Properties and contents of each cell.
+                        #
+                        # Cells that span multiple columns are represented only once with a
+                        # column_span greater
+                        # than 1. As a result, the length of this collection does not always match
+                        # the number of columns of the entire table.
+                      { # Properties and contents of each table cell.
+                        "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                            # text box or rectangle) or a table cell in a page.
+                          "textElements": [ # The text contents broken down into its component parts, including styling
+                              # information. This property is read-only.
+                            { # A TextElement describes the content of a range of indices in the text content
+                                # of a Shape or TableCell.
+                              "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                  # replaced with content that can change over time.
+                                "content": "A String", # The rendered content of this auto text, if available.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "type": "A String", # The type of this auto text.
+                              },
+                              "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                  # units.
+                              "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                              "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                  #
+                                  # The `start_index` and `end_index` of this TextElement represent the
+                                  # range of the paragraph. Other TextElements with an index range contained
+                                  # inside this paragraph's range are considered to be part of this
+                                  # paragraph. The range of indices of two separate paragraphs will never
+                                  # overlap.
+                                "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                    # inherited from the parent. Which paragraph styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A paragraph not in a list will inherit its paragraph style from the
+                                    #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                    # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                    #   at its corresponding nesting level of the list inside the parent
+                                    #   placeholder.
+                                    #
+                                    # Inherited paragraph styles are represented as unset fields in this message.
+                                  "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                  "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                  "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                      # is represented as 100.0. If unset, the value is inherited from the parent.
+                                      # This property is read-only.
+                                  "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the start of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the end of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                      # If unset, the value is inherited from the parent. This property is
+                                      # read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                                },
+                                "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                    # belong to a list.
+                                  "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                  "listId": "A String", # The ID of the list this paragraph belongs to.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                  "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                                },
+                              },
+                              "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                  # in the run have the same TextStyle.
+                                  #
+                                  # The `start_index` and `end_index` of TextRuns will always be fully
+                                  # contained in the index range of a single `paragraph_marker` TextElement.
+                                  # In other words, a TextRun will never span multiple paragraphs.
+                                  # styling.
+                                "content": "A String", # The text of this run.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          ],
+                          "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                            "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                                # associated with a list. A paragraph that is part of a list has an implicit
+                                # reference to that list's ID.
+                              "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                  # level. A list has at most nine levels of nesting, so the possible values
+                                  # for the keys of this map are 0 through 8, inclusive.
+                                "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                    # level of nesting.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                              "listId": "A String", # The ID of the list.
+                            },
+                          },
+                        },
+                        "rowSpan": 42, # Row span of the cell.
+                        "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                          "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                              # for newly created table cells in the Slides editor.
+                            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                                # specified color value.
+                                #
+                                # If any field is unset, its value may be inherited from a parent placeholder
+                                # if it exists.
+                              "color": { # A themeable solid color value. # The color value of the solid fill.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                  # That is, the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color.
+                            },
+                            "propertyState": "A String", # The background fill property state.
+                                #
+                                # Updating the the fill on a table cell will implicitly update this field
+                                # to `RENDERED`, unless another value is specified in the same request. To
+                                # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                                # case, any other fill fields set in the same request will be ignored.
+                          },
+                        },
+                        "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                          "rowIndex": 42, # The 0-based row index.
+                          "columnIndex": 42, # The 0-based column index.
+                        },
+                        "columnSpan": 42, # Column span of the cell.
+                      },
+                    ],
+                    "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "rows": 42, # Number of rows in the table.
+                "columns": 42, # Number of columns in the table.
+              },
+              "line": { # A PageElement kind representing a # A line page element.
+                  # line, curved connector, or bent connector.
+                "lineProperties": { # The properties of the Line. # The properties of the line.
+                    #
+                    # When unset, these fields default to values that match the appearance of
+                    # new lines created in the Slides editor.
+                  "dashStyle": "A String", # The dash style of the line.
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "endArrow": "A String", # The style of the arrow at the end of the line.
+                  "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                  "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                      # lines created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                },
+                "lineType": "A String", # The type of the line.
+              },
+              "size": { # A width and height. # The size of the page element.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+              "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                  # joined collection of PageElements.
+                "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                  # Object with schema name: PageElement
+                ],
+              },
+            },
+          ],
+          "objectId": "A String", # The object ID for this page. Object IDs used by
+              # Page and
+              # PageElement share the same namespace.
+          "pageProperties": { # The properties of the Page. # The properties of the page.
+              #
+              # The page will inherit properties from the parent page. Depending on the page
+              # type the hierarchy is defined in either
+              # SlideProperties or
+              # LayoutProperties.
+            "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+                # from a parent page if it exists. If the page has no parent, then the
+                # background fill defaults to the corresponding fill in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a page will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+              "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                  # the specified picture. The picture is stretched to fit its container.
+                "contentUrl": "A String", # Reading the content_url:
+                    #
+                    # An URL to a picture with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the picture as the original requester. Access to the
+                    # picture may be lost if the presentation's sharing settings change.
+                    #
+                    # Writing the content_url:
+                    #
+                    # The picture is fetched once at insertion time and a copy is stored for
+                    # display inside the presentation. Pictures must be less than 50MB in size,
+                    # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                    # format.
+                "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                  "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+            },
+            "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+                # a parent page. If the page has no parent, the color scheme uses a default
+                # Slides color scheme. This field is read-only.
+              "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+                { # A pair mapping a theme color type to the concrete color it represents.
+                  "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                  "type": "A String", # The type of the theme color.
+                },
+              ],
+            },
+          },
+          "pageType": "A String", # The type of the page.
+          "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+              # relevant for pages with page_type SLIDE.
+            "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+            "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+          },
+        },
+      ],
+      "pageSize": { # A width and height. # The size of pages in the presentation.
+        "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+          "magnitude": 3.14, # The magnitude.
+          "unit": "A String", # The units for magnitude.
+        },
+        "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+          "magnitude": 3.14, # The magnitude.
+          "unit": "A String", # The units for magnitude.
+        },
+      },
+      "title": "A String", # The title of the presentation.
+      "locale": "A String", # The locale of the presentation, as an IETF BCP 47 language tag.
+      "slides": [ # The slides in the presentation.
+          # A slide inherits properties from a slide layout.
+        { # A page in a presentation.
+          "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+              # relevant for pages with page_type LAYOUT.
+            "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+            "name": "A String", # The name of the layout.
+            "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+          },
+          "pageElements": [ # The page elements rendered on the page.
+            { # A visual element rendered on a page.
+              "wordArt": { # A PageElement kind representing # A word art page element.
+                  # word art.
+                "renderedText": "A String", # The text rendered as word art.
+              },
+              "description": "A String", # The description of the page element. Combined with title to display alt
+                  # text.
+              "objectId": "A String", # The object ID for this page element. Object IDs used by
+                  # google.apps.slides.v1.Page and
+                  # google.apps.slides.v1.PageElement share the same namespace.
+              "title": "A String", # The title of the page element. Combined with description to display alt
+                  # text.
+              "image": { # A PageElement kind representing an # An image page element.
+                  # image.
+                "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the image as the original requester. Access to the
+                    # image may be lost if the presentation's sharing settings change.
+                "imageProperties": { # The properties of the Image. # The properties of the image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "shape": { # A PageElement kind representing a # A generic shape.
+                  # generic shape that does not have a more specific classification.
+                "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                    # text box or rectangle) or a table cell in a page.
+                  "textElements": [ # The text contents broken down into its component parts, including styling
+                      # information. This property is read-only.
+                    { # A TextElement describes the content of a range of indices in the text content
+                        # of a Shape or TableCell.
+                      "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                          # replaced with content that can change over time.
+                        "content": "A String", # The rendered content of this auto text, if available.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "type": "A String", # The type of this auto text.
+                      },
+                      "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                          # units.
+                      "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                      "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                          #
+                          # The `start_index` and `end_index` of this TextElement represent the
+                          # range of the paragraph. Other TextElements with an index range contained
+                          # inside this paragraph's range are considered to be part of this
+                          # paragraph. The range of indices of two separate paragraphs will never
+                          # overlap.
+                        "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                            # inherited from the parent. Which paragraph styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A paragraph not in a list will inherit its paragraph style from the
+                            #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                            # * A paragraph in a list will inherit its paragraph style from the paragraph
+                            #   at its corresponding nesting level of the list inside the parent
+                            #   placeholder.
+                            #
+                            # Inherited paragraph styles are represented as unset fields in this message.
+                          "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                          "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                          "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                              # is represented as 100.0. If unset, the value is inherited from the parent.
+                              # This property is read-only.
+                          "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the start of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the end of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                              # If unset, the value is inherited from the parent. This property is
+                              # read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                        },
+                        "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                            # belong to a list.
+                          "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                          "listId": "A String", # The ID of the list this paragraph belongs to.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                          "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                        },
+                      },
+                      "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                          # in the run have the same TextStyle.
+                          #
+                          # The `start_index` and `end_index` of TextRuns will always be fully
+                          # contained in the index range of a single `paragraph_marker` TextElement.
+                          # In other words, a TextRun will never span multiple paragraphs.
+                          # styling.
+                        "content": "A String", # The text of this run.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                  ],
+                  "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                    "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                        # associated with a list. A paragraph that is part of a list has an implicit
+                        # reference to that list's ID.
+                      "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                          # level. A list has at most nine levels of nesting, so the possible values
+                          # for the keys of this map are 0 through 8, inclusive.
+                        "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                            # level of nesting.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                        },
+                      },
+                      "listId": "A String", # The ID of the list.
+                    },
+                  },
+                },
+                "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                    #
+                    # If the shape is a placeholder shape as determined by the
+                    # placeholder field, then these
+                    # properties may be inherited from a parent placeholder shape.
+                    # Determining the rendered value of the property depends on the corresponding
+                    # property_state field value.
+                  "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                      # a parent placeholder if it exists. If the shape has no parent, then the
+                      # default shadow matches the defaults for new shapes created in the Slides
+                      # editor. This property is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                      # inherited from a parent placeholder if it exists. If the shape has no
+                      # parent, then the default background fill depends on the shape type,
+                      # matching the defaults for new shapes created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                    "propertyState": "A String", # The background fill property state.
+                        #
+                        # Updating the the fill on a shape will implicitly update this field to
+                        # `RENDERED`, unless another value is specified in the same request. To
+                        # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                        # any other fill fields set in the same request will be ignored.
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                      # are not inherited from parent placeholders.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                      # parent placeholder if it exists. If the shape has no parent, then the
+                      # default outline depends on the shape type, matching the defaults for
+                      # new shapes created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                    # layouts and masters.
+                    #
+                    # If set, the shape is a placeholder shape and any inherited properties
+                    # can be resolved by looking at the parent placeholder identified by the
+                    # Placeholder.parent_object_id field.
+                  "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                      # If unset, the parent placeholder shape does not exist, so the shape does
+                      # not inherit properties from any other shape.
+                  "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                      # in the same page, they would have different index values.
+                  "type": "A String", # The type of the placeholder.
+                },
+                "shapeType": "A String", # The type of the shape.
+              },
+              "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                  # represented as images.
+                  # a linked chart embedded from Google Sheets.
+                "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                    # embedded.
+                "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+                "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                  "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                    "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "dashStyle": "A String", # The dash style of the outline.
+                      "propertyState": "A String", # The outline property state.
+                          #
+                          # Updating the the outline on a page element will implicitly update this
+                          # field to`RENDERED`, unless another value is specified in the same request.
+                          # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                          # this case, any other outline fields set in the same request will be
+                          # ignored.
+                      "outlineFill": { # The fill of the outline. # The fill of the outline.
+                        "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                            # specified color value.
+                            #
+                            # If any field is unset, its value may be inherited from a parent placeholder
+                            # if it exists.
+                          "color": { # A themeable solid color value. # The color value of the solid fill.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                              # That is, the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color.
+                        },
+                      },
+                      "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                    },
+                    "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                    "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                        # This property is read-only.
+                      "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                          # stops. This property is read-only.
+                        { # A color and position in a gradient band.
+                          "color": { # A themeable solid color value. # The color of the gradient stop.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "position": 3.14, # The relative position of the color stop in the gradient band measured
+                              # in percentage. The value should be in the interval [0.0, 1.0].
+                          "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                              # fully opaque.
+                        },
+                      ],
+                    },
+                    "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                          # presentation with this ID. A page with this ID may not exist.
+                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                          # in the presentation. There may not be a slide at this index.
+                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                          # addressed by its position.
+                    },
+                    "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                        # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                        # This property is read-only.
+                    "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                        # This property is read-only.
+                        # Image.
+                        #
+                        # The crop properties is represented by the offsets of four edges which define
+                        # a crop rectangle. The offsets are measured in percentage from the
+                        # corresponding edges of the object's original bounding rectangle towards
+                        # inside, relative to the object's original dimensions.
+                        #
+                        # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                        # rectangle is positioned inside of the object's original bounding rectangle.
+                        # - If the offset is negative or greater than 1, the corresponding edge of crop
+                        # rectangle is positioned outside of the object's original bounding rectangle.
+                        # - If the left edge of the crop rectangle is on the right side of its right
+                        # edge, the object will be flipped horizontally.
+                        # - If the top edge of the crop rectangle is below its bottom edge, the object
+                        # will be flipped vertically.
+                        # - If all offsets and rotation angle is 0, the object is not cropped.
+                        #
+                        # After cropping, the content in the crop rectangle will be stretched to fit
+                        # its container.
+                      "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                          # the right of the original bounding rectangle left edge, relative to the
+                          # object's original width.
+                      "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                          # Rotation angle is applied after the offset.
+                      "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                          # above the original bounding rectangle bottom edge, relative to the object's
+                          # original height.
+                      "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                          # to the left of the original bounding rectangle right edge, relative to the
+                          # object's original width.
+                      "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                          # below the original bounding rectangle top edge, relative to the object's
+                          # original height.
+                    },
+                    "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                        # is read-only.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "color": { # A themeable solid color value. # The shadow color value.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                          # relative to the alignment position.
+                          # to transform source coordinates (x,y) into destination coordinates (x', y')
+                          # according to:
+                          #
+                          #       x'  x  =   shear_y  scale_y  translate_y
+                          #       1  [ 1 ]
+                          #
+                          # After transformation,
+                          #
+                          #      x' = scale_x * x + shear_x * y + translate_x;
+                          #      y' = scale_y * y + shear_y * x + translate_y;
+                          #
+                          # This message is therefore composed of these six matrix elements.
+                        "translateX": 3.14, # The X coordinate translation element.
+                        "translateY": 3.14, # The Y coordinate translation element.
+                        "scaleX": 3.14, # The X coordinate scaling element.
+                        "scaleY": 3.14, # The Y coordinate scaling element.
+                        "shearY": 3.14, # The Y coordinate shearing element.
+                        "shearX": 3.14, # The X coordinate shearing element.
+                        "unit": "A String", # The units for translate elements.
+                      },
+                      "propertyState": "A String", # The shadow property state.
+                          #
+                          # Updating the the shadow on a page element will implicitly update this field
+                          # to `RENDERED`, unless another value is specified in the same request. To
+                          # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                          # case, any other shadow fields set in the same request will be ignored.
+                      "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                          # shadow becomes.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                      "type": "A String", # The type of the shadow.
+                      "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                          # scale and skew of the shadow.
+                      "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                    },
+                    "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  },
+                },
+                "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                    # minutes. This URL is tagged with the account of the requester. Anyone with
+                    # the URL effectively accesses the image as the original requester. Access to
+                    # the image may be lost if the presentation's sharing settings change.
+              },
+              "video": { # A PageElement kind representing a # A video page element.
+                  # video.
+                "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                    # exists and sharing settings do not change.
+                "videoProperties": { # The properties of the Video. # The properties of the video.
+                  "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                      # videos created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "id": "A String", # The video source's unique identifier for this video.
+                "source": "A String", # The video source.
+              },
+              "table": { # A PageElement kind representing a # A table page element.
+                  # table.
+                "tableColumns": [ # Properties of each column.
+                  { # Properties of each column in a table.
+                    "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "tableRows": [ # Properties and contents of each row.
+                    #
+                    # Cells that span multiple rows are contained in only one of these rows and
+                    # have a row_span greater
+                    # than 1.
+                  { # Properties and contents of each row in a table.
+                    "tableCells": [ # Properties and contents of each cell.
+                        #
+                        # Cells that span multiple columns are represented only once with a
+                        # column_span greater
+                        # than 1. As a result, the length of this collection does not always match
+                        # the number of columns of the entire table.
+                      { # Properties and contents of each table cell.
+                        "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                            # text box or rectangle) or a table cell in a page.
+                          "textElements": [ # The text contents broken down into its component parts, including styling
+                              # information. This property is read-only.
+                            { # A TextElement describes the content of a range of indices in the text content
+                                # of a Shape or TableCell.
+                              "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                  # replaced with content that can change over time.
+                                "content": "A String", # The rendered content of this auto text, if available.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "type": "A String", # The type of this auto text.
+                              },
+                              "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                  # units.
+                              "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                              "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                  #
+                                  # The `start_index` and `end_index` of this TextElement represent the
+                                  # range of the paragraph. Other TextElements with an index range contained
+                                  # inside this paragraph's range are considered to be part of this
+                                  # paragraph. The range of indices of two separate paragraphs will never
+                                  # overlap.
+                                "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                    # inherited from the parent. Which paragraph styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A paragraph not in a list will inherit its paragraph style from the
+                                    #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                    # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                    #   at its corresponding nesting level of the list inside the parent
+                                    #   placeholder.
+                                    #
+                                    # Inherited paragraph styles are represented as unset fields in this message.
+                                  "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                  "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                  "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                      # is represented as 100.0. If unset, the value is inherited from the parent.
+                                      # This property is read-only.
+                                  "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the start of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the end of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                      # If unset, the value is inherited from the parent. This property is
+                                      # read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                                },
+                                "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                    # belong to a list.
+                                  "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                  "listId": "A String", # The ID of the list this paragraph belongs to.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                  "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                                },
+                              },
+                              "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                  # in the run have the same TextStyle.
+                                  #
+                                  # The `start_index` and `end_index` of TextRuns will always be fully
+                                  # contained in the index range of a single `paragraph_marker` TextElement.
+                                  # In other words, a TextRun will never span multiple paragraphs.
+                                  # styling.
+                                "content": "A String", # The text of this run.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          ],
+                          "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                            "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                                # associated with a list. A paragraph that is part of a list has an implicit
+                                # reference to that list's ID.
+                              "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                  # level. A list has at most nine levels of nesting, so the possible values
+                                  # for the keys of this map are 0 through 8, inclusive.
+                                "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                    # level of nesting.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                              "listId": "A String", # The ID of the list.
+                            },
+                          },
+                        },
+                        "rowSpan": 42, # Row span of the cell.
+                        "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                          "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                              # for newly created table cells in the Slides editor.
+                            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                                # specified color value.
+                                #
+                                # If any field is unset, its value may be inherited from a parent placeholder
+                                # if it exists.
+                              "color": { # A themeable solid color value. # The color value of the solid fill.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                  # That is, the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color.
+                            },
+                            "propertyState": "A String", # The background fill property state.
+                                #
+                                # Updating the the fill on a table cell will implicitly update this field
+                                # to `RENDERED`, unless another value is specified in the same request. To
+                                # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                                # case, any other fill fields set in the same request will be ignored.
+                          },
+                        },
+                        "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                          "rowIndex": 42, # The 0-based row index.
+                          "columnIndex": 42, # The 0-based column index.
+                        },
+                        "columnSpan": 42, # Column span of the cell.
+                      },
+                    ],
+                    "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "rows": 42, # Number of rows in the table.
+                "columns": 42, # Number of columns in the table.
+              },
+              "line": { # A PageElement kind representing a # A line page element.
+                  # line, curved connector, or bent connector.
+                "lineProperties": { # The properties of the Line. # The properties of the line.
+                    #
+                    # When unset, these fields default to values that match the appearance of
+                    # new lines created in the Slides editor.
+                  "dashStyle": "A String", # The dash style of the line.
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "endArrow": "A String", # The style of the arrow at the end of the line.
+                  "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                  "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                      # lines created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                },
+                "lineType": "A String", # The type of the line.
+              },
+              "size": { # A width and height. # The size of the page element.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+              "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                  # joined collection of PageElements.
+                "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                  # Object with schema name: PageElement
+                ],
+              },
+            },
+          ],
+          "objectId": "A String", # The object ID for this page. Object IDs used by
+              # Page and
+              # PageElement share the same namespace.
+          "pageProperties": { # The properties of the Page. # The properties of the page.
+              #
+              # The page will inherit properties from the parent page. Depending on the page
+              # type the hierarchy is defined in either
+              # SlideProperties or
+              # LayoutProperties.
+            "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+                # from a parent page if it exists. If the page has no parent, then the
+                # background fill defaults to the corresponding fill in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a page will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+              "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                  # the specified picture. The picture is stretched to fit its container.
+                "contentUrl": "A String", # Reading the content_url:
+                    #
+                    # An URL to a picture with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the picture as the original requester. Access to the
+                    # picture may be lost if the presentation's sharing settings change.
+                    #
+                    # Writing the content_url:
+                    #
+                    # The picture is fetched once at insertion time and a copy is stored for
+                    # display inside the presentation. Pictures must be less than 50MB in size,
+                    # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                    # format.
+                "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                  "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+            },
+            "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+                # a parent page. If the page has no parent, the color scheme uses a default
+                # Slides color scheme. This field is read-only.
+              "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+                { # A pair mapping a theme color type to the concrete color it represents.
+                  "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                  "type": "A String", # The type of the theme color.
+                },
+              ],
+            },
+          },
+          "pageType": "A String", # The type of the page.
+          "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+              # relevant for pages with page_type SLIDE.
+            "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+            "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+          },
+        },
+      ],
+      "layouts": [ # The layouts in the presentation. A layout is a template that determines
+          # how content is arranged and styled on the slides that inherit from that
+          # layout.
+        { # A page in a presentation.
+          "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+              # relevant for pages with page_type LAYOUT.
+            "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+            "name": "A String", # The name of the layout.
+            "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+          },
+          "pageElements": [ # The page elements rendered on the page.
+            { # A visual element rendered on a page.
+              "wordArt": { # A PageElement kind representing # A word art page element.
+                  # word art.
+                "renderedText": "A String", # The text rendered as word art.
+              },
+              "description": "A String", # The description of the page element. Combined with title to display alt
+                  # text.
+              "objectId": "A String", # The object ID for this page element. Object IDs used by
+                  # google.apps.slides.v1.Page and
+                  # google.apps.slides.v1.PageElement share the same namespace.
+              "title": "A String", # The title of the page element. Combined with description to display alt
+                  # text.
+              "image": { # A PageElement kind representing an # An image page element.
+                  # image.
+                "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the image as the original requester. Access to the
+                    # image may be lost if the presentation's sharing settings change.
+                "imageProperties": { # The properties of the Image. # The properties of the image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "shape": { # A PageElement kind representing a # A generic shape.
+                  # generic shape that does not have a more specific classification.
+                "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                    # text box or rectangle) or a table cell in a page.
+                  "textElements": [ # The text contents broken down into its component parts, including styling
+                      # information. This property is read-only.
+                    { # A TextElement describes the content of a range of indices in the text content
+                        # of a Shape or TableCell.
+                      "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                          # replaced with content that can change over time.
+                        "content": "A String", # The rendered content of this auto text, if available.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "type": "A String", # The type of this auto text.
+                      },
+                      "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                          # units.
+                      "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                      "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                          #
+                          # The `start_index` and `end_index` of this TextElement represent the
+                          # range of the paragraph. Other TextElements with an index range contained
+                          # inside this paragraph's range are considered to be part of this
+                          # paragraph. The range of indices of two separate paragraphs will never
+                          # overlap.
+                        "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                            # inherited from the parent. Which paragraph styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A paragraph not in a list will inherit its paragraph style from the
+                            #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                            # * A paragraph in a list will inherit its paragraph style from the paragraph
+                            #   at its corresponding nesting level of the list inside the parent
+                            #   placeholder.
+                            #
+                            # Inherited paragraph styles are represented as unset fields in this message.
+                          "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                          "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                          "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                              # is represented as 100.0. If unset, the value is inherited from the parent.
+                              # This property is read-only.
+                          "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the start of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the end of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                              # If unset, the value is inherited from the parent. This property is
+                              # read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                        },
+                        "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                            # belong to a list.
+                          "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                          "listId": "A String", # The ID of the list this paragraph belongs to.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                          "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                        },
+                      },
+                      "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                          # in the run have the same TextStyle.
+                          #
+                          # The `start_index` and `end_index` of TextRuns will always be fully
+                          # contained in the index range of a single `paragraph_marker` TextElement.
+                          # In other words, a TextRun will never span multiple paragraphs.
+                          # styling.
+                        "content": "A String", # The text of this run.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                  ],
+                  "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                    "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                        # associated with a list. A paragraph that is part of a list has an implicit
+                        # reference to that list's ID.
+                      "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                          # level. A list has at most nine levels of nesting, so the possible values
+                          # for the keys of this map are 0 through 8, inclusive.
+                        "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                            # level of nesting.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                        },
+                      },
+                      "listId": "A String", # The ID of the list.
+                    },
+                  },
+                },
+                "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                    #
+                    # If the shape is a placeholder shape as determined by the
+                    # placeholder field, then these
+                    # properties may be inherited from a parent placeholder shape.
+                    # Determining the rendered value of the property depends on the corresponding
+                    # property_state field value.
+                  "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                      # a parent placeholder if it exists. If the shape has no parent, then the
+                      # default shadow matches the defaults for new shapes created in the Slides
+                      # editor. This property is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                      # inherited from a parent placeholder if it exists. If the shape has no
+                      # parent, then the default background fill depends on the shape type,
+                      # matching the defaults for new shapes created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                    "propertyState": "A String", # The background fill property state.
+                        #
+                        # Updating the the fill on a shape will implicitly update this field to
+                        # `RENDERED`, unless another value is specified in the same request. To
+                        # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                        # any other fill fields set in the same request will be ignored.
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                      # are not inherited from parent placeholders.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                      # parent placeholder if it exists. If the shape has no parent, then the
+                      # default outline depends on the shape type, matching the defaults for
+                      # new shapes created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                    # layouts and masters.
+                    #
+                    # If set, the shape is a placeholder shape and any inherited properties
+                    # can be resolved by looking at the parent placeholder identified by the
+                    # Placeholder.parent_object_id field.
+                  "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                      # If unset, the parent placeholder shape does not exist, so the shape does
+                      # not inherit properties from any other shape.
+                  "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                      # in the same page, they would have different index values.
+                  "type": "A String", # The type of the placeholder.
+                },
+                "shapeType": "A String", # The type of the shape.
+              },
+              "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                  # represented as images.
+                  # a linked chart embedded from Google Sheets.
+                "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                    # embedded.
+                "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+                "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                  "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                    "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "dashStyle": "A String", # The dash style of the outline.
+                      "propertyState": "A String", # The outline property state.
+                          #
+                          # Updating the the outline on a page element will implicitly update this
+                          # field to`RENDERED`, unless another value is specified in the same request.
+                          # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                          # this case, any other outline fields set in the same request will be
+                          # ignored.
+                      "outlineFill": { # The fill of the outline. # The fill of the outline.
+                        "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                            # specified color value.
+                            #
+                            # If any field is unset, its value may be inherited from a parent placeholder
+                            # if it exists.
+                          "color": { # A themeable solid color value. # The color value of the solid fill.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                              # That is, the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color.
+                        },
+                      },
+                      "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                    },
+                    "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                    "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                        # This property is read-only.
+                      "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                          # stops. This property is read-only.
+                        { # A color and position in a gradient band.
+                          "color": { # A themeable solid color value. # The color of the gradient stop.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "position": 3.14, # The relative position of the color stop in the gradient band measured
+                              # in percentage. The value should be in the interval [0.0, 1.0].
+                          "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                              # fully opaque.
+                        },
+                      ],
+                    },
+                    "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                          # presentation with this ID. A page with this ID may not exist.
+                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                          # in the presentation. There may not be a slide at this index.
+                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                          # addressed by its position.
+                    },
+                    "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                        # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                        # This property is read-only.
+                    "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                        # This property is read-only.
+                        # Image.
+                        #
+                        # The crop properties is represented by the offsets of four edges which define
+                        # a crop rectangle. The offsets are measured in percentage from the
+                        # corresponding edges of the object's original bounding rectangle towards
+                        # inside, relative to the object's original dimensions.
+                        #
+                        # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                        # rectangle is positioned inside of the object's original bounding rectangle.
+                        # - If the offset is negative or greater than 1, the corresponding edge of crop
+                        # rectangle is positioned outside of the object's original bounding rectangle.
+                        # - If the left edge of the crop rectangle is on the right side of its right
+                        # edge, the object will be flipped horizontally.
+                        # - If the top edge of the crop rectangle is below its bottom edge, the object
+                        # will be flipped vertically.
+                        # - If all offsets and rotation angle is 0, the object is not cropped.
+                        #
+                        # After cropping, the content in the crop rectangle will be stretched to fit
+                        # its container.
+                      "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                          # the right of the original bounding rectangle left edge, relative to the
+                          # object's original width.
+                      "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                          # Rotation angle is applied after the offset.
+                      "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                          # above the original bounding rectangle bottom edge, relative to the object's
+                          # original height.
+                      "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                          # to the left of the original bounding rectangle right edge, relative to the
+                          # object's original width.
+                      "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                          # below the original bounding rectangle top edge, relative to the object's
+                          # original height.
+                    },
+                    "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                        # is read-only.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "color": { # A themeable solid color value. # The shadow color value.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                          # relative to the alignment position.
+                          # to transform source coordinates (x,y) into destination coordinates (x', y')
+                          # according to:
+                          #
+                          #       x'  x  =   shear_y  scale_y  translate_y
+                          #       1  [ 1 ]
+                          #
+                          # After transformation,
+                          #
+                          #      x' = scale_x * x + shear_x * y + translate_x;
+                          #      y' = scale_y * y + shear_y * x + translate_y;
+                          #
+                          # This message is therefore composed of these six matrix elements.
+                        "translateX": 3.14, # The X coordinate translation element.
+                        "translateY": 3.14, # The Y coordinate translation element.
+                        "scaleX": 3.14, # The X coordinate scaling element.
+                        "scaleY": 3.14, # The Y coordinate scaling element.
+                        "shearY": 3.14, # The Y coordinate shearing element.
+                        "shearX": 3.14, # The X coordinate shearing element.
+                        "unit": "A String", # The units for translate elements.
+                      },
+                      "propertyState": "A String", # The shadow property state.
+                          #
+                          # Updating the the shadow on a page element will implicitly update this field
+                          # to `RENDERED`, unless another value is specified in the same request. To
+                          # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                          # case, any other shadow fields set in the same request will be ignored.
+                      "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                          # shadow becomes.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                      "type": "A String", # The type of the shadow.
+                      "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                          # scale and skew of the shadow.
+                      "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                    },
+                    "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  },
+                },
+                "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                    # minutes. This URL is tagged with the account of the requester. Anyone with
+                    # the URL effectively accesses the image as the original requester. Access to
+                    # the image may be lost if the presentation's sharing settings change.
+              },
+              "video": { # A PageElement kind representing a # A video page element.
+                  # video.
+                "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                    # exists and sharing settings do not change.
+                "videoProperties": { # The properties of the Video. # The properties of the video.
+                  "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                      # videos created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "id": "A String", # The video source's unique identifier for this video.
+                "source": "A String", # The video source.
+              },
+              "table": { # A PageElement kind representing a # A table page element.
+                  # table.
+                "tableColumns": [ # Properties of each column.
+                  { # Properties of each column in a table.
+                    "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "tableRows": [ # Properties and contents of each row.
+                    #
+                    # Cells that span multiple rows are contained in only one of these rows and
+                    # have a row_span greater
+                    # than 1.
+                  { # Properties and contents of each row in a table.
+                    "tableCells": [ # Properties and contents of each cell.
+                        #
+                        # Cells that span multiple columns are represented only once with a
+                        # column_span greater
+                        # than 1. As a result, the length of this collection does not always match
+                        # the number of columns of the entire table.
+                      { # Properties and contents of each table cell.
+                        "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                            # text box or rectangle) or a table cell in a page.
+                          "textElements": [ # The text contents broken down into its component parts, including styling
+                              # information. This property is read-only.
+                            { # A TextElement describes the content of a range of indices in the text content
+                                # of a Shape or TableCell.
+                              "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                  # replaced with content that can change over time.
+                                "content": "A String", # The rendered content of this auto text, if available.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "type": "A String", # The type of this auto text.
+                              },
+                              "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                  # units.
+                              "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                              "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                  #
+                                  # The `start_index` and `end_index` of this TextElement represent the
+                                  # range of the paragraph. Other TextElements with an index range contained
+                                  # inside this paragraph's range are considered to be part of this
+                                  # paragraph. The range of indices of two separate paragraphs will never
+                                  # overlap.
+                                "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                    # inherited from the parent. Which paragraph styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A paragraph not in a list will inherit its paragraph style from the
+                                    #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                    # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                    #   at its corresponding nesting level of the list inside the parent
+                                    #   placeholder.
+                                    #
+                                    # Inherited paragraph styles are represented as unset fields in this message.
+                                  "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                  "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                  "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                      # is represented as 100.0. If unset, the value is inherited from the parent.
+                                      # This property is read-only.
+                                  "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the start of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the end of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                      # If unset, the value is inherited from the parent. This property is
+                                      # read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                                },
+                                "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                    # belong to a list.
+                                  "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                  "listId": "A String", # The ID of the list this paragraph belongs to.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                  "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                                },
+                              },
+                              "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                  # in the run have the same TextStyle.
+                                  #
+                                  # The `start_index` and `end_index` of TextRuns will always be fully
+                                  # contained in the index range of a single `paragraph_marker` TextElement.
+                                  # In other words, a TextRun will never span multiple paragraphs.
+                                  # styling.
+                                "content": "A String", # The text of this run.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          ],
+                          "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                            "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                                # associated with a list. A paragraph that is part of a list has an implicit
+                                # reference to that list's ID.
+                              "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                  # level. A list has at most nine levels of nesting, so the possible values
+                                  # for the keys of this map are 0 through 8, inclusive.
+                                "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                    # level of nesting.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                              "listId": "A String", # The ID of the list.
+                            },
+                          },
+                        },
+                        "rowSpan": 42, # Row span of the cell.
+                        "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                          "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                              # for newly created table cells in the Slides editor.
+                            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                                # specified color value.
+                                #
+                                # If any field is unset, its value may be inherited from a parent placeholder
+                                # if it exists.
+                              "color": { # A themeable solid color value. # The color value of the solid fill.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                  # That is, the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color.
+                            },
+                            "propertyState": "A String", # The background fill property state.
+                                #
+                                # Updating the the fill on a table cell will implicitly update this field
+                                # to `RENDERED`, unless another value is specified in the same request. To
+                                # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                                # case, any other fill fields set in the same request will be ignored.
+                          },
+                        },
+                        "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                          "rowIndex": 42, # The 0-based row index.
+                          "columnIndex": 42, # The 0-based column index.
+                        },
+                        "columnSpan": 42, # Column span of the cell.
+                      },
+                    ],
+                    "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "rows": 42, # Number of rows in the table.
+                "columns": 42, # Number of columns in the table.
+              },
+              "line": { # A PageElement kind representing a # A line page element.
+                  # line, curved connector, or bent connector.
+                "lineProperties": { # The properties of the Line. # The properties of the line.
+                    #
+                    # When unset, these fields default to values that match the appearance of
+                    # new lines created in the Slides editor.
+                  "dashStyle": "A String", # The dash style of the line.
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "endArrow": "A String", # The style of the arrow at the end of the line.
+                  "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                  "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                      # lines created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                },
+                "lineType": "A String", # The type of the line.
+              },
+              "size": { # A width and height. # The size of the page element.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+              "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                  # joined collection of PageElements.
+                "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                  # Object with schema name: PageElement
+                ],
+              },
+            },
+          ],
+          "objectId": "A String", # The object ID for this page. Object IDs used by
+              # Page and
+              # PageElement share the same namespace.
+          "pageProperties": { # The properties of the Page. # The properties of the page.
+              #
+              # The page will inherit properties from the parent page. Depending on the page
+              # type the hierarchy is defined in either
+              # SlideProperties or
+              # LayoutProperties.
+            "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+                # from a parent page if it exists. If the page has no parent, then the
+                # background fill defaults to the corresponding fill in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a page will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+              "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                  # the specified picture. The picture is stretched to fit its container.
+                "contentUrl": "A String", # Reading the content_url:
+                    #
+                    # An URL to a picture with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the picture as the original requester. Access to the
+                    # picture may be lost if the presentation's sharing settings change.
+                    #
+                    # Writing the content_url:
+                    #
+                    # The picture is fetched once at insertion time and a copy is stored for
+                    # display inside the presentation. Pictures must be less than 50MB in size,
+                    # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                    # format.
+                "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                  "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+            },
+            "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+                # a parent page. If the page has no parent, the color scheme uses a default
+                # Slides color scheme. This field is read-only.
+              "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+                { # A pair mapping a theme color type to the concrete color it represents.
+                  "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                  "type": "A String", # The type of the theme color.
+                },
+              ],
+            },
+          },
+          "pageType": "A String", # The type of the page.
+          "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+              # relevant for pages with page_type SLIDE.
+            "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+            "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+          },
+        },
+      ],
+    }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(presentationId, x__xgafv=None)</code>
+  <pre>Gets the latest version of the specified presentation.
+
+Args:
+  presentationId: string, The ID of the presentation to retrieve. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A Google Slides presentation.
+      "presentationId": "A String", # The ID of the presentation.
+      "masters": [ # The slide masters in the presentation. A slide master contains all common
+          # page elements and the common properties for a set of layouts. They serve
+          # three purposes:
+          #
+          # - Placeholder shapes on a master contain the default text styles and shape
+          #   properties of all placeholder shapes on pages that use that master.
+          # - The master page properties define the common page properties inherited by
+          #   its layouts.
+          # - Any other shapes on the master slide will appear on all slides using that
+          #   master, regardless of their layout.
+        { # A page in a presentation.
+          "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+              # relevant for pages with page_type LAYOUT.
+            "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+            "name": "A String", # The name of the layout.
+            "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+          },
+          "pageElements": [ # The page elements rendered on the page.
+            { # A visual element rendered on a page.
+              "wordArt": { # A PageElement kind representing # A word art page element.
+                  # word art.
+                "renderedText": "A String", # The text rendered as word art.
+              },
+              "description": "A String", # The description of the page element. Combined with title to display alt
+                  # text.
+              "objectId": "A String", # The object ID for this page element. Object IDs used by
+                  # google.apps.slides.v1.Page and
+                  # google.apps.slides.v1.PageElement share the same namespace.
+              "title": "A String", # The title of the page element. Combined with description to display alt
+                  # text.
+              "image": { # A PageElement kind representing an # An image page element.
+                  # image.
+                "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the image as the original requester. Access to the
+                    # image may be lost if the presentation's sharing settings change.
+                "imageProperties": { # The properties of the Image. # The properties of the image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "shape": { # A PageElement kind representing a # A generic shape.
+                  # generic shape that does not have a more specific classification.
+                "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                    # text box or rectangle) or a table cell in a page.
+                  "textElements": [ # The text contents broken down into its component parts, including styling
+                      # information. This property is read-only.
+                    { # A TextElement describes the content of a range of indices in the text content
+                        # of a Shape or TableCell.
+                      "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                          # replaced with content that can change over time.
+                        "content": "A String", # The rendered content of this auto text, if available.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "type": "A String", # The type of this auto text.
+                      },
+                      "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                          # units.
+                      "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                      "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                          #
+                          # The `start_index` and `end_index` of this TextElement represent the
+                          # range of the paragraph. Other TextElements with an index range contained
+                          # inside this paragraph's range are considered to be part of this
+                          # paragraph. The range of indices of two separate paragraphs will never
+                          # overlap.
+                        "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                            # inherited from the parent. Which paragraph styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A paragraph not in a list will inherit its paragraph style from the
+                            #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                            # * A paragraph in a list will inherit its paragraph style from the paragraph
+                            #   at its corresponding nesting level of the list inside the parent
+                            #   placeholder.
+                            #
+                            # Inherited paragraph styles are represented as unset fields in this message.
+                          "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                          "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                          "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                              # is represented as 100.0. If unset, the value is inherited from the parent.
+                              # This property is read-only.
+                          "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the start of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the end of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                              # If unset, the value is inherited from the parent. This property is
+                              # read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                        },
+                        "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                            # belong to a list.
+                          "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                          "listId": "A String", # The ID of the list this paragraph belongs to.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                          "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                        },
+                      },
+                      "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                          # in the run have the same TextStyle.
+                          #
+                          # The `start_index` and `end_index` of TextRuns will always be fully
+                          # contained in the index range of a single `paragraph_marker` TextElement.
+                          # In other words, a TextRun will never span multiple paragraphs.
+                          # styling.
+                        "content": "A String", # The text of this run.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                  ],
+                  "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                    "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                        # associated with a list. A paragraph that is part of a list has an implicit
+                        # reference to that list's ID.
+                      "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                          # level. A list has at most nine levels of nesting, so the possible values
+                          # for the keys of this map are 0 through 8, inclusive.
+                        "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                            # level of nesting.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                        },
+                      },
+                      "listId": "A String", # The ID of the list.
+                    },
+                  },
+                },
+                "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                    #
+                    # If the shape is a placeholder shape as determined by the
+                    # placeholder field, then these
+                    # properties may be inherited from a parent placeholder shape.
+                    # Determining the rendered value of the property depends on the corresponding
+                    # property_state field value.
+                  "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                      # a parent placeholder if it exists. If the shape has no parent, then the
+                      # default shadow matches the defaults for new shapes created in the Slides
+                      # editor. This property is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                      # inherited from a parent placeholder if it exists. If the shape has no
+                      # parent, then the default background fill depends on the shape type,
+                      # matching the defaults for new shapes created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                    "propertyState": "A String", # The background fill property state.
+                        #
+                        # Updating the the fill on a shape will implicitly update this field to
+                        # `RENDERED`, unless another value is specified in the same request. To
+                        # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                        # any other fill fields set in the same request will be ignored.
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                      # are not inherited from parent placeholders.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                      # parent placeholder if it exists. If the shape has no parent, then the
+                      # default outline depends on the shape type, matching the defaults for
+                      # new shapes created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                    # layouts and masters.
+                    #
+                    # If set, the shape is a placeholder shape and any inherited properties
+                    # can be resolved by looking at the parent placeholder identified by the
+                    # Placeholder.parent_object_id field.
+                  "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                      # If unset, the parent placeholder shape does not exist, so the shape does
+                      # not inherit properties from any other shape.
+                  "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                      # in the same page, they would have different index values.
+                  "type": "A String", # The type of the placeholder.
+                },
+                "shapeType": "A String", # The type of the shape.
+              },
+              "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                  # represented as images.
+                  # a linked chart embedded from Google Sheets.
+                "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                    # embedded.
+                "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+                "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                  "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                    "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "dashStyle": "A String", # The dash style of the outline.
+                      "propertyState": "A String", # The outline property state.
+                          #
+                          # Updating the the outline on a page element will implicitly update this
+                          # field to`RENDERED`, unless another value is specified in the same request.
+                          # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                          # this case, any other outline fields set in the same request will be
+                          # ignored.
+                      "outlineFill": { # The fill of the outline. # The fill of the outline.
+                        "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                            # specified color value.
+                            #
+                            # If any field is unset, its value may be inherited from a parent placeholder
+                            # if it exists.
+                          "color": { # A themeable solid color value. # The color value of the solid fill.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                              # That is, the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color.
+                        },
+                      },
+                      "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                    },
+                    "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                    "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                        # This property is read-only.
+                      "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                          # stops. This property is read-only.
+                        { # A color and position in a gradient band.
+                          "color": { # A themeable solid color value. # The color of the gradient stop.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "position": 3.14, # The relative position of the color stop in the gradient band measured
+                              # in percentage. The value should be in the interval [0.0, 1.0].
+                          "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                              # fully opaque.
+                        },
+                      ],
+                    },
+                    "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                          # presentation with this ID. A page with this ID may not exist.
+                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                          # in the presentation. There may not be a slide at this index.
+                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                          # addressed by its position.
+                    },
+                    "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                        # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                        # This property is read-only.
+                    "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                        # This property is read-only.
+                        # Image.
+                        #
+                        # The crop properties is represented by the offsets of four edges which define
+                        # a crop rectangle. The offsets are measured in percentage from the
+                        # corresponding edges of the object's original bounding rectangle towards
+                        # inside, relative to the object's original dimensions.
+                        #
+                        # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                        # rectangle is positioned inside of the object's original bounding rectangle.
+                        # - If the offset is negative or greater than 1, the corresponding edge of crop
+                        # rectangle is positioned outside of the object's original bounding rectangle.
+                        # - If the left edge of the crop rectangle is on the right side of its right
+                        # edge, the object will be flipped horizontally.
+                        # - If the top edge of the crop rectangle is below its bottom edge, the object
+                        # will be flipped vertically.
+                        # - If all offsets and rotation angle is 0, the object is not cropped.
+                        #
+                        # After cropping, the content in the crop rectangle will be stretched to fit
+                        # its container.
+                      "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                          # the right of the original bounding rectangle left edge, relative to the
+                          # object's original width.
+                      "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                          # Rotation angle is applied after the offset.
+                      "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                          # above the original bounding rectangle bottom edge, relative to the object's
+                          # original height.
+                      "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                          # to the left of the original bounding rectangle right edge, relative to the
+                          # object's original width.
+                      "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                          # below the original bounding rectangle top edge, relative to the object's
+                          # original height.
+                    },
+                    "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                        # is read-only.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "color": { # A themeable solid color value. # The shadow color value.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                          # relative to the alignment position.
+                          # to transform source coordinates (x,y) into destination coordinates (x', y')
+                          # according to:
+                          #
+                          #       x'  x  =   shear_y  scale_y  translate_y
+                          #       1  [ 1 ]
+                          #
+                          # After transformation,
+                          #
+                          #      x' = scale_x * x + shear_x * y + translate_x;
+                          #      y' = scale_y * y + shear_y * x + translate_y;
+                          #
+                          # This message is therefore composed of these six matrix elements.
+                        "translateX": 3.14, # The X coordinate translation element.
+                        "translateY": 3.14, # The Y coordinate translation element.
+                        "scaleX": 3.14, # The X coordinate scaling element.
+                        "scaleY": 3.14, # The Y coordinate scaling element.
+                        "shearY": 3.14, # The Y coordinate shearing element.
+                        "shearX": 3.14, # The X coordinate shearing element.
+                        "unit": "A String", # The units for translate elements.
+                      },
+                      "propertyState": "A String", # The shadow property state.
+                          #
+                          # Updating the the shadow on a page element will implicitly update this field
+                          # to `RENDERED`, unless another value is specified in the same request. To
+                          # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                          # case, any other shadow fields set in the same request will be ignored.
+                      "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                          # shadow becomes.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                      "type": "A String", # The type of the shadow.
+                      "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                          # scale and skew of the shadow.
+                      "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                    },
+                    "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  },
+                },
+                "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                    # minutes. This URL is tagged with the account of the requester. Anyone with
+                    # the URL effectively accesses the image as the original requester. Access to
+                    # the image may be lost if the presentation's sharing settings change.
+              },
+              "video": { # A PageElement kind representing a # A video page element.
+                  # video.
+                "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                    # exists and sharing settings do not change.
+                "videoProperties": { # The properties of the Video. # The properties of the video.
+                  "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                      # videos created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "id": "A String", # The video source's unique identifier for this video.
+                "source": "A String", # The video source.
+              },
+              "table": { # A PageElement kind representing a # A table page element.
+                  # table.
+                "tableColumns": [ # Properties of each column.
+                  { # Properties of each column in a table.
+                    "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "tableRows": [ # Properties and contents of each row.
+                    #
+                    # Cells that span multiple rows are contained in only one of these rows and
+                    # have a row_span greater
+                    # than 1.
+                  { # Properties and contents of each row in a table.
+                    "tableCells": [ # Properties and contents of each cell.
+                        #
+                        # Cells that span multiple columns are represented only once with a
+                        # column_span greater
+                        # than 1. As a result, the length of this collection does not always match
+                        # the number of columns of the entire table.
+                      { # Properties and contents of each table cell.
+                        "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                            # text box or rectangle) or a table cell in a page.
+                          "textElements": [ # The text contents broken down into its component parts, including styling
+                              # information. This property is read-only.
+                            { # A TextElement describes the content of a range of indices in the text content
+                                # of a Shape or TableCell.
+                              "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                  # replaced with content that can change over time.
+                                "content": "A String", # The rendered content of this auto text, if available.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "type": "A String", # The type of this auto text.
+                              },
+                              "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                  # units.
+                              "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                              "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                  #
+                                  # The `start_index` and `end_index` of this TextElement represent the
+                                  # range of the paragraph. Other TextElements with an index range contained
+                                  # inside this paragraph's range are considered to be part of this
+                                  # paragraph. The range of indices of two separate paragraphs will never
+                                  # overlap.
+                                "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                    # inherited from the parent. Which paragraph styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A paragraph not in a list will inherit its paragraph style from the
+                                    #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                    # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                    #   at its corresponding nesting level of the list inside the parent
+                                    #   placeholder.
+                                    #
+                                    # Inherited paragraph styles are represented as unset fields in this message.
+                                  "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                  "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                  "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                      # is represented as 100.0. If unset, the value is inherited from the parent.
+                                      # This property is read-only.
+                                  "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the start of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the end of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                      # If unset, the value is inherited from the parent. This property is
+                                      # read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                                },
+                                "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                    # belong to a list.
+                                  "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                  "listId": "A String", # The ID of the list this paragraph belongs to.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                  "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                                },
+                              },
+                              "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                  # in the run have the same TextStyle.
+                                  #
+                                  # The `start_index` and `end_index` of TextRuns will always be fully
+                                  # contained in the index range of a single `paragraph_marker` TextElement.
+                                  # In other words, a TextRun will never span multiple paragraphs.
+                                  # styling.
+                                "content": "A String", # The text of this run.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          ],
+                          "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                            "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                                # associated with a list. A paragraph that is part of a list has an implicit
+                                # reference to that list's ID.
+                              "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                  # level. A list has at most nine levels of nesting, so the possible values
+                                  # for the keys of this map are 0 through 8, inclusive.
+                                "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                    # level of nesting.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                              "listId": "A String", # The ID of the list.
+                            },
+                          },
+                        },
+                        "rowSpan": 42, # Row span of the cell.
+                        "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                          "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                              # for newly created table cells in the Slides editor.
+                            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                                # specified color value.
+                                #
+                                # If any field is unset, its value may be inherited from a parent placeholder
+                                # if it exists.
+                              "color": { # A themeable solid color value. # The color value of the solid fill.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                  # That is, the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color.
+                            },
+                            "propertyState": "A String", # The background fill property state.
+                                #
+                                # Updating the the fill on a table cell will implicitly update this field
+                                # to `RENDERED`, unless another value is specified in the same request. To
+                                # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                                # case, any other fill fields set in the same request will be ignored.
+                          },
+                        },
+                        "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                          "rowIndex": 42, # The 0-based row index.
+                          "columnIndex": 42, # The 0-based column index.
+                        },
+                        "columnSpan": 42, # Column span of the cell.
+                      },
+                    ],
+                    "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "rows": 42, # Number of rows in the table.
+                "columns": 42, # Number of columns in the table.
+              },
+              "line": { # A PageElement kind representing a # A line page element.
+                  # line, curved connector, or bent connector.
+                "lineProperties": { # The properties of the Line. # The properties of the line.
+                    #
+                    # When unset, these fields default to values that match the appearance of
+                    # new lines created in the Slides editor.
+                  "dashStyle": "A String", # The dash style of the line.
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "endArrow": "A String", # The style of the arrow at the end of the line.
+                  "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                  "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                      # lines created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                },
+                "lineType": "A String", # The type of the line.
+              },
+              "size": { # A width and height. # The size of the page element.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+              "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                  # joined collection of PageElements.
+                "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                  # Object with schema name: PageElement
+                ],
+              },
+            },
+          ],
+          "objectId": "A String", # The object ID for this page. Object IDs used by
+              # Page and
+              # PageElement share the same namespace.
+          "pageProperties": { # The properties of the Page. # The properties of the page.
+              #
+              # The page will inherit properties from the parent page. Depending on the page
+              # type the hierarchy is defined in either
+              # SlideProperties or
+              # LayoutProperties.
+            "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+                # from a parent page if it exists. If the page has no parent, then the
+                # background fill defaults to the corresponding fill in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a page will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+              "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                  # the specified picture. The picture is stretched to fit its container.
+                "contentUrl": "A String", # Reading the content_url:
+                    #
+                    # An URL to a picture with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the picture as the original requester. Access to the
+                    # picture may be lost if the presentation's sharing settings change.
+                    #
+                    # Writing the content_url:
+                    #
+                    # The picture is fetched once at insertion time and a copy is stored for
+                    # display inside the presentation. Pictures must be less than 50MB in size,
+                    # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                    # format.
+                "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                  "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+            },
+            "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+                # a parent page. If the page has no parent, the color scheme uses a default
+                # Slides color scheme. This field is read-only.
+              "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+                { # A pair mapping a theme color type to the concrete color it represents.
+                  "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                  "type": "A String", # The type of the theme color.
+                },
+              ],
+            },
+          },
+          "pageType": "A String", # The type of the page.
+          "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+              # relevant for pages with page_type SLIDE.
+            "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+            "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+          },
+        },
+      ],
+      "pageSize": { # A width and height. # The size of pages in the presentation.
+        "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+          "magnitude": 3.14, # The magnitude.
+          "unit": "A String", # The units for magnitude.
+        },
+        "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+          "magnitude": 3.14, # The magnitude.
+          "unit": "A String", # The units for magnitude.
+        },
+      },
+      "title": "A String", # The title of the presentation.
+      "locale": "A String", # The locale of the presentation, as an IETF BCP 47 language tag.
+      "slides": [ # The slides in the presentation.
+          # A slide inherits properties from a slide layout.
+        { # A page in a presentation.
+          "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+              # relevant for pages with page_type LAYOUT.
+            "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+            "name": "A String", # The name of the layout.
+            "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+          },
+          "pageElements": [ # The page elements rendered on the page.
+            { # A visual element rendered on a page.
+              "wordArt": { # A PageElement kind representing # A word art page element.
+                  # word art.
+                "renderedText": "A String", # The text rendered as word art.
+              },
+              "description": "A String", # The description of the page element. Combined with title to display alt
+                  # text.
+              "objectId": "A String", # The object ID for this page element. Object IDs used by
+                  # google.apps.slides.v1.Page and
+                  # google.apps.slides.v1.PageElement share the same namespace.
+              "title": "A String", # The title of the page element. Combined with description to display alt
+                  # text.
+              "image": { # A PageElement kind representing an # An image page element.
+                  # image.
+                "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the image as the original requester. Access to the
+                    # image may be lost if the presentation's sharing settings change.
+                "imageProperties": { # The properties of the Image. # The properties of the image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "shape": { # A PageElement kind representing a # A generic shape.
+                  # generic shape that does not have a more specific classification.
+                "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                    # text box or rectangle) or a table cell in a page.
+                  "textElements": [ # The text contents broken down into its component parts, including styling
+                      # information. This property is read-only.
+                    { # A TextElement describes the content of a range of indices in the text content
+                        # of a Shape or TableCell.
+                      "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                          # replaced with content that can change over time.
+                        "content": "A String", # The rendered content of this auto text, if available.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "type": "A String", # The type of this auto text.
+                      },
+                      "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                          # units.
+                      "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                      "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                          #
+                          # The `start_index` and `end_index` of this TextElement represent the
+                          # range of the paragraph. Other TextElements with an index range contained
+                          # inside this paragraph's range are considered to be part of this
+                          # paragraph. The range of indices of two separate paragraphs will never
+                          # overlap.
+                        "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                            # inherited from the parent. Which paragraph styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A paragraph not in a list will inherit its paragraph style from the
+                            #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                            # * A paragraph in a list will inherit its paragraph style from the paragraph
+                            #   at its corresponding nesting level of the list inside the parent
+                            #   placeholder.
+                            #
+                            # Inherited paragraph styles are represented as unset fields in this message.
+                          "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                          "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                          "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                              # is represented as 100.0. If unset, the value is inherited from the parent.
+                              # This property is read-only.
+                          "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the start of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the end of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                              # If unset, the value is inherited from the parent. This property is
+                              # read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                        },
+                        "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                            # belong to a list.
+                          "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                          "listId": "A String", # The ID of the list this paragraph belongs to.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                          "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                        },
+                      },
+                      "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                          # in the run have the same TextStyle.
+                          #
+                          # The `start_index` and `end_index` of TextRuns will always be fully
+                          # contained in the index range of a single `paragraph_marker` TextElement.
+                          # In other words, a TextRun will never span multiple paragraphs.
+                          # styling.
+                        "content": "A String", # The text of this run.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                  ],
+                  "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                    "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                        # associated with a list. A paragraph that is part of a list has an implicit
+                        # reference to that list's ID.
+                      "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                          # level. A list has at most nine levels of nesting, so the possible values
+                          # for the keys of this map are 0 through 8, inclusive.
+                        "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                            # level of nesting.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                        },
+                      },
+                      "listId": "A String", # The ID of the list.
+                    },
+                  },
+                },
+                "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                    #
+                    # If the shape is a placeholder shape as determined by the
+                    # placeholder field, then these
+                    # properties may be inherited from a parent placeholder shape.
+                    # Determining the rendered value of the property depends on the corresponding
+                    # property_state field value.
+                  "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                      # a parent placeholder if it exists. If the shape has no parent, then the
+                      # default shadow matches the defaults for new shapes created in the Slides
+                      # editor. This property is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                      # inherited from a parent placeholder if it exists. If the shape has no
+                      # parent, then the default background fill depends on the shape type,
+                      # matching the defaults for new shapes created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                    "propertyState": "A String", # The background fill property state.
+                        #
+                        # Updating the the fill on a shape will implicitly update this field to
+                        # `RENDERED`, unless another value is specified in the same request. To
+                        # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                        # any other fill fields set in the same request will be ignored.
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                      # are not inherited from parent placeholders.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                      # parent placeholder if it exists. If the shape has no parent, then the
+                      # default outline depends on the shape type, matching the defaults for
+                      # new shapes created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                    # layouts and masters.
+                    #
+                    # If set, the shape is a placeholder shape and any inherited properties
+                    # can be resolved by looking at the parent placeholder identified by the
+                    # Placeholder.parent_object_id field.
+                  "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                      # If unset, the parent placeholder shape does not exist, so the shape does
+                      # not inherit properties from any other shape.
+                  "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                      # in the same page, they would have different index values.
+                  "type": "A String", # The type of the placeholder.
+                },
+                "shapeType": "A String", # The type of the shape.
+              },
+              "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                  # represented as images.
+                  # a linked chart embedded from Google Sheets.
+                "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                    # embedded.
+                "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+                "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                  "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                    "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "dashStyle": "A String", # The dash style of the outline.
+                      "propertyState": "A String", # The outline property state.
+                          #
+                          # Updating the the outline on a page element will implicitly update this
+                          # field to`RENDERED`, unless another value is specified in the same request.
+                          # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                          # this case, any other outline fields set in the same request will be
+                          # ignored.
+                      "outlineFill": { # The fill of the outline. # The fill of the outline.
+                        "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                            # specified color value.
+                            #
+                            # If any field is unset, its value may be inherited from a parent placeholder
+                            # if it exists.
+                          "color": { # A themeable solid color value. # The color value of the solid fill.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                              # That is, the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color.
+                        },
+                      },
+                      "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                    },
+                    "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                    "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                        # This property is read-only.
+                      "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                          # stops. This property is read-only.
+                        { # A color and position in a gradient band.
+                          "color": { # A themeable solid color value. # The color of the gradient stop.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "position": 3.14, # The relative position of the color stop in the gradient band measured
+                              # in percentage. The value should be in the interval [0.0, 1.0].
+                          "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                              # fully opaque.
+                        },
+                      ],
+                    },
+                    "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                          # presentation with this ID. A page with this ID may not exist.
+                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                          # in the presentation. There may not be a slide at this index.
+                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                          # addressed by its position.
+                    },
+                    "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                        # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                        # This property is read-only.
+                    "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                        # This property is read-only.
+                        # Image.
+                        #
+                        # The crop properties is represented by the offsets of four edges which define
+                        # a crop rectangle. The offsets are measured in percentage from the
+                        # corresponding edges of the object's original bounding rectangle towards
+                        # inside, relative to the object's original dimensions.
+                        #
+                        # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                        # rectangle is positioned inside of the object's original bounding rectangle.
+                        # - If the offset is negative or greater than 1, the corresponding edge of crop
+                        # rectangle is positioned outside of the object's original bounding rectangle.
+                        # - If the left edge of the crop rectangle is on the right side of its right
+                        # edge, the object will be flipped horizontally.
+                        # - If the top edge of the crop rectangle is below its bottom edge, the object
+                        # will be flipped vertically.
+                        # - If all offsets and rotation angle is 0, the object is not cropped.
+                        #
+                        # After cropping, the content in the crop rectangle will be stretched to fit
+                        # its container.
+                      "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                          # the right of the original bounding rectangle left edge, relative to the
+                          # object's original width.
+                      "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                          # Rotation angle is applied after the offset.
+                      "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                          # above the original bounding rectangle bottom edge, relative to the object's
+                          # original height.
+                      "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                          # to the left of the original bounding rectangle right edge, relative to the
+                          # object's original width.
+                      "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                          # below the original bounding rectangle top edge, relative to the object's
+                          # original height.
+                    },
+                    "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                        # is read-only.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "color": { # A themeable solid color value. # The shadow color value.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                          # relative to the alignment position.
+                          # to transform source coordinates (x,y) into destination coordinates (x', y')
+                          # according to:
+                          #
+                          #       x'  x  =   shear_y  scale_y  translate_y
+                          #       1  [ 1 ]
+                          #
+                          # After transformation,
+                          #
+                          #      x' = scale_x * x + shear_x * y + translate_x;
+                          #      y' = scale_y * y + shear_y * x + translate_y;
+                          #
+                          # This message is therefore composed of these six matrix elements.
+                        "translateX": 3.14, # The X coordinate translation element.
+                        "translateY": 3.14, # The Y coordinate translation element.
+                        "scaleX": 3.14, # The X coordinate scaling element.
+                        "scaleY": 3.14, # The Y coordinate scaling element.
+                        "shearY": 3.14, # The Y coordinate shearing element.
+                        "shearX": 3.14, # The X coordinate shearing element.
+                        "unit": "A String", # The units for translate elements.
+                      },
+                      "propertyState": "A String", # The shadow property state.
+                          #
+                          # Updating the the shadow on a page element will implicitly update this field
+                          # to `RENDERED`, unless another value is specified in the same request. To
+                          # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                          # case, any other shadow fields set in the same request will be ignored.
+                      "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                          # shadow becomes.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                      "type": "A String", # The type of the shadow.
+                      "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                          # scale and skew of the shadow.
+                      "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                    },
+                    "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  },
+                },
+                "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                    # minutes. This URL is tagged with the account of the requester. Anyone with
+                    # the URL effectively accesses the image as the original requester. Access to
+                    # the image may be lost if the presentation's sharing settings change.
+              },
+              "video": { # A PageElement kind representing a # A video page element.
+                  # video.
+                "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                    # exists and sharing settings do not change.
+                "videoProperties": { # The properties of the Video. # The properties of the video.
+                  "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                      # videos created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "id": "A String", # The video source's unique identifier for this video.
+                "source": "A String", # The video source.
+              },
+              "table": { # A PageElement kind representing a # A table page element.
+                  # table.
+                "tableColumns": [ # Properties of each column.
+                  { # Properties of each column in a table.
+                    "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "tableRows": [ # Properties and contents of each row.
+                    #
+                    # Cells that span multiple rows are contained in only one of these rows and
+                    # have a row_span greater
+                    # than 1.
+                  { # Properties and contents of each row in a table.
+                    "tableCells": [ # Properties and contents of each cell.
+                        #
+                        # Cells that span multiple columns are represented only once with a
+                        # column_span greater
+                        # than 1. As a result, the length of this collection does not always match
+                        # the number of columns of the entire table.
+                      { # Properties and contents of each table cell.
+                        "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                            # text box or rectangle) or a table cell in a page.
+                          "textElements": [ # The text contents broken down into its component parts, including styling
+                              # information. This property is read-only.
+                            { # A TextElement describes the content of a range of indices in the text content
+                                # of a Shape or TableCell.
+                              "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                  # replaced with content that can change over time.
+                                "content": "A String", # The rendered content of this auto text, if available.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "type": "A String", # The type of this auto text.
+                              },
+                              "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                  # units.
+                              "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                              "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                  #
+                                  # The `start_index` and `end_index` of this TextElement represent the
+                                  # range of the paragraph. Other TextElements with an index range contained
+                                  # inside this paragraph's range are considered to be part of this
+                                  # paragraph. The range of indices of two separate paragraphs will never
+                                  # overlap.
+                                "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                    # inherited from the parent. Which paragraph styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A paragraph not in a list will inherit its paragraph style from the
+                                    #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                    # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                    #   at its corresponding nesting level of the list inside the parent
+                                    #   placeholder.
+                                    #
+                                    # Inherited paragraph styles are represented as unset fields in this message.
+                                  "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                  "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                  "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                      # is represented as 100.0. If unset, the value is inherited from the parent.
+                                      # This property is read-only.
+                                  "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the start of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the end of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                      # If unset, the value is inherited from the parent. This property is
+                                      # read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                                },
+                                "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                    # belong to a list.
+                                  "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                  "listId": "A String", # The ID of the list this paragraph belongs to.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                  "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                                },
+                              },
+                              "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                  # in the run have the same TextStyle.
+                                  #
+                                  # The `start_index` and `end_index` of TextRuns will always be fully
+                                  # contained in the index range of a single `paragraph_marker` TextElement.
+                                  # In other words, a TextRun will never span multiple paragraphs.
+                                  # styling.
+                                "content": "A String", # The text of this run.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          ],
+                          "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                            "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                                # associated with a list. A paragraph that is part of a list has an implicit
+                                # reference to that list's ID.
+                              "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                  # level. A list has at most nine levels of nesting, so the possible values
+                                  # for the keys of this map are 0 through 8, inclusive.
+                                "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                    # level of nesting.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                              "listId": "A String", # The ID of the list.
+                            },
+                          },
+                        },
+                        "rowSpan": 42, # Row span of the cell.
+                        "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                          "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                              # for newly created table cells in the Slides editor.
+                            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                                # specified color value.
+                                #
+                                # If any field is unset, its value may be inherited from a parent placeholder
+                                # if it exists.
+                              "color": { # A themeable solid color value. # The color value of the solid fill.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                  # That is, the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color.
+                            },
+                            "propertyState": "A String", # The background fill property state.
+                                #
+                                # Updating the the fill on a table cell will implicitly update this field
+                                # to `RENDERED`, unless another value is specified in the same request. To
+                                # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                                # case, any other fill fields set in the same request will be ignored.
+                          },
+                        },
+                        "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                          "rowIndex": 42, # The 0-based row index.
+                          "columnIndex": 42, # The 0-based column index.
+                        },
+                        "columnSpan": 42, # Column span of the cell.
+                      },
+                    ],
+                    "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "rows": 42, # Number of rows in the table.
+                "columns": 42, # Number of columns in the table.
+              },
+              "line": { # A PageElement kind representing a # A line page element.
+                  # line, curved connector, or bent connector.
+                "lineProperties": { # The properties of the Line. # The properties of the line.
+                    #
+                    # When unset, these fields default to values that match the appearance of
+                    # new lines created in the Slides editor.
+                  "dashStyle": "A String", # The dash style of the line.
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "endArrow": "A String", # The style of the arrow at the end of the line.
+                  "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                  "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                      # lines created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                },
+                "lineType": "A String", # The type of the line.
+              },
+              "size": { # A width and height. # The size of the page element.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+              "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                  # joined collection of PageElements.
+                "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                  # Object with schema name: PageElement
+                ],
+              },
+            },
+          ],
+          "objectId": "A String", # The object ID for this page. Object IDs used by
+              # Page and
+              # PageElement share the same namespace.
+          "pageProperties": { # The properties of the Page. # The properties of the page.
+              #
+              # The page will inherit properties from the parent page. Depending on the page
+              # type the hierarchy is defined in either
+              # SlideProperties or
+              # LayoutProperties.
+            "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+                # from a parent page if it exists. If the page has no parent, then the
+                # background fill defaults to the corresponding fill in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a page will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+              "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                  # the specified picture. The picture is stretched to fit its container.
+                "contentUrl": "A String", # Reading the content_url:
+                    #
+                    # An URL to a picture with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the picture as the original requester. Access to the
+                    # picture may be lost if the presentation's sharing settings change.
+                    #
+                    # Writing the content_url:
+                    #
+                    # The picture is fetched once at insertion time and a copy is stored for
+                    # display inside the presentation. Pictures must be less than 50MB in size,
+                    # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                    # format.
+                "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                  "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+            },
+            "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+                # a parent page. If the page has no parent, the color scheme uses a default
+                # Slides color scheme. This field is read-only.
+              "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+                { # A pair mapping a theme color type to the concrete color it represents.
+                  "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                  "type": "A String", # The type of the theme color.
+                },
+              ],
+            },
+          },
+          "pageType": "A String", # The type of the page.
+          "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+              # relevant for pages with page_type SLIDE.
+            "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+            "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+          },
+        },
+      ],
+      "layouts": [ # The layouts in the presentation. A layout is a template that determines
+          # how content is arranged and styled on the slides that inherit from that
+          # layout.
+        { # A page in a presentation.
+          "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+              # relevant for pages with page_type LAYOUT.
+            "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+            "name": "A String", # The name of the layout.
+            "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+          },
+          "pageElements": [ # The page elements rendered on the page.
+            { # A visual element rendered on a page.
+              "wordArt": { # A PageElement kind representing # A word art page element.
+                  # word art.
+                "renderedText": "A String", # The text rendered as word art.
+              },
+              "description": "A String", # The description of the page element. Combined with title to display alt
+                  # text.
+              "objectId": "A String", # The object ID for this page element. Object IDs used by
+                  # google.apps.slides.v1.Page and
+                  # google.apps.slides.v1.PageElement share the same namespace.
+              "title": "A String", # The title of the page element. Combined with description to display alt
+                  # text.
+              "image": { # A PageElement kind representing an # An image page element.
+                  # image.
+                "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the image as the original requester. Access to the
+                    # image may be lost if the presentation's sharing settings change.
+                "imageProperties": { # The properties of the Image. # The properties of the image.
+                  "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                  "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                      # This property is read-only.
+                    "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                        # stops. This property is read-only.
+                      { # A color and position in a gradient band.
+                        "color": { # A themeable solid color value. # The color of the gradient stop.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "position": 3.14, # The relative position of the color stop in the gradient band measured
+                            # in percentage. The value should be in the interval [0.0, 1.0].
+                        "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                            # fully opaque.
+                      },
+                    ],
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                      # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                      # This property is read-only.
+                  "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                      # This property is read-only.
+                      # Image.
+                      #
+                      # The crop properties is represented by the offsets of four edges which define
+                      # a crop rectangle. The offsets are measured in percentage from the
+                      # corresponding edges of the object's original bounding rectangle towards
+                      # inside, relative to the object's original dimensions.
+                      #
+                      # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                      # rectangle is positioned inside of the object's original bounding rectangle.
+                      # - If the offset is negative or greater than 1, the corresponding edge of crop
+                      # rectangle is positioned outside of the object's original bounding rectangle.
+                      # - If the left edge of the crop rectangle is on the right side of its right
+                      # edge, the object will be flipped horizontally.
+                      # - If the top edge of the crop rectangle is below its bottom edge, the object
+                      # will be flipped vertically.
+                      # - If all offsets and rotation angle is 0, the object is not cropped.
+                      #
+                      # After cropping, the content in the crop rectangle will be stretched to fit
+                      # its container.
+                    "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                        # the right of the original bounding rectangle left edge, relative to the
+                        # object's original width.
+                    "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                        # Rotation angle is applied after the offset.
+                    "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                        # above the original bounding rectangle bottom edge, relative to the object's
+                        # original height.
+                    "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                        # to the left of the original bounding rectangle right edge, relative to the
+                        # object's original width.
+                    "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                        # below the original bounding rectangle top edge, relative to the object's
+                        # original height.
+                  },
+                  "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                      # is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                      # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "shape": { # A PageElement kind representing a # A generic shape.
+                  # generic shape that does not have a more specific classification.
+                "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+                    # text box or rectangle) or a table cell in a page.
+                  "textElements": [ # The text contents broken down into its component parts, including styling
+                      # information. This property is read-only.
+                    { # A TextElement describes the content of a range of indices in the text content
+                        # of a Shape or TableCell.
+                      "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                          # replaced with content that can change over time.
+                        "content": "A String", # The rendered content of this auto text, if available.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                        "type": "A String", # The type of this auto text.
+                      },
+                      "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                          # units.
+                      "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                      "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                          #
+                          # The `start_index` and `end_index` of this TextElement represent the
+                          # range of the paragraph. Other TextElements with an index range contained
+                          # inside this paragraph's range are considered to be part of this
+                          # paragraph. The range of indices of two separate paragraphs will never
+                          # overlap.
+                        "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                            # inherited from the parent. Which paragraph styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A paragraph not in a list will inherit its paragraph style from the
+                            #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                            # * A paragraph in a list will inherit its paragraph style from the paragraph
+                            #   at its corresponding nesting level of the list inside the parent
+                            #   placeholder.
+                            #
+                            # Inherited paragraph styles are represented as unset fields in this message.
+                          "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                          "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                          "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                              # is represented as 100.0. If unset, the value is inherited from the parent.
+                              # This property is read-only.
+                          "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the start of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                              # inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                              # the end of the text, based on the current text direction. If unset, the
+                              # value is inherited from the parent. This property is read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                              # If unset, the value is inherited from the parent. This property is
+                              # read-only.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                        },
+                        "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                            # belong to a list.
+                          "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                          "listId": "A String", # The ID of the list this paragraph belongs to.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                          "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                        },
+                      },
+                      "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                          # in the run have the same TextStyle.
+                          #
+                          # The `start_index` and `end_index` of TextRuns will always be fully
+                          # contained in the index range of a single `paragraph_marker` TextElement.
+                          # In other words, a TextRun will never span multiple paragraphs.
+                          # styling.
+                        "content": "A String", # The text of this run.
+                        "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                            #
+                            # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                            # inherited from the parent. Which text styles are inherited depend on the
+                            # nesting level of lists:
+                            #
+                            # * A text run in a paragraph that is not in a list will inherit its text style
+                            #   from the the newline character in the paragraph at the 0 nesting level of
+                            #   the list inside the parent placeholder.
+                            # * A text run in a paragraph that is in a list will inherit its text style
+                            #   from the newline character in the paragraph at its corresponding nesting
+                            #   level of the list inside the parent placeholder.
+                            #
+                            # Inherited text styles are represented as unset fields in this message. If
+                            # text is contained in a shape without a parent placeholder, unsetting these
+                            # fields will revert the style to a value matching the defaults in the Slides
+                            # editor.
+                          "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                          "bold": True or False, # Whether or not the text is bold.
+                          "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                              #
+                              # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                              # rendered in a smaller font size, computed based on the `font_size` field.
+                              # The `font_size` itself is not affected by changes in this field.
+                          "strikethrough": True or False, # Whether or not the text is struck through.
+                          "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                          "fontFamily": "A String", # The font family of the text.
+                              #
+                              # The font family can be any font from the Font menu in Slides or from
+                              # [Google Fonts] (https://fonts.google.com/). If the font name is
+                              # unrecognized, the text is rendered in `Arial`.
+                              #
+                              # Some fonts can affect the weight of the text. If an update request
+                              # specifies values for both `font_family` and `bold`, the explicitly-set
+                              # `bold` value is used.
+                          "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                              # are not inherited from parent text.
+                              #
+                              # Changing the link in an update request causes some other changes to the
+                              # text style of the range:
+                              #
+                              # * When setting a link, the text foreground color will be set to
+                              #   ThemeColorType.HYPERLINK and the text will
+                              #   be underlined. If these fields are modified in the same
+                              #   request, those values will be used instead of the link defaults.
+                              # * Setting a link on a text range that overlaps with an existing link will
+                              #   also update the existing link to point to the new URL.
+                              # * Links are not settable on newline characters. As a result, setting a link
+                              #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                              #   will separate the newline character(s) into their own text runs. The
+                              #   link will be applied separately to the runs before and after the newline.
+                              # * Removing a link will update the text style of the range to match the
+                              #   style of the preceding text (or the default text styles if the preceding
+                              #   text is another link) unless different styles are being set in the same
+                              #   request.
+                            "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                            "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                # presentation with this ID. A page with this ID may not exist.
+                            "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                # in the presentation. There may not be a slide at this index.
+                            "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                # addressed by its position.
+                          },
+                          "italic": True or False, # Whether or not the text is italicized.
+                          "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                              # points.
+                            "magnitude": 3.14, # The magnitude.
+                            "unit": "A String", # The units for magnitude.
+                          },
+                          "underline": True or False, # Whether or not the text is underlined.
+                          "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                              # transparent, depending on if the `opaque_color` field in it is set.
+                            "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                # a transparent color.
+                              "themeColor": "A String", # An opaque theme color.
+                              "rgbColor": { # An RGB color. # An opaque RGB color.
+                                "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                              },
+                            },
+                          },
+                        },
+                      },
+                    },
+                  ],
+                  "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                    "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                        # associated with a list. A paragraph that is part of a list has an implicit
+                        # reference to that list's ID.
+                      "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                          # level. A list has at most nine levels of nesting, so the possible values
+                          # for the keys of this map are 0 through 8, inclusive.
+                        "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                            # level of nesting.
+                          "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                        },
+                      },
+                      "listId": "A String", # The ID of the list.
+                    },
+                  },
+                },
+                "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+                    #
+                    # If the shape is a placeholder shape as determined by the
+                    # placeholder field, then these
+                    # properties may be inherited from a parent placeholder shape.
+                    # Determining the rendered value of the property depends on the corresponding
+                    # property_state field value.
+                  "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                      # a parent placeholder if it exists. If the shape has no parent, then the
+                      # default shadow matches the defaults for new shapes created in the Slides
+                      # editor. This property is read-only.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "color": { # A themeable solid color value. # The shadow color value.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                        # relative to the alignment position.
+                        # to transform source coordinates (x,y) into destination coordinates (x', y')
+                        # according to:
+                        #
+                        #       x'  x  =   shear_y  scale_y  translate_y
+                        #       1  [ 1 ]
+                        #
+                        # After transformation,
+                        #
+                        #      x' = scale_x * x + shear_x * y + translate_x;
+                        #      y' = scale_y * y + shear_y * x + translate_y;
+                        #
+                        # This message is therefore composed of these six matrix elements.
+                      "translateX": 3.14, # The X coordinate translation element.
+                      "translateY": 3.14, # The Y coordinate translation element.
+                      "scaleX": 3.14, # The X coordinate scaling element.
+                      "scaleY": 3.14, # The Y coordinate scaling element.
+                      "shearY": 3.14, # The Y coordinate shearing element.
+                      "shearX": 3.14, # The X coordinate shearing element.
+                      "unit": "A String", # The units for translate elements.
+                    },
+                    "propertyState": "A String", # The shadow property state.
+                        #
+                        # Updating the the shadow on a page element will implicitly update this field
+                        # to `RENDERED`, unless another value is specified in the same request. To
+                        # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                        # case, any other shadow fields set in the same request will be ignored.
+                    "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                        # shadow becomes.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                    "type": "A String", # The type of the shadow.
+                    "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                        # scale and skew of the shadow.
+                    "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                  },
+                  "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                      # inherited from a parent placeholder if it exists. If the shape has no
+                      # parent, then the default background fill depends on the shape type,
+                      # matching the defaults for new shapes created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                    "propertyState": "A String", # The background fill property state.
+                        #
+                        # Updating the the fill on a shape will implicitly update this field to
+                        # `RENDERED`, unless another value is specified in the same request. To
+                        # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                        # any other fill fields set in the same request will be ignored.
+                  },
+                  "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                      # are not inherited from parent placeholders.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                      # parent placeholder if it exists. If the shape has no parent, then the
+                      # default outline depends on the shape type, matching the defaults for
+                      # new shapes created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+                    # layouts and masters.
+                    #
+                    # If set, the shape is a placeholder shape and any inherited properties
+                    # can be resolved by looking at the parent placeholder identified by the
+                    # Placeholder.parent_object_id field.
+                  "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                      # If unset, the parent placeholder shape does not exist, so the shape does
+                      # not inherit properties from any other shape.
+                  "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                      # in the same page, they would have different index values.
+                  "type": "A String", # The type of the placeholder.
+                },
+                "shapeType": "A String", # The type of the shape.
+              },
+              "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+                  # represented as images.
+                  # a linked chart embedded from Google Sheets.
+                "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+                    # embedded.
+                "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+                "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+                  "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+                    "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "dashStyle": "A String", # The dash style of the outline.
+                      "propertyState": "A String", # The outline property state.
+                          #
+                          # Updating the the outline on a page element will implicitly update this
+                          # field to`RENDERED`, unless another value is specified in the same request.
+                          # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                          # this case, any other outline fields set in the same request will be
+                          # ignored.
+                      "outlineFill": { # The fill of the outline. # The fill of the outline.
+                        "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                            # specified color value.
+                            #
+                            # If any field is unset, its value may be inherited from a parent placeholder
+                            # if it exists.
+                          "color": { # A themeable solid color value. # The color value of the solid fill.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                              # That is, the final pixel color is defined by the equation:
+                              #
+                              #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                              #
+                              # This means that a value of 1.0 corresponds to a solid color, whereas
+                              # a value of 0.0 corresponds to a completely transparent color.
+                        },
+                      },
+                      "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                    },
+                    "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                    "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                        # This property is read-only.
+                      "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                          # stops. This property is read-only.
+                        { # A color and position in a gradient band.
+                          "color": { # A themeable solid color value. # The color of the gradient stop.
+                            "themeColor": "A String", # An opaque theme color.
+                            "rgbColor": { # An RGB color. # An opaque RGB color.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                          "position": 3.14, # The relative position of the color stop in the gradient band measured
+                              # in percentage. The value should be in the interval [0.0, 1.0].
+                          "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                              # fully opaque.
+                        },
+                      ],
+                    },
+                    "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                          # presentation with this ID. A page with this ID may not exist.
+                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                          # in the presentation. There may not be a slide at this index.
+                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                          # addressed by its position.
+                    },
+                    "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                        # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                        # This property is read-only.
+                    "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                        # This property is read-only.
+                        # Image.
+                        #
+                        # The crop properties is represented by the offsets of four edges which define
+                        # a crop rectangle. The offsets are measured in percentage from the
+                        # corresponding edges of the object's original bounding rectangle towards
+                        # inside, relative to the object's original dimensions.
+                        #
+                        # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                        # rectangle is positioned inside of the object's original bounding rectangle.
+                        # - If the offset is negative or greater than 1, the corresponding edge of crop
+                        # rectangle is positioned outside of the object's original bounding rectangle.
+                        # - If the left edge of the crop rectangle is on the right side of its right
+                        # edge, the object will be flipped horizontally.
+                        # - If the top edge of the crop rectangle is below its bottom edge, the object
+                        # will be flipped vertically.
+                        # - If all offsets and rotation angle is 0, the object is not cropped.
+                        #
+                        # After cropping, the content in the crop rectangle will be stretched to fit
+                        # its container.
+                      "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                          # the right of the original bounding rectangle left edge, relative to the
+                          # object's original width.
+                      "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                          # Rotation angle is applied after the offset.
+                      "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                          # above the original bounding rectangle bottom edge, relative to the object's
+                          # original height.
+                      "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                          # to the left of the original bounding rectangle right edge, relative to the
+                          # object's original width.
+                      "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                          # below the original bounding rectangle top edge, relative to the object's
+                          # original height.
+                    },
+                    "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                        # is read-only.
+                        #
+                        # If these fields are unset, they may be inherited from a parent placeholder
+                        # if it exists. If there is no parent, the fields will default to the value
+                        # used for new page elements created in the Slides editor, which may depend on
+                        # the page element kind.
+                      "color": { # A themeable solid color value. # The shadow color value.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                          # relative to the alignment position.
+                          # to transform source coordinates (x,y) into destination coordinates (x', y')
+                          # according to:
+                          #
+                          #       x'  x  =   shear_y  scale_y  translate_y
+                          #       1  [ 1 ]
+                          #
+                          # After transformation,
+                          #
+                          #      x' = scale_x * x + shear_x * y + translate_x;
+                          #      y' = scale_y * y + shear_y * x + translate_y;
+                          #
+                          # This message is therefore composed of these six matrix elements.
+                        "translateX": 3.14, # The X coordinate translation element.
+                        "translateY": 3.14, # The Y coordinate translation element.
+                        "scaleX": 3.14, # The X coordinate scaling element.
+                        "scaleY": 3.14, # The Y coordinate scaling element.
+                        "shearY": 3.14, # The Y coordinate shearing element.
+                        "shearX": 3.14, # The X coordinate shearing element.
+                        "unit": "A String", # The units for translate elements.
+                      },
+                      "propertyState": "A String", # The shadow property state.
+                          #
+                          # Updating the the shadow on a page element will implicitly update this field
+                          # to `RENDERED`, unless another value is specified in the same request. To
+                          # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                          # case, any other shadow fields set in the same request will be ignored.
+                      "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                          # shadow becomes.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                      "type": "A String", # The type of the shadow.
+                      "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                          # scale and skew of the shadow.
+                      "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+                    },
+                    "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                        # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+                  },
+                },
+                "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+                    # minutes. This URL is tagged with the account of the requester. Anyone with
+                    # the URL effectively accesses the image as the original requester. Access to
+                    # the image may be lost if the presentation's sharing settings change.
+              },
+              "video": { # A PageElement kind representing a # A video page element.
+                  # video.
+                "url": "A String", # An URL to a video. The URL is valid as long as the source video
+                    # exists and sharing settings do not change.
+                "videoProperties": { # The properties of the Video. # The properties of the video.
+                  "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                      # videos created in the Slides editor.
+                      #
+                      # If these fields are unset, they may be inherited from a parent placeholder
+                      # if it exists. If there is no parent, the fields will default to the value
+                      # used for new page elements created in the Slides editor, which may depend on
+                      # the page element kind.
+                    "dashStyle": "A String", # The dash style of the outline.
+                    "propertyState": "A String", # The outline property state.
+                        #
+                        # Updating the the outline on a page element will implicitly update this
+                        # field to`RENDERED`, unless another value is specified in the same request.
+                        # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                        # this case, any other outline fields set in the same request will be
+                        # ignored.
+                    "outlineFill": { # The fill of the outline. # The fill of the outline.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                    },
+                    "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                },
+                "id": "A String", # The video source's unique identifier for this video.
+                "source": "A String", # The video source.
+              },
+              "table": { # A PageElement kind representing a # A table page element.
+                  # table.
+                "tableColumns": [ # Properties of each column.
+                  { # Properties of each column in a table.
+                    "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "tableRows": [ # Properties and contents of each row.
+                    #
+                    # Cells that span multiple rows are contained in only one of these rows and
+                    # have a row_span greater
+                    # than 1.
+                  { # Properties and contents of each row in a table.
+                    "tableCells": [ # Properties and contents of each cell.
+                        #
+                        # Cells that span multiple columns are represented only once with a
+                        # column_span greater
+                        # than 1. As a result, the length of this collection does not always match
+                        # the number of columns of the entire table.
+                      { # Properties and contents of each table cell.
+                        "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                            # text box or rectangle) or a table cell in a page.
+                          "textElements": [ # The text contents broken down into its component parts, including styling
+                              # information. This property is read-only.
+                            { # A TextElement describes the content of a range of indices in the text content
+                                # of a Shape or TableCell.
+                              "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                                  # replaced with content that can change over time.
+                                "content": "A String", # The rendered content of this auto text, if available.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                                "type": "A String", # The type of this auto text.
+                              },
+                              "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                                  # units.
+                              "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                              "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                                  #
+                                  # The `start_index` and `end_index` of this TextElement represent the
+                                  # range of the paragraph. Other TextElements with an index range contained
+                                  # inside this paragraph's range are considered to be part of this
+                                  # paragraph. The range of indices of two separate paragraphs will never
+                                  # overlap.
+                                "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                                    # inherited from the parent. Which paragraph styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A paragraph not in a list will inherit its paragraph style from the
+                                    #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                                    # * A paragraph in a list will inherit its paragraph style from the paragraph
+                                    #   at its corresponding nesting level of the list inside the parent
+                                    #   placeholder.
+                                    #
+                                    # Inherited paragraph styles are represented as unset fields in this message.
+                                  "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                                  "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                                  "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                      # is represented as 100.0. If unset, the value is inherited from the parent.
+                                      # This property is read-only.
+                                  "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the start of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                      # inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                      # the end of the text, based on the current text direction. If unset, the
+                                      # value is inherited from the parent. This property is read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                      # If unset, the value is inherited from the parent. This property is
+                                      # read-only.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                                },
+                                "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                                    # belong to a list.
+                                  "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                                  "listId": "A String", # The ID of the list this paragraph belongs to.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                  "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                                },
+                              },
+                              "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                                  # in the run have the same TextStyle.
+                                  #
+                                  # The `start_index` and `end_index` of TextRuns will always be fully
+                                  # contained in the index range of a single `paragraph_marker` TextElement.
+                                  # In other words, a TextRun will never span multiple paragraphs.
+                                  # styling.
+                                "content": "A String", # The text of this run.
+                                "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                                    #
+                                    # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                    # inherited from the parent. Which text styles are inherited depend on the
+                                    # nesting level of lists:
+                                    #
+                                    # * A text run in a paragraph that is not in a list will inherit its text style
+                                    #   from the the newline character in the paragraph at the 0 nesting level of
+                                    #   the list inside the parent placeholder.
+                                    # * A text run in a paragraph that is in a list will inherit its text style
+                                    #   from the newline character in the paragraph at its corresponding nesting
+                                    #   level of the list inside the parent placeholder.
+                                    #
+                                    # Inherited text styles are represented as unset fields in this message. If
+                                    # text is contained in a shape without a parent placeholder, unsetting these
+                                    # fields will revert the style to a value matching the defaults in the Slides
+                                    # editor.
+                                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                  "bold": True or False, # Whether or not the text is bold.
+                                  "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                      #
+                                      # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                      # rendered in a smaller font size, computed based on the `font_size` field.
+                                      # The `font_size` itself is not affected by changes in this field.
+                                  "strikethrough": True or False, # Whether or not the text is struck through.
+                                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                  "fontFamily": "A String", # The font family of the text.
+                                      #
+                                      # The font family can be any font from the Font menu in Slides or from
+                                      # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                      # unrecognized, the text is rendered in `Arial`.
+                                      #
+                                      # Some fonts can affect the weight of the text. If an update request
+                                      # specifies values for both `font_family` and `bold`, the explicitly-set
+                                      # `bold` value is used.
+                                  "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                      # are not inherited from parent text.
+                                      #
+                                      # Changing the link in an update request causes some other changes to the
+                                      # text style of the range:
+                                      #
+                                      # * When setting a link, the text foreground color will be set to
+                                      #   ThemeColorType.HYPERLINK and the text will
+                                      #   be underlined. If these fields are modified in the same
+                                      #   request, those values will be used instead of the link defaults.
+                                      # * Setting a link on a text range that overlaps with an existing link will
+                                      #   also update the existing link to point to the new URL.
+                                      # * Links are not settable on newline characters. As a result, setting a link
+                                      #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                      #   will separate the newline character(s) into their own text runs. The
+                                      #   link will be applied separately to the runs before and after the newline.
+                                      # * Removing a link will update the text style of the range to match the
+                                      #   style of the preceding text (or the default text styles if the preceding
+                                      #   text is another link) unless different styles are being set in the same
+                                      #   request.
+                                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                        # presentation with this ID. A page with this ID may not exist.
+                                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                        # in the presentation. There may not be a slide at this index.
+                                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                        # addressed by its position.
+                                  },
+                                  "italic": True or False, # Whether or not the text is italicized.
+                                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                      # points.
+                                    "magnitude": 3.14, # The magnitude.
+                                    "unit": "A String", # The units for magnitude.
+                                  },
+                                  "underline": True or False, # Whether or not the text is underlined.
+                                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                      # transparent, depending on if the `opaque_color` field in it is set.
+                                    "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                        # a transparent color.
+                                      "themeColor": "A String", # An opaque theme color.
+                                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                            },
+                          ],
+                          "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                            "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                                # associated with a list. A paragraph that is part of a list has an implicit
+                                # reference to that list's ID.
+                              "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                                  # level. A list has at most nine levels of nesting, so the possible values
+                                  # for the keys of this map are 0 through 8, inclusive.
+                                "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                                    # level of nesting.
+                                  "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                      #
+                                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                      # inherited from the parent. Which text styles are inherited depend on the
+                                      # nesting level of lists:
+                                      #
+                                      # * A text run in a paragraph that is not in a list will inherit its text style
+                                      #   from the the newline character in the paragraph at the 0 nesting level of
+                                      #   the list inside the parent placeholder.
+                                      # * A text run in a paragraph that is in a list will inherit its text style
+                                      #   from the newline character in the paragraph at its corresponding nesting
+                                      #   level of the list inside the parent placeholder.
+                                      #
+                                      # Inherited text styles are represented as unset fields in this message. If
+                                      # text is contained in a shape without a parent placeholder, unsetting these
+                                      # fields will revert the style to a value matching the defaults in the Slides
+                                      # editor.
+                                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                    "bold": True or False, # Whether or not the text is bold.
+                                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                        #
+                                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                        # rendered in a smaller font size, computed based on the `font_size` field.
+                                        # The `font_size` itself is not affected by changes in this field.
+                                    "strikethrough": True or False, # Whether or not the text is struck through.
+                                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                                    "fontFamily": "A String", # The font family of the text.
+                                        #
+                                        # The font family can be any font from the Font menu in Slides or from
+                                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                        # unrecognized, the text is rendered in `Arial`.
+                                        #
+                                        # Some fonts can affect the weight of the text. If an update request
+                                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                                        # `bold` value is used.
+                                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                        # are not inherited from parent text.
+                                        #
+                                        # Changing the link in an update request causes some other changes to the
+                                        # text style of the range:
+                                        #
+                                        # * When setting a link, the text foreground color will be set to
+                                        #   ThemeColorType.HYPERLINK and the text will
+                                        #   be underlined. If these fields are modified in the same
+                                        #   request, those values will be used instead of the link defaults.
+                                        # * Setting a link on a text range that overlaps with an existing link will
+                                        #   also update the existing link to point to the new URL.
+                                        # * Links are not settable on newline characters. As a result, setting a link
+                                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                        #   will separate the newline character(s) into their own text runs. The
+                                        #   link will be applied separately to the runs before and after the newline.
+                                        # * Removing a link will update the text style of the range to match the
+                                        #   style of the preceding text (or the default text styles if the preceding
+                                        #   text is another link) unless different styles are being set in the same
+                                        #   request.
+                                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                          # presentation with this ID. A page with this ID may not exist.
+                                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                          # in the presentation. There may not be a slide at this index.
+                                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                          # addressed by its position.
+                                    },
+                                    "italic": True or False, # Whether or not the text is italicized.
+                                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                        # points.
+                                      "magnitude": 3.14, # The magnitude.
+                                      "unit": "A String", # The units for magnitude.
+                                    },
+                                    "underline": True or False, # Whether or not the text is underlined.
+                                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                        # transparent, depending on if the `opaque_color` field in it is set.
+                                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                          # a transparent color.
+                                        "themeColor": "A String", # An opaque theme color.
+                                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                        },
+                                      },
+                                    },
+                                  },
+                                },
+                              },
+                              "listId": "A String", # The ID of the list.
+                            },
+                          },
+                        },
+                        "rowSpan": 42, # Row span of the cell.
+                        "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                          "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                              # for newly created table cells in the Slides editor.
+                            "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                                # specified color value.
+                                #
+                                # If any field is unset, its value may be inherited from a parent placeholder
+                                # if it exists.
+                              "color": { # A themeable solid color value. # The color value of the solid fill.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                              "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                                  # That is, the final pixel color is defined by the equation:
+                                  #
+                                  #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                                  #
+                                  # This means that a value of 1.0 corresponds to a solid color, whereas
+                                  # a value of 0.0 corresponds to a completely transparent color.
+                            },
+                            "propertyState": "A String", # The background fill property state.
+                                #
+                                # Updating the the fill on a table cell will implicitly update this field
+                                # to `RENDERED`, unless another value is specified in the same request. To
+                                # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                                # case, any other fill fields set in the same request will be ignored.
+                          },
+                        },
+                        "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                          "rowIndex": 42, # The 0-based row index.
+                          "columnIndex": 42, # The 0-based column index.
+                        },
+                        "columnSpan": 42, # Column span of the cell.
+                      },
+                    ],
+                    "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                  },
+                ],
+                "rows": 42, # Number of rows in the table.
+                "columns": 42, # Number of columns in the table.
+              },
+              "line": { # A PageElement kind representing a # A line page element.
+                  # line, curved connector, or bent connector.
+                "lineProperties": { # The properties of the Line. # The properties of the line.
+                    #
+                    # When unset, these fields default to values that match the appearance of
+                    # new lines created in the Slides editor.
+                  "dashStyle": "A String", # The dash style of the line.
+                  "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "endArrow": "A String", # The style of the arrow at the end of the line.
+                  "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+                    "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                    "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                        # presentation with this ID. A page with this ID may not exist.
+                    "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                        # in the presentation. There may not be a slide at this index.
+                    "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                        # addressed by its position.
+                  },
+                  "startArrow": "A String", # The style of the arrow at the beginning of the line.
+                  "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                      # lines created in the Slides editor.
+                    "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                        # specified color value.
+                        #
+                        # If any field is unset, its value may be inherited from a parent placeholder
+                        # if it exists.
+                      "color": { # A themeable solid color value. # The color value of the solid fill.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                      "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                          # That is, the final pixel color is defined by the equation:
+                          #
+                          #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                          #
+                          # This means that a value of 1.0 corresponds to a solid color, whereas
+                          # a value of 0.0 corresponds to a completely transparent color.
+                    },
+                  },
+                },
+                "lineType": "A String", # The type of the line.
+              },
+              "size": { # A width and height. # The size of the page element.
+                "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+              "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+                  # joined collection of PageElements.
+                "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+                  # Object with schema name: PageElement
+                ],
+              },
+            },
+          ],
+          "objectId": "A String", # The object ID for this page. Object IDs used by
+              # Page and
+              # PageElement share the same namespace.
+          "pageProperties": { # The properties of the Page. # The properties of the page.
+              #
+              # The page will inherit properties from the parent page. Depending on the page
+              # type the hierarchy is defined in either
+              # SlideProperties or
+              # LayoutProperties.
+            "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+                # from a parent page if it exists. If the page has no parent, then the
+                # background fill defaults to the corresponding fill in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a page will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+              "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+                  # the specified picture. The picture is stretched to fit its container.
+                "contentUrl": "A String", # Reading the content_url:
+                    #
+                    # An URL to a picture with a default lifetime of 30 minutes.
+                    # This URL is tagged with the account of the requester. Anyone with the URL
+                    # effectively accesses the picture as the original requester. Access to the
+                    # picture may be lost if the presentation's sharing settings change.
+                    #
+                    # Writing the content_url:
+                    #
+                    # The picture is fetched once at insertion time and a copy is stored for
+                    # display inside the presentation. Pictures must be less than 50MB in size,
+                    # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+                    # format.
+                "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+                  "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                },
+              },
+            },
+            "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+                # a parent page. If the page has no parent, the color scheme uses a default
+                # Slides color scheme. This field is read-only.
+              "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+                { # A pair mapping a theme color type to the concrete color it represents.
+                  "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                  "type": "A String", # The type of the theme color.
+                },
+              ],
+            },
+          },
+          "pageType": "A String", # The type of the page.
+          "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+              # relevant for pages with page_type SLIDE.
+            "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+            "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+          },
+        },
+      ],
+    }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/slides_v1.presentations.pages.html b/docs/dyn/slides_v1.presentations.pages.html
new file mode 100644
index 00000000000..2d572460a0f
--- /dev/null
+++ b/docs/dyn/slides_v1.presentations.pages.html
@@ -0,0 +1,1902 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="slides_v1.html">Google Slides API</a> . <a href="slides_v1.presentations.html">presentations</a> . <a href="slides_v1.presentations.pages.html">pages</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#get">get(presentationId, pageObjectId, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the latest version of the specified page in the presentation.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="get">get(presentationId, pageObjectId, x__xgafv=None)</code>
+  <pre>Gets the latest version of the specified page in the presentation.
+
+Args:
+  presentationId: string, The ID of the presentation to retrieve. (required)
+  pageObjectId: string, The object ID of the page to retrieve. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A page in a presentation.
+    "layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.
+        # relevant for pages with page_type LAYOUT.
+      "displayName": "A String", # The human readable name of the layout in the presentation's locale.
+      "name": "A String", # The name of the layout.
+      "masterObjectId": "A String", # The object ID of the master that this layout is based on.
+    },
+    "pageElements": [ # The page elements rendered on the page.
+      { # A visual element rendered on a page.
+        "wordArt": { # A PageElement kind representing # A word art page element.
+            # word art.
+          "renderedText": "A String", # The text rendered as word art.
+        },
+        "description": "A String", # The description of the page element. Combined with title to display alt
+            # text.
+        "objectId": "A String", # The object ID for this page element. Object IDs used by
+            # google.apps.slides.v1.Page and
+            # google.apps.slides.v1.PageElement share the same namespace.
+        "title": "A String", # The title of the page element. Combined with description to display alt
+            # text.
+        "image": { # A PageElement kind representing an # An image page element.
+            # image.
+          "contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.
+              # This URL is tagged with the account of the requester. Anyone with the URL
+              # effectively accesses the image as the original requester. Access to the
+              # image may be lost if the presentation's sharing settings change.
+          "imageProperties": { # The properties of the Image. # The properties of the image.
+            "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "dashStyle": "A String", # The dash style of the outline.
+              "propertyState": "A String", # The outline property state.
+                  #
+                  # Updating the the outline on a page element will implicitly update this
+                  # field to`RENDERED`, unless another value is specified in the same request.
+                  # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                  # this case, any other outline fields set in the same request will be
+                  # ignored.
+              "outlineFill": { # The fill of the outline. # The fill of the outline.
+                "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                    # specified color value.
+                    #
+                    # If any field is unset, its value may be inherited from a parent placeholder
+                    # if it exists.
+                  "color": { # A themeable solid color value. # The color value of the solid fill.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                      # That is, the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color.
+                },
+              },
+              "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+            "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+            "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                # This property is read-only.
+              "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                  # stops. This property is read-only.
+                { # A color and position in a gradient band.
+                  "color": { # A themeable solid color value. # The color of the gradient stop.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "position": 3.14, # The relative position of the color stop in the gradient band measured
+                      # in percentage. The value should be in the interval [0.0, 1.0].
+                  "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                      # fully opaque.
+                },
+              ],
+            },
+            "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                  # presentation with this ID. A page with this ID may not exist.
+              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                  # in the presentation. There may not be a slide at this index.
+              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                  # addressed by its position.
+            },
+            "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                # This property is read-only.
+            "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                # This property is read-only.
+                # Image.
+                #
+                # The crop properties is represented by the offsets of four edges which define
+                # a crop rectangle. The offsets are measured in percentage from the
+                # corresponding edges of the object's original bounding rectangle towards
+                # inside, relative to the object's original dimensions.
+                #
+                # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                # rectangle is positioned inside of the object's original bounding rectangle.
+                # - If the offset is negative or greater than 1, the corresponding edge of crop
+                # rectangle is positioned outside of the object's original bounding rectangle.
+                # - If the left edge of the crop rectangle is on the right side of its right
+                # edge, the object will be flipped horizontally.
+                # - If the top edge of the crop rectangle is below its bottom edge, the object
+                # will be flipped vertically.
+                # - If all offsets and rotation angle is 0, the object is not cropped.
+                #
+                # After cropping, the content in the crop rectangle will be stretched to fit
+                # its container.
+              "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                  # the right of the original bounding rectangle left edge, relative to the
+                  # object's original width.
+              "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                  # Rotation angle is applied after the offset.
+              "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                  # above the original bounding rectangle bottom edge, relative to the object's
+                  # original height.
+              "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                  # to the left of the original bounding rectangle right edge, relative to the
+                  # object's original width.
+              "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                  # below the original bounding rectangle top edge, relative to the object's
+                  # original height.
+            },
+            "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                # is read-only.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "color": { # A themeable solid color value. # The shadow color value.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                  # relative to the alignment position.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "propertyState": "A String", # The shadow property state.
+                  #
+                  # Updating the the shadow on a page element will implicitly update this field
+                  # to `RENDERED`, unless another value is specified in the same request. To
+                  # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                  # case, any other shadow fields set in the same request will be ignored.
+              "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                  # shadow becomes.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+              "type": "A String", # The type of the shadow.
+              "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                  # scale and skew of the shadow.
+              "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+            },
+            "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+          },
+        },
+        "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.
+            # to transform source coordinates (x,y) into destination coordinates (x', y')
+            # according to:
+            #
+            #       x'  x  =   shear_y  scale_y  translate_y
+            #       1  [ 1 ]
+            #
+            # After transformation,
+            #
+            #      x' = scale_x * x + shear_x * y + translate_x;
+            #      y' = scale_y * y + shear_y * x + translate_y;
+            #
+            # This message is therefore composed of these six matrix elements.
+          "translateX": 3.14, # The X coordinate translation element.
+          "translateY": 3.14, # The Y coordinate translation element.
+          "scaleX": 3.14, # The X coordinate scaling element.
+          "scaleY": 3.14, # The Y coordinate scaling element.
+          "shearY": 3.14, # The Y coordinate shearing element.
+          "shearX": 3.14, # The X coordinate shearing element.
+          "unit": "A String", # The units for translate elements.
+        },
+        "shape": { # A PageElement kind representing a # A generic shape.
+            # generic shape that does not have a more specific classification.
+          "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.
+              # text box or rectangle) or a table cell in a page.
+            "textElements": [ # The text contents broken down into its component parts, including styling
+                # information. This property is read-only.
+              { # A TextElement describes the content of a range of indices in the text content
+                  # of a Shape or TableCell.
+                "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                    # replaced with content that can change over time.
+                  "content": "A String", # The rendered content of this auto text, if available.
+                  "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                      #
+                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                      # inherited from the parent. Which text styles are inherited depend on the
+                      # nesting level of lists:
+                      #
+                      # * A text run in a paragraph that is not in a list will inherit its text style
+                      #   from the the newline character in the paragraph at the 0 nesting level of
+                      #   the list inside the parent placeholder.
+                      # * A text run in a paragraph that is in a list will inherit its text style
+                      #   from the newline character in the paragraph at its corresponding nesting
+                      #   level of the list inside the parent placeholder.
+                      #
+                      # Inherited text styles are represented as unset fields in this message. If
+                      # text is contained in a shape without a parent placeholder, unsetting these
+                      # fields will revert the style to a value matching the defaults in the Slides
+                      # editor.
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                        # transparent, depending on if the `opaque_color` field in it is set.
+                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                          # a transparent color.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "bold": True or False, # Whether or not the text is bold.
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                        #
+                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                        # rendered in a smaller font size, computed based on the `font_size` field.
+                        # The `font_size` itself is not affected by changes in this field.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "fontFamily": "A String", # The font family of the text.
+                        #
+                        # The font family can be any font from the Font menu in Slides or from
+                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                        # unrecognized, the text is rendered in `Arial`.
+                        #
+                        # Some fonts can affect the weight of the text. If an update request
+                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                        # `bold` value is used.
+                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                        # are not inherited from parent text.
+                        #
+                        # Changing the link in an update request causes some other changes to the
+                        # text style of the range:
+                        #
+                        # * When setting a link, the text foreground color will be set to
+                        #   ThemeColorType.HYPERLINK and the text will
+                        #   be underlined. If these fields are modified in the same
+                        #   request, those values will be used instead of the link defaults.
+                        # * Setting a link on a text range that overlaps with an existing link will
+                        #   also update the existing link to point to the new URL.
+                        # * Links are not settable on newline characters. As a result, setting a link
+                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                        #   will separate the newline character(s) into their own text runs. The
+                        #   link will be applied separately to the runs before and after the newline.
+                        # * Removing a link will update the text style of the range to match the
+                        #   style of the preceding text (or the default text styles if the preceding
+                        #   text is another link) unless different styles are being set in the same
+                        #   request.
+                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                          # presentation with this ID. A page with this ID may not exist.
+                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                          # in the presentation. There may not be a slide at this index.
+                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                          # addressed by its position.
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                        # points.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                        # transparent, depending on if the `opaque_color` field in it is set.
+                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                          # a transparent color.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                  },
+                  "type": "A String", # The type of this auto text.
+                },
+                "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                    # units.
+                "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                    #
+                    # The `start_index` and `end_index` of this TextElement represent the
+                    # range of the paragraph. Other TextElements with an index range contained
+                    # inside this paragraph's range are considered to be part of this
+                    # paragraph. The range of indices of two separate paragraphs will never
+                    # overlap.
+                  "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                      #
+                      # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                      # inherited from the parent. Which paragraph styles are inherited depend on the
+                      # nesting level of lists:
+                      #
+                      # * A paragraph not in a list will inherit its paragraph style from the
+                      #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                      # * A paragraph in a list will inherit its paragraph style from the paragraph
+                      #   at its corresponding nesting level of the list inside the parent
+                      #   placeholder.
+                      #
+                      # Inherited paragraph styles are represented as unset fields in this message.
+                    "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                    "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                    "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                        # inherited from the parent. This property is read-only.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                        # is represented as 100.0. If unset, the value is inherited from the parent.
+                        # This property is read-only.
+                    "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                        # the start of the text, based on the current text direction. If unset, the
+                        # value is inherited from the parent. This property is read-only.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                        # inherited from the parent. This property is read-only.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                        # the end of the text, based on the current text direction. If unset, the
+                        # value is inherited from the parent. This property is read-only.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                        # If unset, the value is inherited from the parent. This property is
+                        # read-only.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                  },
+                  "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                      # belong to a list.
+                    "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                    "listId": "A String", # The ID of the list this paragraph belongs to.
+                    "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                        #
+                        # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                        # inherited from the parent. Which text styles are inherited depend on the
+                        # nesting level of lists:
+                        #
+                        # * A text run in a paragraph that is not in a list will inherit its text style
+                        #   from the the newline character in the paragraph at the 0 nesting level of
+                        #   the list inside the parent placeholder.
+                        # * A text run in a paragraph that is in a list will inherit its text style
+                        #   from the newline character in the paragraph at its corresponding nesting
+                        #   level of the list inside the parent placeholder.
+                        #
+                        # Inherited text styles are represented as unset fields in this message. If
+                        # text is contained in a shape without a parent placeholder, unsetting these
+                        # fields will revert the style to a value matching the defaults in the Slides
+                        # editor.
+                      "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                          # transparent, depending on if the `opaque_color` field in it is set.
+                        "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                            # a transparent color.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                      "bold": True or False, # Whether or not the text is bold.
+                      "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                          #
+                          # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                          # rendered in a smaller font size, computed based on the `font_size` field.
+                          # The `font_size` itself is not affected by changes in this field.
+                      "strikethrough": True or False, # Whether or not the text is struck through.
+                      "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                      "fontFamily": "A String", # The font family of the text.
+                          #
+                          # The font family can be any font from the Font menu in Slides or from
+                          # [Google Fonts] (https://fonts.google.com/). If the font name is
+                          # unrecognized, the text is rendered in `Arial`.
+                          #
+                          # Some fonts can affect the weight of the text. If an update request
+                          # specifies values for both `font_family` and `bold`, the explicitly-set
+                          # `bold` value is used.
+                      "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                          # are not inherited from parent text.
+                          #
+                          # Changing the link in an update request causes some other changes to the
+                          # text style of the range:
+                          #
+                          # * When setting a link, the text foreground color will be set to
+                          #   ThemeColorType.HYPERLINK and the text will
+                          #   be underlined. If these fields are modified in the same
+                          #   request, those values will be used instead of the link defaults.
+                          # * Setting a link on a text range that overlaps with an existing link will
+                          #   also update the existing link to point to the new URL.
+                          # * Links are not settable on newline characters. As a result, setting a link
+                          #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                          #   will separate the newline character(s) into their own text runs. The
+                          #   link will be applied separately to the runs before and after the newline.
+                          # * Removing a link will update the text style of the range to match the
+                          #   style of the preceding text (or the default text styles if the preceding
+                          #   text is another link) unless different styles are being set in the same
+                          #   request.
+                        "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                        "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                            # presentation with this ID. A page with this ID may not exist.
+                        "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                            # in the presentation. There may not be a slide at this index.
+                        "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                            # addressed by its position.
+                      },
+                      "italic": True or False, # Whether or not the text is italicized.
+                      "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                          # points.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "underline": True or False, # Whether or not the text is underlined.
+                      "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                          # transparent, depending on if the `opaque_color` field in it is set.
+                        "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                            # a transparent color.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                    },
+                    "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                  },
+                },
+                "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                    # in the run have the same TextStyle.
+                    #
+                    # The `start_index` and `end_index` of TextRuns will always be fully
+                    # contained in the index range of a single `paragraph_marker` TextElement.
+                    # In other words, a TextRun will never span multiple paragraphs.
+                    # styling.
+                  "content": "A String", # The text of this run.
+                  "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                      #
+                      # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                      # inherited from the parent. Which text styles are inherited depend on the
+                      # nesting level of lists:
+                      #
+                      # * A text run in a paragraph that is not in a list will inherit its text style
+                      #   from the the newline character in the paragraph at the 0 nesting level of
+                      #   the list inside the parent placeholder.
+                      # * A text run in a paragraph that is in a list will inherit its text style
+                      #   from the newline character in the paragraph at its corresponding nesting
+                      #   level of the list inside the parent placeholder.
+                      #
+                      # Inherited text styles are represented as unset fields in this message. If
+                      # text is contained in a shape without a parent placeholder, unsetting these
+                      # fields will revert the style to a value matching the defaults in the Slides
+                      # editor.
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                        # transparent, depending on if the `opaque_color` field in it is set.
+                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                          # a transparent color.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "bold": True or False, # Whether or not the text is bold.
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                        #
+                        # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                        # rendered in a smaller font size, computed based on the `font_size` field.
+                        # The `font_size` itself is not affected by changes in this field.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "fontFamily": "A String", # The font family of the text.
+                        #
+                        # The font family can be any font from the Font menu in Slides or from
+                        # [Google Fonts] (https://fonts.google.com/). If the font name is
+                        # unrecognized, the text is rendered in `Arial`.
+                        #
+                        # Some fonts can affect the weight of the text. If an update request
+                        # specifies values for both `font_family` and `bold`, the explicitly-set
+                        # `bold` value is used.
+                    "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                        # are not inherited from parent text.
+                        #
+                        # Changing the link in an update request causes some other changes to the
+                        # text style of the range:
+                        #
+                        # * When setting a link, the text foreground color will be set to
+                        #   ThemeColorType.HYPERLINK and the text will
+                        #   be underlined. If these fields are modified in the same
+                        #   request, those values will be used instead of the link defaults.
+                        # * Setting a link on a text range that overlaps with an existing link will
+                        #   also update the existing link to point to the new URL.
+                        # * Links are not settable on newline characters. As a result, setting a link
+                        #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                        #   will separate the newline character(s) into their own text runs. The
+                        #   link will be applied separately to the runs before and after the newline.
+                        # * Removing a link will update the text style of the range to match the
+                        #   style of the preceding text (or the default text styles if the preceding
+                        #   text is another link) unless different styles are being set in the same
+                        #   request.
+                      "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                      "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                          # presentation with this ID. A page with this ID may not exist.
+                      "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                          # in the presentation. There may not be a slide at this index.
+                      "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                          # addressed by its position.
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                        # points.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                        # transparent, depending on if the `opaque_color` field in it is set.
+                      "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                          # a transparent color.
+                        "themeColor": "A String", # An opaque theme color.
+                        "rgbColor": { # An RGB color. # An opaque RGB color.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                  },
+                },
+              },
+            ],
+            "lists": { # The bulleted lists contained in this text, keyed by list ID.
+              "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                  # associated with a list. A paragraph that is part of a list has an implicit
+                  # reference to that list's ID.
+                "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                    # level. A list has at most nine levels of nesting, so the possible values
+                    # for the keys of this map are 0 through 8, inclusive.
+                  "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                      # level of nesting.
+                    "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                        #
+                        # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                        # inherited from the parent. Which text styles are inherited depend on the
+                        # nesting level of lists:
+                        #
+                        # * A text run in a paragraph that is not in a list will inherit its text style
+                        #   from the the newline character in the paragraph at the 0 nesting level of
+                        #   the list inside the parent placeholder.
+                        # * A text run in a paragraph that is in a list will inherit its text style
+                        #   from the newline character in the paragraph at its corresponding nesting
+                        #   level of the list inside the parent placeholder.
+                        #
+                        # Inherited text styles are represented as unset fields in this message. If
+                        # text is contained in a shape without a parent placeholder, unsetting these
+                        # fields will revert the style to a value matching the defaults in the Slides
+                        # editor.
+                      "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                          # transparent, depending on if the `opaque_color` field in it is set.
+                        "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                            # a transparent color.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                      "bold": True or False, # Whether or not the text is bold.
+                      "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                          #
+                          # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                          # rendered in a smaller font size, computed based on the `font_size` field.
+                          # The `font_size` itself is not affected by changes in this field.
+                      "strikethrough": True or False, # Whether or not the text is struck through.
+                      "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                      "fontFamily": "A String", # The font family of the text.
+                          #
+                          # The font family can be any font from the Font menu in Slides or from
+                          # [Google Fonts] (https://fonts.google.com/). If the font name is
+                          # unrecognized, the text is rendered in `Arial`.
+                          #
+                          # Some fonts can affect the weight of the text. If an update request
+                          # specifies values for both `font_family` and `bold`, the explicitly-set
+                          # `bold` value is used.
+                      "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                          # are not inherited from parent text.
+                          #
+                          # Changing the link in an update request causes some other changes to the
+                          # text style of the range:
+                          #
+                          # * When setting a link, the text foreground color will be set to
+                          #   ThemeColorType.HYPERLINK and the text will
+                          #   be underlined. If these fields are modified in the same
+                          #   request, those values will be used instead of the link defaults.
+                          # * Setting a link on a text range that overlaps with an existing link will
+                          #   also update the existing link to point to the new URL.
+                          # * Links are not settable on newline characters. As a result, setting a link
+                          #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                          #   will separate the newline character(s) into their own text runs. The
+                          #   link will be applied separately to the runs before and after the newline.
+                          # * Removing a link will update the text style of the range to match the
+                          #   style of the preceding text (or the default text styles if the preceding
+                          #   text is another link) unless different styles are being set in the same
+                          #   request.
+                        "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                        "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                            # presentation with this ID. A page with this ID may not exist.
+                        "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                            # in the presentation. There may not be a slide at this index.
+                        "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                            # addressed by its position.
+                      },
+                      "italic": True or False, # Whether or not the text is italicized.
+                      "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                          # points.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "underline": True or False, # Whether or not the text is underlined.
+                      "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                          # transparent, depending on if the `opaque_color` field in it is set.
+                        "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                            # a transparent color.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                    },
+                  },
+                },
+                "listId": "A String", # The ID of the list.
+              },
+            },
+          },
+          "shapeProperties": { # The properties of a Shape. # The properties of the shape.
+              #
+              # If the shape is a placeholder shape as determined by the
+              # placeholder field, then these
+              # properties may be inherited from a parent placeholder shape.
+              # Determining the rendered value of the property depends on the corresponding
+              # property_state field value.
+            "shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from
+                # a parent placeholder if it exists. If the shape has no parent, then the
+                # default shadow matches the defaults for new shapes created in the Slides
+                # editor. This property is read-only.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "color": { # A themeable solid color value. # The shadow color value.
+                "themeColor": "A String", # An opaque theme color.
+                "rgbColor": { # An RGB color. # An opaque RGB color.
+                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                },
+              },
+              "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                  # relative to the alignment position.
+                  # to transform source coordinates (x,y) into destination coordinates (x', y')
+                  # according to:
+                  #
+                  #       x'  x  =   shear_y  scale_y  translate_y
+                  #       1  [ 1 ]
+                  #
+                  # After transformation,
+                  #
+                  #      x' = scale_x * x + shear_x * y + translate_x;
+                  #      y' = scale_y * y + shear_y * x + translate_y;
+                  #
+                  # This message is therefore composed of these six matrix elements.
+                "translateX": 3.14, # The X coordinate translation element.
+                "translateY": 3.14, # The Y coordinate translation element.
+                "scaleX": 3.14, # The X coordinate scaling element.
+                "scaleY": 3.14, # The Y coordinate scaling element.
+                "shearY": 3.14, # The Y coordinate shearing element.
+                "shearX": 3.14, # The X coordinate shearing element.
+                "unit": "A String", # The units for translate elements.
+              },
+              "propertyState": "A String", # The shadow property state.
+                  #
+                  # Updating the the shadow on a page element will implicitly update this field
+                  # to `RENDERED`, unless another value is specified in the same request. To
+                  # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                  # case, any other shadow fields set in the same request will be ignored.
+              "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                  # shadow becomes.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+              "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+              "type": "A String", # The type of the shadow.
+              "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                  # scale and skew of the shadow.
+              "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+            },
+            "shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is
+                # inherited from a parent placeholder if it exists. If the shape has no
+                # parent, then the default background fill depends on the shape type,
+                # matching the defaults for new shapes created in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+              "propertyState": "A String", # The background fill property state.
+                  #
+                  # Updating the the fill on a shape will implicitly update this field to
+                  # `RENDERED`, unless another value is specified in the same request. To
+                  # have no fill on a shape, set this field to `NOT_RENDERED`. In this case,
+                  # any other fill fields set in the same request will be ignored.
+            },
+            "link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links
+                # are not inherited from parent placeholders.
+              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                  # presentation with this ID. A page with this ID may not exist.
+              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                  # in the presentation. There may not be a slide at this index.
+              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                  # addressed by its position.
+            },
+            "outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a
+                # parent placeholder if it exists. If the shape has no parent, then the
+                # default outline depends on the shape type, matching the defaults for
+                # new shapes created in the Slides editor.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "dashStyle": "A String", # The dash style of the outline.
+              "propertyState": "A String", # The outline property state.
+                  #
+                  # Updating the the outline on a page element will implicitly update this
+                  # field to`RENDERED`, unless another value is specified in the same request.
+                  # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                  # this case, any other outline fields set in the same request will be
+                  # ignored.
+              "outlineFill": { # The fill of the outline. # The fill of the outline.
+                "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                    # specified color value.
+                    #
+                    # If any field is unset, its value may be inherited from a parent placeholder
+                    # if it exists.
+                  "color": { # A themeable solid color value. # The color value of the solid fill.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                      # That is, the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color.
+                },
+              },
+              "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on
+              # layouts and masters.
+              #
+              # If set, the shape is a placeholder shape and any inherited properties
+              # can be resolved by looking at the parent placeholder identified by the
+              # Placeholder.parent_object_id field.
+            "parentObjectId": "A String", # The object ID of this shape's parent placeholder.
+                # If unset, the parent placeholder shape does not exist, so the shape does
+                # not inherit properties from any other shape.
+            "index": 42, # The index of the placeholder. If the same placeholder types are the present
+                # in the same page, they would have different index values.
+            "type": "A String", # The type of the placeholder.
+          },
+          "shapeType": "A String", # The type of the shape.
+        },
+        "sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are
+            # represented as images.
+            # a linked chart embedded from Google Sheets.
+          "chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is
+              # embedded.
+          "spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.
+          "sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.
+            "chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.
+              "outline": { # The outline of a PageElement. # The outline of the image. If not set, the the image has no outline.
+                  #
+                  # If these fields are unset, they may be inherited from a parent placeholder
+                  # if it exists. If there is no parent, the fields will default to the value
+                  # used for new page elements created in the Slides editor, which may depend on
+                  # the page element kind.
+                "dashStyle": "A String", # The dash style of the outline.
+                "propertyState": "A String", # The outline property state.
+                    #
+                    # Updating the the outline on a page element will implicitly update this
+                    # field to`RENDERED`, unless another value is specified in the same request.
+                    # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                    # this case, any other outline fields set in the same request will be
+                    # ignored.
+                "outlineFill": { # The fill of the outline. # The fill of the outline.
+                  "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                      # specified color value.
+                      #
+                      # If any field is unset, its value may be inherited from a parent placeholder
+                      # if it exists.
+                    "color": { # A themeable solid color value. # The color value of the solid fill.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                        # That is, the final pixel color is defined by the equation:
+                        #
+                        #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                        #
+                        # This means that a value of 1.0 corresponds to a solid color, whereas
+                        # a value of 0.0 corresponds to a completely transparent color.
+                  },
+                },
+                "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+              },
+              "brightness": 3.14, # The brightness effect of the image. The value should be in the interval
+                  # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+              "recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.
+                  # This property is read-only.
+                "recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color
+                    # stops. This property is read-only.
+                  { # A color and position in a gradient band.
+                    "color": { # A themeable solid color value. # The color of the gradient stop.
+                      "themeColor": "A String", # An opaque theme color.
+                      "rgbColor": { # An RGB color. # An opaque RGB color.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                    "position": 3.14, # The relative position of the color stop in the gradient band measured
+                        # in percentage. The value should be in the interval [0.0, 1.0].
+                    "alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,
+                        # fully opaque.
+                  },
+                ],
+              },
+              "link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.
+                "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                    # presentation with this ID. A page with this ID may not exist.
+                "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                    # in the presentation. There may not be a slide at this index.
+                "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                    # addressed by its position.
+              },
+              "transparency": 3.14, # The transparency effect of the image. The value should be in the interval
+                  # [0.0, 1.0], where 0 means no effect and 1 means completely transparent.
+                  # This property is read-only.
+              "cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.
+                  # This property is read-only.
+                  # Image.
+                  #
+                  # The crop properties is represented by the offsets of four edges which define
+                  # a crop rectangle. The offsets are measured in percentage from the
+                  # corresponding edges of the object's original bounding rectangle towards
+                  # inside, relative to the object's original dimensions.
+                  #
+                  # - If the offset is in the interval (0, 1), the corresponding edge of crop
+                  # rectangle is positioned inside of the object's original bounding rectangle.
+                  # - If the offset is negative or greater than 1, the corresponding edge of crop
+                  # rectangle is positioned outside of the object's original bounding rectangle.
+                  # - If the left edge of the crop rectangle is on the right side of its right
+                  # edge, the object will be flipped horizontally.
+                  # - If the top edge of the crop rectangle is below its bottom edge, the object
+                  # will be flipped vertically.
+                  # - If all offsets and rotation angle is 0, the object is not cropped.
+                  #
+                  # After cropping, the content in the crop rectangle will be stretched to fit
+                  # its container.
+                "leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to
+                    # the right of the original bounding rectangle left edge, relative to the
+                    # object's original width.
+                "angle": 3.14, # The rotation angle of the crop window around its center, in radians.
+                    # Rotation angle is applied after the offset.
+                "bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located
+                    # above the original bounding rectangle bottom edge, relative to the object's
+                    # original height.
+                "rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located
+                    # to the left of the original bounding rectangle right edge, relative to the
+                    # object's original width.
+                "topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located
+                    # below the original bounding rectangle top edge, relative to the object's
+                    # original height.
+              },
+              "shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property
+                  # is read-only.
+                  #
+                  # If these fields are unset, they may be inherited from a parent placeholder
+                  # if it exists. If there is no parent, the fields will default to the value
+                  # used for new page elements created in the Slides editor, which may depend on
+                  # the page element kind.
+                "color": { # A themeable solid color value. # The shadow color value.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,
+                    # relative to the alignment position.
+                    # to transform source coordinates (x,y) into destination coordinates (x', y')
+                    # according to:
+                    #
+                    #       x'  x  =   shear_y  scale_y  translate_y
+                    #       1  [ 1 ]
+                    #
+                    # After transformation,
+                    #
+                    #      x' = scale_x * x + shear_x * y + translate_x;
+                    #      y' = scale_y * y + shear_y * x + translate_y;
+                    #
+                    # This message is therefore composed of these six matrix elements.
+                  "translateX": 3.14, # The X coordinate translation element.
+                  "translateY": 3.14, # The Y coordinate translation element.
+                  "scaleX": 3.14, # The X coordinate scaling element.
+                  "scaleY": 3.14, # The Y coordinate scaling element.
+                  "shearY": 3.14, # The Y coordinate shearing element.
+                  "shearX": 3.14, # The X coordinate shearing element.
+                  "unit": "A String", # The units for translate elements.
+                },
+                "propertyState": "A String", # The shadow property state.
+                    #
+                    # Updating the the shadow on a page element will implicitly update this field
+                    # to `RENDERED`, unless another value is specified in the same request. To
+                    # have no shadow on a page element, set this field to `NOT_RENDERED`. In this
+                    # case, any other shadow fields set in the same request will be ignored.
+                "blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the
+                    # shadow becomes.
+                  "magnitude": 3.14, # The magnitude.
+                  "unit": "A String", # The units for magnitude.
+                },
+                "alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.
+                "type": "A String", # The type of the shadow.
+                "alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,
+                    # scale and skew of the shadow.
+                "rotateWithShape": True or False, # Whether the shadow should rotate with the shape.
+              },
+              "contrast": 3.14, # The contrast effect of the image. The value should be in the interval
+                  # [-1.0, 1.0], where 0 means no effect. This property is read-only.
+            },
+          },
+          "contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30
+              # minutes. This URL is tagged with the account of the requester. Anyone with
+              # the URL effectively accesses the image as the original requester. Access to
+              # the image may be lost if the presentation's sharing settings change.
+        },
+        "video": { # A PageElement kind representing a # A video page element.
+            # video.
+          "url": "A String", # An URL to a video. The URL is valid as long as the source video
+              # exists and sharing settings do not change.
+          "videoProperties": { # The properties of the Video. # The properties of the video.
+            "outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new
+                # videos created in the Slides editor.
+                #
+                # If these fields are unset, they may be inherited from a parent placeholder
+                # if it exists. If there is no parent, the fields will default to the value
+                # used for new page elements created in the Slides editor, which may depend on
+                # the page element kind.
+              "dashStyle": "A String", # The dash style of the outline.
+              "propertyState": "A String", # The outline property state.
+                  #
+                  # Updating the the outline on a page element will implicitly update this
+                  # field to`RENDERED`, unless another value is specified in the same request.
+                  # To have no outline on a page element, set this field to `NOT_RENDERED`. In
+                  # this case, any other outline fields set in the same request will be
+                  # ignored.
+              "outlineFill": { # The fill of the outline. # The fill of the outline.
+                "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                    # specified color value.
+                    #
+                    # If any field is unset, its value may be inherited from a parent placeholder
+                    # if it exists.
+                  "color": { # A themeable solid color value. # The color value of the solid fill.
+                    "themeColor": "A String", # An opaque theme color.
+                    "rgbColor": { # An RGB color. # An opaque RGB color.
+                      "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                      "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                      "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                    },
+                  },
+                  "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                      # That is, the final pixel color is defined by the equation:
+                      #
+                      #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                      #
+                      # This means that a value of 1.0 corresponds to a solid color, whereas
+                      # a value of 0.0 corresponds to a completely transparent color.
+                },
+              },
+              "weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          },
+          "id": "A String", # The video source's unique identifier for this video.
+          "source": "A String", # The video source.
+        },
+        "table": { # A PageElement kind representing a # A table page element.
+            # table.
+          "tableColumns": [ # Properties of each column.
+            { # Properties of each column in a table.
+              "columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          ],
+          "tableRows": [ # Properties and contents of each row.
+              #
+              # Cells that span multiple rows are contained in only one of these rows and
+              # have a row_span greater
+              # than 1.
+            { # Properties and contents of each row in a table.
+              "tableCells": [ # Properties and contents of each cell.
+                  #
+                  # Cells that span multiple columns are represented only once with a
+                  # column_span greater
+                  # than 1. As a result, the length of this collection does not always match
+                  # the number of columns of the entire table.
+                { # Properties and contents of each table cell.
+                  "text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.
+                      # text box or rectangle) or a table cell in a page.
+                    "textElements": [ # The text contents broken down into its component parts, including styling
+                        # information. This property is read-only.
+                      { # A TextElement describes the content of a range of indices in the text content
+                          # of a Shape or TableCell.
+                        "autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically
+                            # replaced with content that can change over time.
+                          "content": "A String", # The rendered content of this auto text, if available.
+                          "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                          "type": "A String", # The type of this auto text.
+                        },
+                        "endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code
+                            # units.
+                        "startIndex": 42, # The zero-based start index of this text element, in Unicode code units.
+                        "paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.
+                            #
+                            # The `start_index` and `end_index` of this TextElement represent the
+                            # range of the paragraph. Other TextElements with an index range contained
+                            # inside this paragraph's range are considered to be part of this
+                            # paragraph. The range of indices of two separate paragraphs will never
+                            # overlap.
+                          "style": { # Styles that apply to a whole paragraph. # The paragraph's style
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these paragraph styles may be
+                              # inherited from the parent. Which paragraph styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A paragraph not in a list will inherit its paragraph style from the
+                              #   paragraph at the 0 nesting level of the list inside the parent placeholder.
+                              # * A paragraph in a list will inherit its paragraph style from the paragraph
+                              #   at its corresponding nesting level of the list inside the parent
+                              #   placeholder.
+                              #
+                              # Inherited paragraph styles are represented as unset fields in this message.
+                            "spacingMode": "A String", # The spacing mode for the paragraph. This property is read-only.
+                            "direction": "A String", # The text direction of this paragraph. This property is read-only.
+                            "spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                # inherited from the parent. This property is read-only.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal
+                                # is represented as 100.0. If unset, the value is inherited from the parent.
+                                # This property is read-only.
+                            "indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                # the start of the text, based on the current text direction. If unset, the
+                                # value is inherited from the parent. This property is read-only.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is
+                                # inherited from the parent. This property is read-only.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to
+                                # the end of the text, based on the current text direction. If unset, the
+                                # value is inherited from the parent. This property is read-only.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.
+                                # If unset, the value is inherited from the parent. This property is
+                                # read-only.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "alignment": "A String", # The text alignment for this paragraph. This property is read-only.
+                          },
+                          "bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not
+                              # belong to a list.
+                            "nestingLevel": 42, # The nesting level of this paragraph in the list.
+                            "listId": "A String", # The ID of the list this paragraph belongs to.
+                            "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.
+                                #
+                                # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                # inherited from the parent. Which text styles are inherited depend on the
+                                # nesting level of lists:
+                                #
+                                # * A text run in a paragraph that is not in a list will inherit its text style
+                                #   from the the newline character in the paragraph at the 0 nesting level of
+                                #   the list inside the parent placeholder.
+                                # * A text run in a paragraph that is in a list will inherit its text style
+                                #   from the newline character in the paragraph at its corresponding nesting
+                                #   level of the list inside the parent placeholder.
+                                #
+                                # Inherited text styles are represented as unset fields in this message. If
+                                # text is contained in a shape without a parent placeholder, unsetting these
+                                # fields will revert the style to a value matching the defaults in the Slides
+                                # editor.
+                              "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                  # transparent, depending on if the `opaque_color` field in it is set.
+                                "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                    # a transparent color.
+                                  "themeColor": "A String", # An opaque theme color.
+                                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                  },
+                                },
+                              },
+                              "bold": True or False, # Whether or not the text is bold.
+                              "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                  #
+                                  # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                  # rendered in a smaller font size, computed based on the `font_size` field.
+                                  # The `font_size` itself is not affected by changes in this field.
+                              "strikethrough": True or False, # Whether or not the text is struck through.
+                              "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                              "fontFamily": "A String", # The font family of the text.
+                                  #
+                                  # The font family can be any font from the Font menu in Slides or from
+                                  # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                  # unrecognized, the text is rendered in `Arial`.
+                                  #
+                                  # Some fonts can affect the weight of the text. If an update request
+                                  # specifies values for both `font_family` and `bold`, the explicitly-set
+                                  # `bold` value is used.
+                              "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                  # are not inherited from parent text.
+                                  #
+                                  # Changing the link in an update request causes some other changes to the
+                                  # text style of the range:
+                                  #
+                                  # * When setting a link, the text foreground color will be set to
+                                  #   ThemeColorType.HYPERLINK and the text will
+                                  #   be underlined. If these fields are modified in the same
+                                  #   request, those values will be used instead of the link defaults.
+                                  # * Setting a link on a text range that overlaps with an existing link will
+                                  #   also update the existing link to point to the new URL.
+                                  # * Links are not settable on newline characters. As a result, setting a link
+                                  #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                  #   will separate the newline character(s) into their own text runs. The
+                                  #   link will be applied separately to the runs before and after the newline.
+                                  # * Removing a link will update the text style of the range to match the
+                                  #   style of the preceding text (or the default text styles if the preceding
+                                  #   text is another link) unless different styles are being set in the same
+                                  #   request.
+                                "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                    # presentation with this ID. A page with this ID may not exist.
+                                "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                    # in the presentation. There may not be a slide at this index.
+                                "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                    # addressed by its position.
+                              },
+                              "italic": True or False, # Whether or not the text is italicized.
+                              "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                  # points.
+                                "magnitude": 3.14, # The magnitude.
+                                "unit": "A String", # The units for magnitude.
+                              },
+                              "underline": True or False, # Whether or not the text is underlined.
+                              "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                  # transparent, depending on if the `opaque_color` field in it is set.
+                                "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                    # a transparent color.
+                                  "themeColor": "A String", # An opaque theme color.
+                                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                  },
+                                },
+                              },
+                            },
+                            "glyph": "A String", # The rendered bullet glyph for this paragraph.
+                          },
+                        },
+                        "textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters
+                            # in the run have the same TextStyle.
+                            #
+                            # The `start_index` and `end_index` of TextRuns will always be fully
+                            # contained in the index range of a single `paragraph_marker` TextElement.
+                            # In other words, a TextRun will never span multiple paragraphs.
+                            # styling.
+                          "content": "A String", # The text of this run.
+                          "style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.
+                              #
+                              # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                              # inherited from the parent. Which text styles are inherited depend on the
+                              # nesting level of lists:
+                              #
+                              # * A text run in a paragraph that is not in a list will inherit its text style
+                              #   from the the newline character in the paragraph at the 0 nesting level of
+                              #   the list inside the parent placeholder.
+                              # * A text run in a paragraph that is in a list will inherit its text style
+                              #   from the newline character in the paragraph at its corresponding nesting
+                              #   level of the list inside the parent placeholder.
+                              #
+                              # Inherited text styles are represented as unset fields in this message. If
+                              # text is contained in a shape without a parent placeholder, unsetting these
+                              # fields will revert the style to a value matching the defaults in the Slides
+                              # editor.
+                            "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                            "bold": True or False, # Whether or not the text is bold.
+                            "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                #
+                                # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                # rendered in a smaller font size, computed based on the `font_size` field.
+                                # The `font_size` itself is not affected by changes in this field.
+                            "strikethrough": True or False, # Whether or not the text is struck through.
+                            "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                            "fontFamily": "A String", # The font family of the text.
+                                #
+                                # The font family can be any font from the Font menu in Slides or from
+                                # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                # unrecognized, the text is rendered in `Arial`.
+                                #
+                                # Some fonts can affect the weight of the text. If an update request
+                                # specifies values for both `font_family` and `bold`, the explicitly-set
+                                # `bold` value is used.
+                            "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                # are not inherited from parent text.
+                                #
+                                # Changing the link in an update request causes some other changes to the
+                                # text style of the range:
+                                #
+                                # * When setting a link, the text foreground color will be set to
+                                #   ThemeColorType.HYPERLINK and the text will
+                                #   be underlined. If these fields are modified in the same
+                                #   request, those values will be used instead of the link defaults.
+                                # * Setting a link on a text range that overlaps with an existing link will
+                                #   also update the existing link to point to the new URL.
+                                # * Links are not settable on newline characters. As a result, setting a link
+                                #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                #   will separate the newline character(s) into their own text runs. The
+                                #   link will be applied separately to the runs before and after the newline.
+                                # * Removing a link will update the text style of the range to match the
+                                #   style of the preceding text (or the default text styles if the preceding
+                                #   text is another link) unless different styles are being set in the same
+                                #   request.
+                              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                  # presentation with this ID. A page with this ID may not exist.
+                              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                  # in the presentation. There may not be a slide at this index.
+                              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                  # addressed by its position.
+                            },
+                            "italic": True or False, # Whether or not the text is italicized.
+                            "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                # points.
+                              "magnitude": 3.14, # The magnitude.
+                              "unit": "A String", # The units for magnitude.
+                            },
+                            "underline": True or False, # Whether or not the text is underlined.
+                            "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                # transparent, depending on if the `opaque_color` field in it is set.
+                              "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                  # a transparent color.
+                                "themeColor": "A String", # An opaque theme color.
+                                "rgbColor": { # An RGB color. # An opaque RGB color.
+                                  "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                  "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                  "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                },
+                              },
+                            },
+                          },
+                        },
+                      },
+                    ],
+                    "lists": { # The bulleted lists contained in this text, keyed by list ID.
+                      "a_key": { # A List describes the look and feel of bullets belonging to paragraphs
+                          # associated with a list. A paragraph that is part of a list has an implicit
+                          # reference to that list's ID.
+                        "nestingLevel": { # A map of nesting levels to the properties of bullets at the associated
+                            # level. A list has at most nine levels of nesting, so the possible values
+                            # for the keys of this map are 0 through 8, inclusive.
+                          "a_key": { # Contains properties describing the look and feel of a list bullet at a given
+                              # level of nesting.
+                            "bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.
+                                #
+                                # If this text is contained in a shape with a parent placeholder, then these text styles may be
+                                # inherited from the parent. Which text styles are inherited depend on the
+                                # nesting level of lists:
+                                #
+                                # * A text run in a paragraph that is not in a list will inherit its text style
+                                #   from the the newline character in the paragraph at the 0 nesting level of
+                                #   the list inside the parent placeholder.
+                                # * A text run in a paragraph that is in a list will inherit its text style
+                                #   from the newline character in the paragraph at its corresponding nesting
+                                #   level of the list inside the parent placeholder.
+                                #
+                                # Inherited text styles are represented as unset fields in this message. If
+                                # text is contained in a shape without a parent placeholder, unsetting these
+                                # fields will revert the style to a value matching the defaults in the Slides
+                                # editor.
+                              "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or
+                                  # transparent, depending on if the `opaque_color` field in it is set.
+                                "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                    # a transparent color.
+                                  "themeColor": "A String", # An opaque theme color.
+                                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                  },
+                                },
+                              },
+                              "bold": True or False, # Whether or not the text is bold.
+                              "baselineOffset": "A String", # The text's vertical offset from its normal position.
+                                  #
+                                  # Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically
+                                  # rendered in a smaller font size, computed based on the `font_size` field.
+                                  # The `font_size` itself is not affected by changes in this field.
+                              "strikethrough": True or False, # Whether or not the text is struck through.
+                              "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                              "fontFamily": "A String", # The font family of the text.
+                                  #
+                                  # The font family can be any font from the Font menu in Slides or from
+                                  # [Google Fonts] (https://fonts.google.com/). If the font name is
+                                  # unrecognized, the text is rendered in `Arial`.
+                                  #
+                                  # Some fonts can affect the weight of the text. If an update request
+                                  # specifies values for both `font_family` and `bold`, the explicitly-set
+                                  # `bold` value is used.
+                              "link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links
+                                  # are not inherited from parent text.
+                                  #
+                                  # Changing the link in an update request causes some other changes to the
+                                  # text style of the range:
+                                  #
+                                  # * When setting a link, the text foreground color will be set to
+                                  #   ThemeColorType.HYPERLINK and the text will
+                                  #   be underlined. If these fields are modified in the same
+                                  #   request, those values will be used instead of the link defaults.
+                                  # * Setting a link on a text range that overlaps with an existing link will
+                                  #   also update the existing link to point to the new URL.
+                                  # * Links are not settable on newline characters. As a result, setting a link
+                                  #   on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,
+                                  #   will separate the newline character(s) into their own text runs. The
+                                  #   link will be applied separately to the runs before and after the newline.
+                                  # * Removing a link will update the text style of the range to match the
+                                  #   style of the preceding text (or the default text styles if the preceding
+                                  #   text is another link) unless different styles are being set in the same
+                                  #   request.
+                                "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+                                "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                                    # presentation with this ID. A page with this ID may not exist.
+                                "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                                    # in the presentation. There may not be a slide at this index.
+                                "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                                    # addressed by its position.
+                              },
+                              "italic": True or False, # Whether or not the text is italicized.
+                              "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in
+                                  # points.
+                                "magnitude": 3.14, # The magnitude.
+                                "unit": "A String", # The units for magnitude.
+                              },
+                              "underline": True or False, # Whether or not the text is underlined.
+                              "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or
+                                  # transparent, depending on if the `opaque_color` field in it is set.
+                                "opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents
+                                    # a transparent color.
+                                  "themeColor": "A String", # An opaque theme color.
+                                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                                  },
+                                },
+                              },
+                            },
+                          },
+                        },
+                        "listId": "A String", # The ID of the list.
+                      },
+                    },
+                  },
+                  "rowSpan": 42, # Row span of the cell.
+                  "tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.
+                    "tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill
+                        # for newly created table cells in the Slides editor.
+                      "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                          # specified color value.
+                          #
+                          # If any field is unset, its value may be inherited from a parent placeholder
+                          # if it exists.
+                        "color": { # A themeable solid color value. # The color value of the solid fill.
+                          "themeColor": "A String", # An opaque theme color.
+                          "rgbColor": { # An RGB color. # An opaque RGB color.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                        "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                            # That is, the final pixel color is defined by the equation:
+                            #
+                            #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                            #
+                            # This means that a value of 1.0 corresponds to a solid color, whereas
+                            # a value of 0.0 corresponds to a completely transparent color.
+                      },
+                      "propertyState": "A String", # The background fill property state.
+                          #
+                          # Updating the the fill on a table cell will implicitly update this field
+                          # to `RENDERED`, unless another value is specified in the same request. To
+                          # have no fill on a table cell, set this field to `NOT_RENDERED`. In this
+                          # case, any other fill fields set in the same request will be ignored.
+                    },
+                  },
+                  "location": { # A location of a single table cell within a table. # The location of the cell within the table.
+                    "rowIndex": 42, # The 0-based row index.
+                    "columnIndex": 42, # The 0-based column index.
+                  },
+                  "columnSpan": 42, # Column span of the cell.
+                },
+              ],
+              "rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.
+                "magnitude": 3.14, # The magnitude.
+                "unit": "A String", # The units for magnitude.
+              },
+            },
+          ],
+          "rows": 42, # Number of rows in the table.
+          "columns": 42, # Number of columns in the table.
+        },
+        "line": { # A PageElement kind representing a # A line page element.
+            # line, curved connector, or bent connector.
+          "lineProperties": { # The properties of the Line. # The properties of the line.
+              #
+              # When unset, these fields default to values that match the appearance of
+              # new lines created in the Slides editor.
+            "dashStyle": "A String", # The dash style of the line.
+            "weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.
+              "magnitude": 3.14, # The magnitude.
+              "unit": "A String", # The units for magnitude.
+            },
+            "endArrow": "A String", # The style of the arrow at the end of the line.
+            "link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.
+              "url": "A String", # If set, indicates this is a link to the external web page at this URL.
+              "pageObjectId": "A String", # If set, indicates this is a link to the specific page in this
+                  # presentation with this ID. A page with this ID may not exist.
+              "slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index
+                  # in the presentation. There may not be a slide at this index.
+              "relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,
+                  # addressed by its position.
+            },
+            "startArrow": "A String", # The style of the arrow at the beginning of the line.
+            "lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new
+                # lines created in the Slides editor.
+              "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+                  # specified color value.
+                  #
+                  # If any field is unset, its value may be inherited from a parent placeholder
+                  # if it exists.
+                "color": { # A themeable solid color value. # The color value of the solid fill.
+                  "themeColor": "A String", # An opaque theme color.
+                  "rgbColor": { # An RGB color. # An opaque RGB color.
+                    "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                    "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                    "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                  },
+                },
+                "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+                    # That is, the final pixel color is defined by the equation:
+                    #
+                    #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+                    #
+                    # This means that a value of 1.0 corresponds to a solid color, whereas
+                    # a value of 0.0 corresponds to a completely transparent color.
+              },
+            },
+          },
+          "lineType": "A String", # The type of the line.
+        },
+        "size": { # A width and height. # The size of the page element.
+          "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+            "magnitude": 3.14, # The magnitude.
+            "unit": "A String", # The units for magnitude.
+          },
+          "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+            "magnitude": 3.14, # The magnitude.
+            "unit": "A String", # The units for magnitude.
+          },
+        },
+        "elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.
+            # joined collection of PageElements.
+          "children": [ # The collection of elements in the group. The minimum size of a group is 2.
+            # Object with schema name: PageElement
+          ],
+        },
+      },
+    ],
+    "objectId": "A String", # The object ID for this page. Object IDs used by
+        # Page and
+        # PageElement share the same namespace.
+    "pageProperties": { # The properties of the Page. # The properties of the page.
+        #
+        # The page will inherit properties from the parent page. Depending on the page
+        # type the hierarchy is defined in either
+        # SlideProperties or
+        # LayoutProperties.
+      "pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited
+          # from a parent page if it exists. If the page has no parent, then the
+          # background fill defaults to the corresponding fill in the Slides editor.
+        "solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.
+            # specified color value.
+            #
+            # If any field is unset, its value may be inherited from a parent placeholder
+            # if it exists.
+          "color": { # A themeable solid color value. # The color value of the solid fill.
+            "themeColor": "A String", # An opaque theme color.
+            "rgbColor": { # An RGB color. # An opaque RGB color.
+              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+            },
+          },
+          "alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.
+              # That is, the final pixel color is defined by the equation:
+              #
+              #   pixel color = alpha * (color) + (1.0 - alpha) * (background color)
+              #
+              # This means that a value of 1.0 corresponds to a solid color, whereas
+              # a value of 0.0 corresponds to a completely transparent color.
+        },
+        "propertyState": "A String", # The background fill property state.
+            #
+            # Updating the the fill on a page will implicitly update this field to
+            # `RENDERED`, unless another value is specified in the same request. To
+            # have no fill on a page, set this field to `NOT_RENDERED`. In this case,
+            # any other fill fields set in the same request will be ignored.
+        "stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.
+            # the specified picture. The picture is stretched to fit its container.
+          "contentUrl": "A String", # Reading the content_url:
+              #
+              # An URL to a picture with a default lifetime of 30 minutes.
+              # This URL is tagged with the account of the requester. Anyone with the URL
+              # effectively accesses the picture as the original requester. Access to the
+              # picture may be lost if the presentation's sharing settings change.
+              #
+              # Writing the content_url:
+              #
+              # The picture is fetched once at insertion time and a copy is stored for
+              # display inside the presentation. Pictures must be less than 50MB in size,
+              # cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF
+              # format.
+          "size": { # A width and height. # The original size of the picture fill. This field is read-only.
+            "width": { # A magnitude in a single direction in the specified units. # The width of the object.
+              "magnitude": 3.14, # The magnitude.
+              "unit": "A String", # The units for magnitude.
+            },
+            "height": { # A magnitude in a single direction in the specified units. # The height of the object.
+              "magnitude": 3.14, # The magnitude.
+              "unit": "A String", # The units for magnitude.
+            },
+          },
+        },
+      },
+      "colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from
+          # a parent page. If the page has no parent, the color scheme uses a default
+          # Slides color scheme. This field is read-only.
+        "colors": [ # The ThemeColorType and corresponding concrete color pairs.
+          { # A pair mapping a theme color type to the concrete color it represents.
+            "color": { # An RGB color. # The concrete color corresponding to the theme color type above.
+              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+            },
+            "type": "A String", # The type of the theme color.
+          },
+        ],
+      },
+    },
+    "pageType": "A String", # The type of the page.
+    "slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.
+        # relevant for pages with page_type SLIDE.
+      "masterObjectId": "A String", # The object ID of the master that this slide is based on.
+      "layoutObjectId": "A String", # The object ID of the layout that this slide is based on.
+    },
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/docs/dyn/speech_v1beta1.speech.html b/docs/dyn/speech_v1beta1.speech.html
index 2f96060bb58..628ebbccdce 100644
--- a/docs/dyn/speech_v1beta1.speech.html
+++ b/docs/dyn/speech_v1beta1.speech.html
@@ -76,15 +76,17 @@ <h1><a href="speech_v1beta1.html">Google Cloud Speech API</a> . <a href="speech_
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#asyncrecognize">asyncrecognize(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Perform asynchronous speech-recognition: receive results via the</p>
+<p class="firstline">Performs asynchronous speech recognition: receive results via the</p>
 <p class="toc_element">
   <code><a href="#syncrecognize">syncrecognize(body, x__xgafv=None)</a></code></p>
-<p class="firstline">Perform synchronous speech-recognition: receive results after all audio</p>
+<p class="firstline">Performs synchronous speech recognition: receive results after all audio</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="asyncrecognize">asyncrecognize(body, x__xgafv=None)</code>
-  <pre>Perform asynchronous speech-recognition: receive results via the
-google.longrunning.Operations interface. Returns either an
+  <pre>Performs asynchronous speech recognition: receive results via the
+[google.longrunning.Operations]
+(/speech/reference/rest/v1beta1/operations#Operation)
+interface. Returns either an
 `Operation.error` or an `Operation.response` which contains
 an `AsyncRecognizeResponse` message.
 
@@ -246,7 +248,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="syncrecognize">syncrecognize(body, x__xgafv=None)</code>
-  <pre>Perform synchronous speech-recognition: receive results after all audio
+  <pre>Performs synchronous speech recognition: receive results after all audio
 has been sent and processed.
 
 Args:
diff --git a/docs/dyn/sqladmin_v1beta3.tiers.html b/docs/dyn/sqladmin_v1beta3.tiers.html
index d58123be298..70bcf3bcef6 100644
--- a/docs/dyn/sqladmin_v1beta3.tiers.html
+++ b/docs/dyn/sqladmin_v1beta3.tiers.html
@@ -95,7 +95,7 @@ <h3>Method Details</h3>
         "tier": "A String", # An identifier for the service tier, for example D1, D2 etc. For related information, see Pricing.
         "kind": "sql#tier", # This is always sql#tier.
         "RAM": "A String", # The maximum RAM usage of this tier in bytes.
-        "region": [ # The applicable regions for this tier. Can be us-east1, europe-west1, or asia-east1.
+        "region": [ # The applicable regions for this tier.
           "A String",
         ],
       },
diff --git a/docs/dyn/sqladmin_v1beta4.instances.html b/docs/dyn/sqladmin_v1beta4.instances.html
index 51805b7c748..f4b3ef0c8f4 100644
--- a/docs/dyn/sqladmin_v1beta4.instances.html
+++ b/docs/dyn/sqladmin_v1beta4.instances.html
@@ -122,6 +122,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#stopReplica">stopReplica(project, instance)</a></code></p>
 <p class="firstline">Stops the replication in the read replica instance.</p>
+<p class="toc_element">
+  <code><a href="#truncateLog">truncateLog(project, instance, body)</a></code></p>
+<p class="firstline">Truncate MySQL general and slow query log tables</p>
 <p class="toc_element">
   <code><a href="#update">update(project, instance, body)</a></code></p>
 <p class="firstline">Updates settings of a Cloud SQL instance. Caution: This is not a partial update, so you must include values for all the settings that you want to retain. For partial updates, use patch.</p>
@@ -477,6 +480,7 @@ <h3>Method Details</h3>
         { # Database instance IP Mapping.
           "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
           "ipAddress": "A String", # The IP address assigned.
+          "type": "A String", # The type of this IP address. A PRIMARY address is an address that can accept incoming connections. An OUTGOING address is the source address of connections originating from the instance, if supported.
         },
       ],
       "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
@@ -710,6 +714,7 @@ <h3>Method Details</h3>
       { # Database instance IP Mapping.
         "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
         "ipAddress": "A String", # The IP address assigned.
+        "type": "A String", # The type of this IP address. A PRIMARY address is an address that can accept incoming connections. An OUTGOING address is the source address of connections originating from the instance, if supported.
       },
     ],
     "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
@@ -921,6 +926,7 @@ <h3>Method Details</h3>
             { # Database instance IP Mapping.
               "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
               "ipAddress": "A String", # The IP address assigned.
+              "type": "A String", # The type of this IP address. A PRIMARY address is an address that can accept incoming connections. An OUTGOING address is the source address of connections originating from the instance, if supported.
             },
           ],
           "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
@@ -1082,6 +1088,7 @@ <h3>Method Details</h3>
       { # Database instance IP Mapping.
         "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
         "ipAddress": "A String", # The IP address assigned.
+        "type": "A String", # The type of this IP address. A PRIMARY address is an address that can accept incoming connections. An OUTGOING address is the source address of connections originating from the instance, if supported.
       },
     ],
     "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
@@ -1699,6 +1706,86 @@ <h3>Method Details</h3>
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="truncateLog">truncateLog(project, instance, body)</code>
+  <pre>Truncate MySQL general and slow query log tables
+
+Args:
+  project: string, Project ID of the Cloud SQL project. (required)
+  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Instance truncate log request.
+    "truncateLogContext": { # Database Instance truncate log context. # Contains details about the truncate log operation.
+      "logType": "A String", # The type of log to truncate. Valid values are MYSQL_GENERAL_TABLE and MYSQL_SLOW_TABLE.
+      "kind": "sql#truncateLogContext", # This is always sql#truncateLogContext.
+    },
+  }
+
+
+Returns:
+  An object of the form:
+
+    { # An Operations resource contains information about database instance operations such as create, delete, and restart. Operations resources are created in response to operations that were initiated; you never create them directly.
+    "status": "A String", # The status of an operation. Valid values are PENDING, RUNNING, DONE, UNKNOWN.
+    "importContext": { # Database instance import context. # The context for import operation, if applicable.
+      "fileType": "A String", # The file type for the specified uri.
+          # SQL: The file contains SQL statements.
+          # CSV: The file contains CSV data.
+      "database": "A String", # The database (for example, guestbook) to which the import is made. If fileType is SQL and no database is specified, it is assumed that the database is specified in the file to be imported. If fileType is CSV, it must be specified.
+      "kind": "sql#importContext", # This is always sql#importContext.
+      "uri": "A String", # A path to the file in Google Cloud Storage from which the import is made. The URI is in the form gs://bucketName/fileName. Compressed gzip files (.gz) are supported when fileType is SQL.
+      "csvImportOptions": { # Options for importing data as CSV.
+        "table": "A String", # The table to which CSV data is imported.
+        "columns": [ # The columns to which CSV data is imported. If not specified, all columns of the database table are loaded with CSV data.
+          "A String",
+        ],
+      },
+    },
+    "kind": "sql#operation", # This is always sql#operation.
+    "name": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.
+    "exportContext": { # Database instance export context. # The context for export operation, if applicable.
+      "kind": "sql#exportContext", # This is always sql#exportContext.
+      "fileType": "A String", # The file type for the specified uri.
+          # SQL: The file contains SQL statements.
+          # CSV: The file contains CSV data.
+      "uri": "A String", # The path to the file in Google Cloud Storage where the export will be stored. The URI is in the form gs://bucketName/fileName. If the file already exists, the operation fails. If fileType is SQL and the filename ends with .gz, the contents are compressed.
+      "csvExportOptions": { # Options for exporting data as CSV.
+        "selectQuery": "A String", # The select query used to extract the data.
+      },
+      "databases": [ # Databases (for example, guestbook) from which the export is made. If fileType is SQL and no database is specified, all databases are exported. If fileType is CSV, you can optionally specify at most one database to export. If csvExportOptions.selectQuery also specifies the database, this field will be ignored.
+        "A String",
+      ],
+      "sqlExportOptions": { # Options for exporting data as SQL statements.
+        "tables": [ # Tables to export, or that were exported, from the specified database. If you specify tables, specify one and only one database.
+          "A String",
+        ],
+        "schemaOnly": True or False, # Export only schemas.
+      },
+    },
+    "startTime": "A String", # The time this operation actually started in UTC timezone in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+    "targetProject": "A String", # The project ID of the target instance related to this operation.
+    "targetId": "A String", # Name of the database instance related to this operation.
+    "operationType": "A String", # The type of the operation. Valid values are CREATE, DELETE, UPDATE, RESTART, IMPORT, EXPORT, BACKUP_VOLUME, RESTORE_VOLUME, CREATE_USER, DELETE_USER, CREATE_DATABASE, DELETE_DATABASE .
+    "targetLink": "A String", # The URI of the instance related to the operation.
+    "insertTime": "A String", # The time this operation was enqueued in UTC timezone in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+    "error": { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be populated.
+      "kind": "sql#operationErrors", # This is always sql#operationErrors.
+      "errors": [ # The list of errors encountered while processing this operation.
+        { # Database instance operation error.
+          "kind": "sql#operationError", # This is always sql#operationError.
+          "code": "A String", # Identifies the specific error that occurred.
+          "message": "A String", # Additional information about the error encountered.
+        },
+      ],
+    },
+    "endTime": "A String", # The time this operation finished in UTC timezone in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+    "selfLink": "A String", # The URI of this resource.
+    "user": "A String", # The email address of the user who initiated this operation.
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="update">update(project, instance, body)</code>
   <pre>Updates settings of a Cloud SQL instance. Caution: This is not a partial update, so you must include values for all the settings that you want to retain. For partial updates, use patch.
@@ -1719,6 +1806,7 @@ <h3>Method Details</h3>
       { # Database instance IP Mapping.
         "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
         "ipAddress": "A String", # The IP address assigned.
+        "type": "A String", # The type of this IP address. A PRIMARY address is an address that can accept incoming connections. An OUTGOING address is the source address of connections originating from the instance, if supported.
       },
     ],
     "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
diff --git a/docs/dyn/sqladmin_v1beta4.tiers.html b/docs/dyn/sqladmin_v1beta4.tiers.html
index b73f236fef2..5c4199e8dad 100644
--- a/docs/dyn/sqladmin_v1beta4.tiers.html
+++ b/docs/dyn/sqladmin_v1beta4.tiers.html
@@ -95,7 +95,7 @@ <h3>Method Details</h3>
         "tier": "A String", # An identifier for the service tier, for example D1, D2 etc. For related information, see Pricing.
         "kind": "sql#tier", # This is always sql#tier.
         "RAM": "A String", # The maximum RAM usage of this tier in bytes.
-        "region": [ # The applicable regions for this tier. Can be us-east1, europe-west1 or asia-east1.
+        "region": [ # The applicable regions for this tier.
           "A String",
         ],
       },
diff --git a/docs/dyn/storage_v1.objects.html b/docs/dyn/storage_v1.objects.html
index 62dc691611e..8502dec137d 100644
--- a/docs/dyn/storage_v1.objects.html
+++ b/docs/dyn/storage_v1.objects.html
@@ -96,10 +96,10 @@ <h2>Instance Methods</h2>
   <code><a href="#get_media">get_media(bucket, object, ifGenerationNotMatch=None, generation=None, ifMetagenerationMatch=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, projection=None)</a></code></p>
 <p class="firstline">Retrieves an object or its metadata.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(bucket, body=None, projection=None, media_body=None, predefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, name=None, ifMetagenerationMatch=None, contentEncoding=None, ifMetagenerationNotMatch=None)</a></code></p>
+  <code><a href="#insert">insert(bucket, body=None, projection=None, media_body=None, predefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, name=None, ifMetagenerationMatch=None, contentEncoding=None, media_mime_type=None, ifMetagenerationNotMatch=None)</a></code></p>
 <p class="firstline">Stores a new object and metadata.</p>
 <p class="toc_element">
-  <code><a href="#insert_media">insert_media(bucket, body=None, projection=None, media_body=None, predefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, name=None, ifMetagenerationMatch=None, contentEncoding=None, ifMetagenerationNotMatch=None)</a></code></p>
+  <code><a href="#insert_media">insert_media(bucket, body=None, projection=None, media_body=None, predefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, name=None, ifMetagenerationMatch=None, contentEncoding=None, media_mime_type=None, ifMetagenerationNotMatch=None)</a></code></p>
 <p class="firstline">Stores a new object and metadata.</p>
 <p class="toc_element">
   <code><a href="#list">list(bucket, projection=None, versions=None, delimiter=None, maxResults=None, pageToken=None, prefix=None)</a></code></p>
@@ -193,6 +193,7 @@ <h3>Method Details</h3>
           "keySha256": "A String", # SHA256 hash value of the encryption key.
         },
         "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+        "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
         "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
         "name": "A String", # The name of this object. Required if not specified by URL parameter.
         "bucket": "A String", # The name of the bucket containing this object.
@@ -284,6 +285,7 @@ <h3>Method Details</h3>
         "keySha256": "A String", # SHA256 hash value of the encryption key.
       },
       "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+      "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
       "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
       "name": "A String", # The name of this object. Required if not specified by URL parameter.
       "bucket": "A String", # The name of the bucket containing this object.
@@ -364,6 +366,7 @@ <h3>Method Details</h3>
           "keySha256": "A String", # SHA256 hash value of the encryption key.
         },
         "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+        "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
         "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
         "name": "A String", # The name of this object. Required if not specified by URL parameter.
         "bucket": "A String", # The name of the bucket containing this object.
@@ -470,6 +473,7 @@ <h3>Method Details</h3>
       "keySha256": "A String", # SHA256 hash value of the encryption key.
     },
     "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+    "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
     "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
     "name": "A String", # The name of this object. Required if not specified by URL parameter.
     "bucket": "A String", # The name of the bucket containing this object.
@@ -562,6 +566,7 @@ <h3>Method Details</h3>
         "keySha256": "A String", # SHA256 hash value of the encryption key.
       },
       "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+      "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
       "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
       "name": "A String", # The name of this object. Required if not specified by URL parameter.
       "bucket": "A String", # The name of the bucket containing this object.
@@ -642,6 +647,7 @@ <h3>Method Details</h3>
       "keySha256": "A String", # SHA256 hash value of the encryption key.
     },
     "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+    "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
     "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
     "name": "A String", # The name of this object. Required if not specified by URL parameter.
     "bucket": "A String", # The name of the bucket containing this object.
@@ -772,6 +778,7 @@ <h3>Method Details</h3>
         "keySha256": "A String", # SHA256 hash value of the encryption key.
       },
       "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+      "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
       "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
       "name": "A String", # The name of this object. Required if not specified by URL parameter.
       "bucket": "A String", # The name of the bucket containing this object.
@@ -806,7 +813,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(bucket, body=None, projection=None, media_body=None, predefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, name=None, ifMetagenerationMatch=None, contentEncoding=None, ifMetagenerationNotMatch=None)</code>
+    <code class="details" id="insert">insert(bucket, body=None, projection=None, media_body=None, predefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, name=None, ifMetagenerationMatch=None, contentEncoding=None, media_mime_type=None, ifMetagenerationNotMatch=None)</code>
   <pre>Stores a new object and metadata.
 
 Args:
@@ -872,6 +879,7 @@ <h3>Method Details</h3>
       "keySha256": "A String", # SHA256 hash value of the encryption key.
     },
     "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+    "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
     "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
     "name": "A String", # The name of this object. Required if not specified by URL parameter.
     "bucket": "A String", # The name of the bucket containing this object.
@@ -899,6 +907,7 @@ <h3>Method Details</h3>
   name: string, Name of the object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.
   ifMetagenerationMatch: string, Makes the operation conditional on whether the object's current metageneration matches the given value.
   contentEncoding: string, If set, sets the contentEncoding property of the final object to this value. Setting this parameter is equivalent to setting the contentEncoding metadata property. This can be useful when uploading an object with uploadType=media to indicate the encoding of the content being uploaded.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   ifMetagenerationNotMatch: string, Makes the operation conditional on whether the object's current metageneration does not match the given value.
 
 Returns:
@@ -962,6 +971,7 @@ <h3>Method Details</h3>
         "keySha256": "A String", # SHA256 hash value of the encryption key.
       },
       "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+      "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
       "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
       "name": "A String", # The name of this object. Required if not specified by URL parameter.
       "bucket": "A String", # The name of the bucket containing this object.
@@ -973,7 +983,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert_media">insert_media(bucket, body=None, projection=None, media_body=None, predefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, name=None, ifMetagenerationMatch=None, contentEncoding=None, ifMetagenerationNotMatch=None)</code>
+    <code class="details" id="insert_media">insert_media(bucket, body=None, projection=None, media_body=None, predefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, name=None, ifMetagenerationMatch=None, contentEncoding=None, media_mime_type=None, ifMetagenerationNotMatch=None)</code>
   <pre>Stores a new object and metadata.
 
 Args:
@@ -1039,6 +1049,7 @@ <h3>Method Details</h3>
       "keySha256": "A String", # SHA256 hash value of the encryption key.
     },
     "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+    "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
     "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
     "name": "A String", # The name of this object. Required if not specified by URL parameter.
     "bucket": "A String", # The name of the bucket containing this object.
@@ -1066,6 +1077,7 @@ <h3>Method Details</h3>
   name: string, Name of the object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.
   ifMetagenerationMatch: string, Makes the operation conditional on whether the object's current metageneration matches the given value.
   contentEncoding: string, If set, sets the contentEncoding property of the final object to this value. Setting this parameter is equivalent to setting the contentEncoding metadata property. This can be useful when uploading an object with uploadType=media to indicate the encoding of the content being uploaded.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   ifMetagenerationNotMatch: string, Makes the operation conditional on whether the object's current metageneration does not match the given value.
 
 Returns:
@@ -1154,6 +1166,7 @@ <h3>Method Details</h3>
             "keySha256": "A String", # SHA256 hash value of the encryption key.
           },
           "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+          "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
           "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
           "name": "A String", # The name of this object. Required if not specified by URL parameter.
           "bucket": "A String", # The name of the bucket containing this object.
@@ -1252,6 +1265,7 @@ <h3>Method Details</h3>
       "keySha256": "A String", # SHA256 hash value of the encryption key.
     },
     "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+    "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
     "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
     "name": "A String", # The name of this object. Required if not specified by URL parameter.
     "bucket": "A String", # The name of the bucket containing this object.
@@ -1340,6 +1354,7 @@ <h3>Method Details</h3>
         "keySha256": "A String", # SHA256 hash value of the encryption key.
       },
       "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+      "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
       "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
       "name": "A String", # The name of this object. Required if not specified by URL parameter.
       "bucket": "A String", # The name of the bucket containing this object.
@@ -1420,6 +1435,7 @@ <h3>Method Details</h3>
       "keySha256": "A String", # SHA256 hash value of the encryption key.
     },
     "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+    "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
     "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
     "name": "A String", # The name of this object. Required if not specified by URL parameter.
     "bucket": "A String", # The name of the bucket containing this object.
@@ -1517,6 +1533,7 @@ <h3>Method Details</h3>
           "keySha256": "A String", # SHA256 hash value of the encryption key.
         },
         "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+        "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
         "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
         "name": "A String", # The name of this object. Required if not specified by URL parameter.
         "bucket": "A String", # The name of the bucket containing this object.
@@ -1599,6 +1616,7 @@ <h3>Method Details</h3>
       "keySha256": "A String", # SHA256 hash value of the encryption key.
     },
     "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+    "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
     "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
     "name": "A String", # The name of this object. Required if not specified by URL parameter.
     "bucket": "A String", # The name of the bucket containing this object.
@@ -1687,6 +1705,7 @@ <h3>Method Details</h3>
         "keySha256": "A String", # SHA256 hash value of the encryption key.
       },
       "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+      "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
       "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
       "name": "A String", # The name of this object. Required if not specified by URL parameter.
       "bucket": "A String", # The name of the bucket containing this object.
@@ -1765,6 +1784,7 @@ <h3>Method Details</h3>
       "keySha256": "A String", # SHA256 hash value of the encryption key.
     },
     "metageneration": "A String", # The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.
+    "timeStorageClassUpdated": "A String", # The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
     "kind": "storage#object", # The kind of item this is. For objects, this is always storage#object.
     "name": "A String", # The name of this object. Required if not specified by URL parameter.
     "bucket": "A String", # The name of the bucket containing this object.
diff --git a/docs/dyn/storage_v1beta1.objects.html b/docs/dyn/storage_v1beta1.objects.html
index c80a39aa2fb..c984fdfb8e4 100644
--- a/docs/dyn/storage_v1beta1.objects.html
+++ b/docs/dyn/storage_v1beta1.objects.html
@@ -84,10 +84,10 @@ <h2>Instance Methods</h2>
   <code><a href="#get_media">get_media(bucket, object, projection=None)</a></code></p>
 <p class="firstline">Retrieves objects or their associated metadata.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(bucket, body=None, media_body=None, name=None, projection=None)</a></code></p>
+  <code><a href="#insert">insert(bucket, body=None, media_body=None, name=None, media_mime_type=None, projection=None)</a></code></p>
 <p class="firstline">Stores new data blobs and associated metadata.</p>
 <p class="toc_element">
-  <code><a href="#insert_media">insert_media(bucket, body=None, media_body=None, name=None, projection=None)</a></code></p>
+  <code><a href="#insert_media">insert_media(bucket, body=None, media_body=None, name=None, media_mime_type=None, projection=None)</a></code></p>
 <p class="firstline">Stores new data blobs and associated metadata.</p>
 <p class="toc_element">
   <code><a href="#list">list(bucket, projection=None, pageToken=None, delimiter=None, prefix=None, max_results=None)</a></code></p>
@@ -202,7 +202,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(bucket, body=None, media_body=None, name=None, projection=None)</code>
+    <code class="details" id="insert">insert(bucket, body=None, media_body=None, name=None, media_mime_type=None, projection=None)</code>
   <pre>Stores new data blobs and associated metadata.
 
 Args:
@@ -264,6 +264,7 @@ <h3>Method Details</h3>
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
   name: string, Name of the object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   projection: string, Set of properties to return. Defaults to no_acl, unless the object resource specifies the acl property, when it defaults to full.
     Allowed values
       full - Include all properties.
@@ -326,7 +327,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert_media">insert_media(bucket, body=None, media_body=None, name=None, projection=None)</code>
+    <code class="details" id="insert_media">insert_media(bucket, body=None, media_body=None, name=None, media_mime_type=None, projection=None)</code>
   <pre>Stores new data blobs and associated metadata.
 
 Args:
@@ -388,6 +389,7 @@ <h3>Method Details</h3>
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
   name: string, Name of the object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   projection: string, Set of properties to return. Defaults to no_acl, unless the object resource specifies the acl property, when it defaults to full.
     Allowed values
       full - Include all properties.
diff --git a/docs/dyn/storage_v1beta2.objects.html b/docs/dyn/storage_v1beta2.objects.html
index 48ecde9ca5b..ad9b48f15a7 100644
--- a/docs/dyn/storage_v1beta2.objects.html
+++ b/docs/dyn/storage_v1beta2.objects.html
@@ -96,10 +96,10 @@ <h2>Instance Methods</h2>
   <code><a href="#get_media">get_media(bucket, object, ifGenerationNotMatch=None, generation=None, ifMetagenerationMatch=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, projection=None)</a></code></p>
 <p class="firstline">Retrieves objects or their associated metadata.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(bucket, body=None, media_body=None, projection=None, ifMetagenerationMatch=None, name=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, ifGenerationNotMatch=None)</a></code></p>
+  <code><a href="#insert">insert(bucket, body=None, media_body=None, projection=None, media_mime_type=None, ifMetagenerationMatch=None, name=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, ifGenerationNotMatch=None)</a></code></p>
 <p class="firstline">Stores new data blobs and associated metadata.</p>
 <p class="toc_element">
-  <code><a href="#insert_media">insert_media(bucket, body=None, media_body=None, projection=None, ifMetagenerationMatch=None, name=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, ifGenerationNotMatch=None)</a></code></p>
+  <code><a href="#insert_media">insert_media(bucket, body=None, media_body=None, projection=None, media_mime_type=None, ifMetagenerationMatch=None, name=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, ifGenerationNotMatch=None)</a></code></p>
 <p class="firstline">Stores new data blobs and associated metadata.</p>
 <p class="toc_element">
   <code><a href="#list">list(bucket, projection=None, versions=None, delimiter=None, maxResults=None, pageToken=None, prefix=None)</a></code></p>
@@ -701,7 +701,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(bucket, body=None, media_body=None, projection=None, ifMetagenerationMatch=None, name=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, ifGenerationNotMatch=None)</code>
+    <code class="details" id="insert">insert(bucket, body=None, media_body=None, projection=None, media_mime_type=None, ifMetagenerationMatch=None, name=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, ifGenerationNotMatch=None)</code>
   <pre>Stores new data blobs and associated metadata.
 
 Args:
@@ -771,6 +771,7 @@ <h3>Method Details</h3>
     Allowed values
       full - Include all properties.
       noAcl - Omit the acl property.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   ifMetagenerationMatch: string, Makes the operation conditional on whether the object's current metageneration matches the given value.
   name: string, Name of the object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any.
   ifGenerationMatch: string, Makes the operation conditional on whether the object's current generation matches the given value.
@@ -839,7 +840,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert_media">insert_media(bucket, body=None, media_body=None, projection=None, ifMetagenerationMatch=None, name=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, ifGenerationNotMatch=None)</code>
+    <code class="details" id="insert_media">insert_media(bucket, body=None, media_body=None, projection=None, media_mime_type=None, ifMetagenerationMatch=None, name=None, ifGenerationMatch=None, ifMetagenerationNotMatch=None, ifGenerationNotMatch=None)</code>
   <pre>Stores new data blobs and associated metadata.
 
 Args:
@@ -909,6 +910,7 @@ <h3>Method Details</h3>
     Allowed values
       full - Include all properties.
       noAcl - Omit the acl property.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   ifMetagenerationMatch: string, Makes the operation conditional on whether the object's current metageneration matches the given value.
   name: string, Name of the object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any.
   ifGenerationMatch: string, Makes the operation conditional on whether the object's current generation matches the given value.
diff --git a/docs/dyn/surveys_v2.surveys.html b/docs/dyn/surveys_v2.surveys.html
index 13016b58c14..7d259bb5b30 100644
--- a/docs/dyn/surveys_v2.surveys.html
+++ b/docs/dyn/surveys_v2.surveys.html
@@ -184,9 +184,9 @@ <h3>Method Details</h3>
         },
       ],
       "wantedResponseCount": 42, # Number of responses desired for the survey.
-      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
+      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is rejected.
         "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-        "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+        "type": "A String", # Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.
       },
     }</pre>
 </div>
@@ -262,9 +262,9 @@ <h3>Method Details</h3>
       },
     ],
     "wantedResponseCount": 42, # Number of responses desired for the survey.
-    "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
+    "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is rejected.
       "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-      "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+      "type": "A String", # Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.
     },
   }
 
@@ -335,9 +335,9 @@ <h3>Method Details</h3>
         },
       ],
       "wantedResponseCount": 42, # Number of responses desired for the survey.
-      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
+      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is rejected.
         "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-        "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+        "type": "A String", # Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.
       },
     }</pre>
 </div>
@@ -428,9 +428,9 @@ <h3>Method Details</h3>
             },
           ],
           "wantedResponseCount": 42, # Number of responses desired for the survey.
-          "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
+          "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is rejected.
             "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-            "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+            "type": "A String", # Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.
           },
         },
     ],
@@ -519,9 +519,9 @@ <h3>Method Details</h3>
           },
         ],
         "wantedResponseCount": 42, # Number of responses desired for the survey.
-        "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
+        "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is rejected.
           "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-          "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+          "type": "A String", # Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.
         },
       },
     "requestId": "A String", # Unique request ID used for logging and debugging. Please include in any error reporting or troubleshooting requests.
@@ -602,9 +602,9 @@ <h3>Method Details</h3>
           },
         ],
         "wantedResponseCount": 42, # Number of responses desired for the survey.
-        "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
+        "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is rejected.
           "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-          "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+          "type": "A String", # Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.
         },
       },
     "requestId": "A String", # Unique request ID used for logging and debugging. Please include in any error reporting or troubleshooting requests.
@@ -683,9 +683,9 @@ <h3>Method Details</h3>
       },
     ],
     "wantedResponseCount": 42, # Number of responses desired for the survey.
-    "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
+    "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is rejected.
       "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-      "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+      "type": "A String", # Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.
     },
   }
 
@@ -756,9 +756,9 @@ <h3>Method Details</h3>
         },
       ],
       "wantedResponseCount": 42, # Number of responses desired for the survey.
-      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is 'rejected'.
+      "rejectionReason": { # Message representing why the survey was rejected from review, if it was. # Reason for the survey being rejected. Only present if the survey state is rejected.
         "explanation": "A String", # A human-readable explanation of what was wrong with the survey.
-        "type": "A String", # Which category of rejection this was. See the GCS Help Center for additional details on each category.
+        "type": "A String", # Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.
       },
     }</pre>
 </div>
diff --git a/docs/dyn/vision_v1.images.html b/docs/dyn/vision_v1.images.html
index 7f5d55a9a79..7db68f00025 100644
--- a/docs/dyn/vision_v1.images.html
+++ b/docs/dyn/vision_v1.images.html
@@ -90,8 +90,8 @@ <h3>Method Details</h3>
     "requests": [ # Individual image annotation requests for this batch.
       { # Request for performing Google Cloud Vision API tasks over a user-provided
           # image, with user-requested features.
-        "imageContext": { # Image context. # Additional context that may accompany the image.
-          "latLongRect": { # Rectangle determined by min and max LatLng pairs. # Lat/long rectangle that specifies the location of the image.
+        "imageContext": { # Image context and/or feature-specific parameters. # Additional context that may accompany the image.
+          "latLongRect": { # Rectangle determined by min and max `LatLng` pairs. # lat/long rectangle that specifies the location of the image.
             "minLatLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Min lat/long pair.
                 # of doubles representing degrees latitude and degrees longitude. Unless
                 # specified otherwise, this must conform to the
@@ -184,8 +184,7 @@ <h3>Method Details</h3>
               # setting a hint will help get better results (although it will be a
               # significant hindrance if the hint is wrong). Text detection returns an
               # error if one or more of the specified languages is not one of the
-              # [supported
-              # languages](/translate/v2/translate-reference#supported_languages).
+              # [supported languages](/vision/docs/languages).
             "A String",
           ],
         },
@@ -193,19 +192,19 @@ <h3>Method Details</h3>
           "content": "A String", # Image content, represented as a stream of bytes.
               # Note: as with all `bytes` fields, protobuffers use a pure binary
               # representation, whereas JSON representations use base64.
-          "source": { # External image source (Google Cloud Storage image location). # Google Cloud Storage image location. If both 'content' and 'source'
-              # are filled for an image, 'content' takes precedence and it will be
-              # used for performing the image annotation request.
-            "gcsImageUri": "A String", # Google Cloud Storage image URI. It must be in the following form:
-                # `gs://bucket_name/object_name`. For more
-                # details, please see: https://cloud.google.com/storage/docs/reference-uris.
-                # NOTE: Cloud Storage object versioning is not supported!
+          "source": { # External image source (Google Cloud Storage image location). # Google Cloud Storage image location. If both `content` and `source`
+              # are provided for an image, `content` takes precedence and is
+              # used to perform the image annotation request.
+            "gcsImageUri": "A String", # Google Cloud Storage image URI, which must be in the following form:
+                # `gs://bucket_name/object_name` (for details, see
+                # [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris)).
+                # NOTE: Cloud Storage object versioning is not supported.
           },
         },
         "features": [ # Requested features.
-          { # The <em>Feature</em> indicates what type of image detection task to perform.
-              # Users describe the type of Google Cloud Vision API tasks to perform over
-              # images by using <em>Feature</em>s. Features encode the Cloud Vision API
+          { # Users describe the type of Google Cloud Vision API tasks to perform over
+              # images by using *Feature*s. Each Feature indicates a type of image
+              # detection task to perform. Features encode the Cloud Vision API
               # vertical to operate on and the number of top-scoring results to return.
             "type": "A String", # The feature type.
             "maxResults": 42, # Maximum number of results of this type.
@@ -226,39 +225,37 @@ <h3>Method Details</h3>
     { # Response to a batch image annotation request.
     "responses": [ # Individual responses to image annotation requests within the batch.
       { # Response to an image annotation request.
-        "safeSearchAnnotation": { # Set of features pertaining to the image, computed by various computer vision # If present, safe-search annotation completed successfully.
-            # methods over safe-search verticals (for example, adult, spoof, medical,
-            # violence).
-          "medical": "A String", # Likelihood this is a medical image.
+        "safeSearchAnnotation": { # If present, safe-search annotation has completed successfully.
+          "medical": "A String", # Likelihood that this is a medical image.
           "violence": "A String", # Violence likelihood.
-          "spoof": "A String", # Spoof likelihood. The likelihood that an obvious modification
+          "spoof": "A String", # Spoof likelihood. The likelihood that an modification
               # was made to the image's canonical version to make it appear
               # funny or offensive.
-          "adult": "A String", # Represents the adult contents likelihood for the image.
+          "adult": "A String", # Represents the adult content likelihood for the image.
         },
-        "textAnnotations": [ # If present, text (OCR) detection completed successfully.
+        "textAnnotations": [ # If present, text (OCR) detection has completed successfully.
           { # Set of detected entity features.
             "confidence": 3.14, # The accuracy of the entity detection in an image.
-                # For example, for an image containing 'Eiffel Tower,' this field represents
-                # the confidence that there is a tower in the query image. Range [0, 1].
-            "description": "A String", # Entity textual description, expressed in its <code>locale</code> language.
+                # For example, for an image in which the "Eiffel Tower" entity is detected,
+                # this field represents the confidence that there is a tower in the query
+                # image. Range [0, 1].
+            "description": "A String", # Entity textual description, expressed in its `locale` language.
             "locale": "A String", # The language code for the locale in which the entity textual
-                # <code>description</code> (next field) is expressed.
+                # `description` is expressed.
             "topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the
-                # image. For example, the relevancy of 'tower' to an image containing
-                # 'Eiffel Tower' is likely higher than an image containing a distant towering
-                # building, though the confidence that there is a tower may be the same.
-                # Range [0, 1].
-            "mid": "A String", # Opaque entity ID. Some IDs might be available in Knowledge Graph(KG).
-                # For more details on KG please see:
-                # https://developers.google.com/knowledge-graph/
+                # image. For example, the relevancy of "tower" is likely higher to an image
+                # containing the detected "Eiffel Tower" than to an image containing a
+                # detected distant towering building, even though the confidence that
+                # there is a tower in each image may be the same. Range [0, 1].
+            "mid": "A String", # Opaque entity ID. Some IDs may be available in
+                # [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/).
             "locations": [ # The location information for the detected entity. Multiple
-                # <code>LocationInfo</code> elements can be present since one location may
-                # indicate the location of the scene in the query image, and another the
-                # location of the place where the query image was taken. Location information
-                # is usually present for landmarks.
+                # `LocationInfo` elements can be present because one location may
+                # indicate the location of the scene in the image, and another location
+                # may indicate the location of the place where the image was taken.
+                # Location information is usually present for landmarks.
               { # Detected entity location information.
-                "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Lat - long location coordinates.
+                "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.
                     # of doubles representing degrees latitude and degrees longitude. Unless
                     # specified otherwise, this must conform to the
                     # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
@@ -303,7 +300,7 @@ <h3>Method Details</h3>
               },
             ],
             "score": 3.14, # Overall score of the result. Range [0, 1].
-            "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not filled currently
+            "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Currently not produced
                 # for `LABEL_DETECTION` features. For `TEXT_DETECTION` (OCR), `boundingPoly`s
                 # are produced for the entire text detected in an image region, followed by
                 # `boundingPoly`s for each word within the detected text.
@@ -315,38 +312,38 @@ <h3>Method Details</h3>
                 },
               ],
             },
-            "properties": [ # Some entities can have additional optional <code>Property</code> fields.
-                # For example a different kind of score or string that qualifies the entity.
-              { # Arbitrary name/value pair.
+            "properties": [ # Some entities may have optional user-supplied `Property` (name/value)
+                # fields, such a score or string that qualifies the entity.
+              { # A `Property` consists of a user-supplied name/value pair.
                 "name": "A String", # Name of the property.
                 "value": "A String", # Value of the property.
               },
             ],
           },
         ],
-        "labelAnnotations": [ # If present, label detection completed successfully.
+        "labelAnnotations": [ # If present, label detection has completed successfully.
           { # Set of detected entity features.
             "confidence": 3.14, # The accuracy of the entity detection in an image.
-                # For example, for an image containing 'Eiffel Tower,' this field represents
-                # the confidence that there is a tower in the query image. Range [0, 1].
-            "description": "A String", # Entity textual description, expressed in its <code>locale</code> language.
+                # For example, for an image in which the "Eiffel Tower" entity is detected,
+                # this field represents the confidence that there is a tower in the query
+                # image. Range [0, 1].
+            "description": "A String", # Entity textual description, expressed in its `locale` language.
             "locale": "A String", # The language code for the locale in which the entity textual
-                # <code>description</code> (next field) is expressed.
+                # `description` is expressed.
             "topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the
-                # image. For example, the relevancy of 'tower' to an image containing
-                # 'Eiffel Tower' is likely higher than an image containing a distant towering
-                # building, though the confidence that there is a tower may be the same.
-                # Range [0, 1].
-            "mid": "A String", # Opaque entity ID. Some IDs might be available in Knowledge Graph(KG).
-                # For more details on KG please see:
-                # https://developers.google.com/knowledge-graph/
+                # image. For example, the relevancy of "tower" is likely higher to an image
+                # containing the detected "Eiffel Tower" than to an image containing a
+                # detected distant towering building, even though the confidence that
+                # there is a tower in each image may be the same. Range [0, 1].
+            "mid": "A String", # Opaque entity ID. Some IDs may be available in
+                # [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/).
             "locations": [ # The location information for the detected entity. Multiple
-                # <code>LocationInfo</code> elements can be present since one location may
-                # indicate the location of the scene in the query image, and another the
-                # location of the place where the query image was taken. Location information
-                # is usually present for landmarks.
+                # `LocationInfo` elements can be present because one location may
+                # indicate the location of the scene in the image, and another location
+                # may indicate the location of the place where the image was taken.
+                # Location information is usually present for landmarks.
               { # Detected entity location information.
-                "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Lat - long location coordinates.
+                "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.
                     # of doubles representing degrees latitude and degrees longitude. Unless
                     # specified otherwise, this must conform to the
                     # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
@@ -391,7 +388,7 @@ <h3>Method Details</h3>
               },
             ],
             "score": 3.14, # Overall score of the result. Range [0, 1].
-            "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not filled currently
+            "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Currently not produced
                 # for `LABEL_DETECTION` features. For `TEXT_DETECTION` (OCR), `boundingPoly`s
                 # are produced for the entire text detected in an image region, followed by
                 # `boundingPoly`s for each word within the detected text.
@@ -403,20 +400,20 @@ <h3>Method Details</h3>
                 },
               ],
             },
-            "properties": [ # Some entities can have additional optional <code>Property</code> fields.
-                # For example a different kind of score or string that qualifies the entity.
-              { # Arbitrary name/value pair.
+            "properties": [ # Some entities may have optional user-supplied `Property` (name/value)
+                # fields, such a score or string that qualifies the entity.
+              { # A `Property` consists of a user-supplied name/value pair.
                 "name": "A String", # Name of the property.
                 "value": "A String", # Value of the property.
               },
             ],
           },
         ],
-        "imagePropertiesAnnotation": { # Stores image properties (e.g. dominant colors). # If present, image properties were extracted successfully.
+        "imagePropertiesAnnotation": { # Stores image properties, such as dominant colors. # If present, image properties were extracted successfully.
           "dominantColors": { # Set of dominant colors and their corresponding scores. # If present, dominant colors completed successfully.
-            "colors": [ # RGB color values, with their score and pixel fraction.
-              { # Color information consists of RGB channels, score and fraction of
-                  # image the color occupies in the image.
+            "colors": [ # RGB color values with their score and pixel fraction.
+              { # Color information consists of RGB channels, score, and the fraction of
+                  # the image that the color occupies in the image.
                 "color": { # Represents a color in the RGBA color space. This representation is designed # RGB components of the color.
                     # for simplicity of conversion to/from color representations in various
                     # languages over compactness; for example, the fields of this representation
@@ -546,17 +543,17 @@ <h3>Method Details</h3>
                   "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
                   "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
                 },
-                "pixelFraction": 3.14, # Stores the fraction of pixels the color occupies in the image.
+                "pixelFraction": 3.14, # The fraction of pixels the color occupies in the image.
                     # Value in range [0, 1].
                 "score": 3.14, # Image-specific score for this color. Value in range [0, 1].
               },
             ],
           },
         },
-        "faceAnnotations": [ # If present, face detection completed successfully.
+        "faceAnnotations": [ # If present, face detection has completed successfully.
           { # A face annotation object contains the results of face detection.
-            "panAngle": 3.14, # Yaw angle. Indicates the leftward/rightward angle that the face is
-                # pointing, relative to the vertical plane perpendicular to the image. Range
+            "panAngle": 3.14, # Yaw angle, which indicates the leftward/rightward angle that the face is
+                # pointing relative to the vertical plane perpendicular to the image. Range
                 # [-180,180].
             "sorrowLikelihood": "A String", # Sorrow likelihood.
             "underExposedLikelihood": "A String", # Under-exposed likelihood.
@@ -565,8 +562,9 @@ <h3>Method Details</h3>
             "landmarks": [ # Detected face landmarks.
               { # A face-specific landmark (for example, a face feature).
                   # Landmark positions may fall outside the bounds of the image
-                  # when the face is near one or more edges of the image.
-                  # Therefore it is NOT guaranteed that 0 <= x < width or 0 <= y < height.
+                  # if the face is near one or more edges of the image.
+                  # Therefore it is NOT guaranteed that `0 <= x < width` or
+                  # `0 <= y < height`.
                 "position": { # A 3D position in the image, used primarily for Face detection landmarks. # Face landmark position.
                     # A valid Position must have both x and y coordinates.
                     # The position coordinates are in the same scale as the original image.
@@ -579,17 +577,16 @@ <h3>Method Details</h3>
             ],
             "surpriseLikelihood": "A String", # Surprise likelihood.
             "blurredLikelihood": "A String", # Blurred likelihood.
-            "tiltAngle": 3.14, # Pitch angle. Indicates the upwards/downwards angle that the face is
-                # pointing
-                # relative to the image's horizontal plane. Range [-180,180].
+            "tiltAngle": 3.14, # Pitch angle, which indicates the upwards/downwards angle that the face is
+                # pointing relative to the image's horizontal plane. Range [-180,180].
             "angerLikelihood": "A String", # Anger likelihood.
             "boundingPoly": { # A bounding polygon for the detected image annotation. # The bounding polygon around the face. The coordinates of the bounding box
-                # are in the original image's scale, as returned in ImageParams.
+                # are in the original image's scale, as returned in `ImageParams`.
                 # The bounding box is computed to "frame" the face in accordance with human
                 # expectations. It is based on the landmarker results.
                 # Note that one or more x and/or y coordinates may not be generated in the
-                # BoundingPoly (the polygon will be unbounded) if only a partial face appears in
-                # the image to be annotated.
+                # `BoundingPoly` (the polygon will be unbounded) if only a partial face
+                # appears in the image to be annotated.
               "vertices": [ # The bounding polygon vertices.
                 { # A vertex represents a 2D point in the image.
                     # NOTE: the vertex coordinates are in the same scale as the original image.
@@ -598,15 +595,13 @@ <h3>Method Details</h3>
                 },
               ],
             },
-            "rollAngle": 3.14, # Roll angle. Indicates the amount of clockwise/anti-clockwise rotation of
-                # the
-                # face relative to the image vertical, about the axis perpendicular to the
-                # face. Range [-180,180].
+            "rollAngle": 3.14, # Roll angle, which indicates the amount of clockwise/anti-clockwise rotation
+                # of the face relative to the image vertical about the axis perpendicular to
+                # the face. Range [-180,180].
             "headwearLikelihood": "A String", # Headwear likelihood.
-            "fdBoundingPoly": { # A bounding polygon for the detected image annotation. # This bounding polygon is tighter than the previous
-                # <code>boundingPoly</code>, and
-                # encloses only the skin part of the face. Typically, it is used to
-                # eliminate the face from any image analysis that detects the
+            "fdBoundingPoly": { # A bounding polygon for the detected image annotation. # The `fd_bounding_poly` bounding polygon is tighter than the
+                # `boundingPoly`, and encloses only the skin part of the face. Typically, it
+                # is used to eliminate the face from any image analysis that detects the
                 # "amount of skin" visible in an image. It is not based on the
                 # landmarker results, only on the initial face detection, hence
                 # the <code>fd</code> (face detection) prefix.
@@ -621,29 +616,29 @@ <h3>Method Details</h3>
             "landmarkingConfidence": 3.14, # Face landmarking confidence. Range [0, 1].
           },
         ],
-        "logoAnnotations": [ # If present, logo detection completed successfully.
+        "logoAnnotations": [ # If present, logo detection has completed successfully.
           { # Set of detected entity features.
             "confidence": 3.14, # The accuracy of the entity detection in an image.
-                # For example, for an image containing 'Eiffel Tower,' this field represents
-                # the confidence that there is a tower in the query image. Range [0, 1].
-            "description": "A String", # Entity textual description, expressed in its <code>locale</code> language.
+                # For example, for an image in which the "Eiffel Tower" entity is detected,
+                # this field represents the confidence that there is a tower in the query
+                # image. Range [0, 1].
+            "description": "A String", # Entity textual description, expressed in its `locale` language.
             "locale": "A String", # The language code for the locale in which the entity textual
-                # <code>description</code> (next field) is expressed.
+                # `description` is expressed.
             "topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the
-                # image. For example, the relevancy of 'tower' to an image containing
-                # 'Eiffel Tower' is likely higher than an image containing a distant towering
-                # building, though the confidence that there is a tower may be the same.
-                # Range [0, 1].
-            "mid": "A String", # Opaque entity ID. Some IDs might be available in Knowledge Graph(KG).
-                # For more details on KG please see:
-                # https://developers.google.com/knowledge-graph/
+                # image. For example, the relevancy of "tower" is likely higher to an image
+                # containing the detected "Eiffel Tower" than to an image containing a
+                # detected distant towering building, even though the confidence that
+                # there is a tower in each image may be the same. Range [0, 1].
+            "mid": "A String", # Opaque entity ID. Some IDs may be available in
+                # [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/).
             "locations": [ # The location information for the detected entity. Multiple
-                # <code>LocationInfo</code> elements can be present since one location may
-                # indicate the location of the scene in the query image, and another the
-                # location of the place where the query image was taken. Location information
-                # is usually present for landmarks.
+                # `LocationInfo` elements can be present because one location may
+                # indicate the location of the scene in the image, and another location
+                # may indicate the location of the place where the image was taken.
+                # Location information is usually present for landmarks.
               { # Detected entity location information.
-                "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Lat - long location coordinates.
+                "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.
                     # of doubles representing degrees latitude and degrees longitude. Unless
                     # specified otherwise, this must conform to the
                     # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
@@ -688,7 +683,7 @@ <h3>Method Details</h3>
               },
             ],
             "score": 3.14, # Overall score of the result. Range [0, 1].
-            "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not filled currently
+            "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Currently not produced
                 # for `LABEL_DETECTION` features. For `TEXT_DETECTION` (OCR), `boundingPoly`s
                 # are produced for the entire text detected in an image region, followed by
                 # `boundingPoly`s for each word within the detected text.
@@ -700,38 +695,38 @@ <h3>Method Details</h3>
                 },
               ],
             },
-            "properties": [ # Some entities can have additional optional <code>Property</code> fields.
-                # For example a different kind of score or string that qualifies the entity.
-              { # Arbitrary name/value pair.
+            "properties": [ # Some entities may have optional user-supplied `Property` (name/value)
+                # fields, such a score or string that qualifies the entity.
+              { # A `Property` consists of a user-supplied name/value pair.
                 "name": "A String", # Name of the property.
                 "value": "A String", # Value of the property.
               },
             ],
           },
         ],
-        "landmarkAnnotations": [ # If present, landmark detection completed successfully.
+        "landmarkAnnotations": [ # If present, landmark detection has completed successfully.
           { # Set of detected entity features.
             "confidence": 3.14, # The accuracy of the entity detection in an image.
-                # For example, for an image containing 'Eiffel Tower,' this field represents
-                # the confidence that there is a tower in the query image. Range [0, 1].
-            "description": "A String", # Entity textual description, expressed in its <code>locale</code> language.
+                # For example, for an image in which the "Eiffel Tower" entity is detected,
+                # this field represents the confidence that there is a tower in the query
+                # image. Range [0, 1].
+            "description": "A String", # Entity textual description, expressed in its `locale` language.
             "locale": "A String", # The language code for the locale in which the entity textual
-                # <code>description</code> (next field) is expressed.
+                # `description` is expressed.
             "topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the
-                # image. For example, the relevancy of 'tower' to an image containing
-                # 'Eiffel Tower' is likely higher than an image containing a distant towering
-                # building, though the confidence that there is a tower may be the same.
-                # Range [0, 1].
-            "mid": "A String", # Opaque entity ID. Some IDs might be available in Knowledge Graph(KG).
-                # For more details on KG please see:
-                # https://developers.google.com/knowledge-graph/
+                # image. For example, the relevancy of "tower" is likely higher to an image
+                # containing the detected "Eiffel Tower" than to an image containing a
+                # detected distant towering building, even though the confidence that
+                # there is a tower in each image may be the same. Range [0, 1].
+            "mid": "A String", # Opaque entity ID. Some IDs may be available in
+                # [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/).
             "locations": [ # The location information for the detected entity. Multiple
-                # <code>LocationInfo</code> elements can be present since one location may
-                # indicate the location of the scene in the query image, and another the
-                # location of the place where the query image was taken. Location information
-                # is usually present for landmarks.
+                # `LocationInfo` elements can be present because one location may
+                # indicate the location of the scene in the image, and another location
+                # may indicate the location of the place where the image was taken.
+                # Location information is usually present for landmarks.
               { # Detected entity location information.
-                "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Lat - long location coordinates.
+                "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.
                     # of doubles representing degrees latitude and degrees longitude. Unless
                     # specified otherwise, this must conform to the
                     # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
@@ -776,7 +771,7 @@ <h3>Method Details</h3>
               },
             ],
             "score": 3.14, # Overall score of the result. Range [0, 1].
-            "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not filled currently
+            "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Currently not produced
                 # for `LABEL_DETECTION` features. For `TEXT_DETECTION` (OCR), `boundingPoly`s
                 # are produced for the entire text detected in an image region, followed by
                 # `boundingPoly`s for each word within the detected text.
@@ -788,9 +783,9 @@ <h3>Method Details</h3>
                 },
               ],
             },
-            "properties": [ # Some entities can have additional optional <code>Property</code> fields.
-                # For example a different kind of score or string that qualifies the entity.
-              { # Arbitrary name/value pair.
+            "properties": [ # Some entities may have optional user-supplied `Property` (name/value)
+                # fields, such a score or string that qualifies the entity.
+              { # A `Property` consists of a user-supplied name/value pair.
                 "name": "A String", # Name of the property.
                 "value": "A String", # Value of the property.
               },
@@ -798,8 +793,8 @@ <h3>Method Details</h3>
           },
         ],
         "error": { # The `Status` type defines a logical error model that is suitable for different # If set, represents the error message for the operation.
-            # Note that filled-in mage annotations are guaranteed to be
-            # correct, even when <code>error</code> is non-empty.
+            # Note that filled-in image annotations are guaranteed to be
+            # correct, even when `error` is set.
             # programming environments, including REST APIs and RPC APIs. It is used by
             # [gRPC](https://github.com/grpc). The error model is designed to be:
             #
diff --git a/docs/dyn/youtubeAnalytics_v1.html b/docs/dyn/youtubeAnalytics_v1.html
index 5584c1ab687..329db8878e0 100644
--- a/docs/dyn/youtubeAnalytics_v1.html
+++ b/docs/dyn/youtubeAnalytics_v1.html
@@ -74,16 +74,6 @@
 
 <h1><a href="youtubeAnalytics_v1.html">YouTube Analytics API</a></h1>
 <h2>Instance Methods</h2>
-<p class="toc_element">
-  <code><a href="youtubeAnalytics_v1.batchReportDefinitions.html">batchReportDefinitions()</a></code>
-</p>
-<p class="firstline">Returns the batchReportDefinitions Resource.</p>
-
-<p class="toc_element">
-  <code><a href="youtubeAnalytics_v1.batchReports.html">batchReports()</a></code>
-</p>
-<p class="firstline">Returns the batchReports Resource.</p>
-
 <p class="toc_element">
   <code><a href="youtubeAnalytics_v1.groupItems.html">groupItems()</a></code>
 </p>
diff --git a/docs/dyn/youtubeAnalytics_v1beta1.html b/docs/dyn/youtubeAnalytics_v1beta1.html
index 0e3e33ad941..9609ae2c993 100644
--- a/docs/dyn/youtubeAnalytics_v1beta1.html
+++ b/docs/dyn/youtubeAnalytics_v1beta1.html
@@ -74,16 +74,6 @@
 
 <h1><a href="youtubeAnalytics_v1beta1.html">YouTube Analytics API</a></h1>
 <h2>Instance Methods</h2>
-<p class="toc_element">
-  <code><a href="youtubeAnalytics_v1beta1.batchReportDefinitions.html">batchReportDefinitions()</a></code>
-</p>
-<p class="firstline">Returns the batchReportDefinitions Resource.</p>
-
-<p class="toc_element">
-  <code><a href="youtubeAnalytics_v1beta1.batchReports.html">batchReports()</a></code>
-</p>
-<p class="firstline">Returns the batchReports Resource.</p>
-
 <p class="toc_element">
   <code><a href="youtubeAnalytics_v1beta1.groupItems.html">groupItems()</a></code>
 </p>
diff --git a/docs/dyn/youtube_v3.captions.html b/docs/dyn/youtube_v3.captions.html
index ecbae0f47fb..6b5ec67cebd 100644
--- a/docs/dyn/youtube_v3.captions.html
+++ b/docs/dyn/youtube_v3.captions.html
@@ -84,13 +84,13 @@ <h2>Instance Methods</h2>
   <code><a href="#download_media">download_media(id, onBehalfOf=None, tlang=None, onBehalfOfContentOwner=None, tfmt=None)</a></code></p>
 <p class="firstline">Downloads a caption track. The caption track is returned in its original format unless the request specifies a value for the tfmt parameter and in its original language unless the request specifies a value for the tlang parameter.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(part, body=None, media_body=None, onBehalfOf=None, sync=None, onBehalfOfContentOwner=None)</a></code></p>
+  <code><a href="#insert">insert(part, body=None, media_body=None, onBehalfOf=None, media_mime_type=None, sync=None, onBehalfOfContentOwner=None)</a></code></p>
 <p class="firstline">Uploads a caption track.</p>
 <p class="toc_element">
   <code><a href="#list">list(part, videoId, onBehalfOf=None, onBehalfOfContentOwner=None, id=None)</a></code></p>
 <p class="firstline">Returns a list of caption tracks that are associated with a specified video. Note that the API response does not contain the actual captions and that the captions.download method provides the ability to retrieve a caption track.</p>
 <p class="toc_element">
-  <code><a href="#update">update(part, body=None, media_body=None, onBehalfOf=None, sync=None, onBehalfOfContentOwner=None)</a></code></p>
+  <code><a href="#update">update(part, body=None, media_body=None, onBehalfOf=None, media_mime_type=None, sync=None, onBehalfOfContentOwner=None)</a></code></p>
 <p class="firstline">Updates a caption track. When updating a caption track, you can change the track's draft status, upload a new caption file for the track, or both.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -149,7 +149,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(part, body=None, media_body=None, onBehalfOf=None, sync=None, onBehalfOfContentOwner=None)</code>
+    <code class="details" id="insert">insert(part, body=None, media_body=None, onBehalfOf=None, media_mime_type=None, sync=None, onBehalfOfContentOwner=None)</code>
   <pre>Uploads a caption track.
 
 Args:
@@ -180,6 +180,7 @@ <h3>Method Details</h3>
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
   onBehalfOf: string, ID of the Google+ Page for the channel that the request is be on behalf of
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   sync: boolean, The sync parameter indicates whether YouTube should automatically synchronize the caption file with the audio track of the video. If you set the value to true, YouTube will disregard any time codes that are in the uploaded caption file and generate new time codes for the captions.
 
 You should set the sync parameter to true if you are uploading a transcript, which has no time codes, or if you suspect the time codes in your file are incorrect and want YouTube to try to fix them.
@@ -259,7 +260,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(part, body=None, media_body=None, onBehalfOf=None, sync=None, onBehalfOfContentOwner=None)</code>
+    <code class="details" id="update">update(part, body=None, media_body=None, onBehalfOf=None, media_mime_type=None, sync=None, onBehalfOfContentOwner=None)</code>
   <pre>Updates a caption track. When updating a caption track, you can change the track's draft status, upload a new caption file for the track, or both.
 
 Args:
@@ -290,6 +291,7 @@ <h3>Method Details</h3>
 
   media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
   onBehalfOf: string, ID of the Google+ Page for the channel that the request is be on behalf of
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   sync: boolean, Note: The API server only processes the parameter value if the request contains an updated caption file.
 
 The sync parameter indicates whether YouTube should automatically synchronize the caption file with the audio track of the video. If you set the value to true, YouTube will automatically synchronize the caption track with the audio track.
diff --git a/docs/dyn/youtube_v3.channelBanners.html b/docs/dyn/youtube_v3.channelBanners.html
index 029b80ef17e..d1254e37486 100644
--- a/docs/dyn/youtube_v3.channelBanners.html
+++ b/docs/dyn/youtube_v3.channelBanners.html
@@ -75,11 +75,11 @@
 <h1><a href="youtube_v3.html">YouTube Data API</a> . <a href="youtube_v3.channelBanners.html">channelBanners</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#insert">insert(body=None, media_body=None, onBehalfOfContentOwner=None)</a></code></p>
+  <code><a href="#insert">insert(body=None, media_body=None, onBehalfOfContentOwner=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Uploads a channel banner image to YouTube. This method represents the first two steps in a three-step process to update the banner image for a channel:</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="insert">insert(body=None, media_body=None, onBehalfOfContentOwner=None)</code>
+    <code class="details" id="insert">insert(body=None, media_body=None, onBehalfOfContentOwner=None, media_mime_type=None)</code>
   <pre>Uploads a channel banner image to YouTube. This method represents the first two steps in a three-step process to update the banner image for a channel:
 
 - Call the channelBanners.insert method to upload the binary image data to YouTube. The image must have a 16:9 aspect ratio and be at least 2120x1192 pixels.
@@ -100,6 +100,7 @@ <h3>Method Details</h3>
   onBehalfOfContentOwner: string, Note: This parameter is intended exclusively for YouTube content partners.
 
 The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/youtube_v3.channels.html b/docs/dyn/youtube_v3.channels.html
index 05d1ed3646c..b0d359e2e1a 100644
--- a/docs/dyn/youtube_v3.channels.html
+++ b/docs/dyn/youtube_v3.channels.html
@@ -176,7 +176,6 @@ <h3>Method Details</h3>
             "favorites": "A String", # The ID of the playlist that contains the channel"s favorite videos. Use the  playlistItems.insert and  playlistItems.delete to add or remove items from that list.
             "uploads": "A String", # The ID of the playlist that contains the channel"s uploaded videos. Use the  videos.insert method to upload new videos and the videos.delete method to delete previously uploaded videos.
           },
-          "googlePlusUserId": "A String", # The googlePlusUserId object identifies the Google+ profile ID associated with this channel.
         },
         "brandingSettings": { # Branding properties of a YouTube channel. # The brandingSettings object encapsulates information about the branding of the channel.
           "image": { # Branding properties for images associated with the channel. # Branding properties for branding images.
@@ -449,7 +448,6 @@ <h3>Method Details</h3>
       "favorites": "A String", # The ID of the playlist that contains the channel"s favorite videos. Use the  playlistItems.insert and  playlistItems.delete to add or remove items from that list.
       "uploads": "A String", # The ID of the playlist that contains the channel"s uploaded videos. Use the  videos.insert method to upload new videos and the videos.delete method to delete previously uploaded videos.
     },
-    "googlePlusUserId": "A String", # The googlePlusUserId object identifies the Google+ profile ID associated with this channel.
   },
   "brandingSettings": { # Branding properties of a YouTube channel. # The brandingSettings object encapsulates information about the branding of the channel.
     "image": { # Branding properties for images associated with the channel. # Branding properties for branding images.
@@ -689,7 +687,6 @@ <h3>Method Details</h3>
         "favorites": "A String", # The ID of the playlist that contains the channel"s favorite videos. Use the  playlistItems.insert and  playlistItems.delete to add or remove items from that list.
         "uploads": "A String", # The ID of the playlist that contains the channel"s uploaded videos. Use the  videos.insert method to upload new videos and the videos.delete method to delete previously uploaded videos.
       },
-      "googlePlusUserId": "A String", # The googlePlusUserId object identifies the Google+ profile ID associated with this channel.
     },
     "brandingSettings": { # Branding properties of a YouTube channel. # The brandingSettings object encapsulates information about the branding of the channel.
       "image": { # Branding properties for images associated with the channel. # Branding properties for branding images.
diff --git a/docs/dyn/youtube_v3.commentThreads.html b/docs/dyn/youtube_v3.commentThreads.html
index bc90f1358fd..2bacbc2dcce 100644
--- a/docs/dyn/youtube_v3.commentThreads.html
+++ b/docs/dyn/youtube_v3.commentThreads.html
@@ -119,7 +119,6 @@ <h3>Method Details</h3>
           "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
           "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
           "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-          "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
           "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
         },
         "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -148,7 +147,6 @@ <h3>Method Details</h3>
             "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
             "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
             "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-            "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
             "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
           },
           "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -186,7 +184,6 @@ <h3>Method Details</h3>
             "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
             "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
             "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-            "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
             "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
           },
           "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -215,7 +212,6 @@ <h3>Method Details</h3>
               "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
               "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
               "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-              "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
               "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
             },
             "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -296,7 +292,6 @@ <h3>Method Details</h3>
                 "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
                 "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
                 "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-                "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
                 "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
               },
               "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -325,7 +320,6 @@ <h3>Method Details</h3>
                   "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
                   "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
                   "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-                  "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
                   "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
                 },
                 "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -392,7 +386,6 @@ <h3>Method Details</h3>
           "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
           "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
           "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-          "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
           "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
         },
         "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -421,7 +414,6 @@ <h3>Method Details</h3>
             "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
             "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
             "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-            "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
             "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
           },
           "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -459,7 +451,6 @@ <h3>Method Details</h3>
             "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
             "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
             "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-            "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
             "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
           },
           "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -488,7 +479,6 @@ <h3>Method Details</h3>
               "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
               "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
               "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-              "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
               "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
             },
             "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
diff --git a/docs/dyn/youtube_v3.comments.html b/docs/dyn/youtube_v3.comments.html
index a4ba460fce3..6d893868a4b 100644
--- a/docs/dyn/youtube_v3.comments.html
+++ b/docs/dyn/youtube_v3.comments.html
@@ -130,7 +130,6 @@ <h3>Method Details</h3>
     "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
     "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
     "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-    "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
     "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
   },
   "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -158,7 +157,6 @@ <h3>Method Details</h3>
       "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
       "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
       "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-      "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
       "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
     },
     "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -213,7 +211,6 @@ <h3>Method Details</h3>
           "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
           "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
           "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-          "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
           "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
         },
         "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -298,7 +295,6 @@ <h3>Method Details</h3>
     "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
     "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
     "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-    "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
     "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
   },
   "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
@@ -326,7 +322,6 @@ <h3>Method Details</h3>
       "textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.
       "updatedAt": "A String", # The date and time when was last updated . The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
       "authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
-      "authorGoogleplusProfileUrl": "A String", # Link to the author's Google+ profile, if any.
       "textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.
     },
     "kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string "youtube#comment".
diff --git a/docs/dyn/youtube_v3.playlistItems.html b/docs/dyn/youtube_v3.playlistItems.html
index bdf5eb057a3..9f6f7b5da1f 100644
--- a/docs/dyn/youtube_v3.playlistItems.html
+++ b/docs/dyn/youtube_v3.playlistItems.html
@@ -75,7 +75,7 @@
 <h1><a href="youtube_v3.html">YouTube Data API</a> . <a href="youtube_v3.playlistItems.html">playlistItems</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#delete">delete(id)</a></code></p>
+  <code><a href="#delete">delete(id, onBehalfOfContentOwner=None)</a></code></p>
 <p class="firstline">Deletes a playlist item.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(part, body, onBehalfOfContentOwner=None)</a></code></p>
@@ -87,15 +87,18 @@ <h2>Instance Methods</h2>
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#update">update(part=None, body)</a></code></p>
+  <code><a href="#update">update(part=None, body, onBehalfOfContentOwner=None)</a></code></p>
 <p class="firstline">Modifies a playlist item. For example, you could update the item's position in the playlist.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="delete">delete(id)</code>
+    <code class="details" id="delete">delete(id, onBehalfOfContentOwner=None)</code>
   <pre>Deletes a playlist item.
 
 Args:
   id: string, The id parameter specifies the YouTube playlist item ID for the playlist item that is being deleted. In a playlistItem resource, the id property specifies the playlist item's ID. (required)
+  onBehalfOfContentOwner: string, Note: This parameter is intended exclusively for YouTube content partners.
+
+The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.
 </pre>
 </div>
 
@@ -124,6 +127,7 @@ <h3>Method Details</h3>
     "kind": "youtube#playlistItem", # Identifies what kind of resource this is. Value: the fixed string "youtube#playlistItem".
     "contentDetails": { # The contentDetails object is included in the resource if the included item is a YouTube video. The object contains additional information about the video.
       "note": "A String", # A user-generated note for this item.
+      "videoPublishedAt": "A String", # The date and time that the video was published to YouTube. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
       "startAt": "A String", # The time, measured in seconds from the start of the video, when the video should start playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) The default value is 0.
       "endAt": "A String", # The time, measured in seconds from the start of the video, when the video should stop playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) By default, assume that the video.endTime is the end of the video.
       "videoId": "A String", # The ID that YouTube uses to uniquely identify a video. To retrieve the video resource, set the id query parameter to this value in your API request.
@@ -197,6 +201,7 @@ <h3>Method Details</h3>
       "kind": "youtube#playlistItem", # Identifies what kind of resource this is. Value: the fixed string "youtube#playlistItem".
       "contentDetails": { # The contentDetails object is included in the resource if the included item is a YouTube video. The object contains additional information about the video.
         "note": "A String", # A user-generated note for this item.
+        "videoPublishedAt": "A String", # The date and time that the video was published to YouTube. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
         "startAt": "A String", # The time, measured in seconds from the start of the video, when the video should start playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) The default value is 0.
         "endAt": "A String", # The time, measured in seconds from the start of the video, when the video should stop playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) By default, assume that the video.endTime is the end of the video.
         "videoId": "A String", # The ID that YouTube uses to uniquely identify a video. To retrieve the video resource, set the id query parameter to this value in your API request.
@@ -290,6 +295,7 @@ <h3>Method Details</h3>
           "kind": "youtube#playlistItem", # Identifies what kind of resource this is. Value: the fixed string "youtube#playlistItem".
           "contentDetails": { # The contentDetails object is included in the resource if the included item is a YouTube video. The object contains additional information about the video.
             "note": "A String", # A user-generated note for this item.
+            "videoPublishedAt": "A String", # The date and time that the video was published to YouTube. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
             "startAt": "A String", # The time, measured in seconds from the start of the video, when the video should start playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) The default value is 0.
             "endAt": "A String", # The time, measured in seconds from the start of the video, when the video should stop playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) By default, assume that the video.endTime is the end of the video.
             "videoId": "A String", # The ID that YouTube uses to uniquely identify a video. To retrieve the video resource, set the id query parameter to this value in your API request.
@@ -366,7 +372,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(part=None, body)</code>
+    <code class="details" id="update">update(part=None, body, onBehalfOfContentOwner=None)</code>
   <pre>Modifies a playlist item. For example, you could update the item's position in the playlist.
 
 Args:
@@ -392,6 +398,7 @@ <h3>Method Details</h3>
     "kind": "youtube#playlistItem", # Identifies what kind of resource this is. Value: the fixed string "youtube#playlistItem".
     "contentDetails": { # The contentDetails object is included in the resource if the included item is a YouTube video. The object contains additional information about the video.
       "note": "A String", # A user-generated note for this item.
+      "videoPublishedAt": "A String", # The date and time that the video was published to YouTube. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
       "startAt": "A String", # The time, measured in seconds from the start of the video, when the video should start playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) The default value is 0.
       "endAt": "A String", # The time, measured in seconds from the start of the video, when the video should stop playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) By default, assume that the video.endTime is the end of the video.
       "videoId": "A String", # The ID that YouTube uses to uniquely identify a video. To retrieve the video resource, set the id query parameter to this value in your API request.
@@ -442,6 +449,9 @@ <h3>Method Details</h3>
     "id": "A String", # The ID that YouTube uses to uniquely identify the playlist item.
   }
 
+  onBehalfOfContentOwner: string, Note: This parameter is intended exclusively for YouTube content partners.
+
+The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.
 
 Returns:
   An object of the form:
@@ -462,6 +472,7 @@ <h3>Method Details</h3>
       "kind": "youtube#playlistItem", # Identifies what kind of resource this is. Value: the fixed string "youtube#playlistItem".
       "contentDetails": { # The contentDetails object is included in the resource if the included item is a YouTube video. The object contains additional information about the video.
         "note": "A String", # A user-generated note for this item.
+        "videoPublishedAt": "A String", # The date and time that the video was published to YouTube. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
         "startAt": "A String", # The time, measured in seconds from the start of the video, when the video should start playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) The default value is 0.
         "endAt": "A String", # The time, measured in seconds from the start of the video, when the video should stop playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) By default, assume that the video.endTime is the end of the video.
         "videoId": "A String", # The ID that YouTube uses to uniquely identify a video. To retrieve the video resource, set the id query parameter to this value in your API request.
diff --git a/docs/dyn/youtube_v3.thumbnails.html b/docs/dyn/youtube_v3.thumbnails.html
index 2aca0203259..28d987a646d 100644
--- a/docs/dyn/youtube_v3.thumbnails.html
+++ b/docs/dyn/youtube_v3.thumbnails.html
@@ -75,11 +75,11 @@
 <h1><a href="youtube_v3.html">YouTube Data API</a> . <a href="youtube_v3.thumbnails.html">thumbnails</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#set">set(videoId, media_body=None, onBehalfOfContentOwner=None)</a></code></p>
+  <code><a href="#set">set(videoId, media_body=None, onBehalfOfContentOwner=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Uploads a custom video thumbnail to YouTube and sets it for a video.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="set">set(videoId, media_body=None, onBehalfOfContentOwner=None)</code>
+    <code class="details" id="set">set(videoId, media_body=None, onBehalfOfContentOwner=None, media_mime_type=None)</code>
   <pre>Uploads a custom video thumbnail to YouTube and sets it for a video.
 
 Args:
@@ -88,6 +88,7 @@ <h3>Method Details</h3>
   onBehalfOfContentOwner: string, Note: This parameter is intended exclusively for YouTube content partners.
 
 The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 
 Returns:
   An object of the form:
diff --git a/docs/dyn/youtube_v3.videos.html b/docs/dyn/youtube_v3.videos.html
index 67c8fb858ea..def7113d53f 100644
--- a/docs/dyn/youtube_v3.videos.html
+++ b/docs/dyn/youtube_v3.videos.html
@@ -81,10 +81,10 @@ <h2>Instance Methods</h2>
   <code><a href="#getRating">getRating(id, onBehalfOfContentOwner=None)</a></code></p>
 <p class="firstline">Retrieves the ratings that the authorized user gave to a list of specified videos.</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(part=None, body=None, media_body=None, onBehalfOfContentOwner=None, stabilize=None, onBehalfOfContentOwnerChannel=None, notifySubscribers=None, autoLevels=None)</a></code></p>
+  <code><a href="#insert">insert(part=None, body=None, media_body=None, onBehalfOfContentOwner=None, stabilize=None, media_mime_type=None, onBehalfOfContentOwnerChannel=None, notifySubscribers=None, autoLevels=None)</a></code></p>
 <p class="firstline">Uploads a video to YouTube and optionally sets the video's metadata.</p>
 <p class="toc_element">
-  <code><a href="#list">list(part=None, hl=None, locale=None, id=None, onBehalfOfContentOwner=None, regionCode=None, pageToken=None, maxResults=None, chart=None, myRating=None, videoCategoryId=None)</a></code></p>
+  <code><a href="#list">list(part=None, hl=None, maxWidth=None, locale=None, id=None, onBehalfOfContentOwner=None, regionCode=None, pageToken=None, maxResults=None, chart=None, myRating=None, maxHeight=None, videoCategoryId=None)</a></code></p>
 <p class="firstline">Returns a list of videos that match the API request parameters.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -139,7 +139,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(part=None, body=None, media_body=None, onBehalfOfContentOwner=None, stabilize=None, onBehalfOfContentOwnerChannel=None, notifySubscribers=None, autoLevels=None)</code>
+    <code class="details" id="insert">insert(part=None, body=None, media_body=None, onBehalfOfContentOwner=None, stabilize=None, media_mime_type=None, onBehalfOfContentOwnerChannel=None, notifySubscribers=None, autoLevels=None)</code>
   <pre>Uploads a video to YouTube and optionally sets the video's metadata.
 
 Args:
@@ -236,7 +236,8 @@ <h3>Method Details</h3>
         ],
         "allowed": True or False, # The value of allowed indicates whether the access to the policy is allowed or denied by default.
       },
-      "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 68 # Specifies the ratings that the video received under various rating schemes.
+      "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom thumbnail image for the video. This property is only visible to the video uploader.
+      "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 69 # Specifies the ratings that the video received under various rating schemes.
         "cncRating": "A String", # Rating system in France - Commission de classification cinematographique
         "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and Telecommunications Commission (CRTC) for Canadian French-language broadcasts. For more information, see the Canadian Broadcast Standards Council website.
         "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating.
@@ -289,6 +290,7 @@ <h3>Method Details</h3>
         "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and Classification Board (Philippines).
         "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attività Culturali e del Turismo (Italy).
         "anatelRating": "A String", # The video's Anatel (Asociación Nacional de Televisión) rating for Chilean television.
+        "mcstRating": "A String", # The video's rating system for Vietnam - MCST
         "smaisRating": "A String", # The video's rating in Iceland.
         "ilfilmRating": "A String", # The video's rating in Israel.
         "russiaRating": "A String", # The video's National Film Registry of the Russian Federation (MKRF - Russia) rating.
@@ -330,11 +332,6 @@ <h3>Method Details</h3>
     "fileDetails": { # Describes original video file properties, including technical details about audio and video streams, but also metadata information like content length, digitization time, or geotagging information. # The fileDetails object encapsulates information about the video file that was uploaded to YouTube, including the file's resolution, duration, audio and video codecs, stream bitrates, and more. This data can only be retrieved by the video owner.
       "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits per second.
       "container": "A String", # The uploaded video file's container format.
-      "recordingLocation": { # Geographical coordinates of a point, in WGS84. # Geographic coordinates that identify the place where the uploaded video was recorded. Coordinates are defined using WGS 84.
-        "latitude": 3.14, # Latitude in degrees.
-        "altitude": 3.14, # Altitude above the reference ellipsoid, in meters.
-        "longitude": 3.14, # Longitude in degrees.
-      },
       "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing engine. Currently, YouTube only processes video files, but this field is present whether a video file or another type of file was uploaded.
       "creationTime": "A String", # The date and time when the uploaded video file was created. The value is specified in ISO 8601 format. Currently, the following ISO 8601 formats are supported:
           # - Date only: YYYY-MM-DD
@@ -385,6 +382,8 @@ <h3>Method Details</h3>
     },
     "player": { # Player to be used for a video playback. # The player object contains information that you would use to play the video in an embedded player.
       "embedHtml": "A String", # An <iframe> tag that embeds a player that will play the video.
+      "embedHeight": "A String",
+      "embedWidth": "A String", # The embed width
     },
     "etag": "A String", # Etag of this resource.
     "status": { # Basic details about a video category, such as its localized title. # The status object contains information about the video's uploading, processing, and privacy statuses.
@@ -447,6 +446,7 @@ <h3>Method Details</h3>
 
 The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.
   stabilize: boolean, The stabilize parameter indicates whether YouTube should adjust the video to remove shaky camera motions.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
   onBehalfOfContentOwnerChannel: string, This parameter can only be used in a properly authorized request. Note: This parameter is intended exclusively for YouTube content partners.
 
 The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies.
@@ -545,7 +545,8 @@ <h3>Method Details</h3>
           ],
           "allowed": True or False, # The value of allowed indicates whether the access to the policy is allowed or denied by default.
         },
-        "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 68 # Specifies the ratings that the video received under various rating schemes.
+        "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom thumbnail image for the video. This property is only visible to the video uploader.
+        "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 69 # Specifies the ratings that the video received under various rating schemes.
           "cncRating": "A String", # Rating system in France - Commission de classification cinematographique
           "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and Telecommunications Commission (CRTC) for Canadian French-language broadcasts. For more information, see the Canadian Broadcast Standards Council website.
           "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating.
@@ -598,6 +599,7 @@ <h3>Method Details</h3>
           "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and Classification Board (Philippines).
           "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attività Culturali e del Turismo (Italy).
           "anatelRating": "A String", # The video's Anatel (Asociación Nacional de Televisión) rating for Chilean television.
+          "mcstRating": "A String", # The video's rating system for Vietnam - MCST
           "smaisRating": "A String", # The video's rating in Iceland.
           "ilfilmRating": "A String", # The video's rating in Israel.
           "russiaRating": "A String", # The video's National Film Registry of the Russian Federation (MKRF - Russia) rating.
@@ -639,11 +641,6 @@ <h3>Method Details</h3>
       "fileDetails": { # Describes original video file properties, including technical details about audio and video streams, but also metadata information like content length, digitization time, or geotagging information. # The fileDetails object encapsulates information about the video file that was uploaded to YouTube, including the file's resolution, duration, audio and video codecs, stream bitrates, and more. This data can only be retrieved by the video owner.
         "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits per second.
         "container": "A String", # The uploaded video file's container format.
-        "recordingLocation": { # Geographical coordinates of a point, in WGS84. # Geographic coordinates that identify the place where the uploaded video was recorded. Coordinates are defined using WGS 84.
-          "latitude": 3.14, # Latitude in degrees.
-          "altitude": 3.14, # Altitude above the reference ellipsoid, in meters.
-          "longitude": 3.14, # Longitude in degrees.
-        },
         "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing engine. Currently, YouTube only processes video files, but this field is present whether a video file or another type of file was uploaded.
         "creationTime": "A String", # The date and time when the uploaded video file was created. The value is specified in ISO 8601 format. Currently, the following ISO 8601 formats are supported:
             # - Date only: YYYY-MM-DD
@@ -694,6 +691,8 @@ <h3>Method Details</h3>
       },
       "player": { # Player to be used for a video playback. # The player object contains information that you would use to play the video in an embedded player.
         "embedHtml": "A String", # An <iframe> tag that embeds a player that will play the video.
+        "embedHeight": "A String",
+        "embedWidth": "A String", # The embed width
       },
       "etag": "A String", # Etag of this resource.
       "status": { # Basic details about a video category, such as its localized title. # The status object contains information about the video's uploading, processing, and privacy statuses.
@@ -753,7 +752,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(part=None, hl=None, locale=None, id=None, onBehalfOfContentOwner=None, regionCode=None, pageToken=None, maxResults=None, chart=None, myRating=None, videoCategoryId=None)</code>
+    <code class="details" id="list">list(part=None, hl=None, maxWidth=None, locale=None, id=None, onBehalfOfContentOwner=None, regionCode=None, pageToken=None, maxResults=None, chart=None, myRating=None, maxHeight=None, videoCategoryId=None)</code>
   <pre>Returns a list of videos that match the API request parameters.
 
 Args:
@@ -763,6 +762,7 @@ <h3>Method Details</h3>
   hl: string, The hl parameter instructs the API to retrieve localized resource metadata for a specific application language that the YouTube website supports. The parameter value must be a language code included in the list returned by the i18nLanguages.list method.
 
 If localized resource details are available in that language, the resource's snippet.localized object will contain the localized values. However, if localized details are not available, the snippet.localized object will contain resource details in the resource's default language.
+  maxWidth: integer, The maxWidth parameter specifies a maximum width of the embedded player. If maxHeight is provided, maxWidth may not be reached in order to not violate the height request.
   locale: string, DEPRECATED
   id: string, The id parameter specifies a comma-separated list of the YouTube video ID(s) for the resource(s) that are being retrieved. In a video resource, the id property specifies the video's ID.
   onBehalfOfContentOwner: string, Note: This parameter is intended exclusively for YouTube content partners.
@@ -771,10 +771,10 @@ <h3>Method Details</h3>
   regionCode: string, The regionCode parameter instructs the API to select a video chart available in the specified region. This parameter can only be used in conjunction with the chart parameter. The parameter value is an ISO 3166-1 alpha-2 country code.
   pageToken: string, The pageToken parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
 
-Note: This parameter is supported for use in conjunction with the myRating parameter, but it is not supported for use in conjunction with the id parameter.
+Note: This parameter is supported for use in conjunction with the myRating and chart parameters, but it is not supported for use in conjunction with the id parameter.
   maxResults: integer, The maxResults parameter specifies the maximum number of items that should be returned in the result set.
 
-Note: This parameter is supported for use in conjunction with the myRating parameter, but it is not supported for use in conjunction with the id parameter.
+Note: This parameter is supported for use in conjunction with the myRating and chart parameters, but it is not supported for use in conjunction with the id parameter.
   chart: string, The chart parameter identifies the chart that you want to retrieve.
     Allowed values
       mostPopular - Return the most popular videos for the specified content region and video category.
@@ -782,6 +782,7 @@ <h3>Method Details</h3>
     Allowed values
       dislike - Returns only videos disliked by the authenticated user.
       like - Returns only video liked by the authenticated user.
+  maxHeight: integer, The maxHeight parameter specifies a maximum height of the embedded player. If maxWidth is provided, maxHeight may not be reached in order to not violate the width request.
   videoCategoryId: string, The videoCategoryId parameter identifies the video category for which the chart should be retrieved. This parameter can only be used in conjunction with the chart parameter. By default, charts are not restricted to a particular category.
 
 Returns:
@@ -880,7 +881,8 @@ <h3>Method Details</h3>
               ],
               "allowed": True or False, # The value of allowed indicates whether the access to the policy is allowed or denied by default.
             },
-            "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 68 # Specifies the ratings that the video received under various rating schemes.
+            "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom thumbnail image for the video. This property is only visible to the video uploader.
+            "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 69 # Specifies the ratings that the video received under various rating schemes.
               "cncRating": "A String", # Rating system in France - Commission de classification cinematographique
               "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and Telecommunications Commission (CRTC) for Canadian French-language broadcasts. For more information, see the Canadian Broadcast Standards Council website.
               "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating.
@@ -933,6 +935,7 @@ <h3>Method Details</h3>
               "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and Classification Board (Philippines).
               "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attività Culturali e del Turismo (Italy).
               "anatelRating": "A String", # The video's Anatel (Asociación Nacional de Televisión) rating for Chilean television.
+              "mcstRating": "A String", # The video's rating system for Vietnam - MCST
               "smaisRating": "A String", # The video's rating in Iceland.
               "ilfilmRating": "A String", # The video's rating in Israel.
               "russiaRating": "A String", # The video's National Film Registry of the Russian Federation (MKRF - Russia) rating.
@@ -974,11 +977,6 @@ <h3>Method Details</h3>
           "fileDetails": { # Describes original video file properties, including technical details about audio and video streams, but also metadata information like content length, digitization time, or geotagging information. # The fileDetails object encapsulates information about the video file that was uploaded to YouTube, including the file's resolution, duration, audio and video codecs, stream bitrates, and more. This data can only be retrieved by the video owner.
             "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits per second.
             "container": "A String", # The uploaded video file's container format.
-            "recordingLocation": { # Geographical coordinates of a point, in WGS84. # Geographic coordinates that identify the place where the uploaded video was recorded. Coordinates are defined using WGS 84.
-              "latitude": 3.14, # Latitude in degrees.
-              "altitude": 3.14, # Altitude above the reference ellipsoid, in meters.
-              "longitude": 3.14, # Longitude in degrees.
-            },
             "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing engine. Currently, YouTube only processes video files, but this field is present whether a video file or another type of file was uploaded.
             "creationTime": "A String", # The date and time when the uploaded video file was created. The value is specified in ISO 8601 format. Currently, the following ISO 8601 formats are supported:
                 # - Date only: YYYY-MM-DD
@@ -1029,6 +1027,8 @@ <h3>Method Details</h3>
           },
           "player": { # Player to be used for a video playback. # The player object contains information that you would use to play the video in an embedded player.
             "embedHtml": "A String", # An <iframe> tag that embeds a player that will play the video.
+            "embedHeight": "A String",
+            "embedWidth": "A String", # The embed width
           },
           "etag": "A String", # Etag of this resource.
           "status": { # Basic details about a video category, such as its localized title. # The status object contains information about the video's uploading, processing, and privacy statuses.
@@ -1247,7 +1247,8 @@ <h3>Method Details</h3>
         ],
         "allowed": True or False, # The value of allowed indicates whether the access to the policy is allowed or denied by default.
       },
-      "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 68 # Specifies the ratings that the video received under various rating schemes.
+      "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom thumbnail image for the video. This property is only visible to the video uploader.
+      "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 69 # Specifies the ratings that the video received under various rating schemes.
         "cncRating": "A String", # Rating system in France - Commission de classification cinematographique
         "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and Telecommunications Commission (CRTC) for Canadian French-language broadcasts. For more information, see the Canadian Broadcast Standards Council website.
         "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating.
@@ -1300,6 +1301,7 @@ <h3>Method Details</h3>
         "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and Classification Board (Philippines).
         "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attività Culturali e del Turismo (Italy).
         "anatelRating": "A String", # The video's Anatel (Asociación Nacional de Televisión) rating for Chilean television.
+        "mcstRating": "A String", # The video's rating system for Vietnam - MCST
         "smaisRating": "A String", # The video's rating in Iceland.
         "ilfilmRating": "A String", # The video's rating in Israel.
         "russiaRating": "A String", # The video's National Film Registry of the Russian Federation (MKRF - Russia) rating.
@@ -1341,11 +1343,6 @@ <h3>Method Details</h3>
     "fileDetails": { # Describes original video file properties, including technical details about audio and video streams, but also metadata information like content length, digitization time, or geotagging information. # The fileDetails object encapsulates information about the video file that was uploaded to YouTube, including the file's resolution, duration, audio and video codecs, stream bitrates, and more. This data can only be retrieved by the video owner.
       "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits per second.
       "container": "A String", # The uploaded video file's container format.
-      "recordingLocation": { # Geographical coordinates of a point, in WGS84. # Geographic coordinates that identify the place where the uploaded video was recorded. Coordinates are defined using WGS 84.
-        "latitude": 3.14, # Latitude in degrees.
-        "altitude": 3.14, # Altitude above the reference ellipsoid, in meters.
-        "longitude": 3.14, # Longitude in degrees.
-      },
       "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing engine. Currently, YouTube only processes video files, but this field is present whether a video file or another type of file was uploaded.
       "creationTime": "A String", # The date and time when the uploaded video file was created. The value is specified in ISO 8601 format. Currently, the following ISO 8601 formats are supported:
           # - Date only: YYYY-MM-DD
@@ -1396,6 +1393,8 @@ <h3>Method Details</h3>
     },
     "player": { # Player to be used for a video playback. # The player object contains information that you would use to play the video in an embedded player.
       "embedHtml": "A String", # An <iframe> tag that embeds a player that will play the video.
+      "embedHeight": "A String",
+      "embedWidth": "A String", # The embed width
     },
     "etag": "A String", # Etag of this resource.
     "status": { # Basic details about a video category, such as its localized title. # The status object contains information about the video's uploading, processing, and privacy statuses.
@@ -1547,7 +1546,8 @@ <h3>Method Details</h3>
           ],
           "allowed": True or False, # The value of allowed indicates whether the access to the policy is allowed or denied by default.
         },
-        "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 68 # Specifies the ratings that the video received under various rating schemes.
+        "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom thumbnail image for the video. This property is only visible to the video uploader.
+        "contentRating": { # Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 69 # Specifies the ratings that the video received under various rating schemes.
           "cncRating": "A String", # Rating system in France - Commission de classification cinematographique
           "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and Telecommunications Commission (CRTC) for Canadian French-language broadcasts. For more information, see the Canadian Broadcast Standards Council website.
           "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating.
@@ -1600,6 +1600,7 @@ <h3>Method Details</h3>
           "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and Classification Board (Philippines).
           "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attività Culturali e del Turismo (Italy).
           "anatelRating": "A String", # The video's Anatel (Asociación Nacional de Televisión) rating for Chilean television.
+          "mcstRating": "A String", # The video's rating system for Vietnam - MCST
           "smaisRating": "A String", # The video's rating in Iceland.
           "ilfilmRating": "A String", # The video's rating in Israel.
           "russiaRating": "A String", # The video's National Film Registry of the Russian Federation (MKRF - Russia) rating.
@@ -1641,11 +1642,6 @@ <h3>Method Details</h3>
       "fileDetails": { # Describes original video file properties, including technical details about audio and video streams, but also metadata information like content length, digitization time, or geotagging information. # The fileDetails object encapsulates information about the video file that was uploaded to YouTube, including the file's resolution, duration, audio and video codecs, stream bitrates, and more. This data can only be retrieved by the video owner.
         "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits per second.
         "container": "A String", # The uploaded video file's container format.
-        "recordingLocation": { # Geographical coordinates of a point, in WGS84. # Geographic coordinates that identify the place where the uploaded video was recorded. Coordinates are defined using WGS 84.
-          "latitude": 3.14, # Latitude in degrees.
-          "altitude": 3.14, # Altitude above the reference ellipsoid, in meters.
-          "longitude": 3.14, # Longitude in degrees.
-        },
         "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing engine. Currently, YouTube only processes video files, but this field is present whether a video file or another type of file was uploaded.
         "creationTime": "A String", # The date and time when the uploaded video file was created. The value is specified in ISO 8601 format. Currently, the following ISO 8601 formats are supported:
             # - Date only: YYYY-MM-DD
@@ -1696,6 +1692,8 @@ <h3>Method Details</h3>
       },
       "player": { # Player to be used for a video playback. # The player object contains information that you would use to play the video in an embedded player.
         "embedHtml": "A String", # An <iframe> tag that embeds a player that will play the video.
+        "embedHeight": "A String",
+        "embedWidth": "A String", # The embed width
       },
       "etag": "A String", # Etag of this resource.
       "status": { # Basic details about a video category, such as its localized title. # The status object contains information about the video's uploading, processing, and privacy statuses.
diff --git a/docs/dyn/youtube_v3.watermarks.html b/docs/dyn/youtube_v3.watermarks.html
index 76e313f3603..177a01ce216 100644
--- a/docs/dyn/youtube_v3.watermarks.html
+++ b/docs/dyn/youtube_v3.watermarks.html
@@ -75,14 +75,14 @@
 <h1><a href="youtube_v3.html">YouTube Data API</a> . <a href="youtube_v3.watermarks.html">watermarks</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#set">set(channelId, body=None, media_body=None, onBehalfOfContentOwner=None)</a></code></p>
+  <code><a href="#set">set(channelId, body=None, media_body=None, onBehalfOfContentOwner=None, media_mime_type=None)</a></code></p>
 <p class="firstline">Uploads a watermark image to YouTube and sets it for a channel.</p>
 <p class="toc_element">
   <code><a href="#unset">unset(channelId, onBehalfOfContentOwner=None)</a></code></p>
 <p class="firstline">Deletes a channel's watermark image.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="set">set(channelId, body=None, media_body=None, onBehalfOfContentOwner=None)</code>
+    <code class="details" id="set">set(channelId, body=None, media_body=None, onBehalfOfContentOwner=None, media_mime_type=None)</code>
   <pre>Uploads a watermark image to YouTube and sets it for a channel.
 
 Args:
@@ -109,6 +109,7 @@ <h3>Method Details</h3>
   onBehalfOfContentOwner: string, Note: This parameter is intended exclusively for YouTube content partners.
 
 The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.
+  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
 </pre>
 </div>
 
diff --git a/docs/epy/api-objects.txt b/docs/epy/api-objects.txt
index 935999ca2cb..c0fefaf2988 100644
--- a/docs/epy/api-objects.txt
+++ b/docs/epy/api-objects.txt
@@ -1,4 +1,10 @@
 googleapiclient	googleapiclient-module.html
+googleapiclient._auth	googleapiclient._auth-module.html
+googleapiclient._auth.HAS_GOOGLE_AUTH	googleapiclient._auth-module.html#HAS_GOOGLE_AUTH
+googleapiclient._auth.default_credentials	googleapiclient._auth-module.html#default_credentials
+googleapiclient._auth.with_scopes	googleapiclient._auth-module.html#with_scopes
+googleapiclient._auth.HAS_OAUTH2CLIENT	googleapiclient._auth-module.html#HAS_OAUTH2CLIENT
+googleapiclient._auth.authorized_http	googleapiclient._auth-module.html#authorized_http
 googleapiclient.channel	googleapiclient.channel-module.html
 googleapiclient.channel.CHANNEL_PARAMS	googleapiclient.channel-module.html#CHANNEL_PARAMS
 googleapiclient.channel.notification_from_headers	googleapiclient.channel-module.html#notification_from_headers
diff --git a/docs/epy/class-tree.html b/docs/epy/class-tree.html
index d8cf1e510f6..57a9020f649 100644
--- a/docs/epy/class-tree.html
+++ b/docs/epy/class-tree.html
@@ -163,7 +163,7 @@ <h1 class="epydoc">Class Hierarchy</h1>
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient-module.html b/docs/epy/googleapiclient-module.html
index 79098cd2dd5..160590c5739 100644
--- a/docs/epy/googleapiclient-module.html
+++ b/docs/epy/googleapiclient-module.html
@@ -57,7 +57,7 @@
 <h1 class="epydoc">Package googleapiclient</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient-pysrc.html">source&nbsp;code</a></span></p>
 <hr />
 <div class="fields">      <p><strong>Version:</strong>
-        1.5.5
+        1.6.0
       </p>
 </div><!-- ==================== SUBMODULES ==================== -->
 <a name="section-Submodules"></a>
@@ -78,6 +78,7 @@ <h1 class="epydoc">Package googleapiclient</h1><p class="nomargin-top"><span cla
 </tr>
   <tr><td class="summary">
   <ul class="nomargin">
+    <li class="private"> <strong class="uidlink"><a href="googleapiclient._auth-module.html">googleapiclient._auth</a></strong>: <em class="summary">Helpers for authentication using oauth2client or google-auth.</em>    </li>
     <li> <strong class="uidlink"><a href="googleapiclient.channel-module.html">googleapiclient.channel</a></strong>: <em class="summary">Channel notifications support.</em>    </li>
     <li> <strong class="uidlink"><a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a></strong>: <em class="summary">Client for discovery based APIs.</em>    </li>
     <li> <strong class="uidlink"><a href="googleapiclient.discovery_cache-module.html">googleapiclient.discovery_cache</a></strong>: <em class="summary">Caching utility for the discovery document.</em>
@@ -148,7 +149,7 @@ <h1 class="epydoc">Package googleapiclient</h1><p class="nomargin-top"><span cla
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient-pysrc.html b/docs/epy/googleapiclient-pysrc.html
index 70afa7e7e7d..9d9d1ef4148 100644
--- a/docs/epy/googleapiclient-pysrc.html
+++ b/docs/epy/googleapiclient-pysrc.html
@@ -69,7 +69,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient-module.html">Package
 <a name="L12"></a><tt class="py-lineno">12</tt>  <tt class="py-line"><tt class="py-comment"># See the License for the specific language governing permissions and</tt> </tt>
 <a name="L13"></a><tt class="py-lineno">13</tt>  <tt class="py-line"><tt class="py-comment"># limitations under the License.</tt> </tt>
 <a name="L14"></a><tt class="py-lineno">14</tt>  <tt class="py-line"> </tt>
-<a name="L15"></a><tt class="py-lineno">15</tt>  <tt class="py-line"><tt class="py-name">__version__</tt> <tt class="py-op">=</tt> <tt class="py-docstring">"1.5.5"</tt> </tt>
+<a name="L15"></a><tt class="py-lineno">15</tt>  <tt class="py-line"><tt class="py-name">__version__</tt> <tt class="py-op">=</tt> <tt class="py-docstring">"1.6.0"</tt> </tt>
 <a name="L16"></a><tt class="py-lineno">16</tt>  <tt class="py-line"> </tt>
 <a name="L17"></a><tt class="py-lineno">17</tt>  <tt class="py-line"><tt class="py-comment"># Set default logging handler to avoid "No handler found" warnings.</tt> </tt>
 <a name="L18"></a><tt class="py-lineno">18</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">logging</tt> </tt>
@@ -115,7 +115,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient-module.html">Package
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:51 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.NullHandler-class.html b/docs/epy/googleapiclient.NullHandler-class.html
index 0e9087a4273..a44043764b7 100644
--- a/docs/epy/googleapiclient.NullHandler-class.html
+++ b/docs/epy/googleapiclient.NullHandler-class.html
@@ -58,27 +58,27 @@
 <h1 class="epydoc">Class NullHandler</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient-pysrc.html#NullHandler">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap" name="uml_class_diagram_for_googleap">
-<area shape="rect" id="node1_18" href="googleapiclient.NullHandler-class.html#emit" title="Do whatever it takes to actually log the specified logging record." alt="" coords="53,493,159,513"/>
-<area shape="rect" id="node1" href="googleapiclient.NullHandler-class.html" title="googleapiclient.NullHandler" alt="" coords="41,459,170,519"/>
-<area shape="rect" id="node2_19" href="javascript:void(0);" title="logging.Handler.name" alt="" coords="17,151,196,171"/>
-<area shape="rect" id="node2_20" href="javascript:void(0);" title="Initializes the instance &#45; basically setting the formatter to None and the filter list to empty." alt="" coords="17,173,196,193"/>
-<area shape="rect" id="node2_21" href="javascript:void(0);" title="logging.Handler.get_name" alt="" coords="17,193,196,213"/>
-<area shape="rect" id="node2_22" href="javascript:void(0);" title="logging.Handler.set_name" alt="" coords="17,213,196,233"/>
-<area shape="rect" id="node2_23" href="javascript:void(0);" title="Acquire a thread lock for serializing access to the underlying I/O." alt="" coords="17,233,196,253"/>
-<area shape="rect" id="node2_24" href="javascript:void(0);" title="Acquire the I/O thread lock." alt="" coords="17,253,196,273"/>
-<area shape="rect" id="node2_25" href="javascript:void(0);" title="Release the I/O thread lock." alt="" coords="17,273,196,293"/>
-<area shape="rect" id="node2_26" href="javascript:void(0);" title="Set the logging level of this handler." alt="" coords="17,293,196,313"/>
-<area shape="rect" id="node2_27" href="javascript:void(0);" title="Format the specified record." alt="" coords="17,313,196,333"/>
-<area shape="rect" id="node2_28" href="javascript:void(0);" title="Conditionally emit the specified logging record." alt="" coords="17,333,196,353"/>
-<area shape="rect" id="node2_29" href="javascript:void(0);" title="Set the formatter for this handler." alt="" coords="17,353,196,373"/>
-<area shape="rect" id="node2_30" href="javascript:void(0);" title="Ensure all logging output has been flushed." alt="" coords="17,373,196,393"/>
-<area shape="rect" id="node2_31" href="javascript:void(0);" title="Tidy up any resources used by the handler." alt="" coords="17,393,196,413"/>
-<area shape="rect" id="node2_32" href="javascript:void(0);" title="Handle errors which occur during an emit() call." alt="" coords="17,413,196,433"/>
-<area shape="rect" id="node2" href="javascript:void(0);" title="Handler instances dispatch logging events to specific destinations." alt="" coords="5,125,208,440"/>
-<area shape="rect" id="node3_33" href="javascript:void(0);" title="Add the specified filter to this handler." alt="" coords="36,40,177,60"/>
-<area shape="rect" id="node3_34" href="javascript:void(0);" title="Remove the specified filter from this handler." alt="" coords="36,60,177,80"/>
-<area shape="rect" id="node3_35" href="javascript:void(0);" title="Determine if a record is loggable by consulting all the filters." alt="" coords="36,80,177,100"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="A base class for loggers and handlers which allows them to share common code." alt="" coords="24,6,189,106"/>
+<area shape="rect" id="node1_18" href="googleapiclient.NullHandler-class.html#emit" title="Do whatever it takes to actually log the specified logging record." alt="" coords="54,460,159,479"/>
+<area shape="rect" id="node1" href="googleapiclient.NullHandler-class.html" title="googleapiclient.NullHandler" alt="" coords="41,429,171,485"/>
+<area shape="rect" id="node2_19" href="javascript:void(0);" title="logging.Handler.name" alt="" coords="18,140,195,159"/>
+<area shape="rect" id="node2_20" href="javascript:void(0);" title="Initializes the instance &#45; basically setting the formatter to None and the filter list to empty." alt="" coords="18,161,195,180"/>
+<area shape="rect" id="node2_21" href="javascript:void(0);" title="logging.Handler.get_name" alt="" coords="18,180,195,199"/>
+<area shape="rect" id="node2_22" href="javascript:void(0);" title="logging.Handler.set_name" alt="" coords="18,199,195,217"/>
+<area shape="rect" id="node2_23" href="javascript:void(0);" title="Acquire a thread lock for serializing access to the underlying I/O." alt="" coords="18,217,195,236"/>
+<area shape="rect" id="node2_24" href="javascript:void(0);" title="Acquire the I/O thread lock." alt="" coords="18,236,195,255"/>
+<area shape="rect" id="node2_25" href="javascript:void(0);" title="Release the I/O thread lock." alt="" coords="18,255,195,273"/>
+<area shape="rect" id="node2_26" href="javascript:void(0);" title="Set the logging level of this handler." alt="" coords="18,273,195,292"/>
+<area shape="rect" id="node2_27" href="javascript:void(0);" title="Format the specified record." alt="" coords="18,292,195,311"/>
+<area shape="rect" id="node2_28" href="javascript:void(0);" title="Conditionally emit the specified logging record." alt="" coords="18,311,195,329"/>
+<area shape="rect" id="node2_29" href="javascript:void(0);" title="Set the formatter for this handler." alt="" coords="18,329,195,348"/>
+<area shape="rect" id="node2_30" href="javascript:void(0);" title="Ensure all logging output has been flushed." alt="" coords="18,348,195,367"/>
+<area shape="rect" id="node2_31" href="javascript:void(0);" title="Tidy up any resources used by the handler." alt="" coords="18,367,195,385"/>
+<area shape="rect" id="node2_32" href="javascript:void(0);" title="Handle errors which occur during an emit() call." alt="" coords="18,385,195,404"/>
+<area shape="rect" id="node2" href="javascript:void(0);" title="Handler instances dispatch logging events to specific destinations." alt="" coords="5,117,207,411"/>
+<area shape="rect" id="node3_33" href="javascript:void(0);" title="Add the specified filter to this handler." alt="" coords="37,36,178,55"/>
+<area shape="rect" id="node3_34" href="javascript:void(0);" title="Remove the specified filter from this handler." alt="" coords="37,55,178,73"/>
+<area shape="rect" id="node3_35" href="javascript:void(0);" title="Determine if a record is loggable by consulting all the filters." alt="" coords="37,73,178,92"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="A base class for loggers and handlers which allows them to share common code." alt="" coords="25,5,190,99"/>
 </map>
   <img src="uml_class_diagram_for_googleap.gif" alt='' usemap="#uml_class_diagram_for_googleap" ismap="ismap" class="graph-without-title" />
 </center>
@@ -284,7 +284,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">emit</span>(<span cl
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient._auth-module.html b/docs/epy/googleapiclient._auth-module.html
new file mode 100644
index 00000000000..b221eba5ce1
--- /dev/null
+++ b/docs/epy/googleapiclient._auth-module.html
@@ -0,0 +1,294 @@
+<?xml version="1.0" encoding="ascii"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+          "DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>googleapiclient._auth</title>
+  <link rel="stylesheet" href="epydoc.css" type="text/css" />
+  <script type="text/javascript" src="epydoc.js"></script>
+</head>
+
+<body bgcolor="white" text="black" link="blue" vlink="#204080"
+      alink="#204080">
+<!-- ==================== NAVIGATION BAR ==================== -->
+<table class="navbar" border="0" width="100%" cellpadding="0"
+       bgcolor="#a0c0ff" cellspacing="0">
+  <tr valign="middle">
+  <!-- Home link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="googleapiclient-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Tree link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Index link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Help link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
+
+      <th class="navbar" width="100%"></th>
+  </tr>
+</table>
+<table width="100%" cellpadding="0" cellspacing="0">
+  <tr valign="top">
+    <td width="100%">
+      <span class="breadcrumbs">
+        <a href="googleapiclient-module.html">Package&nbsp;googleapiclient</a> ::
+        Module&nbsp;_auth
+      </span>
+    </td>
+    <td>
+      <table cellpadding="0" cellspacing="0">
+        <!-- hide/show private -->
+        <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
+    onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
+        <tr><td align="right"><span class="options"
+            >[<a href="frames.html" target="_top">frames</a
+            >]&nbsp;|&nbsp;<a href="googleapiclient._auth-module.html"
+            target="_top">no&nbsp;frames</a>]</span></td></tr>
+      </table>
+    </td>
+  </tr>
+</table>
+<!-- ==================== MODULE DESCRIPTION ==================== -->
+<h1 class="epydoc">Module _auth</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient._auth-pysrc.html">source&nbsp;code</a></span></p>
+<pre class="literalblock">
+Helpers for authentication using oauth2client or google-auth.
+
+</pre>
+
+<!-- ==================== FUNCTIONS ==================== -->
+<a name="section-Functions"></a>
+<table class="summary" border="1" cellpadding="3"
+       cellspacing="0" width="100%" bgcolor="white">
+<tr bgcolor="#70b0f0" class="table-header">
+  <td colspan="2" class="table-header">
+    <table border="0" cellpadding="0" cellspacing="0" width="100%">
+      <tr valign="top">
+        <td align="left"><span class="table-header">Functions</span></td>
+        <td align="right" valign="top"
+         ><span class="options">[<a href="#section-Functions"
+         class="privatelink" onclick="toggle_private();"
+         >hide private</a>]</span></td>
+      </tr>
+    </table>
+  </td>
+</tr>
+<tr>
+    <td width="15%" align="right" valign="top" class="summary">
+      <span class="summary-type">&nbsp;</span>
+    </td><td class="summary">
+      <table width="100%" cellpadding="0" cellspacing="0" border="0">
+        <tr>
+          <td><span class="summary-sig"><a name="default_credentials"></a><span class="summary-sig-name">default_credentials</span>()</span><br />
+      Returns Application Default Credentials.</td>
+          <td align="right" valign="top">
+            <span class="codelink"><a href="googleapiclient._auth-pysrc.html#default_credentials">source&nbsp;code</a></span>
+            
+          </td>
+        </tr>
+      </table>
+      
+    </td>
+  </tr>
+<tr>
+    <td width="15%" align="right" valign="top" class="summary">
+      <span class="summary-type">&nbsp;</span>
+    </td><td class="summary">
+      <table width="100%" cellpadding="0" cellspacing="0" border="0">
+        <tr>
+          <td><span class="summary-sig"><a href="googleapiclient._auth-module.html#with_scopes" class="summary-sig-name">with_scopes</a>(<span class="summary-sig-arg">credentials</span>,
+        <span class="summary-sig-arg">scopes</span>)</span><br />
+      Scopes the credentials if necessary.</td>
+          <td align="right" valign="top">
+            <span class="codelink"><a href="googleapiclient._auth-pysrc.html#with_scopes">source&nbsp;code</a></span>
+            
+          </td>
+        </tr>
+      </table>
+      
+    </td>
+  </tr>
+<tr>
+    <td width="15%" align="right" valign="top" class="summary">
+      <span class="summary-type">&nbsp;</span>
+    </td><td class="summary">
+      <table width="100%" cellpadding="0" cellspacing="0" border="0">
+        <tr>
+          <td><span class="summary-sig"><a href="googleapiclient._auth-module.html#authorized_http" class="summary-sig-name">authorized_http</a>(<span class="summary-sig-arg">credentials</span>)</span><br />
+      Returns an http client that is authorized with the given credentials.</td>
+          <td align="right" valign="top">
+            <span class="codelink"><a href="googleapiclient._auth-pysrc.html#authorized_http">source&nbsp;code</a></span>
+            
+          </td>
+        </tr>
+      </table>
+      
+    </td>
+  </tr>
+</table>
+<!-- ==================== VARIABLES ==================== -->
+<a name="section-Variables"></a>
+<table class="summary" border="1" cellpadding="3"
+       cellspacing="0" width="100%" bgcolor="white">
+<tr bgcolor="#70b0f0" class="table-header">
+  <td colspan="2" class="table-header">
+    <table border="0" cellpadding="0" cellspacing="0" width="100%">
+      <tr valign="top">
+        <td align="left"><span class="table-header">Variables</span></td>
+        <td align="right" valign="top"
+         ><span class="options">[<a href="#section-Variables"
+         class="privatelink" onclick="toggle_private();"
+         >hide private</a>]</span></td>
+      </tr>
+    </table>
+  </td>
+</tr>
+<tr>
+    <td width="15%" align="right" valign="top" class="summary">
+      <span class="summary-type">&nbsp;</span>
+    </td><td class="summary">
+        <a name="HAS_GOOGLE_AUTH"></a><span class="summary-name">HAS_GOOGLE_AUTH</span> = <code title="False">False</code>
+    </td>
+  </tr>
+<tr>
+    <td width="15%" align="right" valign="top" class="summary">
+      <span class="summary-type">&nbsp;</span>
+    </td><td class="summary">
+        <a name="HAS_OAUTH2CLIENT"></a><span class="summary-name">HAS_OAUTH2CLIENT</span> = <code title="False">False</code>
+    </td>
+  </tr>
+</table>
+<!-- ==================== FUNCTION DETAILS ==================== -->
+<a name="section-FunctionDetails"></a>
+<table class="details" border="1" cellpadding="3"
+       cellspacing="0" width="100%" bgcolor="white">
+<tr bgcolor="#70b0f0" class="table-header">
+  <td colspan="2" class="table-header">
+    <table border="0" cellpadding="0" cellspacing="0" width="100%">
+      <tr valign="top">
+        <td align="left"><span class="table-header">Function Details</span></td>
+        <td align="right" valign="top"
+         ><span class="options">[<a href="#section-FunctionDetails"
+         class="privatelink" onclick="toggle_private();"
+         >hide private</a>]</span></td>
+      </tr>
+    </table>
+  </td>
+</tr>
+</table>
+<a name="with_scopes"></a>
+<div>
+<table class="details" border="1" cellpadding="3"
+       cellspacing="0" width="100%" bgcolor="white">
+<tr><td>
+  <table width="100%" cellpadding="0" cellspacing="0" border="0">
+  <tr valign="top"><td>
+  <h3 class="epydoc"><span class="sig"><span class="sig-name">with_scopes</span>(<span class="sig-arg">credentials</span>,
+        <span class="sig-arg">scopes</span>)</span>
+  </h3>
+  </td><td align="right" valign="top"
+    ><span class="codelink"><a href="googleapiclient._auth-pysrc.html#with_scopes">source&nbsp;code</a></span>&nbsp;
+    </td>
+  </tr></table>
+  
+  <pre class="literalblock">
+Scopes the credentials if necessary.
+
+Args:
+    credentials (Union[
+        google.auth.credentials.Credentials,
+        oauth2client.client.Credentials]): The credentials to scope.
+    scopes (Sequence[str]): The list of scopes.
+
+Returns:
+    Union[google.auth.credentials.Credentials,
+        oauth2client.client.Credentials]: The scoped credentials.
+
+</pre>
+  <dl class="fields">
+  </dl>
+</td></tr></table>
+</div>
+<a name="authorized_http"></a>
+<div>
+<table class="details" border="1" cellpadding="3"
+       cellspacing="0" width="100%" bgcolor="white">
+<tr><td>
+  <table width="100%" cellpadding="0" cellspacing="0" border="0">
+  <tr valign="top"><td>
+  <h3 class="epydoc"><span class="sig"><span class="sig-name">authorized_http</span>(<span class="sig-arg">credentials</span>)</span>
+  </h3>
+  </td><td align="right" valign="top"
+    ><span class="codelink"><a href="googleapiclient._auth-pysrc.html#authorized_http">source&nbsp;code</a></span>&nbsp;
+    </td>
+  </tr></table>
+  
+  <pre class="literalblock">
+Returns an http client that is authorized with the given credentials.
+
+Args:
+    credentials (Union[
+        google.auth.credentials.Credentials,
+        oauth2client.client.Credentials]): The credentials to use.
+
+Returns:
+    Union[httplib2.Http, google_auth_httplib2.AuthorizedHttp]: An
+        authorized http client.
+
+</pre>
+  <dl class="fields">
+  </dl>
+</td></tr></table>
+</div>
+<br />
+<!-- ==================== NAVIGATION BAR ==================== -->
+<table class="navbar" border="0" width="100%" cellpadding="0"
+       bgcolor="#a0c0ff" cellspacing="0">
+  <tr valign="middle">
+  <!-- Home link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="googleapiclient-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Tree link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Index link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Help link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
+
+      <th class="navbar" width="100%"></th>
+  </tr>
+</table>
+<table border="0" cellpadding="0" cellspacing="0" width="100%%">
+  <tr>
+    <td align="left" class="footer">
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
+    </td>
+    <td align="right" class="footer">
+      <a target="mainFrame" href="http://epydoc.sourceforge.net"
+        >http://epydoc.sourceforge.net</a>
+    </td>
+  </tr>
+</table>
+
+<script type="text/javascript">
+  <!--
+  // Private objects are initially displayed (because if
+  // javascript is turned off then we want them to be
+  // visible); but by default, we want to hide them.  So hide
+  // them unless we have a cookie that says to show them.
+  checkCookie();
+  // -->
+</script>
+</body>
+</html>
diff --git a/docs/epy/googleapiclient._auth-pysrc.html b/docs/epy/googleapiclient._auth-pysrc.html
new file mode 100644
index 00000000000..4c73a854c2b
--- /dev/null
+++ b/docs/epy/googleapiclient._auth-pysrc.html
@@ -0,0 +1,201 @@
+<?xml version="1.0" encoding="ascii"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+          "DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>googleapiclient._auth</title>
+  <link rel="stylesheet" href="epydoc.css" type="text/css" />
+  <script type="text/javascript" src="epydoc.js"></script>
+</head>
+
+<body bgcolor="white" text="black" link="blue" vlink="#204080"
+      alink="#204080">
+<!-- ==================== NAVIGATION BAR ==================== -->
+<table class="navbar" border="0" width="100%" cellpadding="0"
+       bgcolor="#a0c0ff" cellspacing="0">
+  <tr valign="middle">
+  <!-- Home link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="googleapiclient-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Tree link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Index link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Help link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
+
+      <th class="navbar" width="100%"></th>
+  </tr>
+</table>
+<table width="100%" cellpadding="0" cellspacing="0">
+  <tr valign="top">
+    <td width="100%">
+      <span class="breadcrumbs">
+        <a href="googleapiclient-module.html">Package&nbsp;googleapiclient</a> ::
+        Module&nbsp;_auth
+      </span>
+    </td>
+    <td>
+      <table cellpadding="0" cellspacing="0">
+        <!-- hide/show private -->
+        <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
+    onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
+        <tr><td align="right"><span class="options"
+            >[<a href="frames.html" target="_top">frames</a
+            >]&nbsp;|&nbsp;<a href="googleapiclient._auth-pysrc.html"
+            target="_top">no&nbsp;frames</a>]</span></td></tr>
+      </table>
+    </td>
+  </tr>
+</table>
+<h1 class="epydoc">Source Code for <a href="googleapiclient._auth-module.html">Module googleapiclient._auth</a></h1>
+<pre class="py-src">
+<a name="L1"></a><tt class="py-lineno"> 1</tt>  <tt class="py-line"><tt class="py-comment"># Copyright 2016 Google Inc. All Rights Reserved.</tt> </tt>
+<a name="L2"></a><tt class="py-lineno"> 2</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
+<a name="L3"></a><tt class="py-lineno"> 3</tt>  <tt class="py-line"><tt class="py-comment"># Licensed under the Apache License, Version 2.0 (the "License");</tt> </tt>
+<a name="L4"></a><tt class="py-lineno"> 4</tt>  <tt class="py-line"><tt class="py-comment"># you may not use this file except in compliance with the License.</tt> </tt>
+<a name="L5"></a><tt class="py-lineno"> 5</tt>  <tt class="py-line"><tt class="py-comment"># You may obtain a copy of the License at</tt> </tt>
+<a name="L6"></a><tt class="py-lineno"> 6</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
+<a name="L7"></a><tt class="py-lineno"> 7</tt>  <tt class="py-line"><tt class="py-comment">#      http://www.apache.org/licenses/LICENSE-2.0</tt> </tt>
+<a name="L8"></a><tt class="py-lineno"> 8</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
+<a name="L9"></a><tt class="py-lineno"> 9</tt>  <tt class="py-line"><tt class="py-comment"># Unless required by applicable law or agreed to in writing, software</tt> </tt>
+<a name="L10"></a><tt class="py-lineno">10</tt>  <tt class="py-line"><tt class="py-comment"># distributed under the License is distributed on an "AS IS" BASIS,</tt> </tt>
+<a name="L11"></a><tt class="py-lineno">11</tt>  <tt class="py-line"><tt class="py-comment"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</tt> </tt>
+<a name="L12"></a><tt class="py-lineno">12</tt>  <tt class="py-line"><tt class="py-comment"># See the License for the specific language governing permissions and</tt> </tt>
+<a name="L13"></a><tt class="py-lineno">13</tt>  <tt class="py-line"><tt class="py-comment"># limitations under the License.</tt> </tt>
+<a name="L14"></a><tt class="py-lineno">14</tt>  <tt class="py-line"> </tt>
+<a name="L15"></a><tt class="py-lineno">15</tt>  <tt class="py-line"><tt class="py-docstring">"""Helpers for authentication using oauth2client or google-auth."""</tt> </tt>
+<a name="L16"></a><tt class="py-lineno">16</tt>  <tt class="py-line"> </tt>
+<a name="L17"></a><tt class="py-lineno">17</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">httplib2</tt> </tt>
+<a name="L18"></a><tt class="py-lineno">18</tt>  <tt class="py-line"> </tt>
+<a name="L19"></a><tt class="py-lineno">19</tt>  <tt class="py-line"><tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L20"></a><tt class="py-lineno">20</tt>  <tt class="py-line">    <tt class="py-keyword">import</tt> <tt class="py-name">google</tt><tt class="py-op">.</tt><tt class="py-name">auth</tt> </tt>
+<a name="L21"></a><tt class="py-lineno">21</tt>  <tt class="py-line">    <tt class="py-keyword">import</tt> <tt class="py-name">google_auth_httplib2</tt> </tt>
+<a name="L22"></a><tt class="py-lineno">22</tt>  <tt class="py-line">    <tt id="link-0" class="py-name" targets="Variable googleapiclient._auth.HAS_GOOGLE_AUTH=googleapiclient._auth-module.html#HAS_GOOGLE_AUTH"><a title="googleapiclient._auth.HAS_GOOGLE_AUTH" class="py-name" href="#" onclick="return doclink('link-0', 'HAS_GOOGLE_AUTH', 'link-0');">HAS_GOOGLE_AUTH</a></tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
+<a name="L23"></a><tt class="py-lineno">23</tt>  <tt class="py-line"><tt class="py-keyword">except</tt> <tt class="py-name">ImportError</tt><tt class="py-op">:</tt>  <tt class="py-comment"># pragma: NO COVER</tt> </tt>
+<a name="L24"></a><tt class="py-lineno">24</tt>  <tt class="py-line">    <tt id="link-1" class="py-name"><a title="googleapiclient._auth.HAS_GOOGLE_AUTH" class="py-name" href="#" onclick="return doclink('link-1', 'HAS_GOOGLE_AUTH', 'link-0');">HAS_GOOGLE_AUTH</a></tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
+<a name="L25"></a><tt class="py-lineno">25</tt>  <tt class="py-line"> </tt>
+<a name="L26"></a><tt class="py-lineno">26</tt>  <tt class="py-line"><tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L27"></a><tt class="py-lineno">27</tt>  <tt class="py-line">    <tt class="py-keyword">import</tt> <tt class="py-name">oauth2client</tt> </tt>
+<a name="L28"></a><tt class="py-lineno">28</tt>  <tt class="py-line">    <tt class="py-keyword">import</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">client</tt> </tt>
+<a name="L29"></a><tt class="py-lineno">29</tt>  <tt class="py-line">    <tt id="link-2" class="py-name" targets="Variable googleapiclient._auth.HAS_OAUTH2CLIENT=googleapiclient._auth-module.html#HAS_OAUTH2CLIENT"><a title="googleapiclient._auth.HAS_OAUTH2CLIENT" class="py-name" href="#" onclick="return doclink('link-2', 'HAS_OAUTH2CLIENT', 'link-2');">HAS_OAUTH2CLIENT</a></tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
+<a name="L30"></a><tt class="py-lineno">30</tt>  <tt class="py-line"><tt class="py-keyword">except</tt> <tt class="py-name">ImportError</tt><tt class="py-op">:</tt>  <tt class="py-comment"># pragma: NO COVER</tt> </tt>
+<a name="L31"></a><tt class="py-lineno">31</tt>  <tt class="py-line">    <tt id="link-3" class="py-name"><a title="googleapiclient._auth.HAS_OAUTH2CLIENT" class="py-name" href="#" onclick="return doclink('link-3', 'HAS_OAUTH2CLIENT', 'link-2');">HAS_OAUTH2CLIENT</a></tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
+<a name="L32"></a><tt class="py-lineno">32</tt>  <tt class="py-line"> </tt>
+<a name="L33"></a><tt class="py-lineno">33</tt>  <tt class="py-line"> </tt>
+<a name="default_credentials"></a><div id="default_credentials-def"><a name="L34"></a><tt class="py-lineno">34</tt> <a class="py-toggle" href="#" id="default_credentials-toggle" onclick="return toggle('default_credentials');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient._auth-module.html#default_credentials">default_credentials</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="default_credentials-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="default_credentials-expanded"><a name="L35"></a><tt class="py-lineno">35</tt>  <tt class="py-line">    <tt class="py-docstring">"""Returns Application Default Credentials."""</tt> </tt>
+<a name="L36"></a><tt class="py-lineno">36</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-4" class="py-name"><a title="googleapiclient._auth.HAS_GOOGLE_AUTH" class="py-name" href="#" onclick="return doclink('link-4', 'HAS_GOOGLE_AUTH', 'link-0');">HAS_GOOGLE_AUTH</a></tt><tt class="py-op">:</tt> </tt>
+<a name="L37"></a><tt class="py-lineno">37</tt>  <tt class="py-line">        <tt class="py-name">credentials</tt><tt class="py-op">,</tt> <tt class="py-name">_</tt> <tt class="py-op">=</tt> <tt class="py-name">google</tt><tt class="py-op">.</tt><tt class="py-name">auth</tt><tt class="py-op">.</tt><tt class="py-name">default</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L38"></a><tt class="py-lineno">38</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">credentials</tt> </tt>
+<a name="L39"></a><tt class="py-lineno">39</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt id="link-5" class="py-name"><a title="googleapiclient._auth.HAS_OAUTH2CLIENT" class="py-name" href="#" onclick="return doclink('link-5', 'HAS_OAUTH2CLIENT', 'link-2');">HAS_OAUTH2CLIENT</a></tt><tt class="py-op">:</tt> </tt>
+<a name="L40"></a><tt class="py-lineno">40</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">client</tt><tt class="py-op">.</tt><tt class="py-name">GoogleCredentials</tt><tt class="py-op">.</tt><tt class="py-name">get_application_default</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L41"></a><tt class="py-lineno">41</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L42"></a><tt class="py-lineno">42</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">EnvironmentError</tt><tt class="py-op">(</tt> </tt>
+<a name="L43"></a><tt class="py-lineno">43</tt>  <tt class="py-line">            <tt class="py-string">'No authentication library is available. Please install either '</tt> </tt>
+<a name="L44"></a><tt class="py-lineno">44</tt>  <tt class="py-line">            <tt class="py-string">'google-auth or oauth2client.'</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L45"></a><tt class="py-lineno">45</tt>  <tt class="py-line"> </tt>
+<a name="L46"></a><tt class="py-lineno">46</tt>  <tt class="py-line"> </tt>
+<a name="with_scopes"></a><div id="with_scopes-def"><a name="L47"></a><tt class="py-lineno">47</tt> <a class="py-toggle" href="#" id="with_scopes-toggle" onclick="return toggle('with_scopes');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient._auth-module.html#with_scopes">with_scopes</a><tt class="py-op">(</tt><tt class="py-param">credentials</tt><tt class="py-op">,</tt> <tt class="py-param">scopes</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="with_scopes-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="with_scopes-expanded"><a name="L48"></a><tt class="py-lineno">48</tt>  <tt class="py-line">    <tt class="py-docstring">"""Scopes the credentials if necessary.</tt> </tt>
+<a name="L49"></a><tt class="py-lineno">49</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L50"></a><tt class="py-lineno">50</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L51"></a><tt class="py-lineno">51</tt>  <tt class="py-line"><tt class="py-docstring">        credentials (Union[</tt> </tt>
+<a name="L52"></a><tt class="py-lineno">52</tt>  <tt class="py-line"><tt class="py-docstring">            google.auth.credentials.Credentials,</tt> </tt>
+<a name="L53"></a><tt class="py-lineno">53</tt>  <tt class="py-line"><tt class="py-docstring">            oauth2client.client.Credentials]): The credentials to scope.</tt> </tt>
+<a name="L54"></a><tt class="py-lineno">54</tt>  <tt class="py-line"><tt class="py-docstring">        scopes (Sequence[str]): The list of scopes.</tt> </tt>
+<a name="L55"></a><tt class="py-lineno">55</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L56"></a><tt class="py-lineno">56</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L57"></a><tt class="py-lineno">57</tt>  <tt class="py-line"><tt class="py-docstring">        Union[google.auth.credentials.Credentials,</tt> </tt>
+<a name="L58"></a><tt class="py-lineno">58</tt>  <tt class="py-line"><tt class="py-docstring">            oauth2client.client.Credentials]: The scoped credentials.</tt> </tt>
+<a name="L59"></a><tt class="py-lineno">59</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L60"></a><tt class="py-lineno">60</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-6" class="py-name"><a title="googleapiclient._auth.HAS_GOOGLE_AUTH" class="py-name" href="#" onclick="return doclink('link-6', 'HAS_GOOGLE_AUTH', 'link-0');">HAS_GOOGLE_AUTH</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt> </tt>
+<a name="L61"></a><tt class="py-lineno">61</tt>  <tt class="py-line">            <tt class="py-name">credentials</tt><tt class="py-op">,</tt> <tt class="py-name">google</tt><tt class="py-op">.</tt><tt class="py-name">auth</tt><tt class="py-op">.</tt><tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">Credentials</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L62"></a><tt class="py-lineno">62</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">google</tt><tt class="py-op">.</tt><tt class="py-name">auth</tt><tt class="py-op">.</tt><tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">with_scopes_if_required</tt><tt class="py-op">(</tt> </tt>
+<a name="L63"></a><tt class="py-lineno">63</tt>  <tt class="py-line">            <tt class="py-name">credentials</tt><tt class="py-op">,</tt> <tt class="py-name">scopes</tt><tt class="py-op">)</tt> </tt>
+<a name="L64"></a><tt class="py-lineno">64</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L65"></a><tt class="py-lineno">65</tt>  <tt class="py-line">        <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L66"></a><tt class="py-lineno">66</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">create_scoped_required</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L67"></a><tt class="py-lineno">67</tt>  <tt class="py-line">                <tt class="py-keyword">return</tt> <tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">create_scoped</tt><tt class="py-op">(</tt><tt class="py-name">scopes</tt><tt class="py-op">)</tt> </tt>
+<a name="L68"></a><tt class="py-lineno">68</tt>  <tt class="py-line">            <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L69"></a><tt class="py-lineno">69</tt>  <tt class="py-line">                <tt class="py-keyword">return</tt> <tt class="py-name">credentials</tt> </tt>
+<a name="L70"></a><tt class="py-lineno">70</tt>  <tt class="py-line">        <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt>
+<a name="L71"></a><tt class="py-lineno">71</tt>  <tt class="py-line">            <tt class="py-keyword">return</tt> <tt class="py-name">credentials</tt> </tt>
+</div><a name="L72"></a><tt class="py-lineno">72</tt>  <tt class="py-line"> </tt>
+<a name="L73"></a><tt class="py-lineno">73</tt>  <tt class="py-line"> </tt>
+<a name="authorized_http"></a><div id="authorized_http-def"><a name="L74"></a><tt class="py-lineno">74</tt> <a class="py-toggle" href="#" id="authorized_http-toggle" onclick="return toggle('authorized_http');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient._auth-module.html#authorized_http">authorized_http</a><tt class="py-op">(</tt><tt class="py-param">credentials</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="authorized_http-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="authorized_http-expanded"><a name="L75"></a><tt class="py-lineno">75</tt>  <tt class="py-line">    <tt class="py-docstring">"""Returns an http client that is authorized with the given credentials.</tt> </tt>
+<a name="L76"></a><tt class="py-lineno">76</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L77"></a><tt class="py-lineno">77</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L78"></a><tt class="py-lineno">78</tt>  <tt class="py-line"><tt class="py-docstring">        credentials (Union[</tt> </tt>
+<a name="L79"></a><tt class="py-lineno">79</tt>  <tt class="py-line"><tt class="py-docstring">            google.auth.credentials.Credentials,</tt> </tt>
+<a name="L80"></a><tt class="py-lineno">80</tt>  <tt class="py-line"><tt class="py-docstring">            oauth2client.client.Credentials]): The credentials to use.</tt> </tt>
+<a name="L81"></a><tt class="py-lineno">81</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L82"></a><tt class="py-lineno">82</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L83"></a><tt class="py-lineno">83</tt>  <tt class="py-line"><tt class="py-docstring">        Union[httplib2.Http, google_auth_httplib2.AuthorizedHttp]: An</tt> </tt>
+<a name="L84"></a><tt class="py-lineno">84</tt>  <tt class="py-line"><tt class="py-docstring">            authorized http client.</tt> </tt>
+<a name="L85"></a><tt class="py-lineno">85</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L86"></a><tt class="py-lineno">86</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-7" class="py-name"><a title="googleapiclient._auth.HAS_GOOGLE_AUTH" class="py-name" href="#" onclick="return doclink('link-7', 'HAS_GOOGLE_AUTH', 'link-0');">HAS_GOOGLE_AUTH</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt> </tt>
+<a name="L87"></a><tt class="py-lineno">87</tt>  <tt class="py-line">            <tt class="py-name">credentials</tt><tt class="py-op">,</tt> <tt class="py-name">google</tt><tt class="py-op">.</tt><tt class="py-name">auth</tt><tt class="py-op">.</tt><tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">Credentials</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L88"></a><tt class="py-lineno">88</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">google_auth_httplib2</tt><tt class="py-op">.</tt><tt class="py-name">AuthorizedHttp</tt><tt class="py-op">(</tt><tt class="py-name">credentials</tt><tt class="py-op">)</tt> </tt>
+<a name="L89"></a><tt class="py-lineno">89</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L90"></a><tt class="py-lineno">90</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">authorize</tt><tt class="py-op">(</tt><tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Http</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L91"></a><tt class="py-lineno">91</tt>  <tt class="py-line"> </tt><script type="text/javascript">
+<!--
+expandto(location.href);
+// -->
+</script>
+</pre>
+<br />
+<!-- ==================== NAVIGATION BAR ==================== -->
+<table class="navbar" border="0" width="100%" cellpadding="0"
+       bgcolor="#a0c0ff" cellspacing="0">
+  <tr valign="middle">
+  <!-- Home link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="googleapiclient-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Tree link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Index link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
+
+  <!-- Help link -->
+      <th>&nbsp;&nbsp;&nbsp;<a
+        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
+
+      <th class="navbar" width="100%"></th>
+  </tr>
+</table>
+<table border="0" cellpadding="0" cellspacing="0" width="100%%">
+  <tr>
+    <td align="left" class="footer">
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
+    </td>
+    <td align="right" class="footer">
+      <a target="mainFrame" href="http://epydoc.sourceforge.net"
+        >http://epydoc.sourceforge.net</a>
+    </td>
+  </tr>
+</table>
+
+<script type="text/javascript">
+  <!--
+  // Private objects are initially displayed (because if
+  // javascript is turned off then we want them to be
+  // visible); but by default, we want to hide them.  So hide
+  // them unless we have a cookie that says to show them.
+  checkCookie();
+  // -->
+</script>
+</body>
+</html>
diff --git a/docs/epy/googleapiclient.channel-module.html b/docs/epy/googleapiclient.channel-module.html
index 2415746cc45..1c2a43f6809 100644
--- a/docs/epy/googleapiclient.channel-module.html
+++ b/docs/epy/googleapiclient.channel-module.html
@@ -455,7 +455,7 @@ <h3 class="epydoc">CHANNEL_PARAMS</h3>
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.channel-pysrc.html b/docs/epy/googleapiclient.channel-pysrc.html
index a14d722be22..48c9f87339e 100644
--- a/docs/epy/googleapiclient.channel-pysrc.html
+++ b/docs/epy/googleapiclient.channel-pysrc.html
@@ -386,7 +386,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.channel-module.html"
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.channel.Channel-class.html b/docs/epy/googleapiclient.channel.Channel-class.html
index 1eff0111b8c..2292f91e385 100644
--- a/docs/epy/googleapiclient.channel.Channel-class.html
+++ b/docs/epy/googleapiclient.channel.Channel-class.html
@@ -59,10 +59,10 @@
 <h1 class="epydoc">Class Channel</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.channel-pysrc.html#Channel">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_2" name="uml_class_diagram_for_googleap_2">
-<area shape="rect" id="node1_3" href="googleapiclient.channel.Channel-class.html#__init__" title="Create a new Channel." alt="" coords="17,40,627,60"/>
-<area shape="rect" id="node1_4" href="googleapiclient.channel.Channel-class.html#body" title="Build a body from the Channel." alt="" coords="17,60,627,80"/>
-<area shape="rect" id="node1_5" href="googleapiclient.channel.Channel-class.html#update" title="Update a channel with information from the response of watch()." alt="" coords="17,80,627,100"/>
-<area shape="rect" id="node1" href="googleapiclient.channel.Channel-class.html" title="A Channel for notifications." alt="" coords="5,6,638,106"/>
+<area shape="rect" id="node1_3" href="googleapiclient.channel.Channel-class.html#__init__" title="Create a new Channel." alt="" coords="17,36,633,55"/>
+<area shape="rect" id="node1_4" href="googleapiclient.channel.Channel-class.html#body" title="Build a body from the Channel." alt="" coords="17,55,633,73"/>
+<area shape="rect" id="node1_5" href="googleapiclient.channel.Channel-class.html#update" title="Update a channel with information from the response of watch()." alt="" coords="17,73,633,92"/>
+<area shape="rect" id="node1" href="googleapiclient.channel.Channel-class.html" title="A Channel for notifications." alt="" coords="5,5,645,99"/>
 </map>
   <img src="uml_class_diagram_for_googleap_2.gif" alt='' usemap="#uml_class_diagram_for_googleap_2" ismap="ismap" class="graph-without-title" />
 </center>
@@ -376,7 +376,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">update</span>(<span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.channel.Notification-class.html b/docs/epy/googleapiclient.channel.Notification-class.html
index 40c5d643b85..bb9c1f8a849 100644
--- a/docs/epy/googleapiclient.channel.Notification-class.html
+++ b/docs/epy/googleapiclient.channel.Notification-class.html
@@ -59,8 +59,8 @@
 <h1 class="epydoc">Class Notification</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.channel-pysrc.html#Notification">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_3" name="uml_class_diagram_for_googleap_3">
-<area shape="rect" id="node1_1" href="googleapiclient.channel.Notification-class.html#__init__" title="Notification constructor." alt="" coords="17,40,401,60"/>
-<area shape="rect" id="node1" href="googleapiclient.channel.Notification-class.html" title="A Notification from a Channel." alt="" coords="5,6,413,66"/>
+<area shape="rect" id="node1_1" href="googleapiclient.channel.Notification-class.html#__init__" title="Notification constructor." alt="" coords="17,36,407,55"/>
+<area shape="rect" id="node1" href="googleapiclient.channel.Notification-class.html" title="A Notification from a Channel." alt="" coords="5,5,419,61"/>
 </map>
   <img src="uml_class_diagram_for_googleap_3.gif" alt='' usemap="#uml_class_diagram_for_googleap_3" ismap="ismap" class="graph-without-title" />
 </center>
@@ -249,7 +249,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery-module.html b/docs/epy/googleapiclient.discovery-module.html
index 009d36e5327..cb8ac4a0e61 100644
--- a/docs/epy/googleapiclient.discovery-module.html
+++ b/docs/epy/googleapiclient.discovery-module.html
@@ -643,7 +643,8 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">build</span>(<span c
   model: googleapiclient.Model, converts to and from the wire format.
   requestBuilder: googleapiclient.http.HttpRequest, encapsulator for an HTTP
     request.
-  credentials: oauth2client.Credentials, credentials to be used for
+  credentials: oauth2client.Credentials or
+    google.auth.credentials.Credentials, credentials to be used for
     authentication.
   cache_discovery: Boolean, whether or not to cache the discovery doc.
   cache: googleapiclient.discovery_cache.base.CacheBase, an optional
@@ -739,7 +740,9 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">build_from_document<
   model: Model class instance that serializes and de-serializes requests and
     responses.
   requestBuilder: Takes an http request and packages it up to be executed.
-  credentials: object, credentials to be used for authentication.
+  credentials: oauth2client.Credentials or
+    google.auth.credentials.Credentials, credentials to be used for
+    authentication.
 
 Returns:
   A Resource object with methods for interacting with the service.
@@ -1250,7 +1253,7 @@ <h3 class="epydoc">STACK_QUERY_PARAMETER_DEFAULT_VALUE</h3>
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery-pysrc.html b/docs/epy/googleapiclient.discovery-pysrc.html
index 0ff4e6e2854..3392f06d37a 100644
--- a/docs/epy/googleapiclient.discovery-pysrc.html
+++ b/docs/epy/googleapiclient.discovery-pysrc.html
@@ -111,1246 +111,1251 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.discovery-module.htm
 <a name="L53"></a><tt class="py-lineno">  53</tt>  <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">uritemplate</tt> </tt>
 <a name="L54"></a><tt class="py-lineno">  54</tt>  <tt class="py-line"> </tt>
 <a name="L55"></a><tt class="py-lineno">  55</tt>  <tt class="py-line"><tt class="py-comment"># Local imports</tt> </tt>
-<a name="L56"></a><tt class="py-lineno">  56</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-0" class="py-name" targets="Package googleapiclient=googleapiclient-module.html"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-0', 'googleapiclient', 'link-0');">googleapiclient</a></tt> <tt class="py-keyword">import</tt> <tt id="link-1" class="py-name" targets="Module googleapiclient.mimeparse=googleapiclient.mimeparse-module.html"><a title="googleapiclient.mimeparse" class="py-name" href="#" onclick="return doclink('link-1', 'mimeparse', 'link-1');">mimeparse</a></tt> </tt>
-<a name="L57"></a><tt class="py-lineno">  57</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-2" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-2', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-3" class="py-name" targets="Module googleapiclient.errors=googleapiclient.errors-module.html"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-3', 'errors', 'link-3');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-4" class="py-name" targets="Class googleapiclient.errors.HttpError=googleapiclient.errors.HttpError-class.html"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-4', 'HttpError', 'link-4');">HttpError</a></tt> </tt>
-<a name="L58"></a><tt class="py-lineno">  58</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-5" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-5', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-6" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-6', 'errors', 'link-3');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-7" class="py-name" targets="Class googleapiclient.errors.InvalidJsonError=googleapiclient.errors.InvalidJsonError-class.html"><a title="googleapiclient.errors.InvalidJsonError" class="py-name" href="#" onclick="return doclink('link-7', 'InvalidJsonError', 'link-7');">InvalidJsonError</a></tt> </tt>
-<a name="L59"></a><tt class="py-lineno">  59</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-8" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-8', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-9" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-9', 'errors', 'link-3');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-10" class="py-name" targets="Class googleapiclient.errors.MediaUploadSizeError=googleapiclient.errors.MediaUploadSizeError-class.html"><a title="googleapiclient.errors.MediaUploadSizeError" class="py-name" href="#" onclick="return doclink('link-10', 'MediaUploadSizeError', 'link-10');">MediaUploadSizeError</a></tt> </tt>
-<a name="L60"></a><tt class="py-lineno">  60</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-11" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-11', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-12" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-12', 'errors', 'link-3');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-13" class="py-name" targets="Class googleapiclient.errors.UnacceptableMimeTypeError=googleapiclient.errors.UnacceptableMimeTypeError-class.html"><a title="googleapiclient.errors.UnacceptableMimeTypeError" class="py-name" href="#" onclick="return doclink('link-13', 'UnacceptableMimeTypeError', 'link-13');">UnacceptableMimeTypeError</a></tt> </tt>
-<a name="L61"></a><tt class="py-lineno">  61</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-14" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-14', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-15" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-15', 'errors', 'link-3');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-16" class="py-name" targets="Class googleapiclient.errors.UnknownApiNameOrVersion=googleapiclient.errors.UnknownApiNameOrVersion-class.html"><a title="googleapiclient.errors.UnknownApiNameOrVersion" class="py-name" href="#" onclick="return doclink('link-16', 'UnknownApiNameOrVersion', 'link-16');">UnknownApiNameOrVersion</a></tt> </tt>
-<a name="L62"></a><tt class="py-lineno">  62</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-17" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-17', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-18" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-18', 'errors', 'link-3');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-19" class="py-name" targets="Class googleapiclient.errors.UnknownFileType=googleapiclient.errors.UnknownFileType-class.html"><a title="googleapiclient.errors.UnknownFileType" class="py-name" href="#" onclick="return doclink('link-19', 'UnknownFileType', 'link-19');">UnknownFileType</a></tt> </tt>
-<a name="L63"></a><tt class="py-lineno">  63</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-20" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-20', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-21" class="py-name" targets="Module googleapiclient.http=googleapiclient.http-module.html"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-21', 'http', 'link-21');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-22" class="py-name" targets="Class googleapiclient.http.BatchHttpRequest=googleapiclient.http.BatchHttpRequest-class.html"><a title="googleapiclient.http.BatchHttpRequest" class="py-name" href="#" onclick="return doclink('link-22', 'BatchHttpRequest', 'link-22');">BatchHttpRequest</a></tt> </tt>
-<a name="L64"></a><tt class="py-lineno">  64</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-23" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-23', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-24" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-24', 'http', 'link-21');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-25" class="py-name" targets="Class googleapiclient.http.HttpMock=googleapiclient.http.HttpMock-class.html"><a title="googleapiclient.http.HttpMock" class="py-name" href="#" onclick="return doclink('link-25', 'HttpMock', 'link-25');">HttpMock</a></tt> </tt>
-<a name="L65"></a><tt class="py-lineno">  65</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-26" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-26', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-27" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-27', 'http', 'link-21');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-28" class="py-name" targets="Class googleapiclient.http.HttpMockSequence=googleapiclient.http.HttpMockSequence-class.html"><a title="googleapiclient.http.HttpMockSequence" class="py-name" href="#" onclick="return doclink('link-28', 'HttpMockSequence', 'link-28');">HttpMockSequence</a></tt> </tt>
-<a name="L66"></a><tt class="py-lineno">  66</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-29" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-29', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-30" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-30', 'http', 'link-21');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-31" class="py-name" targets="Class googleapiclient.http.HttpRequest=googleapiclient.http.HttpRequest-class.html"><a title="googleapiclient.http.HttpRequest" class="py-name" href="#" onclick="return doclink('link-31', 'HttpRequest', 'link-31');">HttpRequest</a></tt> </tt>
-<a name="L67"></a><tt class="py-lineno">  67</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-32" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-32', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-33" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-33', 'http', 'link-21');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-34" class="py-name" targets="Class googleapiclient.http.MediaFileUpload=googleapiclient.http.MediaFileUpload-class.html"><a title="googleapiclient.http.MediaFileUpload" class="py-name" href="#" onclick="return doclink('link-34', 'MediaFileUpload', 'link-34');">MediaFileUpload</a></tt> </tt>
-<a name="L68"></a><tt class="py-lineno">  68</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-35" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-35', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-36" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-36', 'http', 'link-21');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-37" class="py-name" targets="Class googleapiclient.http.MediaUpload=googleapiclient.http.MediaUpload-class.html"><a title="googleapiclient.http.MediaUpload" class="py-name" href="#" onclick="return doclink('link-37', 'MediaUpload', 'link-37');">MediaUpload</a></tt> </tt>
-<a name="L69"></a><tt class="py-lineno">  69</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-38" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-38', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-39" class="py-name" targets="Module googleapiclient.model=googleapiclient.model-module.html"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-39', 'model', 'link-39');">model</a></tt> <tt class="py-keyword">import</tt> <tt id="link-40" class="py-name" targets="Class googleapiclient.model.JsonModel=googleapiclient.model.JsonModel-class.html"><a title="googleapiclient.model.JsonModel" class="py-name" href="#" onclick="return doclink('link-40', 'JsonModel', 'link-40');">JsonModel</a></tt> </tt>
-<a name="L70"></a><tt class="py-lineno">  70</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-41" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-41', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-42" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-42', 'model', 'link-39');">model</a></tt> <tt class="py-keyword">import</tt> <tt id="link-43" class="py-name" targets="Class googleapiclient.model.MediaModel=googleapiclient.model.MediaModel-class.html"><a title="googleapiclient.model.MediaModel" class="py-name" href="#" onclick="return doclink('link-43', 'MediaModel', 'link-43');">MediaModel</a></tt> </tt>
-<a name="L71"></a><tt class="py-lineno">  71</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-44" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-44', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-45" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-45', 'model', 'link-39');">model</a></tt> <tt class="py-keyword">import</tt> <tt id="link-46" class="py-name" targets="Class googleapiclient.model.RawModel=googleapiclient.model.RawModel-class.html"><a title="googleapiclient.model.RawModel" class="py-name" href="#" onclick="return doclink('link-46', 'RawModel', 'link-46');">RawModel</a></tt> </tt>
-<a name="L72"></a><tt class="py-lineno">  72</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-47" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-47', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-48" class="py-name" targets="Module googleapiclient.schema=googleapiclient.schema-module.html"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-48', 'schema', 'link-48');">schema</a></tt> <tt class="py-keyword">import</tt> <tt id="link-49" class="py-name" targets="Class googleapiclient.schema.Schemas=googleapiclient.schema.Schemas-class.html"><a title="googleapiclient.schema.Schemas" class="py-name" href="#" onclick="return doclink('link-49', 'Schemas', 'link-49');">Schemas</a></tt> </tt>
-<a name="L73"></a><tt class="py-lineno">  73</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">client</tt> <tt class="py-keyword">import</tt> <tt class="py-name">GoogleCredentials</tt> </tt>
-<a name="L74"></a><tt class="py-lineno">  74</tt>  <tt class="py-line"> </tt>
-<a name="L75"></a><tt class="py-lineno">  75</tt>  <tt class="py-line"><tt class="py-comment"># Oauth2client &lt; 3 has the positional helper in 'util', &gt;= 3 has it</tt> </tt>
-<a name="L76"></a><tt class="py-lineno">  76</tt>  <tt class="py-line"><tt class="py-comment"># in '_helpers'.</tt> </tt>
-<a name="L77"></a><tt class="py-lineno">  77</tt>  <tt class="py-line"><tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
-<a name="L78"></a><tt class="py-lineno">  78</tt>  <tt class="py-line">  <tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">util</tt> <tt class="py-keyword">import</tt> <tt class="py-name">_add_query_parameter</tt> </tt>
-<a name="L79"></a><tt class="py-lineno">  79</tt>  <tt class="py-line">  <tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">util</tt> <tt class="py-keyword">import</tt> <tt class="py-name">positional</tt> </tt>
-<a name="L80"></a><tt class="py-lineno">  80</tt>  <tt class="py-line"><tt class="py-keyword">except</tt> <tt class="py-name">ImportError</tt><tt class="py-op">:</tt> </tt>
-<a name="L81"></a><tt class="py-lineno">  81</tt>  <tt class="py-line">  <tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">_helpers</tt> <tt class="py-keyword">import</tt> <tt class="py-name">_add_query_parameter</tt> </tt>
-<a name="L82"></a><tt class="py-lineno">  82</tt>  <tt class="py-line">  <tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">_helpers</tt> <tt class="py-keyword">import</tt> <tt class="py-name">positional</tt> </tt>
-<a name="L83"></a><tt class="py-lineno">  83</tt>  <tt class="py-line"> </tt>
+<a name="L56"></a><tt class="py-lineno">  56</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-0" class="py-name" targets="Package googleapiclient=googleapiclient-module.html"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-0', 'googleapiclient', 'link-0');">googleapiclient</a></tt> <tt class="py-keyword">import</tt> <tt id="link-1" class="py-name" targets="Module googleapiclient._auth=googleapiclient._auth-module.html"><a title="googleapiclient._auth" class="py-name" href="#" onclick="return doclink('link-1', '_auth', 'link-1');">_auth</a></tt> </tt>
+<a name="L57"></a><tt class="py-lineno">  57</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-2" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-2', 'googleapiclient', 'link-0');">googleapiclient</a></tt> <tt class="py-keyword">import</tt> <tt id="link-3" class="py-name" targets="Module googleapiclient.mimeparse=googleapiclient.mimeparse-module.html"><a title="googleapiclient.mimeparse" class="py-name" href="#" onclick="return doclink('link-3', 'mimeparse', 'link-3');">mimeparse</a></tt> </tt>
+<a name="L58"></a><tt class="py-lineno">  58</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-4" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-4', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-5" class="py-name" targets="Module googleapiclient.errors=googleapiclient.errors-module.html"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-5', 'errors', 'link-5');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-6" class="py-name" targets="Class googleapiclient.errors.HttpError=googleapiclient.errors.HttpError-class.html"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-6', 'HttpError', 'link-6');">HttpError</a></tt> </tt>
+<a name="L59"></a><tt class="py-lineno">  59</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-7" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-7', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-8" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-8', 'errors', 'link-5');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-9" class="py-name" targets="Class googleapiclient.errors.InvalidJsonError=googleapiclient.errors.InvalidJsonError-class.html"><a title="googleapiclient.errors.InvalidJsonError" class="py-name" href="#" onclick="return doclink('link-9', 'InvalidJsonError', 'link-9');">InvalidJsonError</a></tt> </tt>
+<a name="L60"></a><tt class="py-lineno">  60</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-10" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-10', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-11" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-11', 'errors', 'link-5');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-12" class="py-name" targets="Class googleapiclient.errors.MediaUploadSizeError=googleapiclient.errors.MediaUploadSizeError-class.html"><a title="googleapiclient.errors.MediaUploadSizeError" class="py-name" href="#" onclick="return doclink('link-12', 'MediaUploadSizeError', 'link-12');">MediaUploadSizeError</a></tt> </tt>
+<a name="L61"></a><tt class="py-lineno">  61</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-13" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-13', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-14" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-14', 'errors', 'link-5');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-15" class="py-name" targets="Class googleapiclient.errors.UnacceptableMimeTypeError=googleapiclient.errors.UnacceptableMimeTypeError-class.html"><a title="googleapiclient.errors.UnacceptableMimeTypeError" class="py-name" href="#" onclick="return doclink('link-15', 'UnacceptableMimeTypeError', 'link-15');">UnacceptableMimeTypeError</a></tt> </tt>
+<a name="L62"></a><tt class="py-lineno">  62</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-16" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-16', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-17" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-17', 'errors', 'link-5');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-18" class="py-name" targets="Class googleapiclient.errors.UnknownApiNameOrVersion=googleapiclient.errors.UnknownApiNameOrVersion-class.html"><a title="googleapiclient.errors.UnknownApiNameOrVersion" class="py-name" href="#" onclick="return doclink('link-18', 'UnknownApiNameOrVersion', 'link-18');">UnknownApiNameOrVersion</a></tt> </tt>
+<a name="L63"></a><tt class="py-lineno">  63</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-19" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-19', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-20" class="py-name"><a title="googleapiclient.errors" class="py-name" href="#" onclick="return doclink('link-20', 'errors', 'link-5');">errors</a></tt> <tt class="py-keyword">import</tt> <tt id="link-21" class="py-name" targets="Class googleapiclient.errors.UnknownFileType=googleapiclient.errors.UnknownFileType-class.html"><a title="googleapiclient.errors.UnknownFileType" class="py-name" href="#" onclick="return doclink('link-21', 'UnknownFileType', 'link-21');">UnknownFileType</a></tt> </tt>
+<a name="L64"></a><tt class="py-lineno">  64</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-22" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-22', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-23" class="py-name" targets="Module googleapiclient.http=googleapiclient.http-module.html"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-23', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-24" class="py-name" targets="Class googleapiclient.http.BatchHttpRequest=googleapiclient.http.BatchHttpRequest-class.html"><a title="googleapiclient.http.BatchHttpRequest" class="py-name" href="#" onclick="return doclink('link-24', 'BatchHttpRequest', 'link-24');">BatchHttpRequest</a></tt> </tt>
+<a name="L65"></a><tt class="py-lineno">  65</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-25" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-25', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-26" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-26', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-27" class="py-name" targets="Class googleapiclient.http.HttpMock=googleapiclient.http.HttpMock-class.html"><a title="googleapiclient.http.HttpMock" class="py-name" href="#" onclick="return doclink('link-27', 'HttpMock', 'link-27');">HttpMock</a></tt> </tt>
+<a name="L66"></a><tt class="py-lineno">  66</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-28" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-28', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-29" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-29', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-30" class="py-name" targets="Class googleapiclient.http.HttpMockSequence=googleapiclient.http.HttpMockSequence-class.html"><a title="googleapiclient.http.HttpMockSequence" class="py-name" href="#" onclick="return doclink('link-30', 'HttpMockSequence', 'link-30');">HttpMockSequence</a></tt> </tt>
+<a name="L67"></a><tt class="py-lineno">  67</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-31" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-31', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-32" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-32', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-33" class="py-name" targets="Class googleapiclient.http.HttpRequest=googleapiclient.http.HttpRequest-class.html"><a title="googleapiclient.http.HttpRequest" class="py-name" href="#" onclick="return doclink('link-33', 'HttpRequest', 'link-33');">HttpRequest</a></tt> </tt>
+<a name="L68"></a><tt class="py-lineno">  68</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-34" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-34', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-35" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-35', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-36" class="py-name" targets="Class googleapiclient.http.MediaFileUpload=googleapiclient.http.MediaFileUpload-class.html"><a title="googleapiclient.http.MediaFileUpload" class="py-name" href="#" onclick="return doclink('link-36', 'MediaFileUpload', 'link-36');">MediaFileUpload</a></tt> </tt>
+<a name="L69"></a><tt class="py-lineno">  69</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-37" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-37', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-38" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-38', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">import</tt> <tt id="link-39" class="py-name" targets="Class googleapiclient.http.MediaUpload=googleapiclient.http.MediaUpload-class.html"><a title="googleapiclient.http.MediaUpload" class="py-name" href="#" onclick="return doclink('link-39', 'MediaUpload', 'link-39');">MediaUpload</a></tt> </tt>
+<a name="L70"></a><tt class="py-lineno">  70</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-40" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-40', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-41" class="py-name" targets="Module googleapiclient.model=googleapiclient.model-module.html"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-41', 'model', 'link-41');">model</a></tt> <tt class="py-keyword">import</tt> <tt id="link-42" class="py-name" targets="Class googleapiclient.model.JsonModel=googleapiclient.model.JsonModel-class.html"><a title="googleapiclient.model.JsonModel" class="py-name" href="#" onclick="return doclink('link-42', 'JsonModel', 'link-42');">JsonModel</a></tt> </tt>
+<a name="L71"></a><tt class="py-lineno">  71</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-43" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-43', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-44" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-44', 'model', 'link-41');">model</a></tt> <tt class="py-keyword">import</tt> <tt id="link-45" class="py-name" targets="Class googleapiclient.model.MediaModel=googleapiclient.model.MediaModel-class.html"><a title="googleapiclient.model.MediaModel" class="py-name" href="#" onclick="return doclink('link-45', 'MediaModel', 'link-45');">MediaModel</a></tt> </tt>
+<a name="L72"></a><tt class="py-lineno">  72</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-46" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-46', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-47" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-47', 'model', 'link-41');">model</a></tt> <tt class="py-keyword">import</tt> <tt id="link-48" class="py-name" targets="Class googleapiclient.model.RawModel=googleapiclient.model.RawModel-class.html"><a title="googleapiclient.model.RawModel" class="py-name" href="#" onclick="return doclink('link-48', 'RawModel', 'link-48');">RawModel</a></tt> </tt>
+<a name="L73"></a><tt class="py-lineno">  73</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-49" class="py-name"><a title="googleapiclient" class="py-name" href="#" onclick="return doclink('link-49', 'googleapiclient', 'link-0');">googleapiclient</a></tt><tt class="py-op">.</tt><tt id="link-50" class="py-name" targets="Module googleapiclient.schema=googleapiclient.schema-module.html"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-50', 'schema', 'link-50');">schema</a></tt> <tt class="py-keyword">import</tt> <tt id="link-51" class="py-name" targets="Class googleapiclient.schema.Schemas=googleapiclient.schema.Schemas-class.html"><a title="googleapiclient.schema.Schemas" class="py-name" href="#" onclick="return doclink('link-51', 'Schemas', 'link-51');">Schemas</a></tt> </tt>
+<a name="L74"></a><tt class="py-lineno">  74</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">client</tt> <tt class="py-keyword">import</tt> <tt class="py-name">GoogleCredentials</tt> </tt>
+<a name="L75"></a><tt class="py-lineno">  75</tt>  <tt class="py-line"> </tt>
+<a name="L76"></a><tt class="py-lineno">  76</tt>  <tt class="py-line"><tt class="py-comment"># Oauth2client &lt; 3 has the positional helper in 'util', &gt;= 3 has it</tt> </tt>
+<a name="L77"></a><tt class="py-lineno">  77</tt>  <tt class="py-line"><tt class="py-comment"># in '_helpers'.</tt> </tt>
+<a name="L78"></a><tt class="py-lineno">  78</tt>  <tt class="py-line"><tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L79"></a><tt class="py-lineno">  79</tt>  <tt class="py-line">  <tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">util</tt> <tt class="py-keyword">import</tt> <tt class="py-name">_add_query_parameter</tt> </tt>
+<a name="L80"></a><tt class="py-lineno">  80</tt>  <tt class="py-line">  <tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">util</tt> <tt class="py-keyword">import</tt> <tt class="py-name">positional</tt> </tt>
+<a name="L81"></a><tt class="py-lineno">  81</tt>  <tt class="py-line"><tt class="py-keyword">except</tt> <tt class="py-name">ImportError</tt><tt class="py-op">:</tt> </tt>
+<a name="L82"></a><tt class="py-lineno">  82</tt>  <tt class="py-line">  <tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">_helpers</tt> <tt class="py-keyword">import</tt> <tt class="py-name">_add_query_parameter</tt> </tt>
+<a name="L83"></a><tt class="py-lineno">  83</tt>  <tt class="py-line">  <tt class="py-keyword">from</tt> <tt class="py-name">oauth2client</tt><tt class="py-op">.</tt><tt class="py-name">_helpers</tt> <tt class="py-keyword">import</tt> <tt class="py-name">positional</tt> </tt>
 <a name="L84"></a><tt class="py-lineno">  84</tt>  <tt class="py-line"> </tt>
-<a name="L85"></a><tt class="py-lineno">  85</tt>  <tt class="py-line"><tt class="py-comment"># The client library requires a version of httplib2 that supports RETRIES.</tt> </tt>
-<a name="L86"></a><tt class="py-lineno">  86</tt>  <tt class="py-line"><tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">RETRIES</tt> <tt class="py-op">=</tt> <tt class="py-number">1</tt> </tt>
-<a name="L87"></a><tt class="py-lineno">  87</tt>  <tt class="py-line"> </tt>
-<a name="L88"></a><tt class="py-lineno">  88</tt>  <tt class="py-line"><tt id="link-50" class="py-name" targets="Variable googleapiclient.discovery.logger=googleapiclient.discovery-module.html#logger"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-50', 'logger', 'link-50');">logger</a></tt> <tt class="py-op">=</tt> <tt class="py-name">logging</tt><tt class="py-op">.</tt><tt class="py-name">getLogger</tt><tt class="py-op">(</tt><tt class="py-name">__name__</tt><tt class="py-op">)</tt> </tt>
-<a name="L89"></a><tt class="py-lineno">  89</tt>  <tt class="py-line"> </tt>
-<a name="L90"></a><tt class="py-lineno">  90</tt>  <tt class="py-line"><tt id="link-51" class="py-name" targets="Variable googleapiclient.discovery.URITEMPLATE=googleapiclient.discovery-module.html#URITEMPLATE"><a title="googleapiclient.discovery.URITEMPLATE" class="py-name" href="#" onclick="return doclink('link-51', 'URITEMPLATE', 'link-51');">URITEMPLATE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">'{[^}]*}'</tt><tt class="py-op">)</tt> </tt>
-<a name="L91"></a><tt class="py-lineno">  91</tt>  <tt class="py-line"><tt id="link-52" class="py-name" targets="Variable googleapiclient.discovery.VARNAME=googleapiclient.discovery-module.html#VARNAME"><a title="googleapiclient.discovery.VARNAME" class="py-name" href="#" onclick="return doclink('link-52', 'VARNAME', 'link-52');">VARNAME</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">'[a-zA-Z0-9_-]+'</tt><tt class="py-op">)</tt> </tt>
-<a name="L92"></a><tt class="py-lineno">  92</tt>  <tt class="py-line"><tt id="link-53" class="py-name" targets="Variable googleapiclient.discovery.DISCOVERY_URI=googleapiclient.discovery-module.html#DISCOVERY_URI"><a title="googleapiclient.discovery.DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-53', 'DISCOVERY_URI', 'link-53');">DISCOVERY_URI</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'https://www.googleapis.com/discovery/v1/apis/'</tt> </tt>
-<a name="L93"></a><tt class="py-lineno">  93</tt>  <tt class="py-line">                 <tt class="py-string">'{api}/{apiVersion}/rest'</tt><tt class="py-op">)</tt> </tt>
-<a name="L94"></a><tt class="py-lineno">  94</tt>  <tt class="py-line"><tt id="link-54" class="py-name" targets="Variable googleapiclient.discovery.V1_DISCOVERY_URI=googleapiclient.discovery-module.html#V1_DISCOVERY_URI"><a title="googleapiclient.discovery.V1_DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-54', 'V1_DISCOVERY_URI', 'link-54');">V1_DISCOVERY_URI</a></tt> <tt class="py-op">=</tt> <tt id="link-55" class="py-name"><a title="googleapiclient.discovery.DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-55', 'DISCOVERY_URI', 'link-53');">DISCOVERY_URI</a></tt> </tt>
-<a name="L95"></a><tt class="py-lineno">  95</tt>  <tt class="py-line"><tt id="link-56" class="py-name" targets="Variable googleapiclient.discovery.V2_DISCOVERY_URI=googleapiclient.discovery-module.html#V2_DISCOVERY_URI"><a title="googleapiclient.discovery.V2_DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-56', 'V2_DISCOVERY_URI', 'link-56');">V2_DISCOVERY_URI</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'https://{api}.googleapis.com/$discovery/rest?'</tt> </tt>
-<a name="L96"></a><tt class="py-lineno">  96</tt>  <tt class="py-line">                    <tt class="py-string">'version={apiVersion}'</tt><tt class="py-op">)</tt> </tt>
-<a name="L97"></a><tt class="py-lineno">  97</tt>  <tt class="py-line"><tt id="link-57" class="py-name" targets="Variable googleapiclient.discovery.DEFAULT_METHOD_DOC=googleapiclient.discovery-module.html#DEFAULT_METHOD_DOC"><a title="googleapiclient.discovery.DEFAULT_METHOD_DOC" class="py-name" href="#" onclick="return doclink('link-57', 'DEFAULT_METHOD_DOC', 'link-57');">DEFAULT_METHOD_DOC</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'A description of how to use this function'</tt> </tt>
-<a name="L98"></a><tt class="py-lineno">  98</tt>  <tt class="py-line"><tt id="link-58" class="py-name" targets="Variable googleapiclient.discovery.HTTP_PAYLOAD_METHODS=googleapiclient.discovery-module.html#HTTP_PAYLOAD_METHODS"><a title="googleapiclient.discovery.HTTP_PAYLOAD_METHODS" class="py-name" href="#" onclick="return doclink('link-58', 'HTTP_PAYLOAD_METHODS', 'link-58');">HTTP_PAYLOAD_METHODS</a></tt> <tt class="py-op">=</tt> <tt class="py-name">frozenset</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'PUT'</tt><tt class="py-op">,</tt> <tt class="py-string">'POST'</tt><tt class="py-op">,</tt> <tt class="py-string">'PATCH'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L99"></a><tt class="py-lineno">  99</tt>  <tt class="py-line"><tt id="link-59" class="py-name" targets="Variable googleapiclient.discovery._MEDIA_SIZE_BIT_SHIFTS=googleapiclient.discovery-module.html#_MEDIA_SIZE_BIT_SHIFTS"><a title="googleapiclient.discovery._MEDIA_SIZE_BIT_SHIFTS" class="py-name" href="#" onclick="return doclink('link-59', '_MEDIA_SIZE_BIT_SHIFTS', 'link-59');">_MEDIA_SIZE_BIT_SHIFTS</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-string">'KB'</tt><tt class="py-op">:</tt> <tt class="py-number">10</tt><tt class="py-op">,</tt> <tt class="py-string">'MB'</tt><tt class="py-op">:</tt> <tt class="py-number">20</tt><tt class="py-op">,</tt> <tt class="py-string">'GB'</tt><tt class="py-op">:</tt> <tt class="py-number">30</tt><tt class="py-op">,</tt> <tt class="py-string">'TB'</tt><tt class="py-op">:</tt> <tt class="py-number">40</tt><tt class="py-op">}</tt> </tt>
-<a name="L100"></a><tt class="py-lineno"> 100</tt>  <tt class="py-line"><tt id="link-60" class="py-name" targets="Variable googleapiclient.discovery.BODY_PARAMETER_DEFAULT_VALUE=googleapiclient.discovery-module.html#BODY_PARAMETER_DEFAULT_VALUE"><a title="googleapiclient.discovery.BODY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-60', 'BODY_PARAMETER_DEFAULT_VALUE', 'link-60');">BODY_PARAMETER_DEFAULT_VALUE</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
-<a name="L101"></a><tt class="py-lineno"> 101</tt>  <tt class="py-line">    <tt class="py-string">'description'</tt><tt class="py-op">:</tt> <tt class="py-string">'The request body.'</tt><tt class="py-op">,</tt> </tt>
-<a name="L102"></a><tt class="py-lineno"> 102</tt>  <tt class="py-line">    <tt class="py-string">'type'</tt><tt class="py-op">:</tt> <tt class="py-string">'object'</tt><tt class="py-op">,</tt> </tt>
-<a name="L103"></a><tt class="py-lineno"> 103</tt>  <tt class="py-line">    <tt class="py-string">'required'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
-<a name="L104"></a><tt class="py-lineno"> 104</tt>  <tt class="py-line"><tt class="py-op">}</tt> </tt>
-<a name="L105"></a><tt class="py-lineno"> 105</tt>  <tt class="py-line"><tt id="link-61" class="py-name" targets="Variable googleapiclient.discovery.MEDIA_BODY_PARAMETER_DEFAULT_VALUE=googleapiclient.discovery-module.html#MEDIA_BODY_PARAMETER_DEFAULT_VALUE"><a title="googleapiclient.discovery.MEDIA_BODY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-61', 'MEDIA_BODY_PARAMETER_DEFAULT_VALUE', 'link-61');">MEDIA_BODY_PARAMETER_DEFAULT_VALUE</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
-<a name="L106"></a><tt class="py-lineno"> 106</tt>  <tt class="py-line">    <tt class="py-string">'description'</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt class="py-string">'The filename of the media request body, or an instance '</tt> </tt>
-<a name="L107"></a><tt class="py-lineno"> 107</tt>  <tt class="py-line">                    <tt class="py-string">'of a MediaUpload object.'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
-<a name="L108"></a><tt class="py-lineno"> 108</tt>  <tt class="py-line">    <tt class="py-string">'type'</tt><tt class="py-op">:</tt> <tt class="py-string">'string'</tt><tt class="py-op">,</tt> </tt>
-<a name="L109"></a><tt class="py-lineno"> 109</tt>  <tt class="py-line">    <tt class="py-string">'required'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
-<a name="L110"></a><tt class="py-lineno"> 110</tt>  <tt class="py-line"><tt class="py-op">}</tt> </tt>
-<a name="L111"></a><tt class="py-lineno"> 111</tt>  <tt class="py-line"><tt id="link-62" class="py-name" targets="Variable googleapiclient.discovery.MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE=googleapiclient.discovery-module.html#MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE"><a title="googleapiclient.discovery.MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-62', 'MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE', 'link-62');">MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
-<a name="L112"></a><tt class="py-lineno"> 112</tt>  <tt class="py-line">    <tt class="py-string">'description'</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt class="py-string">'The MIME type of the media request body, or an instance '</tt> </tt>
-<a name="L113"></a><tt class="py-lineno"> 113</tt>  <tt class="py-line">                    <tt class="py-string">'of a MediaUpload object.'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
-<a name="L114"></a><tt class="py-lineno"> 114</tt>  <tt class="py-line">    <tt class="py-string">'type'</tt><tt class="py-op">:</tt> <tt class="py-string">'string'</tt><tt class="py-op">,</tt> </tt>
-<a name="L115"></a><tt class="py-lineno"> 115</tt>  <tt class="py-line">    <tt class="py-string">'required'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
-<a name="L116"></a><tt class="py-lineno"> 116</tt>  <tt class="py-line"><tt class="py-op">}</tt> </tt>
-<a name="L117"></a><tt class="py-lineno"> 117</tt>  <tt class="py-line"> </tt>
-<a name="L118"></a><tt class="py-lineno"> 118</tt>  <tt class="py-line"><tt class="py-comment"># Parameters accepted by the stack, but not visible via discovery.</tt> </tt>
-<a name="L119"></a><tt class="py-lineno"> 119</tt>  <tt class="py-line"><tt class="py-comment"># TODO(dhermes): Remove 'userip' in 'v2'.</tt> </tt>
-<a name="L120"></a><tt class="py-lineno"> 120</tt>  <tt class="py-line"><tt id="link-63" class="py-name" targets="Variable googleapiclient.discovery.STACK_QUERY_PARAMETERS=googleapiclient.discovery-module.html#STACK_QUERY_PARAMETERS"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETERS" class="py-name" href="#" onclick="return doclink('link-63', 'STACK_QUERY_PARAMETERS', 'link-63');">STACK_QUERY_PARAMETERS</a></tt> <tt class="py-op">=</tt> <tt class="py-name">frozenset</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'trace'</tt><tt class="py-op">,</tt> <tt class="py-string">'pp'</tt><tt class="py-op">,</tt> <tt class="py-string">'userip'</tt><tt class="py-op">,</tt> <tt class="py-string">'strict'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L121"></a><tt class="py-lineno"> 121</tt>  <tt class="py-line"><tt id="link-64" class="py-name" targets="Variable googleapiclient.discovery.STACK_QUERY_PARAMETER_DEFAULT_VALUE=googleapiclient.discovery-module.html#STACK_QUERY_PARAMETER_DEFAULT_VALUE"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-64', 'STACK_QUERY_PARAMETER_DEFAULT_VALUE', 'link-64');">STACK_QUERY_PARAMETER_DEFAULT_VALUE</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-string">'type'</tt><tt class="py-op">:</tt> <tt class="py-string">'string'</tt><tt class="py-op">,</tt> <tt class="py-string">'location'</tt><tt class="py-op">:</tt> <tt class="py-string">'query'</tt><tt class="py-op">}</tt> </tt>
-<a name="L122"></a><tt class="py-lineno"> 122</tt>  <tt class="py-line"> </tt>
-<a name="L123"></a><tt class="py-lineno"> 123</tt>  <tt class="py-line"><tt class="py-comment"># Library-specific reserved words beyond Python keywords.</tt> </tt>
-<a name="L124"></a><tt class="py-lineno"> 124</tt>  <tt class="py-line"><tt id="link-65" class="py-name" targets="Variable googleapiclient.discovery.RESERVED_WORDS=googleapiclient.discovery-module.html#RESERVED_WORDS"><a title="googleapiclient.discovery.RESERVED_WORDS" class="py-name" href="#" onclick="return doclink('link-65', 'RESERVED_WORDS', 'link-65');">RESERVED_WORDS</a></tt> <tt class="py-op">=</tt> <tt class="py-name">frozenset</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'body'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="_BytesGenerator"></a><div id="_BytesGenerator-def"><a name="L125"></a><tt class="py-lineno"> 125</tt>  <tt class="py-line"> </tt>
-<a name="L126"></a><tt class="py-lineno"> 126</tt>  <tt class="py-line"><tt class="py-comment"># patch _write_lines to avoid munging '\r' into '\n'</tt> </tt>
-<a name="L127"></a><tt class="py-lineno"> 127</tt>  <tt class="py-line"><tt class="py-comment"># ( https://bugs.python.org/issue18886 https://bugs.python.org/issue19003 )</tt> </tt>
-<a name="L128"></a><tt class="py-lineno"> 128</tt> <a class="py-toggle" href="#" id="_BytesGenerator-toggle" onclick="return toggle('_BytesGenerator');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.discovery._BytesGenerator-class.html">_BytesGenerator</a><tt class="py-op">(</tt><tt class="py-base-class">BytesGenerator</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_BytesGenerator-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_BytesGenerator-expanded"><a name="L129"></a><tt class="py-lineno"> 129</tt>  <tt class="py-line">  <tt id="link-66" class="py-name" targets="Variable googleapiclient.discovery._BytesGenerator._write_lines=googleapiclient.discovery._BytesGenerator-class.html#_write_lines"><a title="googleapiclient.discovery._BytesGenerator._write_lines" class="py-name" href="#" onclick="return doclink('link-66', '_write_lines', 'link-66');">_write_lines</a></tt> <tt class="py-op">=</tt> <tt class="py-name">BytesGenerator</tt><tt class="py-op">.</tt><tt class="py-name">write</tt> </tt>
-</div><a name="L130"></a><tt class="py-lineno"> 130</tt>  <tt class="py-line"> </tt>
-<a name="fix_method_name"></a><div id="fix_method_name-def"><a name="L131"></a><tt class="py-lineno"> 131</tt> <a class="py-toggle" href="#" id="fix_method_name-toggle" onclick="return toggle('fix_method_name');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#fix_method_name">fix_method_name</a><tt class="py-op">(</tt><tt class="py-param">name</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="fix_method_name-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="fix_method_name-expanded"><a name="L132"></a><tt class="py-lineno"> 132</tt>  <tt class="py-line">  <tt class="py-docstring">"""Fix method names to avoid reserved word conflicts.</tt> </tt>
-<a name="L133"></a><tt class="py-lineno"> 133</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L134"></a><tt class="py-lineno"> 134</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L135"></a><tt class="py-lineno"> 135</tt>  <tt class="py-line"><tt class="py-docstring">    name: string, method name.</tt> </tt>
-<a name="L136"></a><tt class="py-lineno"> 136</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L137"></a><tt class="py-lineno"> 137</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L138"></a><tt class="py-lineno"> 138</tt>  <tt class="py-line"><tt class="py-docstring">    The name with a '_' prefixed if the name is a reserved word.</tt> </tt>
-<a name="L139"></a><tt class="py-lineno"> 139</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L140"></a><tt class="py-lineno"> 140</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">keyword</tt><tt class="py-op">.</tt><tt class="py-name">iskeyword</tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt id="link-67" class="py-name"><a title="googleapiclient.discovery.RESERVED_WORDS" class="py-name" href="#" onclick="return doclink('link-67', 'RESERVED_WORDS', 'link-65');">RESERVED_WORDS</a></tt><tt class="py-op">:</tt> </tt>
-<a name="L141"></a><tt class="py-lineno"> 141</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">name</tt> <tt class="py-op">+</tt> <tt class="py-string">'_'</tt> </tt>
-<a name="L142"></a><tt class="py-lineno"> 142</tt>  <tt class="py-line">  <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L143"></a><tt class="py-lineno"> 143</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">name</tt> </tt>
-</div><a name="L144"></a><tt class="py-lineno"> 144</tt>  <tt class="py-line"> </tt>
-<a name="key2param"></a><div id="key2param-def"><a name="L145"></a><tt class="py-lineno"> 145</tt>  <tt class="py-line"> </tt>
-<a name="L146"></a><tt class="py-lineno"> 146</tt> <a class="py-toggle" href="#" id="key2param-toggle" onclick="return toggle('key2param');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#key2param">key2param</a><tt class="py-op">(</tt><tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="key2param-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="key2param-expanded"><a name="L147"></a><tt class="py-lineno"> 147</tt>  <tt class="py-line">  <tt class="py-docstring">"""Converts key names into parameter names.</tt> </tt>
-<a name="L148"></a><tt class="py-lineno"> 148</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L149"></a><tt class="py-lineno"> 149</tt>  <tt class="py-line"><tt class="py-docstring">  For example, converting "max-results" -&gt; "max_results"</tt> </tt>
-<a name="L150"></a><tt class="py-lineno"> 150</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L151"></a><tt class="py-lineno"> 151</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L152"></a><tt class="py-lineno"> 152</tt>  <tt class="py-line"><tt class="py-docstring">    key: string, the method key name.</tt> </tt>
-<a name="L153"></a><tt class="py-lineno"> 153</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L154"></a><tt class="py-lineno"> 154</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L155"></a><tt class="py-lineno"> 155</tt>  <tt class="py-line"><tt class="py-docstring">    A safe method name based on the key name.</tt> </tt>
-<a name="L156"></a><tt class="py-lineno"> 156</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L157"></a><tt class="py-lineno"> 157</tt>  <tt class="py-line">  <tt class="py-name">result</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
-<a name="L158"></a><tt class="py-lineno"> 158</tt>  <tt class="py-line">  <tt class="py-name">key</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
-<a name="L159"></a><tt class="py-lineno"> 159</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">key</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">isalpha</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L160"></a><tt class="py-lineno"> 160</tt>  <tt class="py-line">    <tt class="py-name">result</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'x'</tt><tt class="py-op">)</tt> </tt>
-<a name="L161"></a><tt class="py-lineno"> 161</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">c</tt> <tt class="py-keyword">in</tt> <tt class="py-name">key</tt><tt class="py-op">:</tt> </tt>
-<a name="L162"></a><tt class="py-lineno"> 162</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">c</tt><tt class="py-op">.</tt><tt class="py-name">isalnum</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L163"></a><tt class="py-lineno"> 163</tt>  <tt class="py-line">      <tt class="py-name">result</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">c</tt><tt class="py-op">)</tt> </tt>
-<a name="L164"></a><tt class="py-lineno"> 164</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L165"></a><tt class="py-lineno"> 165</tt>  <tt class="py-line">      <tt class="py-name">result</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'_'</tt><tt class="py-op">)</tt> </tt>
-<a name="L166"></a><tt class="py-lineno"> 166</tt>  <tt class="py-line"> </tt>
-<a name="L167"></a><tt class="py-lineno"> 167</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">result</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L168"></a><tt class="py-lineno"> 168</tt>  <tt class="py-line"> </tt>
-<a name="build"></a><div id="build-def"><a name="L169"></a><tt class="py-lineno"> 169</tt>  <tt class="py-line"> </tt>
-<a name="L170"></a><tt class="py-lineno"> 170</tt>  <tt class="py-line"><tt class="py-decorator">@</tt><tt class="py-decorator">positional</tt><tt class="py-op">(</tt><tt class="py-number">2</tt><tt class="py-op">)</tt> </tt>
-<a name="L171"></a><tt class="py-lineno"> 171</tt> <a class="py-toggle" href="#" id="build-toggle" onclick="return toggle('build');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#build">build</a><tt class="py-op">(</tt><tt class="py-param">serviceName</tt><tt class="py-op">,</tt> </tt>
-<a name="L172"></a><tt class="py-lineno"> 172</tt>  <tt class="py-line">          <tt class="py-param">version</tt><tt class="py-op">,</tt> </tt>
-<a name="L173"></a><tt class="py-lineno"> 173</tt>  <tt class="py-line">          <tt class="py-param">http</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L174"></a><tt class="py-lineno"> 174</tt>  <tt class="py-line">          <tt class="py-param">discoveryServiceUrl</tt><tt class="py-op">=</tt><tt id="link-68" class="py-name"><a title="googleapiclient.discovery.DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-68', 'DISCOVERY_URI', 'link-53');">DISCOVERY_URI</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L175"></a><tt class="py-lineno"> 175</tt>  <tt class="py-line">          <tt class="py-param">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L176"></a><tt class="py-lineno"> 176</tt>  <tt class="py-line">          <tt class="py-param">model</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L177"></a><tt class="py-lineno"> 177</tt>  <tt class="py-line">          <tt class="py-param">requestBuilder</tt><tt class="py-op">=</tt><tt id="link-69" class="py-name"><a title="googleapiclient.http.HttpRequest" class="py-name" href="#" onclick="return doclink('link-69', 'HttpRequest', 'link-31');">HttpRequest</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L178"></a><tt class="py-lineno"> 178</tt>  <tt class="py-line">          <tt class="py-param">credentials</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L179"></a><tt class="py-lineno"> 179</tt>  <tt class="py-line">          <tt class="py-param">cache_discovery</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
-<a name="L180"></a><tt class="py-lineno"> 180</tt>  <tt class="py-line">          <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="build-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="build-expanded"><a name="L181"></a><tt class="py-lineno"> 181</tt>  <tt class="py-line">  <tt class="py-docstring">"""Construct a Resource for interacting with an API.</tt> </tt>
-<a name="L182"></a><tt class="py-lineno"> 182</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L183"></a><tt class="py-lineno"> 183</tt>  <tt class="py-line"><tt class="py-docstring">  Construct a Resource object for interacting with an API. The serviceName and</tt> </tt>
-<a name="L184"></a><tt class="py-lineno"> 184</tt>  <tt class="py-line"><tt class="py-docstring">  version are the names from the Discovery service.</tt> </tt>
-<a name="L185"></a><tt class="py-lineno"> 185</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L186"></a><tt class="py-lineno"> 186</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L187"></a><tt class="py-lineno"> 187</tt>  <tt class="py-line"><tt class="py-docstring">    serviceName: string, name of the service.</tt> </tt>
-<a name="L188"></a><tt class="py-lineno"> 188</tt>  <tt class="py-line"><tt class="py-docstring">    version: string, the version of the service.</tt> </tt>
-<a name="L189"></a><tt class="py-lineno"> 189</tt>  <tt class="py-line"><tt class="py-docstring">    http: httplib2.Http, An instance of httplib2.Http or something that acts</tt> </tt>
-<a name="L190"></a><tt class="py-lineno"> 190</tt>  <tt class="py-line"><tt class="py-docstring">      like it that HTTP requests will be made through.</tt> </tt>
-<a name="L191"></a><tt class="py-lineno"> 191</tt>  <tt class="py-line"><tt class="py-docstring">    discoveryServiceUrl: string, a URI Template that points to the location of</tt> </tt>
-<a name="L192"></a><tt class="py-lineno"> 192</tt>  <tt class="py-line"><tt class="py-docstring">      the discovery service. It should have two parameters {api} and</tt> </tt>
-<a name="L193"></a><tt class="py-lineno"> 193</tt>  <tt class="py-line"><tt class="py-docstring">      {apiVersion} that when filled in produce an absolute URI to the discovery</tt> </tt>
-<a name="L194"></a><tt class="py-lineno"> 194</tt>  <tt class="py-line"><tt class="py-docstring">      document for that service.</tt> </tt>
-<a name="L195"></a><tt class="py-lineno"> 195</tt>  <tt class="py-line"><tt class="py-docstring">    developerKey: string, key obtained from</tt> </tt>
-<a name="L196"></a><tt class="py-lineno"> 196</tt>  <tt class="py-line"><tt class="py-docstring">      https://code.google.com/apis/console.</tt> </tt>
-<a name="L197"></a><tt class="py-lineno"> 197</tt>  <tt class="py-line"><tt class="py-docstring">    model: googleapiclient.Model, converts to and from the wire format.</tt> </tt>
-<a name="L198"></a><tt class="py-lineno"> 198</tt>  <tt class="py-line"><tt class="py-docstring">    requestBuilder: googleapiclient.http.HttpRequest, encapsulator for an HTTP</tt> </tt>
-<a name="L199"></a><tt class="py-lineno"> 199</tt>  <tt class="py-line"><tt class="py-docstring">      request.</tt> </tt>
-<a name="L200"></a><tt class="py-lineno"> 200</tt>  <tt class="py-line"><tt class="py-docstring">    credentials: oauth2client.Credentials, credentials to be used for</tt> </tt>
-<a name="L201"></a><tt class="py-lineno"> 201</tt>  <tt class="py-line"><tt class="py-docstring">      authentication.</tt> </tt>
-<a name="L202"></a><tt class="py-lineno"> 202</tt>  <tt class="py-line"><tt class="py-docstring">    cache_discovery: Boolean, whether or not to cache the discovery doc.</tt> </tt>
-<a name="L203"></a><tt class="py-lineno"> 203</tt>  <tt class="py-line"><tt class="py-docstring">    cache: googleapiclient.discovery_cache.base.CacheBase, an optional</tt> </tt>
-<a name="L204"></a><tt class="py-lineno"> 204</tt>  <tt class="py-line"><tt class="py-docstring">      cache object for the discovery documents.</tt> </tt>
-<a name="L205"></a><tt class="py-lineno"> 205</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L206"></a><tt class="py-lineno"> 206</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L207"></a><tt class="py-lineno"> 207</tt>  <tt class="py-line"><tt class="py-docstring">    A Resource object with methods for interacting with the service.</tt> </tt>
-<a name="L208"></a><tt class="py-lineno"> 208</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L209"></a><tt class="py-lineno"> 209</tt>  <tt class="py-line">  <tt class="py-name">params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
-<a name="L210"></a><tt class="py-lineno"> 210</tt>  <tt class="py-line">      <tt class="py-string">'api'</tt><tt class="py-op">:</tt> <tt class="py-name">serviceName</tt><tt class="py-op">,</tt> </tt>
-<a name="L211"></a><tt class="py-lineno"> 211</tt>  <tt class="py-line">      <tt class="py-string">'apiVersion'</tt><tt class="py-op">:</tt> <tt class="py-name">version</tt> </tt>
-<a name="L212"></a><tt class="py-lineno"> 212</tt>  <tt class="py-line">      <tt class="py-op">}</tt> </tt>
-<a name="L213"></a><tt class="py-lineno"> 213</tt>  <tt class="py-line"> </tt>
-<a name="L214"></a><tt class="py-lineno"> 214</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt id="link-70" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-70', 'http', 'link-21');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L215"></a><tt class="py-lineno"> 215</tt>  <tt class="py-line">    <tt id="link-71" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-71', 'http', 'link-21');">http</a></tt> <tt class="py-op">=</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Http</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L216"></a><tt class="py-lineno"> 216</tt>  <tt class="py-line"> </tt>
-<a name="L217"></a><tt class="py-lineno"> 217</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">discovery_url</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">discoveryServiceUrl</tt><tt class="py-op">,</tt> <tt id="link-72" class="py-name"><a title="googleapiclient.discovery.V2_DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-72', 'V2_DISCOVERY_URI', 'link-56');">V2_DISCOVERY_URI</a></tt><tt class="py-op">,</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L218"></a><tt class="py-lineno"> 218</tt>  <tt class="py-line">    <tt class="py-name">requested_url</tt> <tt class="py-op">=</tt> <tt class="py-name">uritemplate</tt><tt class="py-op">.</tt><tt class="py-name">expand</tt><tt class="py-op">(</tt><tt class="py-name">discovery_url</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">)</tt> </tt>
-<a name="L219"></a><tt class="py-lineno"> 219</tt>  <tt class="py-line"> </tt>
-<a name="L220"></a><tt class="py-lineno"> 220</tt>  <tt class="py-line">    <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
-<a name="L221"></a><tt class="py-lineno"> 221</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-73" class="py-name" targets="Function googleapiclient.discovery._retrieve_discovery_doc()=googleapiclient.discovery-module.html#_retrieve_discovery_doc"><a title="googleapiclient.discovery._retrieve_discovery_doc" class="py-name" href="#" onclick="return doclink('link-73', '_retrieve_discovery_doc', 'link-73');">_retrieve_discovery_doc</a></tt><tt class="py-op">(</tt><tt class="py-name">requested_url</tt><tt class="py-op">,</tt> <tt id="link-74" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-74', 'http', 'link-21');">http</a></tt><tt class="py-op">,</tt> <tt class="py-name">cache_discovery</tt><tt class="py-op">,</tt> </tt>
-<a name="L222"></a><tt class="py-lineno"> 222</tt>  <tt class="py-line">                                        <tt id="link-75" class="py-name" targets="Variable googleapiclient.discovery_cache.appengine_memcache.cache=googleapiclient.discovery_cache.appengine_memcache-module.html#cache,Variable googleapiclient.discovery_cache.file_cache.cache=googleapiclient.discovery_cache.file_cache-module.html#cache"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
-googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-75', 'cache', 'link-75');">cache</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L223"></a><tt class="py-lineno"> 223</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt id="link-76" class="py-name" targets="Function googleapiclient.discovery.build_from_document()=googleapiclient.discovery-module.html#build_from_document"><a title="googleapiclient.discovery.build_from_document" class="py-name" href="#" onclick="return doclink('link-76', 'build_from_document', 'link-76');">build_from_document</a></tt><tt class="py-op">(</tt><tt class="py-name">content</tt><tt class="py-op">,</tt> <tt id="link-77" class="py-name" targets="Module googleapiclient.discovery_cache.base=googleapiclient.discovery_cache.base-module.html"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-77', 'base', 'link-77');">base</a></tt><tt class="py-op">=</tt><tt class="py-name">discovery_url</tt><tt class="py-op">,</tt> <tt id="link-78" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-78', 'http', 'link-21');">http</a></tt><tt class="py-op">=</tt><tt id="link-79" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-79', 'http', 'link-21');">http</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L224"></a><tt class="py-lineno"> 224</tt>  <tt class="py-line">          <tt class="py-name">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">developerKey</tt><tt class="py-op">,</tt> <tt id="link-80" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-80', 'model', 'link-39');">model</a></tt><tt class="py-op">=</tt><tt id="link-81" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-81', 'model', 'link-39');">model</a></tt><tt class="py-op">,</tt> <tt class="py-name">requestBuilder</tt><tt class="py-op">=</tt><tt class="py-name">requestBuilder</tt><tt class="py-op">,</tt> </tt>
-<a name="L225"></a><tt class="py-lineno"> 225</tt>  <tt class="py-line">          <tt class="py-name">credentials</tt><tt class="py-op">=</tt><tt class="py-name">credentials</tt><tt class="py-op">)</tt> </tt>
-<a name="L226"></a><tt class="py-lineno"> 226</tt>  <tt class="py-line">    <tt class="py-keyword">except</tt> <tt id="link-82" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-82', 'HttpError', 'link-4');">HttpError</a></tt> <tt class="py-keyword">as</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
-<a name="L227"></a><tt class="py-lineno"> 227</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">e</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">==</tt> <tt class="py-name">http_client</tt><tt class="py-op">.</tt><tt class="py-name">NOT_FOUND</tt><tt class="py-op">:</tt> </tt>
-<a name="L228"></a><tt class="py-lineno"> 228</tt>  <tt class="py-line">        <tt class="py-keyword">continue</tt> </tt>
-<a name="L229"></a><tt class="py-lineno"> 229</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L230"></a><tt class="py-lineno"> 230</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">e</tt> </tt>
-<a name="L231"></a><tt class="py-lineno"> 231</tt>  <tt class="py-line"> </tt>
-<a name="L232"></a><tt class="py-lineno"> 232</tt>  <tt class="py-line">  <tt class="py-keyword">raise</tt> <tt id="link-83" class="py-name"><a title="googleapiclient.errors.UnknownApiNameOrVersion" class="py-name" href="#" onclick="return doclink('link-83', 'UnknownApiNameOrVersion', 'link-16');">UnknownApiNameOrVersion</a></tt><tt class="py-op">(</tt> </tt>
-<a name="L233"></a><tt class="py-lineno"> 233</tt>  <tt class="py-line">        <tt class="py-string">"name: %s  version: %s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">serviceName</tt><tt class="py-op">,</tt> <tt class="py-name">version</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L234"></a><tt class="py-lineno"> 234</tt>  <tt class="py-line"> </tt>
-<a name="_retrieve_discovery_doc"></a><div id="_retrieve_discovery_doc-def"><a name="L235"></a><tt class="py-lineno"> 235</tt>  <tt class="py-line"> </tt>
-<a name="L236"></a><tt class="py-lineno"> 236</tt> <a class="py-toggle" href="#" id="_retrieve_discovery_doc-toggle" onclick="return toggle('_retrieve_discovery_doc');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_retrieve_discovery_doc">_retrieve_discovery_doc</a><tt class="py-op">(</tt><tt class="py-param">url</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">cache_discovery</tt><tt class="py-op">,</tt> <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_retrieve_discovery_doc-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_retrieve_discovery_doc-expanded"><a name="L237"></a><tt class="py-lineno"> 237</tt>  <tt class="py-line">  <tt class="py-docstring">"""Retrieves the discovery_doc from cache or the internet.</tt> </tt>
-<a name="L238"></a><tt class="py-lineno"> 238</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L239"></a><tt class="py-lineno"> 239</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L240"></a><tt class="py-lineno"> 240</tt>  <tt class="py-line"><tt class="py-docstring">    url: string, the URL of the discovery document.</tt> </tt>
-<a name="L241"></a><tt class="py-lineno"> 241</tt>  <tt class="py-line"><tt class="py-docstring">    http: httplib2.Http, An instance of httplib2.Http or something that acts</tt> </tt>
-<a name="L242"></a><tt class="py-lineno"> 242</tt>  <tt class="py-line"><tt class="py-docstring">      like it through which HTTP requests will be made.</tt> </tt>
-<a name="L243"></a><tt class="py-lineno"> 243</tt>  <tt class="py-line"><tt class="py-docstring">    cache_discovery: Boolean, whether or not to cache the discovery doc.</tt> </tt>
-<a name="L244"></a><tt class="py-lineno"> 244</tt>  <tt class="py-line"><tt class="py-docstring">    cache: googleapiclient.discovery_cache.base.Cache, an optional cache</tt> </tt>
-<a name="L245"></a><tt class="py-lineno"> 245</tt>  <tt class="py-line"><tt class="py-docstring">      object for the discovery documents.</tt> </tt>
-<a name="L246"></a><tt class="py-lineno"> 246</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L247"></a><tt class="py-lineno"> 247</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L248"></a><tt class="py-lineno"> 248</tt>  <tt class="py-line"><tt class="py-docstring">    A unicode string representation of the discovery document.</tt> </tt>
-<a name="L249"></a><tt class="py-lineno"> 249</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L250"></a><tt class="py-lineno"> 250</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">cache_discovery</tt><tt class="py-op">:</tt> </tt>
-<a name="L251"></a><tt class="py-lineno"> 251</tt>  <tt class="py-line">    <tt class="py-keyword">from</tt> <tt class="py-op">.</tt> <tt class="py-keyword">import</tt> <tt id="link-84" class="py-name" targets="Package googleapiclient.discovery_cache=googleapiclient.discovery_cache-module.html"><a title="googleapiclient.discovery_cache" class="py-name" href="#" onclick="return doclink('link-84', 'discovery_cache', 'link-84');">discovery_cache</a></tt> </tt>
-<a name="L252"></a><tt class="py-lineno"> 252</tt>  <tt class="py-line">    <tt class="py-keyword">from</tt> <tt class="py-op">.</tt><tt id="link-85" class="py-name"><a title="googleapiclient.discovery_cache" class="py-name" href="#" onclick="return doclink('link-85', 'discovery_cache', 'link-84');">discovery_cache</a></tt> <tt class="py-keyword">import</tt> <tt id="link-86" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-86', 'base', 'link-77');">base</a></tt> </tt>
-<a name="L253"></a><tt class="py-lineno"> 253</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-87" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
-googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-87', 'cache', 'link-75');">cache</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L254"></a><tt class="py-lineno"> 254</tt>  <tt class="py-line">      <tt id="link-88" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
-googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-88', 'cache', 'link-75');">cache</a></tt> <tt class="py-op">=</tt> <tt id="link-89" class="py-name"><a title="googleapiclient.discovery_cache" class="py-name" href="#" onclick="return doclink('link-89', 'discovery_cache', 'link-84');">discovery_cache</a></tt><tt class="py-op">.</tt><tt id="link-90" class="py-name" targets="Function googleapiclient.discovery_cache.autodetect()=googleapiclient.discovery_cache-module.html#autodetect"><a title="googleapiclient.discovery_cache.autodetect" class="py-name" href="#" onclick="return doclink('link-90', 'autodetect', 'link-90');">autodetect</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L255"></a><tt class="py-lineno"> 255</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-91" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
-googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-91', 'cache', 'link-75');">cache</a></tt><tt class="py-op">:</tt> </tt>
-<a name="L256"></a><tt class="py-lineno"> 256</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-92" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
-googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-92', 'cache', 'link-75');">cache</a></tt><tt class="py-op">.</tt><tt id="link-93" class="py-name" targets="Method googleapiclient.discovery_cache.appengine_memcache.Cache.get()=googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#get,Method googleapiclient.discovery_cache.base.Cache.get()=googleapiclient.discovery_cache.base.Cache-class.html#get,Method googleapiclient.discovery_cache.file_cache.Cache.get()=googleapiclient.discovery_cache.file_cache.Cache-class.html#get,Method googleapiclient.schema.Schemas.get()=googleapiclient.schema.Schemas-class.html#get"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="L85"></a><tt class="py-lineno">  85</tt>  <tt class="py-line"> </tt>
+<a name="L86"></a><tt class="py-lineno">  86</tt>  <tt class="py-line"><tt class="py-comment"># The client library requires a version of httplib2 that supports RETRIES.</tt> </tt>
+<a name="L87"></a><tt class="py-lineno">  87</tt>  <tt class="py-line"><tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">RETRIES</tt> <tt class="py-op">=</tt> <tt class="py-number">1</tt> </tt>
+<a name="L88"></a><tt class="py-lineno">  88</tt>  <tt class="py-line"> </tt>
+<a name="L89"></a><tt class="py-lineno">  89</tt>  <tt class="py-line"><tt id="link-52" class="py-name" targets="Variable googleapiclient.discovery.logger=googleapiclient.discovery-module.html#logger"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-52', 'logger', 'link-52');">logger</a></tt> <tt class="py-op">=</tt> <tt class="py-name">logging</tt><tt class="py-op">.</tt><tt class="py-name">getLogger</tt><tt class="py-op">(</tt><tt class="py-name">__name__</tt><tt class="py-op">)</tt> </tt>
+<a name="L90"></a><tt class="py-lineno">  90</tt>  <tt class="py-line"> </tt>
+<a name="L91"></a><tt class="py-lineno">  91</tt>  <tt class="py-line"><tt id="link-53" class="py-name" targets="Variable googleapiclient.discovery.URITEMPLATE=googleapiclient.discovery-module.html#URITEMPLATE"><a title="googleapiclient.discovery.URITEMPLATE" class="py-name" href="#" onclick="return doclink('link-53', 'URITEMPLATE', 'link-53');">URITEMPLATE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">'{[^}]*}'</tt><tt class="py-op">)</tt> </tt>
+<a name="L92"></a><tt class="py-lineno">  92</tt>  <tt class="py-line"><tt id="link-54" class="py-name" targets="Variable googleapiclient.discovery.VARNAME=googleapiclient.discovery-module.html#VARNAME"><a title="googleapiclient.discovery.VARNAME" class="py-name" href="#" onclick="return doclink('link-54', 'VARNAME', 'link-54');">VARNAME</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">'[a-zA-Z0-9_-]+'</tt><tt class="py-op">)</tt> </tt>
+<a name="L93"></a><tt class="py-lineno">  93</tt>  <tt class="py-line"><tt id="link-55" class="py-name" targets="Variable googleapiclient.discovery.DISCOVERY_URI=googleapiclient.discovery-module.html#DISCOVERY_URI"><a title="googleapiclient.discovery.DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-55', 'DISCOVERY_URI', 'link-55');">DISCOVERY_URI</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'https://www.googleapis.com/discovery/v1/apis/'</tt> </tt>
+<a name="L94"></a><tt class="py-lineno">  94</tt>  <tt class="py-line">                 <tt class="py-string">'{api}/{apiVersion}/rest'</tt><tt class="py-op">)</tt> </tt>
+<a name="L95"></a><tt class="py-lineno">  95</tt>  <tt class="py-line"><tt id="link-56" class="py-name" targets="Variable googleapiclient.discovery.V1_DISCOVERY_URI=googleapiclient.discovery-module.html#V1_DISCOVERY_URI"><a title="googleapiclient.discovery.V1_DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-56', 'V1_DISCOVERY_URI', 'link-56');">V1_DISCOVERY_URI</a></tt> <tt class="py-op">=</tt> <tt id="link-57" class="py-name"><a title="googleapiclient.discovery.DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-57', 'DISCOVERY_URI', 'link-55');">DISCOVERY_URI</a></tt> </tt>
+<a name="L96"></a><tt class="py-lineno">  96</tt>  <tt class="py-line"><tt id="link-58" class="py-name" targets="Variable googleapiclient.discovery.V2_DISCOVERY_URI=googleapiclient.discovery-module.html#V2_DISCOVERY_URI"><a title="googleapiclient.discovery.V2_DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-58', 'V2_DISCOVERY_URI', 'link-58');">V2_DISCOVERY_URI</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'https://{api}.googleapis.com/$discovery/rest?'</tt> </tt>
+<a name="L97"></a><tt class="py-lineno">  97</tt>  <tt class="py-line">                    <tt class="py-string">'version={apiVersion}'</tt><tt class="py-op">)</tt> </tt>
+<a name="L98"></a><tt class="py-lineno">  98</tt>  <tt class="py-line"><tt id="link-59" class="py-name" targets="Variable googleapiclient.discovery.DEFAULT_METHOD_DOC=googleapiclient.discovery-module.html#DEFAULT_METHOD_DOC"><a title="googleapiclient.discovery.DEFAULT_METHOD_DOC" class="py-name" href="#" onclick="return doclink('link-59', 'DEFAULT_METHOD_DOC', 'link-59');">DEFAULT_METHOD_DOC</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'A description of how to use this function'</tt> </tt>
+<a name="L99"></a><tt class="py-lineno">  99</tt>  <tt class="py-line"><tt id="link-60" class="py-name" targets="Variable googleapiclient.discovery.HTTP_PAYLOAD_METHODS=googleapiclient.discovery-module.html#HTTP_PAYLOAD_METHODS"><a title="googleapiclient.discovery.HTTP_PAYLOAD_METHODS" class="py-name" href="#" onclick="return doclink('link-60', 'HTTP_PAYLOAD_METHODS', 'link-60');">HTTP_PAYLOAD_METHODS</a></tt> <tt class="py-op">=</tt> <tt class="py-name">frozenset</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'PUT'</tt><tt class="py-op">,</tt> <tt class="py-string">'POST'</tt><tt class="py-op">,</tt> <tt class="py-string">'PATCH'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L100"></a><tt class="py-lineno"> 100</tt>  <tt class="py-line"><tt id="link-61" class="py-name" targets="Variable googleapiclient.discovery._MEDIA_SIZE_BIT_SHIFTS=googleapiclient.discovery-module.html#_MEDIA_SIZE_BIT_SHIFTS"><a title="googleapiclient.discovery._MEDIA_SIZE_BIT_SHIFTS" class="py-name" href="#" onclick="return doclink('link-61', '_MEDIA_SIZE_BIT_SHIFTS', 'link-61');">_MEDIA_SIZE_BIT_SHIFTS</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-string">'KB'</tt><tt class="py-op">:</tt> <tt class="py-number">10</tt><tt class="py-op">,</tt> <tt class="py-string">'MB'</tt><tt class="py-op">:</tt> <tt class="py-number">20</tt><tt class="py-op">,</tt> <tt class="py-string">'GB'</tt><tt class="py-op">:</tt> <tt class="py-number">30</tt><tt class="py-op">,</tt> <tt class="py-string">'TB'</tt><tt class="py-op">:</tt> <tt class="py-number">40</tt><tt class="py-op">}</tt> </tt>
+<a name="L101"></a><tt class="py-lineno"> 101</tt>  <tt class="py-line"><tt id="link-62" class="py-name" targets="Variable googleapiclient.discovery.BODY_PARAMETER_DEFAULT_VALUE=googleapiclient.discovery-module.html#BODY_PARAMETER_DEFAULT_VALUE"><a title="googleapiclient.discovery.BODY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-62', 'BODY_PARAMETER_DEFAULT_VALUE', 'link-62');">BODY_PARAMETER_DEFAULT_VALUE</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
+<a name="L102"></a><tt class="py-lineno"> 102</tt>  <tt class="py-line">    <tt class="py-string">'description'</tt><tt class="py-op">:</tt> <tt class="py-string">'The request body.'</tt><tt class="py-op">,</tt> </tt>
+<a name="L103"></a><tt class="py-lineno"> 103</tt>  <tt class="py-line">    <tt class="py-string">'type'</tt><tt class="py-op">:</tt> <tt class="py-string">'object'</tt><tt class="py-op">,</tt> </tt>
+<a name="L104"></a><tt class="py-lineno"> 104</tt>  <tt class="py-line">    <tt class="py-string">'required'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
+<a name="L105"></a><tt class="py-lineno"> 105</tt>  <tt class="py-line"><tt class="py-op">}</tt> </tt>
+<a name="L106"></a><tt class="py-lineno"> 106</tt>  <tt class="py-line"><tt id="link-63" class="py-name" targets="Variable googleapiclient.discovery.MEDIA_BODY_PARAMETER_DEFAULT_VALUE=googleapiclient.discovery-module.html#MEDIA_BODY_PARAMETER_DEFAULT_VALUE"><a title="googleapiclient.discovery.MEDIA_BODY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-63', 'MEDIA_BODY_PARAMETER_DEFAULT_VALUE', 'link-63');">MEDIA_BODY_PARAMETER_DEFAULT_VALUE</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
+<a name="L107"></a><tt class="py-lineno"> 107</tt>  <tt class="py-line">    <tt class="py-string">'description'</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt class="py-string">'The filename of the media request body, or an instance '</tt> </tt>
+<a name="L108"></a><tt class="py-lineno"> 108</tt>  <tt class="py-line">                    <tt class="py-string">'of a MediaUpload object.'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
+<a name="L109"></a><tt class="py-lineno"> 109</tt>  <tt class="py-line">    <tt class="py-string">'type'</tt><tt class="py-op">:</tt> <tt class="py-string">'string'</tt><tt class="py-op">,</tt> </tt>
+<a name="L110"></a><tt class="py-lineno"> 110</tt>  <tt class="py-line">    <tt class="py-string">'required'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
+<a name="L111"></a><tt class="py-lineno"> 111</tt>  <tt class="py-line"><tt class="py-op">}</tt> </tt>
+<a name="L112"></a><tt class="py-lineno"> 112</tt>  <tt class="py-line"><tt id="link-64" class="py-name" targets="Variable googleapiclient.discovery.MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE=googleapiclient.discovery-module.html#MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE"><a title="googleapiclient.discovery.MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-64', 'MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE', 'link-64');">MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
+<a name="L113"></a><tt class="py-lineno"> 113</tt>  <tt class="py-line">    <tt class="py-string">'description'</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt class="py-string">'The MIME type of the media request body, or an instance '</tt> </tt>
+<a name="L114"></a><tt class="py-lineno"> 114</tt>  <tt class="py-line">                    <tt class="py-string">'of a MediaUpload object.'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
+<a name="L115"></a><tt class="py-lineno"> 115</tt>  <tt class="py-line">    <tt class="py-string">'type'</tt><tt class="py-op">:</tt> <tt class="py-string">'string'</tt><tt class="py-op">,</tt> </tt>
+<a name="L116"></a><tt class="py-lineno"> 116</tt>  <tt class="py-line">    <tt class="py-string">'required'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
+<a name="L117"></a><tt class="py-lineno"> 117</tt>  <tt class="py-line"><tt class="py-op">}</tt> </tt>
+<a name="L118"></a><tt class="py-lineno"> 118</tt>  <tt class="py-line"> </tt>
+<a name="L119"></a><tt class="py-lineno"> 119</tt>  <tt class="py-line"><tt class="py-comment"># Parameters accepted by the stack, but not visible via discovery.</tt> </tt>
+<a name="L120"></a><tt class="py-lineno"> 120</tt>  <tt class="py-line"><tt class="py-comment"># TODO(dhermes): Remove 'userip' in 'v2'.</tt> </tt>
+<a name="L121"></a><tt class="py-lineno"> 121</tt>  <tt class="py-line"><tt id="link-65" class="py-name" targets="Variable googleapiclient.discovery.STACK_QUERY_PARAMETERS=googleapiclient.discovery-module.html#STACK_QUERY_PARAMETERS"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETERS" class="py-name" href="#" onclick="return doclink('link-65', 'STACK_QUERY_PARAMETERS', 'link-65');">STACK_QUERY_PARAMETERS</a></tt> <tt class="py-op">=</tt> <tt class="py-name">frozenset</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'trace'</tt><tt class="py-op">,</tt> <tt class="py-string">'pp'</tt><tt class="py-op">,</tt> <tt class="py-string">'userip'</tt><tt class="py-op">,</tt> <tt class="py-string">'strict'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L122"></a><tt class="py-lineno"> 122</tt>  <tt class="py-line"><tt id="link-66" class="py-name" targets="Variable googleapiclient.discovery.STACK_QUERY_PARAMETER_DEFAULT_VALUE=googleapiclient.discovery-module.html#STACK_QUERY_PARAMETER_DEFAULT_VALUE"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-66', 'STACK_QUERY_PARAMETER_DEFAULT_VALUE', 'link-66');">STACK_QUERY_PARAMETER_DEFAULT_VALUE</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-string">'type'</tt><tt class="py-op">:</tt> <tt class="py-string">'string'</tt><tt class="py-op">,</tt> <tt class="py-string">'location'</tt><tt class="py-op">:</tt> <tt class="py-string">'query'</tt><tt class="py-op">}</tt> </tt>
+<a name="L123"></a><tt class="py-lineno"> 123</tt>  <tt class="py-line"> </tt>
+<a name="L124"></a><tt class="py-lineno"> 124</tt>  <tt class="py-line"><tt class="py-comment"># Library-specific reserved words beyond Python keywords.</tt> </tt>
+<a name="L125"></a><tt class="py-lineno"> 125</tt>  <tt class="py-line"><tt id="link-67" class="py-name" targets="Variable googleapiclient.discovery.RESERVED_WORDS=googleapiclient.discovery-module.html#RESERVED_WORDS"><a title="googleapiclient.discovery.RESERVED_WORDS" class="py-name" href="#" onclick="return doclink('link-67', 'RESERVED_WORDS', 'link-67');">RESERVED_WORDS</a></tt> <tt class="py-op">=</tt> <tt class="py-name">frozenset</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'body'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="_BytesGenerator"></a><div id="_BytesGenerator-def"><a name="L126"></a><tt class="py-lineno"> 126</tt>  <tt class="py-line"> </tt>
+<a name="L127"></a><tt class="py-lineno"> 127</tt>  <tt class="py-line"><tt class="py-comment"># patch _write_lines to avoid munging '\r' into '\n'</tt> </tt>
+<a name="L128"></a><tt class="py-lineno"> 128</tt>  <tt class="py-line"><tt class="py-comment"># ( https://bugs.python.org/issue18886 https://bugs.python.org/issue19003 )</tt> </tt>
+<a name="L129"></a><tt class="py-lineno"> 129</tt> <a class="py-toggle" href="#" id="_BytesGenerator-toggle" onclick="return toggle('_BytesGenerator');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.discovery._BytesGenerator-class.html">_BytesGenerator</a><tt class="py-op">(</tt><tt class="py-base-class">BytesGenerator</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_BytesGenerator-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_BytesGenerator-expanded"><a name="L130"></a><tt class="py-lineno"> 130</tt>  <tt class="py-line">  <tt id="link-68" class="py-name" targets="Variable googleapiclient.discovery._BytesGenerator._write_lines=googleapiclient.discovery._BytesGenerator-class.html#_write_lines"><a title="googleapiclient.discovery._BytesGenerator._write_lines" class="py-name" href="#" onclick="return doclink('link-68', '_write_lines', 'link-68');">_write_lines</a></tt> <tt class="py-op">=</tt> <tt class="py-name">BytesGenerator</tt><tt class="py-op">.</tt><tt class="py-name">write</tt> </tt>
+</div><a name="L131"></a><tt class="py-lineno"> 131</tt>  <tt class="py-line"> </tt>
+<a name="fix_method_name"></a><div id="fix_method_name-def"><a name="L132"></a><tt class="py-lineno"> 132</tt> <a class="py-toggle" href="#" id="fix_method_name-toggle" onclick="return toggle('fix_method_name');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#fix_method_name">fix_method_name</a><tt class="py-op">(</tt><tt class="py-param">name</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="fix_method_name-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="fix_method_name-expanded"><a name="L133"></a><tt class="py-lineno"> 133</tt>  <tt class="py-line">  <tt class="py-docstring">"""Fix method names to avoid reserved word conflicts.</tt> </tt>
+<a name="L134"></a><tt class="py-lineno"> 134</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L135"></a><tt class="py-lineno"> 135</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L136"></a><tt class="py-lineno"> 136</tt>  <tt class="py-line"><tt class="py-docstring">    name: string, method name.</tt> </tt>
+<a name="L137"></a><tt class="py-lineno"> 137</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L138"></a><tt class="py-lineno"> 138</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L139"></a><tt class="py-lineno"> 139</tt>  <tt class="py-line"><tt class="py-docstring">    The name with a '_' prefixed if the name is a reserved word.</tt> </tt>
+<a name="L140"></a><tt class="py-lineno"> 140</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L141"></a><tt class="py-lineno"> 141</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">keyword</tt><tt class="py-op">.</tt><tt class="py-name">iskeyword</tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt id="link-69" class="py-name"><a title="googleapiclient.discovery.RESERVED_WORDS" class="py-name" href="#" onclick="return doclink('link-69', 'RESERVED_WORDS', 'link-67');">RESERVED_WORDS</a></tt><tt class="py-op">:</tt> </tt>
+<a name="L142"></a><tt class="py-lineno"> 142</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">name</tt> <tt class="py-op">+</tt> <tt class="py-string">'_'</tt> </tt>
+<a name="L143"></a><tt class="py-lineno"> 143</tt>  <tt class="py-line">  <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L144"></a><tt class="py-lineno"> 144</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">name</tt> </tt>
+</div><a name="L145"></a><tt class="py-lineno"> 145</tt>  <tt class="py-line"> </tt>
+<a name="key2param"></a><div id="key2param-def"><a name="L146"></a><tt class="py-lineno"> 146</tt>  <tt class="py-line"> </tt>
+<a name="L147"></a><tt class="py-lineno"> 147</tt> <a class="py-toggle" href="#" id="key2param-toggle" onclick="return toggle('key2param');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#key2param">key2param</a><tt class="py-op">(</tt><tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="key2param-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="key2param-expanded"><a name="L148"></a><tt class="py-lineno"> 148</tt>  <tt class="py-line">  <tt class="py-docstring">"""Converts key names into parameter names.</tt> </tt>
+<a name="L149"></a><tt class="py-lineno"> 149</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L150"></a><tt class="py-lineno"> 150</tt>  <tt class="py-line"><tt class="py-docstring">  For example, converting "max-results" -&gt; "max_results"</tt> </tt>
+<a name="L151"></a><tt class="py-lineno"> 151</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L152"></a><tt class="py-lineno"> 152</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L153"></a><tt class="py-lineno"> 153</tt>  <tt class="py-line"><tt class="py-docstring">    key: string, the method key name.</tt> </tt>
+<a name="L154"></a><tt class="py-lineno"> 154</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L155"></a><tt class="py-lineno"> 155</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L156"></a><tt class="py-lineno"> 156</tt>  <tt class="py-line"><tt class="py-docstring">    A safe method name based on the key name.</tt> </tt>
+<a name="L157"></a><tt class="py-lineno"> 157</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L158"></a><tt class="py-lineno"> 158</tt>  <tt class="py-line">  <tt class="py-name">result</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+<a name="L159"></a><tt class="py-lineno"> 159</tt>  <tt class="py-line">  <tt class="py-name">key</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
+<a name="L160"></a><tt class="py-lineno"> 160</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">key</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">isalpha</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L161"></a><tt class="py-lineno"> 161</tt>  <tt class="py-line">    <tt class="py-name">result</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'x'</tt><tt class="py-op">)</tt> </tt>
+<a name="L162"></a><tt class="py-lineno"> 162</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">c</tt> <tt class="py-keyword">in</tt> <tt class="py-name">key</tt><tt class="py-op">:</tt> </tt>
+<a name="L163"></a><tt class="py-lineno"> 163</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">c</tt><tt class="py-op">.</tt><tt class="py-name">isalnum</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L164"></a><tt class="py-lineno"> 164</tt>  <tt class="py-line">      <tt class="py-name">result</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">c</tt><tt class="py-op">)</tt> </tt>
+<a name="L165"></a><tt class="py-lineno"> 165</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L166"></a><tt class="py-lineno"> 166</tt>  <tt class="py-line">      <tt class="py-name">result</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'_'</tt><tt class="py-op">)</tt> </tt>
+<a name="L167"></a><tt class="py-lineno"> 167</tt>  <tt class="py-line"> </tt>
+<a name="L168"></a><tt class="py-lineno"> 168</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">result</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L169"></a><tt class="py-lineno"> 169</tt>  <tt class="py-line"> </tt>
+<a name="build"></a><div id="build-def"><a name="L170"></a><tt class="py-lineno"> 170</tt>  <tt class="py-line"> </tt>
+<a name="L171"></a><tt class="py-lineno"> 171</tt>  <tt class="py-line"><tt class="py-decorator">@</tt><tt class="py-decorator">positional</tt><tt class="py-op">(</tt><tt class="py-number">2</tt><tt class="py-op">)</tt> </tt>
+<a name="L172"></a><tt class="py-lineno"> 172</tt> <a class="py-toggle" href="#" id="build-toggle" onclick="return toggle('build');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#build">build</a><tt class="py-op">(</tt><tt class="py-param">serviceName</tt><tt class="py-op">,</tt> </tt>
+<a name="L173"></a><tt class="py-lineno"> 173</tt>  <tt class="py-line">          <tt class="py-param">version</tt><tt class="py-op">,</tt> </tt>
+<a name="L174"></a><tt class="py-lineno"> 174</tt>  <tt class="py-line">          <tt class="py-param">http</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L175"></a><tt class="py-lineno"> 175</tt>  <tt class="py-line">          <tt class="py-param">discoveryServiceUrl</tt><tt class="py-op">=</tt><tt id="link-70" class="py-name"><a title="googleapiclient.discovery.DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-70', 'DISCOVERY_URI', 'link-55');">DISCOVERY_URI</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L176"></a><tt class="py-lineno"> 176</tt>  <tt class="py-line">          <tt class="py-param">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L177"></a><tt class="py-lineno"> 177</tt>  <tt class="py-line">          <tt class="py-param">model</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L178"></a><tt class="py-lineno"> 178</tt>  <tt class="py-line">          <tt class="py-param">requestBuilder</tt><tt class="py-op">=</tt><tt id="link-71" class="py-name"><a title="googleapiclient.http.HttpRequest" class="py-name" href="#" onclick="return doclink('link-71', 'HttpRequest', 'link-33');">HttpRequest</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L179"></a><tt class="py-lineno"> 179</tt>  <tt class="py-line">          <tt class="py-param">credentials</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L180"></a><tt class="py-lineno"> 180</tt>  <tt class="py-line">          <tt class="py-param">cache_discovery</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
+<a name="L181"></a><tt class="py-lineno"> 181</tt>  <tt class="py-line">          <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="build-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="build-expanded"><a name="L182"></a><tt class="py-lineno"> 182</tt>  <tt class="py-line">  <tt class="py-docstring">"""Construct a Resource for interacting with an API.</tt> </tt>
+<a name="L183"></a><tt class="py-lineno"> 183</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L184"></a><tt class="py-lineno"> 184</tt>  <tt class="py-line"><tt class="py-docstring">  Construct a Resource object for interacting with an API. The serviceName and</tt> </tt>
+<a name="L185"></a><tt class="py-lineno"> 185</tt>  <tt class="py-line"><tt class="py-docstring">  version are the names from the Discovery service.</tt> </tt>
+<a name="L186"></a><tt class="py-lineno"> 186</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L187"></a><tt class="py-lineno"> 187</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L188"></a><tt class="py-lineno"> 188</tt>  <tt class="py-line"><tt class="py-docstring">    serviceName: string, name of the service.</tt> </tt>
+<a name="L189"></a><tt class="py-lineno"> 189</tt>  <tt class="py-line"><tt class="py-docstring">    version: string, the version of the service.</tt> </tt>
+<a name="L190"></a><tt class="py-lineno"> 190</tt>  <tt class="py-line"><tt class="py-docstring">    http: httplib2.Http, An instance of httplib2.Http or something that acts</tt> </tt>
+<a name="L191"></a><tt class="py-lineno"> 191</tt>  <tt class="py-line"><tt class="py-docstring">      like it that HTTP requests will be made through.</tt> </tt>
+<a name="L192"></a><tt class="py-lineno"> 192</tt>  <tt class="py-line"><tt class="py-docstring">    discoveryServiceUrl: string, a URI Template that points to the location of</tt> </tt>
+<a name="L193"></a><tt class="py-lineno"> 193</tt>  <tt class="py-line"><tt class="py-docstring">      the discovery service. It should have two parameters {api} and</tt> </tt>
+<a name="L194"></a><tt class="py-lineno"> 194</tt>  <tt class="py-line"><tt class="py-docstring">      {apiVersion} that when filled in produce an absolute URI to the discovery</tt> </tt>
+<a name="L195"></a><tt class="py-lineno"> 195</tt>  <tt class="py-line"><tt class="py-docstring">      document for that service.</tt> </tt>
+<a name="L196"></a><tt class="py-lineno"> 196</tt>  <tt class="py-line"><tt class="py-docstring">    developerKey: string, key obtained from</tt> </tt>
+<a name="L197"></a><tt class="py-lineno"> 197</tt>  <tt class="py-line"><tt class="py-docstring">      https://code.google.com/apis/console.</tt> </tt>
+<a name="L198"></a><tt class="py-lineno"> 198</tt>  <tt class="py-line"><tt class="py-docstring">    model: googleapiclient.Model, converts to and from the wire format.</tt> </tt>
+<a name="L199"></a><tt class="py-lineno"> 199</tt>  <tt class="py-line"><tt class="py-docstring">    requestBuilder: googleapiclient.http.HttpRequest, encapsulator for an HTTP</tt> </tt>
+<a name="L200"></a><tt class="py-lineno"> 200</tt>  <tt class="py-line"><tt class="py-docstring">      request.</tt> </tt>
+<a name="L201"></a><tt class="py-lineno"> 201</tt>  <tt class="py-line"><tt class="py-docstring">    credentials: oauth2client.Credentials or</tt> </tt>
+<a name="L202"></a><tt class="py-lineno"> 202</tt>  <tt class="py-line"><tt class="py-docstring">      google.auth.credentials.Credentials, credentials to be used for</tt> </tt>
+<a name="L203"></a><tt class="py-lineno"> 203</tt>  <tt class="py-line"><tt class="py-docstring">      authentication.</tt> </tt>
+<a name="L204"></a><tt class="py-lineno"> 204</tt>  <tt class="py-line"><tt class="py-docstring">    cache_discovery: Boolean, whether or not to cache the discovery doc.</tt> </tt>
+<a name="L205"></a><tt class="py-lineno"> 205</tt>  <tt class="py-line"><tt class="py-docstring">    cache: googleapiclient.discovery_cache.base.CacheBase, an optional</tt> </tt>
+<a name="L206"></a><tt class="py-lineno"> 206</tt>  <tt class="py-line"><tt class="py-docstring">      cache object for the discovery documents.</tt> </tt>
+<a name="L207"></a><tt class="py-lineno"> 207</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L208"></a><tt class="py-lineno"> 208</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L209"></a><tt class="py-lineno"> 209</tt>  <tt class="py-line"><tt class="py-docstring">    A Resource object with methods for interacting with the service.</tt> </tt>
+<a name="L210"></a><tt class="py-lineno"> 210</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L211"></a><tt class="py-lineno"> 211</tt>  <tt class="py-line">  <tt class="py-name">params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
+<a name="L212"></a><tt class="py-lineno"> 212</tt>  <tt class="py-line">      <tt class="py-string">'api'</tt><tt class="py-op">:</tt> <tt class="py-name">serviceName</tt><tt class="py-op">,</tt> </tt>
+<a name="L213"></a><tt class="py-lineno"> 213</tt>  <tt class="py-line">      <tt class="py-string">'apiVersion'</tt><tt class="py-op">:</tt> <tt class="py-name">version</tt> </tt>
+<a name="L214"></a><tt class="py-lineno"> 214</tt>  <tt class="py-line">      <tt class="py-op">}</tt> </tt>
+<a name="L215"></a><tt class="py-lineno"> 215</tt>  <tt class="py-line"> </tt>
+<a name="L216"></a><tt class="py-lineno"> 216</tt>  <tt class="py-line">  <tt class="py-name">discovery_http</tt> <tt class="py-op">=</tt> <tt id="link-72" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-72', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">if</tt> <tt id="link-73" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-73', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">else</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Http</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L217"></a><tt class="py-lineno"> 217</tt>  <tt class="py-line"> </tt>
+<a name="L218"></a><tt class="py-lineno"> 218</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">discovery_url</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">discoveryServiceUrl</tt><tt class="py-op">,</tt> <tt id="link-74" class="py-name"><a title="googleapiclient.discovery.V2_DISCOVERY_URI" class="py-name" href="#" onclick="return doclink('link-74', 'V2_DISCOVERY_URI', 'link-58');">V2_DISCOVERY_URI</a></tt><tt class="py-op">,</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L219"></a><tt class="py-lineno"> 219</tt>  <tt class="py-line">    <tt class="py-name">requested_url</tt> <tt class="py-op">=</tt> <tt class="py-name">uritemplate</tt><tt class="py-op">.</tt><tt class="py-name">expand</tt><tt class="py-op">(</tt><tt class="py-name">discovery_url</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">)</tt> </tt>
+<a name="L220"></a><tt class="py-lineno"> 220</tt>  <tt class="py-line"> </tt>
+<a name="L221"></a><tt class="py-lineno"> 221</tt>  <tt class="py-line">    <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L222"></a><tt class="py-lineno"> 222</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-75" class="py-name" targets="Function googleapiclient.discovery._retrieve_discovery_doc()=googleapiclient.discovery-module.html#_retrieve_discovery_doc"><a title="googleapiclient.discovery._retrieve_discovery_doc" class="py-name" href="#" onclick="return doclink('link-75', '_retrieve_discovery_doc', 'link-75');">_retrieve_discovery_doc</a></tt><tt class="py-op">(</tt> </tt>
+<a name="L223"></a><tt class="py-lineno"> 223</tt>  <tt class="py-line">        <tt class="py-name">requested_url</tt><tt class="py-op">,</tt> <tt class="py-name">discovery_http</tt><tt class="py-op">,</tt> <tt class="py-name">cache_discovery</tt><tt class="py-op">,</tt> <tt id="link-76" class="py-name" targets="Variable googleapiclient.discovery_cache.appengine_memcache.cache=googleapiclient.discovery_cache.appengine_memcache-module.html#cache,Variable googleapiclient.discovery_cache.file_cache.cache=googleapiclient.discovery_cache.file_cache-module.html#cache"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
+googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-76', 'cache', 'link-76');">cache</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L224"></a><tt class="py-lineno"> 224</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt id="link-77" class="py-name" targets="Function googleapiclient.discovery.build_from_document()=googleapiclient.discovery-module.html#build_from_document"><a title="googleapiclient.discovery.build_from_document" class="py-name" href="#" onclick="return doclink('link-77', 'build_from_document', 'link-77');">build_from_document</a></tt><tt class="py-op">(</tt><tt class="py-name">content</tt><tt class="py-op">,</tt> <tt id="link-78" class="py-name" targets="Module googleapiclient.discovery_cache.base=googleapiclient.discovery_cache.base-module.html"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-78', 'base', 'link-78');">base</a></tt><tt class="py-op">=</tt><tt class="py-name">discovery_url</tt><tt class="py-op">,</tt> <tt id="link-79" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-79', 'http', 'link-23');">http</a></tt><tt class="py-op">=</tt><tt id="link-80" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-80', 'http', 'link-23');">http</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L225"></a><tt class="py-lineno"> 225</tt>  <tt class="py-line">          <tt class="py-name">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">developerKey</tt><tt class="py-op">,</tt> <tt id="link-81" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-81', 'model', 'link-41');">model</a></tt><tt class="py-op">=</tt><tt id="link-82" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-82', 'model', 'link-41');">model</a></tt><tt class="py-op">,</tt> <tt class="py-name">requestBuilder</tt><tt class="py-op">=</tt><tt class="py-name">requestBuilder</tt><tt class="py-op">,</tt> </tt>
+<a name="L226"></a><tt class="py-lineno"> 226</tt>  <tt class="py-line">          <tt class="py-name">credentials</tt><tt class="py-op">=</tt><tt class="py-name">credentials</tt><tt class="py-op">)</tt> </tt>
+<a name="L227"></a><tt class="py-lineno"> 227</tt>  <tt class="py-line">    <tt class="py-keyword">except</tt> <tt id="link-83" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-83', 'HttpError', 'link-6');">HttpError</a></tt> <tt class="py-keyword">as</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
+<a name="L228"></a><tt class="py-lineno"> 228</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">e</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">==</tt> <tt class="py-name">http_client</tt><tt class="py-op">.</tt><tt class="py-name">NOT_FOUND</tt><tt class="py-op">:</tt> </tt>
+<a name="L229"></a><tt class="py-lineno"> 229</tt>  <tt class="py-line">        <tt class="py-keyword">continue</tt> </tt>
+<a name="L230"></a><tt class="py-lineno"> 230</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L231"></a><tt class="py-lineno"> 231</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">e</tt> </tt>
+<a name="L232"></a><tt class="py-lineno"> 232</tt>  <tt class="py-line"> </tt>
+<a name="L233"></a><tt class="py-lineno"> 233</tt>  <tt class="py-line">  <tt class="py-keyword">raise</tt> <tt id="link-84" class="py-name"><a title="googleapiclient.errors.UnknownApiNameOrVersion" class="py-name" href="#" onclick="return doclink('link-84', 'UnknownApiNameOrVersion', 'link-18');">UnknownApiNameOrVersion</a></tt><tt class="py-op">(</tt> </tt>
+<a name="L234"></a><tt class="py-lineno"> 234</tt>  <tt class="py-line">        <tt class="py-string">"name: %s  version: %s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">serviceName</tt><tt class="py-op">,</tt> <tt class="py-name">version</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L235"></a><tt class="py-lineno"> 235</tt>  <tt class="py-line"> </tt>
+<a name="_retrieve_discovery_doc"></a><div id="_retrieve_discovery_doc-def"><a name="L236"></a><tt class="py-lineno"> 236</tt>  <tt class="py-line"> </tt>
+<a name="L237"></a><tt class="py-lineno"> 237</tt> <a class="py-toggle" href="#" id="_retrieve_discovery_doc-toggle" onclick="return toggle('_retrieve_discovery_doc');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_retrieve_discovery_doc">_retrieve_discovery_doc</a><tt class="py-op">(</tt><tt class="py-param">url</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">cache_discovery</tt><tt class="py-op">,</tt> <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_retrieve_discovery_doc-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_retrieve_discovery_doc-expanded"><a name="L238"></a><tt class="py-lineno"> 238</tt>  <tt class="py-line">  <tt class="py-docstring">"""Retrieves the discovery_doc from cache or the internet.</tt> </tt>
+<a name="L239"></a><tt class="py-lineno"> 239</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L240"></a><tt class="py-lineno"> 240</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L241"></a><tt class="py-lineno"> 241</tt>  <tt class="py-line"><tt class="py-docstring">    url: string, the URL of the discovery document.</tt> </tt>
+<a name="L242"></a><tt class="py-lineno"> 242</tt>  <tt class="py-line"><tt class="py-docstring">    http: httplib2.Http, An instance of httplib2.Http or something that acts</tt> </tt>
+<a name="L243"></a><tt class="py-lineno"> 243</tt>  <tt class="py-line"><tt class="py-docstring">      like it through which HTTP requests will be made.</tt> </tt>
+<a name="L244"></a><tt class="py-lineno"> 244</tt>  <tt class="py-line"><tt class="py-docstring">    cache_discovery: Boolean, whether or not to cache the discovery doc.</tt> </tt>
+<a name="L245"></a><tt class="py-lineno"> 245</tt>  <tt class="py-line"><tt class="py-docstring">    cache: googleapiclient.discovery_cache.base.Cache, an optional cache</tt> </tt>
+<a name="L246"></a><tt class="py-lineno"> 246</tt>  <tt class="py-line"><tt class="py-docstring">      object for the discovery documents.</tt> </tt>
+<a name="L247"></a><tt class="py-lineno"> 247</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L248"></a><tt class="py-lineno"> 248</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L249"></a><tt class="py-lineno"> 249</tt>  <tt class="py-line"><tt class="py-docstring">    A unicode string representation of the discovery document.</tt> </tt>
+<a name="L250"></a><tt class="py-lineno"> 250</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L251"></a><tt class="py-lineno"> 251</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">cache_discovery</tt><tt class="py-op">:</tt> </tt>
+<a name="L252"></a><tt class="py-lineno"> 252</tt>  <tt class="py-line">    <tt class="py-keyword">from</tt> <tt class="py-op">.</tt> <tt class="py-keyword">import</tt> <tt id="link-85" class="py-name" targets="Package googleapiclient.discovery_cache=googleapiclient.discovery_cache-module.html"><a title="googleapiclient.discovery_cache" class="py-name" href="#" onclick="return doclink('link-85', 'discovery_cache', 'link-85');">discovery_cache</a></tt> </tt>
+<a name="L253"></a><tt class="py-lineno"> 253</tt>  <tt class="py-line">    <tt class="py-keyword">from</tt> <tt class="py-op">.</tt><tt id="link-86" class="py-name"><a title="googleapiclient.discovery_cache" class="py-name" href="#" onclick="return doclink('link-86', 'discovery_cache', 'link-85');">discovery_cache</a></tt> <tt class="py-keyword">import</tt> <tt id="link-87" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-87', 'base', 'link-78');">base</a></tt> </tt>
+<a name="L254"></a><tt class="py-lineno"> 254</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-88" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
+googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-88', 'cache', 'link-76');">cache</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L255"></a><tt class="py-lineno"> 255</tt>  <tt class="py-line">      <tt id="link-89" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
+googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-89', 'cache', 'link-76');">cache</a></tt> <tt class="py-op">=</tt> <tt id="link-90" class="py-name"><a title="googleapiclient.discovery_cache" class="py-name" href="#" onclick="return doclink('link-90', 'discovery_cache', 'link-85');">discovery_cache</a></tt><tt class="py-op">.</tt><tt id="link-91" class="py-name" targets="Function googleapiclient.discovery_cache.autodetect()=googleapiclient.discovery_cache-module.html#autodetect"><a title="googleapiclient.discovery_cache.autodetect" class="py-name" href="#" onclick="return doclink('link-91', 'autodetect', 'link-91');">autodetect</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L256"></a><tt class="py-lineno"> 256</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-92" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
+googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-92', 'cache', 'link-76');">cache</a></tt><tt class="py-op">:</tt> </tt>
+<a name="L257"></a><tt class="py-lineno"> 257</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-93" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
+googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-93', 'cache', 'link-76');">cache</a></tt><tt class="py-op">.</tt><tt id="link-94" class="py-name" targets="Method googleapiclient.discovery_cache.appengine_memcache.Cache.get()=googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#get,Method googleapiclient.discovery_cache.base.Cache.get()=googleapiclient.discovery_cache.base.Cache-class.html#get,Method googleapiclient.discovery_cache.file_cache.Cache.get()=googleapiclient.discovery_cache.file_cache.Cache-class.html#get,Method googleapiclient.schema.Schemas.get()=googleapiclient.schema.Schemas-class.html#get"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-93', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">)</tt> </tt>
-<a name="L257"></a><tt class="py-lineno"> 257</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">content</tt><tt class="py-op">:</tt> </tt>
-<a name="L258"></a><tt class="py-lineno"> 258</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">content</tt> </tt>
-<a name="L259"></a><tt class="py-lineno"> 259</tt>  <tt class="py-line"> </tt>
-<a name="L260"></a><tt class="py-lineno"> 260</tt>  <tt class="py-line">  <tt class="py-name">actual_url</tt> <tt class="py-op">=</tt> <tt class="py-name">url</tt> </tt>
-<a name="L261"></a><tt class="py-lineno"> 261</tt>  <tt class="py-line">  <tt class="py-comment"># REMOTE_ADDR is defined by the CGI spec [RFC3875] as the environment</tt> </tt>
-<a name="L262"></a><tt class="py-lineno"> 262</tt>  <tt class="py-line">  <tt class="py-comment"># variable that contains the network address of the client sending the</tt> </tt>
-<a name="L263"></a><tt class="py-lineno"> 263</tt>  <tt class="py-line">  <tt class="py-comment"># request. If it exists then add that to the request for the discovery</tt> </tt>
-<a name="L264"></a><tt class="py-lineno"> 264</tt>  <tt class="py-line">  <tt class="py-comment"># document to avoid exceeding the quota on discovery requests.</tt> </tt>
-<a name="L265"></a><tt class="py-lineno"> 265</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-string">'REMOTE_ADDR'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">environ</tt><tt class="py-op">:</tt> </tt>
-<a name="L266"></a><tt class="py-lineno"> 266</tt>  <tt class="py-line">    <tt class="py-name">actual_url</tt> <tt class="py-op">=</tt> <tt class="py-name">_add_query_parameter</tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-string">'userIp'</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">environ</tt><tt class="py-op">[</tt><tt class="py-string">'REMOTE_ADDR'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L267"></a><tt class="py-lineno"> 267</tt>  <tt class="py-line">  <tt id="link-94" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-94', 'logger', 'link-50');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">info</tt><tt class="py-op">(</tt><tt class="py-string">'URL being requested: GET %s'</tt><tt class="py-op">,</tt> <tt class="py-name">actual_url</tt><tt class="py-op">)</tt> </tt>
-<a name="L268"></a><tt class="py-lineno"> 268</tt>  <tt class="py-line"> </tt>
-<a name="L269"></a><tt class="py-lineno"> 269</tt>  <tt class="py-line">  <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-95" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-95', 'http', 'link-21');">http</a></tt><tt class="py-op">.</tt><tt id="link-96" class="py-name" targets="Method googleapiclient.http.HttpMock.request()=googleapiclient.http.HttpMock-class.html#request,Method googleapiclient.http.HttpMockSequence.request()=googleapiclient.http.HttpMockSequence-class.html#request,Method googleapiclient.model.BaseModel.request()=googleapiclient.model.BaseModel-class.html#request,Method googleapiclient.model.Model.request()=googleapiclient.model.Model-class.html#request"><a title="googleapiclient.http.HttpMock.request
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-94', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">)</tt> </tt>
+<a name="L258"></a><tt class="py-lineno"> 258</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">content</tt><tt class="py-op">:</tt> </tt>
+<a name="L259"></a><tt class="py-lineno"> 259</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">content</tt> </tt>
+<a name="L260"></a><tt class="py-lineno"> 260</tt>  <tt class="py-line"> </tt>
+<a name="L261"></a><tt class="py-lineno"> 261</tt>  <tt class="py-line">  <tt class="py-name">actual_url</tt> <tt class="py-op">=</tt> <tt class="py-name">url</tt> </tt>
+<a name="L262"></a><tt class="py-lineno"> 262</tt>  <tt class="py-line">  <tt class="py-comment"># REMOTE_ADDR is defined by the CGI spec [RFC3875] as the environment</tt> </tt>
+<a name="L263"></a><tt class="py-lineno"> 263</tt>  <tt class="py-line">  <tt class="py-comment"># variable that contains the network address of the client sending the</tt> </tt>
+<a name="L264"></a><tt class="py-lineno"> 264</tt>  <tt class="py-line">  <tt class="py-comment"># request. If it exists then add that to the request for the discovery</tt> </tt>
+<a name="L265"></a><tt class="py-lineno"> 265</tt>  <tt class="py-line">  <tt class="py-comment"># document to avoid exceeding the quota on discovery requests.</tt> </tt>
+<a name="L266"></a><tt class="py-lineno"> 266</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-string">'REMOTE_ADDR'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">environ</tt><tt class="py-op">:</tt> </tt>
+<a name="L267"></a><tt class="py-lineno"> 267</tt>  <tt class="py-line">    <tt class="py-name">actual_url</tt> <tt class="py-op">=</tt> <tt class="py-name">_add_query_parameter</tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-string">'userIp'</tt><tt class="py-op">,</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">environ</tt><tt class="py-op">[</tt><tt class="py-string">'REMOTE_ADDR'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L268"></a><tt class="py-lineno"> 268</tt>  <tt class="py-line">  <tt id="link-95" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-95', 'logger', 'link-52');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">info</tt><tt class="py-op">(</tt><tt class="py-string">'URL being requested: GET %s'</tt><tt class="py-op">,</tt> <tt class="py-name">actual_url</tt><tt class="py-op">)</tt> </tt>
+<a name="L269"></a><tt class="py-lineno"> 269</tt>  <tt class="py-line"> </tt>
+<a name="L270"></a><tt class="py-lineno"> 270</tt>  <tt class="py-line">  <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-96" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-96', 'http', 'link-23');">http</a></tt><tt class="py-op">.</tt><tt id="link-97" class="py-name" targets="Method googleapiclient.http.HttpMock.request()=googleapiclient.http.HttpMock-class.html#request,Method googleapiclient.http.HttpMockSequence.request()=googleapiclient.http.HttpMockSequence-class.html#request,Method googleapiclient.model.BaseModel.request()=googleapiclient.model.BaseModel-class.html#request,Method googleapiclient.model.Model.request()=googleapiclient.model.Model-class.html#request"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
-googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-96', 'request', 'link-96');">request</a></tt><tt class="py-op">(</tt><tt class="py-name">actual_url</tt><tt class="py-op">)</tt> </tt>
-<a name="L270"></a><tt class="py-lineno"> 270</tt>  <tt class="py-line"> </tt>
-<a name="L271"></a><tt class="py-lineno"> 271</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">&gt;=</tt> <tt class="py-number">400</tt><tt class="py-op">:</tt> </tt>
-<a name="L272"></a><tt class="py-lineno"> 272</tt>  <tt class="py-line">    <tt class="py-keyword">raise</tt> <tt id="link-97" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-97', 'HttpError', 'link-4');">HttpError</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt class="py-name">actual_url</tt><tt class="py-op">)</tt> </tt>
-<a name="L273"></a><tt class="py-lineno"> 273</tt>  <tt class="py-line"> </tt>
-<a name="L274"></a><tt class="py-lineno"> 274</tt>  <tt class="py-line">  <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
-<a name="L275"></a><tt class="py-lineno"> 275</tt>  <tt class="py-line">    <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt><tt class="py-op">.</tt><tt class="py-name">decode</tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
-<a name="L276"></a><tt class="py-lineno"> 276</tt>  <tt class="py-line">  <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt>
-<a name="L277"></a><tt class="py-lineno"> 277</tt>  <tt class="py-line">    <tt class="py-keyword">pass</tt> </tt>
-<a name="L278"></a><tt class="py-lineno"> 278</tt>  <tt class="py-line"> </tt>
-<a name="L279"></a><tt class="py-lineno"> 279</tt>  <tt class="py-line">  <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
-<a name="L280"></a><tt class="py-lineno"> 280</tt>  <tt class="py-line">    <tt class="py-name">service</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
-<a name="L281"></a><tt class="py-lineno"> 281</tt>  <tt class="py-line">  <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt> <tt class="py-keyword">as</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
-<a name="L282"></a><tt class="py-lineno"> 282</tt>  <tt class="py-line">    <tt id="link-98" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-98', 'logger', 'link-50');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">error</tt><tt class="py-op">(</tt><tt class="py-string">'Failed to parse as JSON: '</tt> <tt class="py-op">+</tt> <tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
-<a name="L283"></a><tt class="py-lineno"> 283</tt>  <tt class="py-line">    <tt class="py-keyword">raise</tt> <tt id="link-99" class="py-name"><a title="googleapiclient.errors.InvalidJsonError" class="py-name" href="#" onclick="return doclink('link-99', 'InvalidJsonError', 'link-7');">InvalidJsonError</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L284"></a><tt class="py-lineno"> 284</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">cache_discovery</tt> <tt class="py-keyword">and</tt> <tt id="link-100" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
-googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-100', 'cache', 'link-75');">cache</a></tt><tt class="py-op">:</tt> </tt>
-<a name="L285"></a><tt class="py-lineno"> 285</tt>  <tt class="py-line">    <tt id="link-101" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
-googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-101', 'cache', 'link-75');">cache</a></tt><tt class="py-op">.</tt><tt id="link-102" class="py-name" targets="Method googleapiclient.discovery_cache.appengine_memcache.Cache.set()=googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#set,Method googleapiclient.discovery_cache.base.Cache.set()=googleapiclient.discovery_cache.base.Cache-class.html#set,Method googleapiclient.discovery_cache.file_cache.Cache.set()=googleapiclient.discovery_cache.file_cache.Cache-class.html#set"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.set
+googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-97', 'request', 'link-97');">request</a></tt><tt class="py-op">(</tt><tt class="py-name">actual_url</tt><tt class="py-op">)</tt> </tt>
+<a name="L271"></a><tt class="py-lineno"> 271</tt>  <tt class="py-line"> </tt>
+<a name="L272"></a><tt class="py-lineno"> 272</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">&gt;=</tt> <tt class="py-number">400</tt><tt class="py-op">:</tt> </tt>
+<a name="L273"></a><tt class="py-lineno"> 273</tt>  <tt class="py-line">    <tt class="py-keyword">raise</tt> <tt id="link-98" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-98', 'HttpError', 'link-6');">HttpError</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt class="py-name">actual_url</tt><tt class="py-op">)</tt> </tt>
+<a name="L274"></a><tt class="py-lineno"> 274</tt>  <tt class="py-line"> </tt>
+<a name="L275"></a><tt class="py-lineno"> 275</tt>  <tt class="py-line">  <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L276"></a><tt class="py-lineno"> 276</tt>  <tt class="py-line">    <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt><tt class="py-op">.</tt><tt class="py-name">decode</tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
+<a name="L277"></a><tt class="py-lineno"> 277</tt>  <tt class="py-line">  <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt>
+<a name="L278"></a><tt class="py-lineno"> 278</tt>  <tt class="py-line">    <tt class="py-keyword">pass</tt> </tt>
+<a name="L279"></a><tt class="py-lineno"> 279</tt>  <tt class="py-line"> </tt>
+<a name="L280"></a><tt class="py-lineno"> 280</tt>  <tt class="py-line">  <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L281"></a><tt class="py-lineno"> 281</tt>  <tt class="py-line">    <tt class="py-name">service</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
+<a name="L282"></a><tt class="py-lineno"> 282</tt>  <tt class="py-line">  <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt> <tt class="py-keyword">as</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
+<a name="L283"></a><tt class="py-lineno"> 283</tt>  <tt class="py-line">    <tt id="link-99" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-99', 'logger', 'link-52');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">error</tt><tt class="py-op">(</tt><tt class="py-string">'Failed to parse as JSON: '</tt> <tt class="py-op">+</tt> <tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
+<a name="L284"></a><tt class="py-lineno"> 284</tt>  <tt class="py-line">    <tt class="py-keyword">raise</tt> <tt id="link-100" class="py-name"><a title="googleapiclient.errors.InvalidJsonError" class="py-name" href="#" onclick="return doclink('link-100', 'InvalidJsonError', 'link-9');">InvalidJsonError</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L285"></a><tt class="py-lineno"> 285</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">cache_discovery</tt> <tt class="py-keyword">and</tt> <tt id="link-101" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
+googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-101', 'cache', 'link-76');">cache</a></tt><tt class="py-op">:</tt> </tt>
+<a name="L286"></a><tt class="py-lineno"> 286</tt>  <tt class="py-line">    <tt id="link-102" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.cache
+googleapiclient.discovery_cache.file_cache.cache" class="py-name" href="#" onclick="return doclink('link-102', 'cache', 'link-76');">cache</a></tt><tt class="py-op">.</tt><tt id="link-103" class="py-name" targets="Method googleapiclient.discovery_cache.appengine_memcache.Cache.set()=googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#set,Method googleapiclient.discovery_cache.base.Cache.set()=googleapiclient.discovery_cache.base.Cache-class.html#set,Method googleapiclient.discovery_cache.file_cache.Cache.set()=googleapiclient.discovery_cache.file_cache.Cache-class.html#set"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.set
 googleapiclient.discovery_cache.base.Cache.set
-googleapiclient.discovery_cache.file_cache.Cache.set" class="py-name" href="#" onclick="return doclink('link-102', 'set', 'link-102');">set</a></tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
-<a name="L286"></a><tt class="py-lineno"> 286</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-name">content</tt> </tt>
-</div><a name="L287"></a><tt class="py-lineno"> 287</tt>  <tt class="py-line"> </tt>
-<a name="build_from_document"></a><div id="build_from_document-def"><a name="L288"></a><tt class="py-lineno"> 288</tt>  <tt class="py-line"> </tt>
-<a name="L289"></a><tt class="py-lineno"> 289</tt>  <tt class="py-line"><tt class="py-decorator">@</tt><tt class="py-decorator">positional</tt><tt class="py-op">(</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
-<a name="L290"></a><tt class="py-lineno"> 290</tt> <a class="py-toggle" href="#" id="build_from_document-toggle" onclick="return toggle('build_from_document');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#build_from_document">build_from_document</a><tt class="py-op">(</tt> </tt>
-<a name="L291"></a><tt class="py-lineno"> 291</tt>  <tt class="py-line">    <tt class="py-param">service</tt><tt class="py-op">,</tt> </tt>
-<a name="L292"></a><tt class="py-lineno"> 292</tt>  <tt class="py-line">    <tt class="py-param">base</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L293"></a><tt class="py-lineno"> 293</tt>  <tt class="py-line">    <tt class="py-param">future</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L294"></a><tt class="py-lineno"> 294</tt>  <tt class="py-line">    <tt class="py-param">http</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L295"></a><tt class="py-lineno"> 295</tt>  <tt class="py-line">    <tt class="py-param">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L296"></a><tt class="py-lineno"> 296</tt>  <tt class="py-line">    <tt class="py-param">model</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L297"></a><tt class="py-lineno"> 297</tt>  <tt class="py-line">    <tt class="py-param">requestBuilder</tt><tt class="py-op">=</tt><tt id="link-103" class="py-name"><a title="googleapiclient.http.HttpRequest" class="py-name" href="#" onclick="return doclink('link-103', 'HttpRequest', 'link-31');">HttpRequest</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L298"></a><tt class="py-lineno"> 298</tt>  <tt class="py-line">    <tt class="py-param">credentials</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="build_from_document-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="build_from_document-expanded"><a name="L299"></a><tt class="py-lineno"> 299</tt>  <tt class="py-line">  <tt class="py-docstring">"""Create a Resource for interacting with an API.</tt> </tt>
-<a name="L300"></a><tt class="py-lineno"> 300</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L301"></a><tt class="py-lineno"> 301</tt>  <tt class="py-line"><tt class="py-docstring">  Same as `build()`, but constructs the Resource object from a discovery</tt> </tt>
-<a name="L302"></a><tt class="py-lineno"> 302</tt>  <tt class="py-line"><tt class="py-docstring">  document that is it given, as opposed to retrieving one over HTTP.</tt> </tt>
-<a name="L303"></a><tt class="py-lineno"> 303</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L304"></a><tt class="py-lineno"> 304</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L305"></a><tt class="py-lineno"> 305</tt>  <tt class="py-line"><tt class="py-docstring">    service: string or object, the JSON discovery document describing the API.</tt> </tt>
-<a name="L306"></a><tt class="py-lineno"> 306</tt>  <tt class="py-line"><tt class="py-docstring">      The value passed in may either be the JSON string or the deserialized</tt> </tt>
-<a name="L307"></a><tt class="py-lineno"> 307</tt>  <tt class="py-line"><tt class="py-docstring">      JSON.</tt> </tt>
-<a name="L308"></a><tt class="py-lineno"> 308</tt>  <tt class="py-line"><tt class="py-docstring">    base: string, base URI for all HTTP requests, usually the discovery URI.</tt> </tt>
-<a name="L309"></a><tt class="py-lineno"> 309</tt>  <tt class="py-line"><tt class="py-docstring">      This parameter is no longer used as rootUrl and servicePath are included</tt> </tt>
-<a name="L310"></a><tt class="py-lineno"> 310</tt>  <tt class="py-line"><tt class="py-docstring">      within the discovery document. (deprecated)</tt> </tt>
-<a name="L311"></a><tt class="py-lineno"> 311</tt>  <tt class="py-line"><tt class="py-docstring">    future: string, discovery document with future capabilities (deprecated).</tt> </tt>
-<a name="L312"></a><tt class="py-lineno"> 312</tt>  <tt class="py-line"><tt class="py-docstring">    http: httplib2.Http, An instance of httplib2.Http or something that acts</tt> </tt>
-<a name="L313"></a><tt class="py-lineno"> 313</tt>  <tt class="py-line"><tt class="py-docstring">      like it that HTTP requests will be made through.</tt> </tt>
-<a name="L314"></a><tt class="py-lineno"> 314</tt>  <tt class="py-line"><tt class="py-docstring">    developerKey: string, Key for controlling API usage, generated</tt> </tt>
-<a name="L315"></a><tt class="py-lineno"> 315</tt>  <tt class="py-line"><tt class="py-docstring">      from the API Console.</tt> </tt>
-<a name="L316"></a><tt class="py-lineno"> 316</tt>  <tt class="py-line"><tt class="py-docstring">    model: Model class instance that serializes and de-serializes requests and</tt> </tt>
-<a name="L317"></a><tt class="py-lineno"> 317</tt>  <tt class="py-line"><tt class="py-docstring">      responses.</tt> </tt>
-<a name="L318"></a><tt class="py-lineno"> 318</tt>  <tt class="py-line"><tt class="py-docstring">    requestBuilder: Takes an http request and packages it up to be executed.</tt> </tt>
-<a name="L319"></a><tt class="py-lineno"> 319</tt>  <tt class="py-line"><tt class="py-docstring">    credentials: object, credentials to be used for authentication.</tt> </tt>
-<a name="L320"></a><tt class="py-lineno"> 320</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L321"></a><tt class="py-lineno"> 321</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L322"></a><tt class="py-lineno"> 322</tt>  <tt class="py-line"><tt class="py-docstring">    A Resource object with methods for interacting with the service.</tt> </tt>
-<a name="L323"></a><tt class="py-lineno"> 323</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L324"></a><tt class="py-lineno"> 324</tt>  <tt class="py-line"> </tt>
-<a name="L325"></a><tt class="py-lineno"> 325</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt id="link-104" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-104', 'http', 'link-21');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L326"></a><tt class="py-lineno"> 326</tt>  <tt class="py-line">    <tt id="link-105" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-105', 'http', 'link-21');">http</a></tt> <tt class="py-op">=</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Http</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+googleapiclient.discovery_cache.file_cache.Cache.set" class="py-name" href="#" onclick="return doclink('link-103', 'set', 'link-103');">set</a></tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
+<a name="L287"></a><tt class="py-lineno"> 287</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-name">content</tt> </tt>
+</div><a name="L288"></a><tt class="py-lineno"> 288</tt>  <tt class="py-line"> </tt>
+<a name="build_from_document"></a><div id="build_from_document-def"><a name="L289"></a><tt class="py-lineno"> 289</tt>  <tt class="py-line"> </tt>
+<a name="L290"></a><tt class="py-lineno"> 290</tt>  <tt class="py-line"><tt class="py-decorator">@</tt><tt class="py-decorator">positional</tt><tt class="py-op">(</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
+<a name="L291"></a><tt class="py-lineno"> 291</tt> <a class="py-toggle" href="#" id="build_from_document-toggle" onclick="return toggle('build_from_document');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#build_from_document">build_from_document</a><tt class="py-op">(</tt> </tt>
+<a name="L292"></a><tt class="py-lineno"> 292</tt>  <tt class="py-line">    <tt class="py-param">service</tt><tt class="py-op">,</tt> </tt>
+<a name="L293"></a><tt class="py-lineno"> 293</tt>  <tt class="py-line">    <tt class="py-param">base</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L294"></a><tt class="py-lineno"> 294</tt>  <tt class="py-line">    <tt class="py-param">future</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L295"></a><tt class="py-lineno"> 295</tt>  <tt class="py-line">    <tt class="py-param">http</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L296"></a><tt class="py-lineno"> 296</tt>  <tt class="py-line">    <tt class="py-param">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L297"></a><tt class="py-lineno"> 297</tt>  <tt class="py-line">    <tt class="py-param">model</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L298"></a><tt class="py-lineno"> 298</tt>  <tt class="py-line">    <tt class="py-param">requestBuilder</tt><tt class="py-op">=</tt><tt id="link-104" class="py-name"><a title="googleapiclient.http.HttpRequest" class="py-name" href="#" onclick="return doclink('link-104', 'HttpRequest', 'link-33');">HttpRequest</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L299"></a><tt class="py-lineno"> 299</tt>  <tt class="py-line">    <tt class="py-param">credentials</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="build_from_document-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="build_from_document-expanded"><a name="L300"></a><tt class="py-lineno"> 300</tt>  <tt class="py-line">  <tt class="py-docstring">"""Create a Resource for interacting with an API.</tt> </tt>
+<a name="L301"></a><tt class="py-lineno"> 301</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L302"></a><tt class="py-lineno"> 302</tt>  <tt class="py-line"><tt class="py-docstring">  Same as `build()`, but constructs the Resource object from a discovery</tt> </tt>
+<a name="L303"></a><tt class="py-lineno"> 303</tt>  <tt class="py-line"><tt class="py-docstring">  document that is it given, as opposed to retrieving one over HTTP.</tt> </tt>
+<a name="L304"></a><tt class="py-lineno"> 304</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L305"></a><tt class="py-lineno"> 305</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L306"></a><tt class="py-lineno"> 306</tt>  <tt class="py-line"><tt class="py-docstring">    service: string or object, the JSON discovery document describing the API.</tt> </tt>
+<a name="L307"></a><tt class="py-lineno"> 307</tt>  <tt class="py-line"><tt class="py-docstring">      The value passed in may either be the JSON string or the deserialized</tt> </tt>
+<a name="L308"></a><tt class="py-lineno"> 308</tt>  <tt class="py-line"><tt class="py-docstring">      JSON.</tt> </tt>
+<a name="L309"></a><tt class="py-lineno"> 309</tt>  <tt class="py-line"><tt class="py-docstring">    base: string, base URI for all HTTP requests, usually the discovery URI.</tt> </tt>
+<a name="L310"></a><tt class="py-lineno"> 310</tt>  <tt class="py-line"><tt class="py-docstring">      This parameter is no longer used as rootUrl and servicePath are included</tt> </tt>
+<a name="L311"></a><tt class="py-lineno"> 311</tt>  <tt class="py-line"><tt class="py-docstring">      within the discovery document. (deprecated)</tt> </tt>
+<a name="L312"></a><tt class="py-lineno"> 312</tt>  <tt class="py-line"><tt class="py-docstring">    future: string, discovery document with future capabilities (deprecated).</tt> </tt>
+<a name="L313"></a><tt class="py-lineno"> 313</tt>  <tt class="py-line"><tt class="py-docstring">    http: httplib2.Http, An instance of httplib2.Http or something that acts</tt> </tt>
+<a name="L314"></a><tt class="py-lineno"> 314</tt>  <tt class="py-line"><tt class="py-docstring">      like it that HTTP requests will be made through.</tt> </tt>
+<a name="L315"></a><tt class="py-lineno"> 315</tt>  <tt class="py-line"><tt class="py-docstring">    developerKey: string, Key for controlling API usage, generated</tt> </tt>
+<a name="L316"></a><tt class="py-lineno"> 316</tt>  <tt class="py-line"><tt class="py-docstring">      from the API Console.</tt> </tt>
+<a name="L317"></a><tt class="py-lineno"> 317</tt>  <tt class="py-line"><tt class="py-docstring">    model: Model class instance that serializes and de-serializes requests and</tt> </tt>
+<a name="L318"></a><tt class="py-lineno"> 318</tt>  <tt class="py-line"><tt class="py-docstring">      responses.</tt> </tt>
+<a name="L319"></a><tt class="py-lineno"> 319</tt>  <tt class="py-line"><tt class="py-docstring">    requestBuilder: Takes an http request and packages it up to be executed.</tt> </tt>
+<a name="L320"></a><tt class="py-lineno"> 320</tt>  <tt class="py-line"><tt class="py-docstring">    credentials: oauth2client.Credentials or</tt> </tt>
+<a name="L321"></a><tt class="py-lineno"> 321</tt>  <tt class="py-line"><tt class="py-docstring">      google.auth.credentials.Credentials, credentials to be used for</tt> </tt>
+<a name="L322"></a><tt class="py-lineno"> 322</tt>  <tt class="py-line"><tt class="py-docstring">      authentication.</tt> </tt>
+<a name="L323"></a><tt class="py-lineno"> 323</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L324"></a><tt class="py-lineno"> 324</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L325"></a><tt class="py-lineno"> 325</tt>  <tt class="py-line"><tt class="py-docstring">    A Resource object with methods for interacting with the service.</tt> </tt>
+<a name="L326"></a><tt class="py-lineno"> 326</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
 <a name="L327"></a><tt class="py-lineno"> 327</tt>  <tt class="py-line"> </tt>
-<a name="L328"></a><tt class="py-lineno"> 328</tt>  <tt class="py-line">  <tt class="py-comment"># future is no longer used.</tt> </tt>
-<a name="L329"></a><tt class="py-lineno"> 329</tt>  <tt class="py-line">  <tt class="py-name">future</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L328"></a><tt class="py-lineno"> 328</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt id="link-105" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-105', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-name">credentials</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L329"></a><tt class="py-lineno"> 329</tt>  <tt class="py-line">    <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'Arguments http and credentials are mutually exclusive.'</tt><tt class="py-op">)</tt> </tt>
 <a name="L330"></a><tt class="py-lineno"> 330</tt>  <tt class="py-line"> </tt>
 <a name="L331"></a><tt class="py-lineno"> 331</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">service</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">string_types</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
 <a name="L332"></a><tt class="py-lineno"> 332</tt>  <tt class="py-line">    <tt class="py-name">service</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt class="py-name">service</tt><tt class="py-op">)</tt> </tt>
 <a name="L333"></a><tt class="py-lineno"> 333</tt>  <tt class="py-line"> </tt>
-<a name="L334"></a><tt class="py-lineno"> 334</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt>  <tt class="py-string">'rootUrl'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">service</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-106" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-106', 'http', 'link-21');">http</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt id="link-107" class="py-name"><a title="googleapiclient.http.HttpMock" class="py-name" href="#" onclick="return doclink('link-107', 'HttpMock', 'link-25');">HttpMock</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L335"></a><tt class="py-lineno"> 335</tt>  <tt class="py-line">                                                      <tt id="link-108" class="py-name"><a title="googleapiclient.http.HttpMockSequence" class="py-name" href="#" onclick="return doclink('link-108', 'HttpMockSequence', 'link-28');">HttpMockSequence</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L336"></a><tt class="py-lineno"> 336</tt>  <tt class="py-line">      <tt id="link-109" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-109', 'logger', 'link-50');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">error</tt><tt class="py-op">(</tt><tt class="py-string">"You are using HttpMock or HttpMockSequence without"</tt> <tt class="py-op">+</tt> </tt>
+<a name="L334"></a><tt class="py-lineno"> 334</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt>  <tt class="py-string">'rootUrl'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">service</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-106" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-106', 'http', 'link-23');">http</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt id="link-107" class="py-name"><a title="googleapiclient.http.HttpMock" class="py-name" href="#" onclick="return doclink('link-107', 'HttpMock', 'link-27');">HttpMock</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L335"></a><tt class="py-lineno"> 335</tt>  <tt class="py-line">                                                      <tt id="link-108" class="py-name"><a title="googleapiclient.http.HttpMockSequence" class="py-name" href="#" onclick="return doclink('link-108', 'HttpMockSequence', 'link-30');">HttpMockSequence</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L336"></a><tt class="py-lineno"> 336</tt>  <tt class="py-line">      <tt id="link-109" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-109', 'logger', 'link-52');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">error</tt><tt class="py-op">(</tt><tt class="py-string">"You are using HttpMock or HttpMockSequence without"</tt> <tt class="py-op">+</tt> </tt>
 <a name="L337"></a><tt class="py-lineno"> 337</tt>  <tt class="py-line">                   <tt class="py-string">"having the service discovery doc in cache. Try calling "</tt> <tt class="py-op">+</tt> </tt>
 <a name="L338"></a><tt class="py-lineno"> 338</tt>  <tt class="py-line">                   <tt class="py-string">"build() without mocking once first to populate the "</tt> <tt class="py-op">+</tt> </tt>
 <a name="L339"></a><tt class="py-lineno"> 339</tt>  <tt class="py-line">                   <tt class="py-string">"cache."</tt><tt class="py-op">)</tt> </tt>
-<a name="L340"></a><tt class="py-lineno"> 340</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-110" class="py-name"><a title="googleapiclient.errors.InvalidJsonError" class="py-name" href="#" onclick="return doclink('link-110', 'InvalidJsonError', 'link-7');">InvalidJsonError</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L340"></a><tt class="py-lineno"> 340</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-110" class="py-name"><a title="googleapiclient.errors.InvalidJsonError" class="py-name" href="#" onclick="return doclink('link-110', 'InvalidJsonError', 'link-9');">InvalidJsonError</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
 <a name="L341"></a><tt class="py-lineno"> 341</tt>  <tt class="py-line"> </tt>
-<a name="L342"></a><tt class="py-lineno"> 342</tt>  <tt class="py-line">  <tt id="link-111" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-111', 'base', 'link-77');">base</a></tt> <tt class="py-op">=</tt> <tt class="py-name">urljoin</tt><tt class="py-op">(</tt><tt class="py-name">service</tt><tt class="py-op">[</tt><tt class="py-string">'rootUrl'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">service</tt><tt class="py-op">[</tt><tt class="py-string">'servicePath'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L343"></a><tt class="py-lineno"> 343</tt>  <tt class="py-line">  <tt id="link-112" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-112', 'schema', 'link-48');">schema</a></tt> <tt class="py-op">=</tt> <tt id="link-113" class="py-name"><a title="googleapiclient.schema.Schemas" class="py-name" href="#" onclick="return doclink('link-113', 'Schemas', 'link-49');">Schemas</a></tt><tt class="py-op">(</tt><tt class="py-name">service</tt><tt class="py-op">)</tt> </tt>
+<a name="L342"></a><tt class="py-lineno"> 342</tt>  <tt class="py-line">  <tt id="link-111" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-111', 'base', 'link-78');">base</a></tt> <tt class="py-op">=</tt> <tt class="py-name">urljoin</tt><tt class="py-op">(</tt><tt class="py-name">service</tt><tt class="py-op">[</tt><tt class="py-string">'rootUrl'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">service</tt><tt class="py-op">[</tt><tt class="py-string">'servicePath'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L343"></a><tt class="py-lineno"> 343</tt>  <tt class="py-line">  <tt id="link-112" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-112', 'schema', 'link-50');">schema</a></tt> <tt class="py-op">=</tt> <tt id="link-113" class="py-name"><a title="googleapiclient.schema.Schemas" class="py-name" href="#" onclick="return doclink('link-113', 'Schemas', 'link-51');">Schemas</a></tt><tt class="py-op">(</tt><tt class="py-name">service</tt><tt class="py-op">)</tt> </tt>
 <a name="L344"></a><tt class="py-lineno"> 344</tt>  <tt class="py-line"> </tt>
-<a name="L345"></a><tt class="py-lineno"> 345</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">credentials</tt><tt class="py-op">:</tt> </tt>
-<a name="L346"></a><tt class="py-lineno"> 346</tt>  <tt class="py-line">    <tt class="py-comment"># If credentials were passed in, we could have two cases:</tt> </tt>
-<a name="L347"></a><tt class="py-lineno"> 347</tt>  <tt class="py-line">    <tt class="py-comment"># 1. the scopes were specified, in which case the given credentials</tt> </tt>
-<a name="L348"></a><tt class="py-lineno"> 348</tt>  <tt class="py-line">    <tt class="py-comment">#    are used for authorizing the http;</tt> </tt>
-<a name="L349"></a><tt class="py-lineno"> 349</tt>  <tt class="py-line">    <tt class="py-comment"># 2. the scopes were not provided (meaning the Application Default</tt> </tt>
-<a name="L350"></a><tt class="py-lineno"> 350</tt>  <tt class="py-line">    <tt class="py-comment">#    Credentials are to be used). In this case, the Application Default</tt> </tt>
-<a name="L351"></a><tt class="py-lineno"> 351</tt>  <tt class="py-line">    <tt class="py-comment">#    Credentials are built and used instead of the original credentials.</tt> </tt>
-<a name="L352"></a><tt class="py-lineno"> 352</tt>  <tt class="py-line">    <tt class="py-comment">#    If there are no scopes found (meaning the given service requires no</tt> </tt>
-<a name="L353"></a><tt class="py-lineno"> 353</tt>  <tt class="py-line">    <tt class="py-comment">#    authentication), there is no authorization of the http.</tt> </tt>
-<a name="L354"></a><tt class="py-lineno"> 354</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">credentials</tt><tt class="py-op">,</tt> <tt class="py-name">GoogleCredentials</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> </tt>
-<a name="L355"></a><tt class="py-lineno"> 355</tt>  <tt class="py-line">        <tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">create_scoped_required</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L356"></a><tt class="py-lineno"> 356</tt>  <tt class="py-line">      <tt class="py-name">scopes</tt> <tt class="py-op">=</tt> <tt class="py-name">service</tt><tt class="py-op">.</tt><tt id="link-114" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="L345"></a><tt class="py-lineno"> 345</tt>  <tt class="py-line">  <tt class="py-comment"># If the http client is not specified, then we must construct an http client</tt> </tt>
+<a name="L346"></a><tt class="py-lineno"> 346</tt>  <tt class="py-line">  <tt class="py-comment"># to make requests. If the service has scopes, then we also need to setup</tt> </tt>
+<a name="L347"></a><tt class="py-lineno"> 347</tt>  <tt class="py-line">  <tt class="py-comment"># authentication.</tt> </tt>
+<a name="L348"></a><tt class="py-lineno"> 348</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt id="link-114" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-114', 'http', 'link-23');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L349"></a><tt class="py-lineno"> 349</tt>  <tt class="py-line">    <tt class="py-comment"># Does the service require scopes?</tt> </tt>
+<a name="L350"></a><tt class="py-lineno"> 350</tt>  <tt class="py-line">    <tt class="py-name">scopes</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt> </tt>
+<a name="L351"></a><tt class="py-lineno"> 351</tt>  <tt class="py-line">      <tt class="py-name">service</tt><tt class="py-op">.</tt><tt id="link-115" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-114', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'auth'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-115" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-115', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'auth'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-116" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-115', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'oauth2'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-116" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-116', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'oauth2'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-117" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-116', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'scopes'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
-<a name="L357"></a><tt class="py-lineno"> 357</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">scopes</tt><tt class="py-op">:</tt> </tt>
-<a name="L358"></a><tt class="py-lineno"> 358</tt>  <tt class="py-line">        <tt class="py-name">credentials</tt> <tt class="py-op">=</tt> <tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">create_scoped</tt><tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">scopes</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L359"></a><tt class="py-lineno"> 359</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L360"></a><tt class="py-lineno"> 360</tt>  <tt class="py-line">        <tt class="py-comment"># No need to authorize the http object</tt> </tt>
-<a name="L361"></a><tt class="py-lineno"> 361</tt>  <tt class="py-line">        <tt class="py-comment"># if the service does not require authentication.</tt> </tt>
-<a name="L362"></a><tt class="py-lineno"> 362</tt>  <tt class="py-line">        <tt class="py-name">credentials</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L363"></a><tt class="py-lineno"> 363</tt>  <tt class="py-line"> </tt>
-<a name="L364"></a><tt class="py-lineno"> 364</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">credentials</tt><tt class="py-op">:</tt> </tt>
-<a name="L365"></a><tt class="py-lineno"> 365</tt>  <tt class="py-line">      <tt id="link-117" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-117', 'http', 'link-21');">http</a></tt> <tt class="py-op">=</tt> <tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">authorize</tt><tt class="py-op">(</tt><tt id="link-118" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-118', 'http', 'link-21');">http</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L366"></a><tt class="py-lineno"> 366</tt>  <tt class="py-line"> </tt>
-<a name="L367"></a><tt class="py-lineno"> 367</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt id="link-119" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-119', 'model', 'link-39');">model</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L368"></a><tt class="py-lineno"> 368</tt>  <tt class="py-line">    <tt class="py-name">features</tt> <tt class="py-op">=</tt> <tt class="py-name">service</tt><tt class="py-op">.</tt><tt id="link-120" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-117', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'scopes'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L352"></a><tt class="py-lineno"> 352</tt>  <tt class="py-line"> </tt>
+<a name="L353"></a><tt class="py-lineno"> 353</tt>  <tt class="py-line">    <tt class="py-comment"># If so, then the we need to setup authentication.</tt> </tt>
+<a name="L354"></a><tt class="py-lineno"> 354</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">scopes</tt><tt class="py-op">:</tt> </tt>
+<a name="L355"></a><tt class="py-lineno"> 355</tt>  <tt class="py-line">      <tt class="py-comment"># If the user didn't pass in credentials, attempt to acquire application</tt> </tt>
+<a name="L356"></a><tt class="py-lineno"> 356</tt>  <tt class="py-line">      <tt class="py-comment"># default credentials.</tt> </tt>
+<a name="L357"></a><tt class="py-lineno"> 357</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">credentials</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L358"></a><tt class="py-lineno"> 358</tt>  <tt class="py-line">        <tt class="py-name">credentials</tt> <tt class="py-op">=</tt> <tt id="link-118" class="py-name"><a title="googleapiclient._auth" class="py-name" href="#" onclick="return doclink('link-118', '_auth', 'link-1');">_auth</a></tt><tt class="py-op">.</tt><tt id="link-119" class="py-name" targets="Function googleapiclient._auth.default_credentials()=googleapiclient._auth-module.html#default_credentials"><a title="googleapiclient._auth.default_credentials" class="py-name" href="#" onclick="return doclink('link-119', 'default_credentials', 'link-119');">default_credentials</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L359"></a><tt class="py-lineno"> 359</tt>  <tt class="py-line"> </tt>
+<a name="L360"></a><tt class="py-lineno"> 360</tt>  <tt class="py-line">      <tt class="py-comment"># The credentials need to be scoped.</tt> </tt>
+<a name="L361"></a><tt class="py-lineno"> 361</tt>  <tt class="py-line">      <tt class="py-name">credentials</tt> <tt class="py-op">=</tt> <tt id="link-120" class="py-name"><a title="googleapiclient._auth" class="py-name" href="#" onclick="return doclink('link-120', '_auth', 'link-1');">_auth</a></tt><tt class="py-op">.</tt><tt id="link-121" class="py-name" targets="Function googleapiclient._auth.with_scopes()=googleapiclient._auth-module.html#with_scopes"><a title="googleapiclient._auth.with_scopes" class="py-name" href="#" onclick="return doclink('link-121', 'with_scopes', 'link-121');">with_scopes</a></tt><tt class="py-op">(</tt><tt class="py-name">credentials</tt><tt class="py-op">,</tt> <tt class="py-name">scopes</tt><tt class="py-op">)</tt> </tt>
+<a name="L362"></a><tt class="py-lineno"> 362</tt>  <tt class="py-line"> </tt>
+<a name="L363"></a><tt class="py-lineno"> 363</tt>  <tt class="py-line">      <tt class="py-comment"># Create an authorized http instance</tt> </tt>
+<a name="L364"></a><tt class="py-lineno"> 364</tt>  <tt class="py-line">      <tt id="link-122" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-122', 'http', 'link-23');">http</a></tt> <tt class="py-op">=</tt> <tt id="link-123" class="py-name"><a title="googleapiclient._auth" class="py-name" href="#" onclick="return doclink('link-123', '_auth', 'link-1');">_auth</a></tt><tt class="py-op">.</tt><tt id="link-124" class="py-name" targets="Function googleapiclient._auth.authorized_http()=googleapiclient._auth-module.html#authorized_http"><a title="googleapiclient._auth.authorized_http" class="py-name" href="#" onclick="return doclink('link-124', 'authorized_http', 'link-124');">authorized_http</a></tt><tt class="py-op">(</tt><tt class="py-name">credentials</tt><tt class="py-op">)</tt> </tt>
+<a name="L365"></a><tt class="py-lineno"> 365</tt>  <tt class="py-line"> </tt>
+<a name="L366"></a><tt class="py-lineno"> 366</tt>  <tt class="py-line">    <tt class="py-comment"># If the service doesn't require scopes then there is no need for</tt> </tt>
+<a name="L367"></a><tt class="py-lineno"> 367</tt>  <tt class="py-line">    <tt class="py-comment"># authentication.</tt> </tt>
+<a name="L368"></a><tt class="py-lineno"> 368</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L369"></a><tt class="py-lineno"> 369</tt>  <tt class="py-line">      <tt id="link-125" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-125', 'http', 'link-23');">http</a></tt> <tt class="py-op">=</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Http</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L370"></a><tt class="py-lineno"> 370</tt>  <tt class="py-line"> </tt>
+<a name="L371"></a><tt class="py-lineno"> 371</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt id="link-126" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-126', 'model', 'link-41');">model</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L372"></a><tt class="py-lineno"> 372</tt>  <tt class="py-line">    <tt class="py-name">features</tt> <tt class="py-op">=</tt> <tt class="py-name">service</tt><tt class="py-op">.</tt><tt id="link-127" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-120', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'features'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L369"></a><tt class="py-lineno"> 369</tt>  <tt class="py-line">    <tt id="link-121" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-121', 'model', 'link-39');">model</a></tt> <tt class="py-op">=</tt> <tt id="link-122" class="py-name"><a title="googleapiclient.model.JsonModel" class="py-name" href="#" onclick="return doclink('link-122', 'JsonModel', 'link-40');">JsonModel</a></tt><tt class="py-op">(</tt><tt class="py-string">'dataWrapper'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">features</tt><tt class="py-op">)</tt> </tt>
-<a name="L370"></a><tt class="py-lineno"> 370</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt id="link-123" class="py-name" targets="Class googleapiclient.discovery.Resource=googleapiclient.discovery.Resource-class.html"><a title="googleapiclient.discovery.Resource" class="py-name" href="#" onclick="return doclink('link-123', 'Resource', 'link-123');">Resource</a></tt><tt class="py-op">(</tt><tt id="link-124" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-124', 'http', 'link-21');">http</a></tt><tt class="py-op">=</tt><tt id="link-125" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-125', 'http', 'link-21');">http</a></tt><tt class="py-op">,</tt> <tt class="py-name">baseUrl</tt><tt class="py-op">=</tt><tt id="link-126" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-126', 'base', 'link-77');">base</a></tt><tt class="py-op">,</tt> <tt id="link-127" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-127', 'model', 'link-39');">model</a></tt><tt class="py-op">=</tt><tt id="link-128" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-128', 'model', 'link-39');">model</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L371"></a><tt class="py-lineno"> 371</tt>  <tt class="py-line">                  <tt class="py-name">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">developerKey</tt><tt class="py-op">,</tt> <tt class="py-name">requestBuilder</tt><tt class="py-op">=</tt><tt class="py-name">requestBuilder</tt><tt class="py-op">,</tt> </tt>
-<a name="L372"></a><tt class="py-lineno"> 372</tt>  <tt class="py-line">                  <tt class="py-name">resourceDesc</tt><tt class="py-op">=</tt><tt class="py-name">service</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">=</tt><tt class="py-name">service</tt><tt class="py-op">,</tt> <tt id="link-129" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-129', 'schema', 'link-48');">schema</a></tt><tt class="py-op">=</tt><tt id="link-130" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-130', 'schema', 'link-48');">schema</a></tt><tt class="py-op">)</tt> </tt>
-</div><a name="L373"></a><tt class="py-lineno"> 373</tt>  <tt class="py-line"> </tt>
-<a name="_cast"></a><div id="_cast-def"><a name="L374"></a><tt class="py-lineno"> 374</tt>  <tt class="py-line"> </tt>
-<a name="L375"></a><tt class="py-lineno"> 375</tt> <a class="py-toggle" href="#" id="_cast-toggle" onclick="return toggle('_cast');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_cast">_cast</a><tt class="py-op">(</tt><tt class="py-param">value</tt><tt class="py-op">,</tt> <tt class="py-param">schema_type</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_cast-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_cast-expanded"><a name="L376"></a><tt class="py-lineno"> 376</tt>  <tt class="py-line">  <tt class="py-docstring">"""Convert value to a string based on JSON Schema type.</tt> </tt>
-<a name="L377"></a><tt class="py-lineno"> 377</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L378"></a><tt class="py-lineno"> 378</tt>  <tt class="py-line"><tt class="py-docstring">  See http://tools.ietf.org/html/draft-zyp-json-schema-03 for more details on</tt> </tt>
-<a name="L379"></a><tt class="py-lineno"> 379</tt>  <tt class="py-line"><tt class="py-docstring">  JSON Schema.</tt> </tt>
-<a name="L380"></a><tt class="py-lineno"> 380</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L381"></a><tt class="py-lineno"> 381</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L382"></a><tt class="py-lineno"> 382</tt>  <tt class="py-line"><tt class="py-docstring">    value: any, the value to convert</tt> </tt>
-<a name="L383"></a><tt class="py-lineno"> 383</tt>  <tt class="py-line"><tt class="py-docstring">    schema_type: string, the type that value should be interpreted as</tt> </tt>
-<a name="L384"></a><tt class="py-lineno"> 384</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L385"></a><tt class="py-lineno"> 385</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L386"></a><tt class="py-lineno"> 386</tt>  <tt class="py-line"><tt class="py-docstring">    A string representation of 'value' based on the schema_type.</tt> </tt>
-<a name="L387"></a><tt class="py-lineno"> 387</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L388"></a><tt class="py-lineno"> 388</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">schema_type</tt> <tt class="py-op">==</tt> <tt class="py-string">'string'</tt><tt class="py-op">:</tt> </tt>
-<a name="L389"></a><tt class="py-lineno"> 389</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-string">u''</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L390"></a><tt class="py-lineno"> 390</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
-<a name="L391"></a><tt class="py-lineno"> 391</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L392"></a><tt class="py-lineno"> 392</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
-<a name="L393"></a><tt class="py-lineno"> 393</tt>  <tt class="py-line">  <tt class="py-keyword">elif</tt> <tt class="py-name">schema_type</tt> <tt class="py-op">==</tt> <tt class="py-string">'integer'</tt><tt class="py-op">:</tt> </tt>
-<a name="L394"></a><tt class="py-lineno"> 394</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L395"></a><tt class="py-lineno"> 395</tt>  <tt class="py-line">  <tt class="py-keyword">elif</tt> <tt class="py-name">schema_type</tt> <tt class="py-op">==</tt> <tt class="py-string">'number'</tt><tt class="py-op">:</tt> </tt>
-<a name="L396"></a><tt class="py-lineno"> 396</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">float</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L397"></a><tt class="py-lineno"> 397</tt>  <tt class="py-line">  <tt class="py-keyword">elif</tt> <tt class="py-name">schema_type</tt> <tt class="py-op">==</tt> <tt class="py-string">'boolean'</tt><tt class="py-op">:</tt> </tt>
-<a name="L398"></a><tt class="py-lineno"> 398</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">bool</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L399"></a><tt class="py-lineno"> 399</tt>  <tt class="py-line">  <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L400"></a><tt class="py-lineno"> 400</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-string">u''</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L401"></a><tt class="py-lineno"> 401</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
-<a name="L402"></a><tt class="py-lineno"> 402</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L403"></a><tt class="py-lineno"> 403</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L404"></a><tt class="py-lineno"> 404</tt>  <tt class="py-line"> </tt>
-<a name="_media_size_to_long"></a><div id="_media_size_to_long-def"><a name="L405"></a><tt class="py-lineno"> 405</tt>  <tt class="py-line"> </tt>
-<a name="L406"></a><tt class="py-lineno"> 406</tt> <a class="py-toggle" href="#" id="_media_size_to_long-toggle" onclick="return toggle('_media_size_to_long');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_media_size_to_long">_media_size_to_long</a><tt class="py-op">(</tt><tt class="py-param">maxSize</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_media_size_to_long-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_media_size_to_long-expanded"><a name="L407"></a><tt class="py-lineno"> 407</tt>  <tt class="py-line">  <tt class="py-docstring">"""Convert a string media size, such as 10GB or 3TB into an integer.</tt> </tt>
-<a name="L408"></a><tt class="py-lineno"> 408</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L409"></a><tt class="py-lineno"> 409</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L410"></a><tt class="py-lineno"> 410</tt>  <tt class="py-line"><tt class="py-docstring">    maxSize: string, size as a string, such as 2MB or 7GB.</tt> </tt>
-<a name="L411"></a><tt class="py-lineno"> 411</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L412"></a><tt class="py-lineno"> 412</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L413"></a><tt class="py-lineno"> 413</tt>  <tt class="py-line"><tt class="py-docstring">    The size as an integer value.</tt> </tt>
-<a name="L414"></a><tt class="py-lineno"> 414</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L415"></a><tt class="py-lineno"> 415</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">maxSize</tt><tt class="py-op">)</tt> <tt class="py-op">&lt;</tt> <tt class="py-number">2</tt><tt class="py-op">:</tt> </tt>
-<a name="L416"></a><tt class="py-lineno"> 416</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-number">0</tt> </tt>
-<a name="L417"></a><tt class="py-lineno"> 417</tt>  <tt class="py-line">  <tt class="py-name">units</tt> <tt class="py-op">=</tt> <tt class="py-name">maxSize</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L418"></a><tt class="py-lineno"> 418</tt>  <tt class="py-line">  <tt class="py-name">bit_shift</tt> <tt class="py-op">=</tt> <tt id="link-131" class="py-name"><a title="googleapiclient.discovery._MEDIA_SIZE_BIT_SHIFTS" class="py-name" href="#" onclick="return doclink('link-131', '_MEDIA_SIZE_BIT_SHIFTS', 'link-59');">_MEDIA_SIZE_BIT_SHIFTS</a></tt><tt class="py-op">.</tt><tt id="link-132" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-127', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'features'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L373"></a><tt class="py-lineno"> 373</tt>  <tt class="py-line">    <tt id="link-128" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-128', 'model', 'link-41');">model</a></tt> <tt class="py-op">=</tt> <tt id="link-129" class="py-name"><a title="googleapiclient.model.JsonModel" class="py-name" href="#" onclick="return doclink('link-129', 'JsonModel', 'link-42');">JsonModel</a></tt><tt class="py-op">(</tt><tt class="py-string">'dataWrapper'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">features</tt><tt class="py-op">)</tt> </tt>
+<a name="L374"></a><tt class="py-lineno"> 374</tt>  <tt class="py-line"> </tt>
+<a name="L375"></a><tt class="py-lineno"> 375</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt id="link-130" class="py-name" targets="Class googleapiclient.discovery.Resource=googleapiclient.discovery.Resource-class.html"><a title="googleapiclient.discovery.Resource" class="py-name" href="#" onclick="return doclink('link-130', 'Resource', 'link-130');">Resource</a></tt><tt class="py-op">(</tt><tt id="link-131" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-131', 'http', 'link-23');">http</a></tt><tt class="py-op">=</tt><tt id="link-132" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-132', 'http', 'link-23');">http</a></tt><tt class="py-op">,</tt> <tt class="py-name">baseUrl</tt><tt class="py-op">=</tt><tt id="link-133" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-133', 'base', 'link-78');">base</a></tt><tt class="py-op">,</tt> <tt id="link-134" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-134', 'model', 'link-41');">model</a></tt><tt class="py-op">=</tt><tt id="link-135" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-135', 'model', 'link-41');">model</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L376"></a><tt class="py-lineno"> 376</tt>  <tt class="py-line">                  <tt class="py-name">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">developerKey</tt><tt class="py-op">,</tt> <tt class="py-name">requestBuilder</tt><tt class="py-op">=</tt><tt class="py-name">requestBuilder</tt><tt class="py-op">,</tt> </tt>
+<a name="L377"></a><tt class="py-lineno"> 377</tt>  <tt class="py-line">                  <tt class="py-name">resourceDesc</tt><tt class="py-op">=</tt><tt class="py-name">service</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">=</tt><tt class="py-name">service</tt><tt class="py-op">,</tt> <tt id="link-136" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-136', 'schema', 'link-50');">schema</a></tt><tt class="py-op">=</tt><tt id="link-137" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-137', 'schema', 'link-50');">schema</a></tt><tt class="py-op">)</tt> </tt>
+</div><a name="L378"></a><tt class="py-lineno"> 378</tt>  <tt class="py-line"> </tt>
+<a name="_cast"></a><div id="_cast-def"><a name="L379"></a><tt class="py-lineno"> 379</tt>  <tt class="py-line"> </tt>
+<a name="L380"></a><tt class="py-lineno"> 380</tt> <a class="py-toggle" href="#" id="_cast-toggle" onclick="return toggle('_cast');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_cast">_cast</a><tt class="py-op">(</tt><tt class="py-param">value</tt><tt class="py-op">,</tt> <tt class="py-param">schema_type</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_cast-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_cast-expanded"><a name="L381"></a><tt class="py-lineno"> 381</tt>  <tt class="py-line">  <tt class="py-docstring">"""Convert value to a string based on JSON Schema type.</tt> </tt>
+<a name="L382"></a><tt class="py-lineno"> 382</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L383"></a><tt class="py-lineno"> 383</tt>  <tt class="py-line"><tt class="py-docstring">  See http://tools.ietf.org/html/draft-zyp-json-schema-03 for more details on</tt> </tt>
+<a name="L384"></a><tt class="py-lineno"> 384</tt>  <tt class="py-line"><tt class="py-docstring">  JSON Schema.</tt> </tt>
+<a name="L385"></a><tt class="py-lineno"> 385</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L386"></a><tt class="py-lineno"> 386</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L387"></a><tt class="py-lineno"> 387</tt>  <tt class="py-line"><tt class="py-docstring">    value: any, the value to convert</tt> </tt>
+<a name="L388"></a><tt class="py-lineno"> 388</tt>  <tt class="py-line"><tt class="py-docstring">    schema_type: string, the type that value should be interpreted as</tt> </tt>
+<a name="L389"></a><tt class="py-lineno"> 389</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L390"></a><tt class="py-lineno"> 390</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L391"></a><tt class="py-lineno"> 391</tt>  <tt class="py-line"><tt class="py-docstring">    A string representation of 'value' based on the schema_type.</tt> </tt>
+<a name="L392"></a><tt class="py-lineno"> 392</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L393"></a><tt class="py-lineno"> 393</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">schema_type</tt> <tt class="py-op">==</tt> <tt class="py-string">'string'</tt><tt class="py-op">:</tt> </tt>
+<a name="L394"></a><tt class="py-lineno"> 394</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-string">u''</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L395"></a><tt class="py-lineno"> 395</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
+<a name="L396"></a><tt class="py-lineno"> 396</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L397"></a><tt class="py-lineno"> 397</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
+<a name="L398"></a><tt class="py-lineno"> 398</tt>  <tt class="py-line">  <tt class="py-keyword">elif</tt> <tt class="py-name">schema_type</tt> <tt class="py-op">==</tt> <tt class="py-string">'integer'</tt><tt class="py-op">:</tt> </tt>
+<a name="L399"></a><tt class="py-lineno"> 399</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L400"></a><tt class="py-lineno"> 400</tt>  <tt class="py-line">  <tt class="py-keyword">elif</tt> <tt class="py-name">schema_type</tt> <tt class="py-op">==</tt> <tt class="py-string">'number'</tt><tt class="py-op">:</tt> </tt>
+<a name="L401"></a><tt class="py-lineno"> 401</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">float</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L402"></a><tt class="py-lineno"> 402</tt>  <tt class="py-line">  <tt class="py-keyword">elif</tt> <tt class="py-name">schema_type</tt> <tt class="py-op">==</tt> <tt class="py-string">'boolean'</tt><tt class="py-op">:</tt> </tt>
+<a name="L403"></a><tt class="py-lineno"> 403</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">bool</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L404"></a><tt class="py-lineno"> 404</tt>  <tt class="py-line">  <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L405"></a><tt class="py-lineno"> 405</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-string">u''</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L406"></a><tt class="py-lineno"> 406</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
+<a name="L407"></a><tt class="py-lineno"> 407</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L408"></a><tt class="py-lineno"> 408</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L409"></a><tt class="py-lineno"> 409</tt>  <tt class="py-line"> </tt>
+<a name="_media_size_to_long"></a><div id="_media_size_to_long-def"><a name="L410"></a><tt class="py-lineno"> 410</tt>  <tt class="py-line"> </tt>
+<a name="L411"></a><tt class="py-lineno"> 411</tt> <a class="py-toggle" href="#" id="_media_size_to_long-toggle" onclick="return toggle('_media_size_to_long');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_media_size_to_long">_media_size_to_long</a><tt class="py-op">(</tt><tt class="py-param">maxSize</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_media_size_to_long-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_media_size_to_long-expanded"><a name="L412"></a><tt class="py-lineno"> 412</tt>  <tt class="py-line">  <tt class="py-docstring">"""Convert a string media size, such as 10GB or 3TB into an integer.</tt> </tt>
+<a name="L413"></a><tt class="py-lineno"> 413</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L414"></a><tt class="py-lineno"> 414</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L415"></a><tt class="py-lineno"> 415</tt>  <tt class="py-line"><tt class="py-docstring">    maxSize: string, size as a string, such as 2MB or 7GB.</tt> </tt>
+<a name="L416"></a><tt class="py-lineno"> 416</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L417"></a><tt class="py-lineno"> 417</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L418"></a><tt class="py-lineno"> 418</tt>  <tt class="py-line"><tt class="py-docstring">    The size as an integer value.</tt> </tt>
+<a name="L419"></a><tt class="py-lineno"> 419</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L420"></a><tt class="py-lineno"> 420</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">maxSize</tt><tt class="py-op">)</tt> <tt class="py-op">&lt;</tt> <tt class="py-number">2</tt><tt class="py-op">:</tt> </tt>
+<a name="L421"></a><tt class="py-lineno"> 421</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-number">0</tt> </tt>
+<a name="L422"></a><tt class="py-lineno"> 422</tt>  <tt class="py-line">  <tt class="py-name">units</tt> <tt class="py-op">=</tt> <tt class="py-name">maxSize</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L423"></a><tt class="py-lineno"> 423</tt>  <tt class="py-line">  <tt class="py-name">bit_shift</tt> <tt class="py-op">=</tt> <tt id="link-138" class="py-name"><a title="googleapiclient.discovery._MEDIA_SIZE_BIT_SHIFTS" class="py-name" href="#" onclick="return doclink('link-138', '_MEDIA_SIZE_BIT_SHIFTS', 'link-61');">_MEDIA_SIZE_BIT_SHIFTS</a></tt><tt class="py-op">.</tt><tt id="link-139" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-132', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">units</tt><tt class="py-op">)</tt> </tt>
-<a name="L419"></a><tt class="py-lineno"> 419</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">bit_shift</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L420"></a><tt class="py-lineno"> 420</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">maxSize</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> <tt class="py-op">&lt;&lt;</tt> <tt class="py-name">bit_shift</tt> </tt>
-<a name="L421"></a><tt class="py-lineno"> 421</tt>  <tt class="py-line">  <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L422"></a><tt class="py-lineno"> 422</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">maxSize</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L423"></a><tt class="py-lineno"> 423</tt>  <tt class="py-line"> </tt>
-<a name="_media_path_url_from_info"></a><div id="_media_path_url_from_info-def"><a name="L424"></a><tt class="py-lineno"> 424</tt>  <tt class="py-line"> </tt>
-<a name="L425"></a><tt class="py-lineno"> 425</tt> <a class="py-toggle" href="#" id="_media_path_url_from_info-toggle" onclick="return toggle('_media_path_url_from_info');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_media_path_url_from_info">_media_path_url_from_info</a><tt class="py-op">(</tt><tt class="py-param">root_desc</tt><tt class="py-op">,</tt> <tt class="py-param">path_url</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_media_path_url_from_info-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_media_path_url_from_info-expanded"><a name="L426"></a><tt class="py-lineno"> 426</tt>  <tt class="py-line">  <tt class="py-docstring">"""Creates an absolute media path URL.</tt> </tt>
-<a name="L427"></a><tt class="py-lineno"> 427</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L428"></a><tt class="py-lineno"> 428</tt>  <tt class="py-line"><tt class="py-docstring">  Constructed using the API root URI and service path from the discovery</tt> </tt>
-<a name="L429"></a><tt class="py-lineno"> 429</tt>  <tt class="py-line"><tt class="py-docstring">  document and the relative path for the API method.</tt> </tt>
-<a name="L430"></a><tt class="py-lineno"> 430</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L431"></a><tt class="py-lineno"> 431</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L432"></a><tt class="py-lineno"> 432</tt>  <tt class="py-line"><tt class="py-docstring">    root_desc: Dictionary; the entire original deserialized discovery document.</tt> </tt>
-<a name="L433"></a><tt class="py-lineno"> 433</tt>  <tt class="py-line"><tt class="py-docstring">    path_url: String; the relative URL for the API method. Relative to the API</tt> </tt>
-<a name="L434"></a><tt class="py-lineno"> 434</tt>  <tt class="py-line"><tt class="py-docstring">        root, which is specified in the discovery document.</tt> </tt>
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-139', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">units</tt><tt class="py-op">)</tt> </tt>
+<a name="L424"></a><tt class="py-lineno"> 424</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">bit_shift</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L425"></a><tt class="py-lineno"> 425</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">maxSize</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> <tt class="py-op">&lt;&lt;</tt> <tt class="py-name">bit_shift</tt> </tt>
+<a name="L426"></a><tt class="py-lineno"> 426</tt>  <tt class="py-line">  <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L427"></a><tt class="py-lineno"> 427</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">maxSize</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L428"></a><tt class="py-lineno"> 428</tt>  <tt class="py-line"> </tt>
+<a name="_media_path_url_from_info"></a><div id="_media_path_url_from_info-def"><a name="L429"></a><tt class="py-lineno"> 429</tt>  <tt class="py-line"> </tt>
+<a name="L430"></a><tt class="py-lineno"> 430</tt> <a class="py-toggle" href="#" id="_media_path_url_from_info-toggle" onclick="return toggle('_media_path_url_from_info');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_media_path_url_from_info">_media_path_url_from_info</a><tt class="py-op">(</tt><tt class="py-param">root_desc</tt><tt class="py-op">,</tt> <tt class="py-param">path_url</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_media_path_url_from_info-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_media_path_url_from_info-expanded"><a name="L431"></a><tt class="py-lineno"> 431</tt>  <tt class="py-line">  <tt class="py-docstring">"""Creates an absolute media path URL.</tt> </tt>
+<a name="L432"></a><tt class="py-lineno"> 432</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L433"></a><tt class="py-lineno"> 433</tt>  <tt class="py-line"><tt class="py-docstring">  Constructed using the API root URI and service path from the discovery</tt> </tt>
+<a name="L434"></a><tt class="py-lineno"> 434</tt>  <tt class="py-line"><tt class="py-docstring">  document and the relative path for the API method.</tt> </tt>
 <a name="L435"></a><tt class="py-lineno"> 435</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L436"></a><tt class="py-lineno"> 436</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L437"></a><tt class="py-lineno"> 437</tt>  <tt class="py-line"><tt class="py-docstring">    String; the absolute URI for media upload for the API method.</tt> </tt>
-<a name="L438"></a><tt class="py-lineno"> 438</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L439"></a><tt class="py-lineno"> 439</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-string">'%(root)supload/%(service_path)s%(path)s'</tt> <tt class="py-op">%</tt> <tt class="py-op">{</tt> </tt>
-<a name="L440"></a><tt class="py-lineno"> 440</tt>  <tt class="py-line">      <tt class="py-string">'root'</tt><tt class="py-op">:</tt> <tt class="py-name">root_desc</tt><tt class="py-op">[</tt><tt class="py-string">'rootUrl'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
-<a name="L441"></a><tt class="py-lineno"> 441</tt>  <tt class="py-line">      <tt class="py-string">'service_path'</tt><tt class="py-op">:</tt> <tt class="py-name">root_desc</tt><tt class="py-op">[</tt><tt class="py-string">'servicePath'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
-<a name="L442"></a><tt class="py-lineno"> 442</tt>  <tt class="py-line">      <tt class="py-string">'path'</tt><tt class="py-op">:</tt> <tt class="py-name">path_url</tt><tt class="py-op">,</tt> </tt>
-<a name="L443"></a><tt class="py-lineno"> 443</tt>  <tt class="py-line">  <tt class="py-op">}</tt> </tt>
-</div><a name="L444"></a><tt class="py-lineno"> 444</tt>  <tt class="py-line"> </tt>
-<a name="_fix_up_parameters"></a><div id="_fix_up_parameters-def"><a name="L445"></a><tt class="py-lineno"> 445</tt>  <tt class="py-line"> </tt>
-<a name="L446"></a><tt class="py-lineno"> 446</tt> <a class="py-toggle" href="#" id="_fix_up_parameters-toggle" onclick="return toggle('_fix_up_parameters');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_fix_up_parameters">_fix_up_parameters</a><tt class="py-op">(</tt><tt class="py-param">method_desc</tt><tt class="py-op">,</tt> <tt class="py-param">root_desc</tt><tt class="py-op">,</tt> <tt class="py-param">http_method</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_fix_up_parameters-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_fix_up_parameters-expanded"><a name="L447"></a><tt class="py-lineno"> 447</tt>  <tt class="py-line">  <tt class="py-docstring">"""Updates parameters of an API method with values specific to this library.</tt> </tt>
-<a name="L448"></a><tt class="py-lineno"> 448</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L449"></a><tt class="py-lineno"> 449</tt>  <tt class="py-line"><tt class="py-docstring">  Specifically, adds whatever global parameters are specified by the API to the</tt> </tt>
-<a name="L450"></a><tt class="py-lineno"> 450</tt>  <tt class="py-line"><tt class="py-docstring">  parameters for the individual method. Also adds parameters which don't</tt> </tt>
-<a name="L451"></a><tt class="py-lineno"> 451</tt>  <tt class="py-line"><tt class="py-docstring">  appear in the discovery document, but are available to all discovery based</tt> </tt>
-<a name="L452"></a><tt class="py-lineno"> 452</tt>  <tt class="py-line"><tt class="py-docstring">  APIs (these are listed in STACK_QUERY_PARAMETERS).</tt> </tt>
+<a name="L436"></a><tt class="py-lineno"> 436</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L437"></a><tt class="py-lineno"> 437</tt>  <tt class="py-line"><tt class="py-docstring">    root_desc: Dictionary; the entire original deserialized discovery document.</tt> </tt>
+<a name="L438"></a><tt class="py-lineno"> 438</tt>  <tt class="py-line"><tt class="py-docstring">    path_url: String; the relative URL for the API method. Relative to the API</tt> </tt>
+<a name="L439"></a><tt class="py-lineno"> 439</tt>  <tt class="py-line"><tt class="py-docstring">        root, which is specified in the discovery document.</tt> </tt>
+<a name="L440"></a><tt class="py-lineno"> 440</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L441"></a><tt class="py-lineno"> 441</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L442"></a><tt class="py-lineno"> 442</tt>  <tt class="py-line"><tt class="py-docstring">    String; the absolute URI for media upload for the API method.</tt> </tt>
+<a name="L443"></a><tt class="py-lineno"> 443</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L444"></a><tt class="py-lineno"> 444</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-string">'%(root)supload/%(service_path)s%(path)s'</tt> <tt class="py-op">%</tt> <tt class="py-op">{</tt> </tt>
+<a name="L445"></a><tt class="py-lineno"> 445</tt>  <tt class="py-line">      <tt class="py-string">'root'</tt><tt class="py-op">:</tt> <tt class="py-name">root_desc</tt><tt class="py-op">[</tt><tt class="py-string">'rootUrl'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
+<a name="L446"></a><tt class="py-lineno"> 446</tt>  <tt class="py-line">      <tt class="py-string">'service_path'</tt><tt class="py-op">:</tt> <tt class="py-name">root_desc</tt><tt class="py-op">[</tt><tt class="py-string">'servicePath'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
+<a name="L447"></a><tt class="py-lineno"> 447</tt>  <tt class="py-line">      <tt class="py-string">'path'</tt><tt class="py-op">:</tt> <tt class="py-name">path_url</tt><tt class="py-op">,</tt> </tt>
+<a name="L448"></a><tt class="py-lineno"> 448</tt>  <tt class="py-line">  <tt class="py-op">}</tt> </tt>
+</div><a name="L449"></a><tt class="py-lineno"> 449</tt>  <tt class="py-line"> </tt>
+<a name="_fix_up_parameters"></a><div id="_fix_up_parameters-def"><a name="L450"></a><tt class="py-lineno"> 450</tt>  <tt class="py-line"> </tt>
+<a name="L451"></a><tt class="py-lineno"> 451</tt> <a class="py-toggle" href="#" id="_fix_up_parameters-toggle" onclick="return toggle('_fix_up_parameters');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_fix_up_parameters">_fix_up_parameters</a><tt class="py-op">(</tt><tt class="py-param">method_desc</tt><tt class="py-op">,</tt> <tt class="py-param">root_desc</tt><tt class="py-op">,</tt> <tt class="py-param">http_method</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_fix_up_parameters-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_fix_up_parameters-expanded"><a name="L452"></a><tt class="py-lineno"> 452</tt>  <tt class="py-line">  <tt class="py-docstring">"""Updates parameters of an API method with values specific to this library.</tt> </tt>
 <a name="L453"></a><tt class="py-lineno"> 453</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L454"></a><tt class="py-lineno"> 454</tt>  <tt class="py-line"><tt class="py-docstring">  SIDE EFFECTS: This updates the parameters dictionary object in the method</tt> </tt>
-<a name="L455"></a><tt class="py-lineno"> 455</tt>  <tt class="py-line"><tt class="py-docstring">  description.</tt> </tt>
-<a name="L456"></a><tt class="py-lineno"> 456</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L457"></a><tt class="py-lineno"> 457</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L458"></a><tt class="py-lineno"> 458</tt>  <tt class="py-line"><tt class="py-docstring">    method_desc: Dictionary with metadata describing an API method. Value comes</tt> </tt>
-<a name="L459"></a><tt class="py-lineno"> 459</tt>  <tt class="py-line"><tt class="py-docstring">        from the dictionary of methods stored in the 'methods' key in the</tt> </tt>
-<a name="L460"></a><tt class="py-lineno"> 460</tt>  <tt class="py-line"><tt class="py-docstring">        deserialized discovery document.</tt> </tt>
-<a name="L461"></a><tt class="py-lineno"> 461</tt>  <tt class="py-line"><tt class="py-docstring">    root_desc: Dictionary; the entire original deserialized discovery document.</tt> </tt>
-<a name="L462"></a><tt class="py-lineno"> 462</tt>  <tt class="py-line"><tt class="py-docstring">    http_method: String; the HTTP method used to call the API method described</tt> </tt>
-<a name="L463"></a><tt class="py-lineno"> 463</tt>  <tt class="py-line"><tt class="py-docstring">        in method_desc.</tt> </tt>
-<a name="L464"></a><tt class="py-lineno"> 464</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L465"></a><tt class="py-lineno"> 465</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L466"></a><tt class="py-lineno"> 466</tt>  <tt class="py-line"><tt class="py-docstring">    The updated Dictionary stored in the 'parameters' key of the method</tt> </tt>
-<a name="L467"></a><tt class="py-lineno"> 467</tt>  <tt class="py-line"><tt class="py-docstring">        description dictionary.</tt> </tt>
-<a name="L468"></a><tt class="py-lineno"> 468</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L469"></a><tt class="py-lineno"> 469</tt>  <tt class="py-line">  <tt class="py-name">parameters</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">.</tt><tt class="py-name">setdefault</tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
-<a name="L470"></a><tt class="py-lineno"> 470</tt>  <tt class="py-line"> </tt>
-<a name="L471"></a><tt class="py-lineno"> 471</tt>  <tt class="py-line">  <tt class="py-comment"># Add in the parameters common to all methods.</tt> </tt>
-<a name="L472"></a><tt class="py-lineno"> 472</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">description</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">root_desc</tt><tt class="py-op">.</tt><tt id="link-133" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="L454"></a><tt class="py-lineno"> 454</tt>  <tt class="py-line"><tt class="py-docstring">  Specifically, adds whatever global parameters are specified by the API to the</tt> </tt>
+<a name="L455"></a><tt class="py-lineno"> 455</tt>  <tt class="py-line"><tt class="py-docstring">  parameters for the individual method. Also adds parameters which don't</tt> </tt>
+<a name="L456"></a><tt class="py-lineno"> 456</tt>  <tt class="py-line"><tt class="py-docstring">  appear in the discovery document, but are available to all discovery based</tt> </tt>
+<a name="L457"></a><tt class="py-lineno"> 457</tt>  <tt class="py-line"><tt class="py-docstring">  APIs (these are listed in STACK_QUERY_PARAMETERS).</tt> </tt>
+<a name="L458"></a><tt class="py-lineno"> 458</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L459"></a><tt class="py-lineno"> 459</tt>  <tt class="py-line"><tt class="py-docstring">  SIDE EFFECTS: This updates the parameters dictionary object in the method</tt> </tt>
+<a name="L460"></a><tt class="py-lineno"> 460</tt>  <tt class="py-line"><tt class="py-docstring">  description.</tt> </tt>
+<a name="L461"></a><tt class="py-lineno"> 461</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L462"></a><tt class="py-lineno"> 462</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L463"></a><tt class="py-lineno"> 463</tt>  <tt class="py-line"><tt class="py-docstring">    method_desc: Dictionary with metadata describing an API method. Value comes</tt> </tt>
+<a name="L464"></a><tt class="py-lineno"> 464</tt>  <tt class="py-line"><tt class="py-docstring">        from the dictionary of methods stored in the 'methods' key in the</tt> </tt>
+<a name="L465"></a><tt class="py-lineno"> 465</tt>  <tt class="py-line"><tt class="py-docstring">        deserialized discovery document.</tt> </tt>
+<a name="L466"></a><tt class="py-lineno"> 466</tt>  <tt class="py-line"><tt class="py-docstring">    root_desc: Dictionary; the entire original deserialized discovery document.</tt> </tt>
+<a name="L467"></a><tt class="py-lineno"> 467</tt>  <tt class="py-line"><tt class="py-docstring">    http_method: String; the HTTP method used to call the API method described</tt> </tt>
+<a name="L468"></a><tt class="py-lineno"> 468</tt>  <tt class="py-line"><tt class="py-docstring">        in method_desc.</tt> </tt>
+<a name="L469"></a><tt class="py-lineno"> 469</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L470"></a><tt class="py-lineno"> 470</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L471"></a><tt class="py-lineno"> 471</tt>  <tt class="py-line"><tt class="py-docstring">    The updated Dictionary stored in the 'parameters' key of the method</tt> </tt>
+<a name="L472"></a><tt class="py-lineno"> 472</tt>  <tt class="py-line"><tt class="py-docstring">        description dictionary.</tt> </tt>
+<a name="L473"></a><tt class="py-lineno"> 473</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L474"></a><tt class="py-lineno"> 474</tt>  <tt class="py-line">  <tt class="py-name">parameters</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">.</tt><tt class="py-name">setdefault</tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
+<a name="L475"></a><tt class="py-lineno"> 475</tt>  <tt class="py-line"> </tt>
+<a name="L476"></a><tt class="py-lineno"> 476</tt>  <tt class="py-line">  <tt class="py-comment"># Add in the parameters common to all methods.</tt> </tt>
+<a name="L477"></a><tt class="py-lineno"> 477</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">description</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">root_desc</tt><tt class="py-op">.</tt><tt id="link-140" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-133', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L473"></a><tt class="py-lineno"> 473</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">description</tt> </tt>
-<a name="L474"></a><tt class="py-lineno"> 474</tt>  <tt class="py-line"> </tt>
-<a name="L475"></a><tt class="py-lineno"> 475</tt>  <tt class="py-line">  <tt class="py-comment"># Add in undocumented query parameters.</tt> </tt>
-<a name="L476"></a><tt class="py-lineno"> 476</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt id="link-134" class="py-name"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETERS" class="py-name" href="#" onclick="return doclink('link-134', 'STACK_QUERY_PARAMETERS', 'link-63');">STACK_QUERY_PARAMETERS</a></tt><tt class="py-op">:</tt> </tt>
-<a name="L477"></a><tt class="py-lineno"> 477</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-135" class="py-name"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-135', 'STACK_QUERY_PARAMETER_DEFAULT_VALUE', 'link-64');">STACK_QUERY_PARAMETER_DEFAULT_VALUE</a></tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L478"></a><tt class="py-lineno"> 478</tt>  <tt class="py-line"> </tt>
-<a name="L479"></a><tt class="py-lineno"> 479</tt>  <tt class="py-line">  <tt class="py-comment"># Add 'body' (our own reserved word) to parameters if the method supports</tt> </tt>
-<a name="L480"></a><tt class="py-lineno"> 480</tt>  <tt class="py-line">  <tt class="py-comment"># a request payload.</tt> </tt>
-<a name="L481"></a><tt class="py-lineno"> 481</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">http_method</tt> <tt class="py-keyword">in</tt> <tt id="link-136" class="py-name"><a title="googleapiclient.discovery.HTTP_PAYLOAD_METHODS" class="py-name" href="#" onclick="return doclink('link-136', 'HTTP_PAYLOAD_METHODS', 'link-58');">HTTP_PAYLOAD_METHODS</a></tt> <tt class="py-keyword">and</tt> <tt class="py-string">'request'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">method_desc</tt><tt class="py-op">:</tt> </tt>
-<a name="L482"></a><tt class="py-lineno"> 482</tt>  <tt class="py-line">    <tt id="link-137" class="py-name" targets="Method googleapiclient.channel.Channel.body()=googleapiclient.channel.Channel-class.html#body"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-137', 'body', 'link-137');">body</a></tt> <tt class="py-op">=</tt> <tt id="link-138" class="py-name"><a title="googleapiclient.discovery.BODY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-138', 'BODY_PARAMETER_DEFAULT_VALUE', 'link-60');">BODY_PARAMETER_DEFAULT_VALUE</a></tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L483"></a><tt class="py-lineno"> 483</tt>  <tt class="py-line">    <tt id="link-139" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-139', 'body', 'link-137');">body</a></tt><tt class="py-op">.</tt><tt id="link-140" class="py-name" targets="Method googleapiclient.channel.Channel.update()=googleapiclient.channel.Channel-class.html#update"><a title="googleapiclient.channel.Channel.update" class="py-name" href="#" onclick="return doclink('link-140', 'update', 'link-140');">update</a></tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'request'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L484"></a><tt class="py-lineno"> 484</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-string">'body'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-141" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-141', 'body', 'link-137');">body</a></tt> </tt>
-<a name="L485"></a><tt class="py-lineno"> 485</tt>  <tt class="py-line"> </tt>
-<a name="L486"></a><tt class="py-lineno"> 486</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-name">parameters</tt> </tt>
-</div><a name="L487"></a><tt class="py-lineno"> 487</tt>  <tt class="py-line"> </tt>
-<a name="_fix_up_media_upload"></a><div id="_fix_up_media_upload-def"><a name="L488"></a><tt class="py-lineno"> 488</tt>  <tt class="py-line"> </tt>
-<a name="L489"></a><tt class="py-lineno"> 489</tt> <a class="py-toggle" href="#" id="_fix_up_media_upload-toggle" onclick="return toggle('_fix_up_media_upload');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_fix_up_media_upload">_fix_up_media_upload</a><tt class="py-op">(</tt><tt class="py-param">method_desc</tt><tt class="py-op">,</tt> <tt class="py-param">root_desc</tt><tt class="py-op">,</tt> <tt class="py-param">path_url</tt><tt class="py-op">,</tt> <tt class="py-param">parameters</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_fix_up_media_upload-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_fix_up_media_upload-expanded"><a name="L490"></a><tt class="py-lineno"> 490</tt>  <tt class="py-line">  <tt class="py-docstring">"""Adds 'media_body' and 'media_mime_type' parameters if supported by method.</tt> </tt>
-<a name="L491"></a><tt class="py-lineno"> 491</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L492"></a><tt class="py-lineno"> 492</tt>  <tt class="py-line"><tt class="py-docstring">  SIDE EFFECTS: If the method supports media upload and has a required body,</tt> </tt>
-<a name="L493"></a><tt class="py-lineno"> 493</tt>  <tt class="py-line"><tt class="py-docstring">  sets body to be optional (required=False) instead. Also, if there is a</tt> </tt>
-<a name="L494"></a><tt class="py-lineno"> 494</tt>  <tt class="py-line"><tt class="py-docstring">  'mediaUpload' in the method description, adds 'media_upload' key to</tt> </tt>
-<a name="L495"></a><tt class="py-lineno"> 495</tt>  <tt class="py-line"><tt class="py-docstring">  parameters.</tt> </tt>
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-140', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L478"></a><tt class="py-lineno"> 478</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">description</tt> </tt>
+<a name="L479"></a><tt class="py-lineno"> 479</tt>  <tt class="py-line"> </tt>
+<a name="L480"></a><tt class="py-lineno"> 480</tt>  <tt class="py-line">  <tt class="py-comment"># Add in undocumented query parameters.</tt> </tt>
+<a name="L481"></a><tt class="py-lineno"> 481</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt id="link-141" class="py-name"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETERS" class="py-name" href="#" onclick="return doclink('link-141', 'STACK_QUERY_PARAMETERS', 'link-65');">STACK_QUERY_PARAMETERS</a></tt><tt class="py-op">:</tt> </tt>
+<a name="L482"></a><tt class="py-lineno"> 482</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-142" class="py-name"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-142', 'STACK_QUERY_PARAMETER_DEFAULT_VALUE', 'link-66');">STACK_QUERY_PARAMETER_DEFAULT_VALUE</a></tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L483"></a><tt class="py-lineno"> 483</tt>  <tt class="py-line"> </tt>
+<a name="L484"></a><tt class="py-lineno"> 484</tt>  <tt class="py-line">  <tt class="py-comment"># Add 'body' (our own reserved word) to parameters if the method supports</tt> </tt>
+<a name="L485"></a><tt class="py-lineno"> 485</tt>  <tt class="py-line">  <tt class="py-comment"># a request payload.</tt> </tt>
+<a name="L486"></a><tt class="py-lineno"> 486</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">http_method</tt> <tt class="py-keyword">in</tt> <tt id="link-143" class="py-name"><a title="googleapiclient.discovery.HTTP_PAYLOAD_METHODS" class="py-name" href="#" onclick="return doclink('link-143', 'HTTP_PAYLOAD_METHODS', 'link-60');">HTTP_PAYLOAD_METHODS</a></tt> <tt class="py-keyword">and</tt> <tt class="py-string">'request'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">method_desc</tt><tt class="py-op">:</tt> </tt>
+<a name="L487"></a><tt class="py-lineno"> 487</tt>  <tt class="py-line">    <tt id="link-144" class="py-name" targets="Method googleapiclient.channel.Channel.body()=googleapiclient.channel.Channel-class.html#body"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-144', 'body', 'link-144');">body</a></tt> <tt class="py-op">=</tt> <tt id="link-145" class="py-name"><a title="googleapiclient.discovery.BODY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-145', 'BODY_PARAMETER_DEFAULT_VALUE', 'link-62');">BODY_PARAMETER_DEFAULT_VALUE</a></tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L488"></a><tt class="py-lineno"> 488</tt>  <tt class="py-line">    <tt id="link-146" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-146', 'body', 'link-144');">body</a></tt><tt class="py-op">.</tt><tt id="link-147" class="py-name" targets="Method googleapiclient.channel.Channel.update()=googleapiclient.channel.Channel-class.html#update"><a title="googleapiclient.channel.Channel.update" class="py-name" href="#" onclick="return doclink('link-147', 'update', 'link-147');">update</a></tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'request'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L489"></a><tt class="py-lineno"> 489</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-string">'body'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-148" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-148', 'body', 'link-144');">body</a></tt> </tt>
+<a name="L490"></a><tt class="py-lineno"> 490</tt>  <tt class="py-line"> </tt>
+<a name="L491"></a><tt class="py-lineno"> 491</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-name">parameters</tt> </tt>
+</div><a name="L492"></a><tt class="py-lineno"> 492</tt>  <tt class="py-line"> </tt>
+<a name="_fix_up_media_upload"></a><div id="_fix_up_media_upload-def"><a name="L493"></a><tt class="py-lineno"> 493</tt>  <tt class="py-line"> </tt>
+<a name="L494"></a><tt class="py-lineno"> 494</tt> <a class="py-toggle" href="#" id="_fix_up_media_upload-toggle" onclick="return toggle('_fix_up_media_upload');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_fix_up_media_upload">_fix_up_media_upload</a><tt class="py-op">(</tt><tt class="py-param">method_desc</tt><tt class="py-op">,</tt> <tt class="py-param">root_desc</tt><tt class="py-op">,</tt> <tt class="py-param">path_url</tt><tt class="py-op">,</tt> <tt class="py-param">parameters</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_fix_up_media_upload-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_fix_up_media_upload-expanded"><a name="L495"></a><tt class="py-lineno"> 495</tt>  <tt class="py-line">  <tt class="py-docstring">"""Adds 'media_body' and 'media_mime_type' parameters if supported by method.</tt> </tt>
 <a name="L496"></a><tt class="py-lineno"> 496</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L497"></a><tt class="py-lineno"> 497</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L498"></a><tt class="py-lineno"> 498</tt>  <tt class="py-line"><tt class="py-docstring">    method_desc: Dictionary with metadata describing an API method. Value comes</tt> </tt>
-<a name="L499"></a><tt class="py-lineno"> 499</tt>  <tt class="py-line"><tt class="py-docstring">        from the dictionary of methods stored in the 'methods' key in the</tt> </tt>
-<a name="L500"></a><tt class="py-lineno"> 500</tt>  <tt class="py-line"><tt class="py-docstring">        deserialized discovery document.</tt> </tt>
-<a name="L501"></a><tt class="py-lineno"> 501</tt>  <tt class="py-line"><tt class="py-docstring">    root_desc: Dictionary; the entire original deserialized discovery document.</tt> </tt>
-<a name="L502"></a><tt class="py-lineno"> 502</tt>  <tt class="py-line"><tt class="py-docstring">    path_url: String; the relative URL for the API method. Relative to the API</tt> </tt>
-<a name="L503"></a><tt class="py-lineno"> 503</tt>  <tt class="py-line"><tt class="py-docstring">        root, which is specified in the discovery document.</tt> </tt>
-<a name="L504"></a><tt class="py-lineno"> 504</tt>  <tt class="py-line"><tt class="py-docstring">    parameters: A dictionary describing method parameters for method described</tt> </tt>
-<a name="L505"></a><tt class="py-lineno"> 505</tt>  <tt class="py-line"><tt class="py-docstring">        in method_desc.</tt> </tt>
-<a name="L506"></a><tt class="py-lineno"> 506</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L507"></a><tt class="py-lineno"> 507</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L508"></a><tt class="py-lineno"> 508</tt>  <tt class="py-line"><tt class="py-docstring">    Triple (accept, max_size, media_path_url) where:</tt> </tt>
-<a name="L509"></a><tt class="py-lineno"> 509</tt>  <tt class="py-line"><tt class="py-docstring">      - accept is a list of strings representing what content types are</tt> </tt>
-<a name="L510"></a><tt class="py-lineno"> 510</tt>  <tt class="py-line"><tt class="py-docstring">        accepted for media upload. Defaults to empty list if not in the</tt> </tt>
-<a name="L511"></a><tt class="py-lineno"> 511</tt>  <tt class="py-line"><tt class="py-docstring">        discovery document.</tt> </tt>
-<a name="L512"></a><tt class="py-lineno"> 512</tt>  <tt class="py-line"><tt class="py-docstring">      - max_size is a long representing the max size in bytes allowed for a</tt> </tt>
-<a name="L513"></a><tt class="py-lineno"> 513</tt>  <tt class="py-line"><tt class="py-docstring">        media upload. Defaults to 0L if not in the discovery document.</tt> </tt>
-<a name="L514"></a><tt class="py-lineno"> 514</tt>  <tt class="py-line"><tt class="py-docstring">      - media_path_url is a String; the absolute URI for media upload for the</tt> </tt>
-<a name="L515"></a><tt class="py-lineno"> 515</tt>  <tt class="py-line"><tt class="py-docstring">        API method. Constructed using the API root URI and service path from</tt> </tt>
-<a name="L516"></a><tt class="py-lineno"> 516</tt>  <tt class="py-line"><tt class="py-docstring">        the discovery document and the relative path for the API method. If</tt> </tt>
-<a name="L517"></a><tt class="py-lineno"> 517</tt>  <tt class="py-line"><tt class="py-docstring">        media upload is not supported, this is None.</tt> </tt>
-<a name="L518"></a><tt class="py-lineno"> 518</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L519"></a><tt class="py-lineno"> 519</tt>  <tt class="py-line">  <tt class="py-name">media_upload</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">.</tt><tt id="link-142" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="L497"></a><tt class="py-lineno"> 497</tt>  <tt class="py-line"><tt class="py-docstring">  SIDE EFFECTS: If the method supports media upload and has a required body,</tt> </tt>
+<a name="L498"></a><tt class="py-lineno"> 498</tt>  <tt class="py-line"><tt class="py-docstring">  sets body to be optional (required=False) instead. Also, if there is a</tt> </tt>
+<a name="L499"></a><tt class="py-lineno"> 499</tt>  <tt class="py-line"><tt class="py-docstring">  'mediaUpload' in the method description, adds 'media_upload' key to</tt> </tt>
+<a name="L500"></a><tt class="py-lineno"> 500</tt>  <tt class="py-line"><tt class="py-docstring">  parameters.</tt> </tt>
+<a name="L501"></a><tt class="py-lineno"> 501</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L502"></a><tt class="py-lineno"> 502</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L503"></a><tt class="py-lineno"> 503</tt>  <tt class="py-line"><tt class="py-docstring">    method_desc: Dictionary with metadata describing an API method. Value comes</tt> </tt>
+<a name="L504"></a><tt class="py-lineno"> 504</tt>  <tt class="py-line"><tt class="py-docstring">        from the dictionary of methods stored in the 'methods' key in the</tt> </tt>
+<a name="L505"></a><tt class="py-lineno"> 505</tt>  <tt class="py-line"><tt class="py-docstring">        deserialized discovery document.</tt> </tt>
+<a name="L506"></a><tt class="py-lineno"> 506</tt>  <tt class="py-line"><tt class="py-docstring">    root_desc: Dictionary; the entire original deserialized discovery document.</tt> </tt>
+<a name="L507"></a><tt class="py-lineno"> 507</tt>  <tt class="py-line"><tt class="py-docstring">    path_url: String; the relative URL for the API method. Relative to the API</tt> </tt>
+<a name="L508"></a><tt class="py-lineno"> 508</tt>  <tt class="py-line"><tt class="py-docstring">        root, which is specified in the discovery document.</tt> </tt>
+<a name="L509"></a><tt class="py-lineno"> 509</tt>  <tt class="py-line"><tt class="py-docstring">    parameters: A dictionary describing method parameters for method described</tt> </tt>
+<a name="L510"></a><tt class="py-lineno"> 510</tt>  <tt class="py-line"><tt class="py-docstring">        in method_desc.</tt> </tt>
+<a name="L511"></a><tt class="py-lineno"> 511</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L512"></a><tt class="py-lineno"> 512</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L513"></a><tt class="py-lineno"> 513</tt>  <tt class="py-line"><tt class="py-docstring">    Triple (accept, max_size, media_path_url) where:</tt> </tt>
+<a name="L514"></a><tt class="py-lineno"> 514</tt>  <tt class="py-line"><tt class="py-docstring">      - accept is a list of strings representing what content types are</tt> </tt>
+<a name="L515"></a><tt class="py-lineno"> 515</tt>  <tt class="py-line"><tt class="py-docstring">        accepted for media upload. Defaults to empty list if not in the</tt> </tt>
+<a name="L516"></a><tt class="py-lineno"> 516</tt>  <tt class="py-line"><tt class="py-docstring">        discovery document.</tt> </tt>
+<a name="L517"></a><tt class="py-lineno"> 517</tt>  <tt class="py-line"><tt class="py-docstring">      - max_size is a long representing the max size in bytes allowed for a</tt> </tt>
+<a name="L518"></a><tt class="py-lineno"> 518</tt>  <tt class="py-line"><tt class="py-docstring">        media upload. Defaults to 0L if not in the discovery document.</tt> </tt>
+<a name="L519"></a><tt class="py-lineno"> 519</tt>  <tt class="py-line"><tt class="py-docstring">      - media_path_url is a String; the absolute URI for media upload for the</tt> </tt>
+<a name="L520"></a><tt class="py-lineno"> 520</tt>  <tt class="py-line"><tt class="py-docstring">        API method. Constructed using the API root URI and service path from</tt> </tt>
+<a name="L521"></a><tt class="py-lineno"> 521</tt>  <tt class="py-line"><tt class="py-docstring">        the discovery document and the relative path for the API method. If</tt> </tt>
+<a name="L522"></a><tt class="py-lineno"> 522</tt>  <tt class="py-line"><tt class="py-docstring">        media upload is not supported, this is None.</tt> </tt>
+<a name="L523"></a><tt class="py-lineno"> 523</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L524"></a><tt class="py-lineno"> 524</tt>  <tt class="py-line">  <tt class="py-name">media_upload</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">.</tt><tt id="link-149" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-142', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'mediaUpload'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
-<a name="L520"></a><tt class="py-lineno"> 520</tt>  <tt class="py-line">  <tt id="link-143" class="py-name" targets="Variable googleapiclient.model.BaseModel.accept=googleapiclient.model.BaseModel-class.html#accept,Variable googleapiclient.model.JsonModel.accept=googleapiclient.model.JsonModel-class.html#accept,Variable googleapiclient.model.MediaModel.accept=googleapiclient.model.MediaModel-class.html#accept,Variable googleapiclient.model.ProtocolBufferModel.accept=googleapiclient.model.ProtocolBufferModel-class.html#accept,Variable googleapiclient.model.RawModel.accept=googleapiclient.model.RawModel-class.html#accept"><a title="googleapiclient.model.BaseModel.accept
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-149', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'mediaUpload'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
+<a name="L525"></a><tt class="py-lineno"> 525</tt>  <tt class="py-line">  <tt id="link-150" class="py-name" targets="Variable googleapiclient.model.BaseModel.accept=googleapiclient.model.BaseModel-class.html#accept,Variable googleapiclient.model.JsonModel.accept=googleapiclient.model.JsonModel-class.html#accept,Variable googleapiclient.model.MediaModel.accept=googleapiclient.model.MediaModel-class.html#accept,Variable googleapiclient.model.ProtocolBufferModel.accept=googleapiclient.model.ProtocolBufferModel-class.html#accept,Variable googleapiclient.model.RawModel.accept=googleapiclient.model.RawModel-class.html#accept"><a title="googleapiclient.model.BaseModel.accept
 googleapiclient.model.JsonModel.accept
 googleapiclient.model.MediaModel.accept
 googleapiclient.model.ProtocolBufferModel.accept
-googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-143', 'accept', 'link-143');">accept</a></tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-144" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-150', 'accept', 'link-150');">accept</a></tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-151" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-144', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'accept'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L521"></a><tt class="py-lineno"> 521</tt>  <tt class="py-line">  <tt class="py-name">max_size</tt> <tt class="py-op">=</tt> <tt id="link-145" class="py-name" targets="Function googleapiclient.discovery._media_size_to_long()=googleapiclient.discovery-module.html#_media_size_to_long"><a title="googleapiclient.discovery._media_size_to_long" class="py-name" href="#" onclick="return doclink('link-145', '_media_size_to_long', 'link-145');">_media_size_to_long</a></tt><tt class="py-op">(</tt><tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-146" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-151', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'accept'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L526"></a><tt class="py-lineno"> 526</tt>  <tt class="py-line">  <tt class="py-name">max_size</tt> <tt class="py-op">=</tt> <tt id="link-152" class="py-name" targets="Function googleapiclient.discovery._media_size_to_long()=googleapiclient.discovery-module.html#_media_size_to_long"><a title="googleapiclient.discovery._media_size_to_long" class="py-name" href="#" onclick="return doclink('link-152', '_media_size_to_long', 'link-152');">_media_size_to_long</a></tt><tt class="py-op">(</tt><tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-153" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-146', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'maxSize'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L522"></a><tt class="py-lineno"> 522</tt>  <tt class="py-line">  <tt class="py-name">media_path_url</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L523"></a><tt class="py-lineno"> 523</tt>  <tt class="py-line"> </tt>
-<a name="L524"></a><tt class="py-lineno"> 524</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">media_upload</tt><tt class="py-op">:</tt> </tt>
-<a name="L525"></a><tt class="py-lineno"> 525</tt>  <tt class="py-line">    <tt class="py-name">media_path_url</tt> <tt class="py-op">=</tt> <tt id="link-147" class="py-name" targets="Function googleapiclient.discovery._media_path_url_from_info()=googleapiclient.discovery-module.html#_media_path_url_from_info"><a title="googleapiclient.discovery._media_path_url_from_info" class="py-name" href="#" onclick="return doclink('link-147', '_media_path_url_from_info', 'link-147');">_media_path_url_from_info</a></tt><tt class="py-op">(</tt><tt class="py-name">root_desc</tt><tt class="py-op">,</tt> <tt class="py-name">path_url</tt><tt class="py-op">)</tt> </tt>
-<a name="L526"></a><tt class="py-lineno"> 526</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-string">'media_body'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-148" class="py-name"><a title="googleapiclient.discovery.MEDIA_BODY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-148', 'MEDIA_BODY_PARAMETER_DEFAULT_VALUE', 'link-61');">MEDIA_BODY_PARAMETER_DEFAULT_VALUE</a></tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L527"></a><tt class="py-lineno"> 527</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-string">'media_mime_type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-149" class="py-name"><a title="googleapiclient.discovery.MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-149', 'MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE', 'link-62');">MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE</a></tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L528"></a><tt class="py-lineno"> 528</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'body'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">:</tt> </tt>
-<a name="L529"></a><tt class="py-lineno"> 529</tt>  <tt class="py-line">      <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-string">'body'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'required'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
-<a name="L530"></a><tt class="py-lineno"> 530</tt>  <tt class="py-line"> </tt>
-<a name="L531"></a><tt class="py-lineno"> 531</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt id="link-150" class="py-name"><a title="googleapiclient.model.BaseModel.accept
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-153', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'maxSize'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L527"></a><tt class="py-lineno"> 527</tt>  <tt class="py-line">  <tt class="py-name">media_path_url</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L528"></a><tt class="py-lineno"> 528</tt>  <tt class="py-line"> </tt>
+<a name="L529"></a><tt class="py-lineno"> 529</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">media_upload</tt><tt class="py-op">:</tt> </tt>
+<a name="L530"></a><tt class="py-lineno"> 530</tt>  <tt class="py-line">    <tt class="py-name">media_path_url</tt> <tt class="py-op">=</tt> <tt id="link-154" class="py-name" targets="Function googleapiclient.discovery._media_path_url_from_info()=googleapiclient.discovery-module.html#_media_path_url_from_info"><a title="googleapiclient.discovery._media_path_url_from_info" class="py-name" href="#" onclick="return doclink('link-154', '_media_path_url_from_info', 'link-154');">_media_path_url_from_info</a></tt><tt class="py-op">(</tt><tt class="py-name">root_desc</tt><tt class="py-op">,</tt> <tt class="py-name">path_url</tt><tt class="py-op">)</tt> </tt>
+<a name="L531"></a><tt class="py-lineno"> 531</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-string">'media_body'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-155" class="py-name"><a title="googleapiclient.discovery.MEDIA_BODY_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-155', 'MEDIA_BODY_PARAMETER_DEFAULT_VALUE', 'link-63');">MEDIA_BODY_PARAMETER_DEFAULT_VALUE</a></tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L532"></a><tt class="py-lineno"> 532</tt>  <tt class="py-line">    <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-string">'media_mime_type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-156" class="py-name"><a title="googleapiclient.discovery.MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE" class="py-name" href="#" onclick="return doclink('link-156', 'MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE', 'link-64');">MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE</a></tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L533"></a><tt class="py-lineno"> 533</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'body'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">:</tt> </tt>
+<a name="L534"></a><tt class="py-lineno"> 534</tt>  <tt class="py-line">      <tt class="py-name">parameters</tt><tt class="py-op">[</tt><tt class="py-string">'body'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'required'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
+<a name="L535"></a><tt class="py-lineno"> 535</tt>  <tt class="py-line"> </tt>
+<a name="L536"></a><tt class="py-lineno"> 536</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt id="link-157" class="py-name"><a title="googleapiclient.model.BaseModel.accept
 googleapiclient.model.JsonModel.accept
 googleapiclient.model.MediaModel.accept
 googleapiclient.model.ProtocolBufferModel.accept
-googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-150', 'accept', 'link-143');">accept</a></tt><tt class="py-op">,</tt> <tt class="py-name">max_size</tt><tt class="py-op">,</tt> <tt class="py-name">media_path_url</tt> </tt>
-</div><a name="L532"></a><tt class="py-lineno"> 532</tt>  <tt class="py-line"> </tt>
-<a name="_fix_up_method_description"></a><div id="_fix_up_method_description-def"><a name="L533"></a><tt class="py-lineno"> 533</tt>  <tt class="py-line"> </tt>
-<a name="L534"></a><tt class="py-lineno"> 534</tt> <a class="py-toggle" href="#" id="_fix_up_method_description-toggle" onclick="return toggle('_fix_up_method_description');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_fix_up_method_description">_fix_up_method_description</a><tt class="py-op">(</tt><tt class="py-param">method_desc</tt><tt class="py-op">,</tt> <tt class="py-param">root_desc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_fix_up_method_description-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_fix_up_method_description-expanded"><a name="L535"></a><tt class="py-lineno"> 535</tt>  <tt class="py-line">  <tt class="py-docstring">"""Updates a method description in a discovery document.</tt> </tt>
-<a name="L536"></a><tt class="py-lineno"> 536</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L537"></a><tt class="py-lineno"> 537</tt>  <tt class="py-line"><tt class="py-docstring">  SIDE EFFECTS: Changes the parameters dictionary in the method description with</tt> </tt>
-<a name="L538"></a><tt class="py-lineno"> 538</tt>  <tt class="py-line"><tt class="py-docstring">  extra parameters which are used locally.</tt> </tt>
-<a name="L539"></a><tt class="py-lineno"> 539</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L540"></a><tt class="py-lineno"> 540</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L541"></a><tt class="py-lineno"> 541</tt>  <tt class="py-line"><tt class="py-docstring">    method_desc: Dictionary with metadata describing an API method. Value comes</tt> </tt>
-<a name="L542"></a><tt class="py-lineno"> 542</tt>  <tt class="py-line"><tt class="py-docstring">        from the dictionary of methods stored in the 'methods' key in the</tt> </tt>
-<a name="L543"></a><tt class="py-lineno"> 543</tt>  <tt class="py-line"><tt class="py-docstring">        deserialized discovery document.</tt> </tt>
-<a name="L544"></a><tt class="py-lineno"> 544</tt>  <tt class="py-line"><tt class="py-docstring">    root_desc: Dictionary; the entire original deserialized discovery document.</tt> </tt>
-<a name="L545"></a><tt class="py-lineno"> 545</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L546"></a><tt class="py-lineno"> 546</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L547"></a><tt class="py-lineno"> 547</tt>  <tt class="py-line"><tt class="py-docstring">    Tuple (path_url, http_method, method_id, accept, max_size, media_path_url)</tt> </tt>
-<a name="L548"></a><tt class="py-lineno"> 548</tt>  <tt class="py-line"><tt class="py-docstring">    where:</tt> </tt>
-<a name="L549"></a><tt class="py-lineno"> 549</tt>  <tt class="py-line"><tt class="py-docstring">      - path_url is a String; the relative URL for the API method. Relative to</tt> </tt>
-<a name="L550"></a><tt class="py-lineno"> 550</tt>  <tt class="py-line"><tt class="py-docstring">        the API root, which is specified in the discovery document.</tt> </tt>
-<a name="L551"></a><tt class="py-lineno"> 551</tt>  <tt class="py-line"><tt class="py-docstring">      - http_method is a String; the HTTP method used to call the API method</tt> </tt>
-<a name="L552"></a><tt class="py-lineno"> 552</tt>  <tt class="py-line"><tt class="py-docstring">        described in the method description.</tt> </tt>
-<a name="L553"></a><tt class="py-lineno"> 553</tt>  <tt class="py-line"><tt class="py-docstring">      - method_id is a String; the name of the RPC method associated with the</tt> </tt>
-<a name="L554"></a><tt class="py-lineno"> 554</tt>  <tt class="py-line"><tt class="py-docstring">        API method, and is in the method description in the 'id' key.</tt> </tt>
-<a name="L555"></a><tt class="py-lineno"> 555</tt>  <tt class="py-line"><tt class="py-docstring">      - accept is a list of strings representing what content types are</tt> </tt>
-<a name="L556"></a><tt class="py-lineno"> 556</tt>  <tt class="py-line"><tt class="py-docstring">        accepted for media upload. Defaults to empty list if not in the</tt> </tt>
-<a name="L557"></a><tt class="py-lineno"> 557</tt>  <tt class="py-line"><tt class="py-docstring">        discovery document.</tt> </tt>
-<a name="L558"></a><tt class="py-lineno"> 558</tt>  <tt class="py-line"><tt class="py-docstring">      - max_size is a long representing the max size in bytes allowed for a</tt> </tt>
-<a name="L559"></a><tt class="py-lineno"> 559</tt>  <tt class="py-line"><tt class="py-docstring">        media upload. Defaults to 0L if not in the discovery document.</tt> </tt>
-<a name="L560"></a><tt class="py-lineno"> 560</tt>  <tt class="py-line"><tt class="py-docstring">      - media_path_url is a String; the absolute URI for media upload for the</tt> </tt>
-<a name="L561"></a><tt class="py-lineno"> 561</tt>  <tt class="py-line"><tt class="py-docstring">        API method. Constructed using the API root URI and service path from</tt> </tt>
-<a name="L562"></a><tt class="py-lineno"> 562</tt>  <tt class="py-line"><tt class="py-docstring">        the discovery document and the relative path for the API method. If</tt> </tt>
-<a name="L563"></a><tt class="py-lineno"> 563</tt>  <tt class="py-line"><tt class="py-docstring">        media upload is not supported, this is None.</tt> </tt>
-<a name="L564"></a><tt class="py-lineno"> 564</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L565"></a><tt class="py-lineno"> 565</tt>  <tt class="py-line">  <tt class="py-name">path_url</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'path'</tt><tt class="py-op">]</tt> </tt>
-<a name="L566"></a><tt class="py-lineno"> 566</tt>  <tt class="py-line">  <tt class="py-name">http_method</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'httpMethod'</tt><tt class="py-op">]</tt> </tt>
-<a name="L567"></a><tt class="py-lineno"> 567</tt>  <tt class="py-line">  <tt class="py-name">method_id</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'id'</tt><tt class="py-op">]</tt> </tt>
-<a name="L568"></a><tt class="py-lineno"> 568</tt>  <tt class="py-line"> </tt>
-<a name="L569"></a><tt class="py-lineno"> 569</tt>  <tt class="py-line">  <tt class="py-name">parameters</tt> <tt class="py-op">=</tt> <tt id="link-151" class="py-name" targets="Function googleapiclient.discovery._fix_up_parameters()=googleapiclient.discovery-module.html#_fix_up_parameters"><a title="googleapiclient.discovery._fix_up_parameters" class="py-name" href="#" onclick="return doclink('link-151', '_fix_up_parameters', 'link-151');">_fix_up_parameters</a></tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">,</tt> <tt class="py-name">root_desc</tt><tt class="py-op">,</tt> <tt class="py-name">http_method</tt><tt class="py-op">)</tt> </tt>
-<a name="L570"></a><tt class="py-lineno"> 570</tt>  <tt class="py-line">  <tt class="py-comment"># Order is important. `_fix_up_media_upload` needs `method_desc` to have a</tt> </tt>
-<a name="L571"></a><tt class="py-lineno"> 571</tt>  <tt class="py-line">  <tt class="py-comment"># 'parameters' key and needs to know if there is a 'body' parameter because it</tt> </tt>
-<a name="L572"></a><tt class="py-lineno"> 572</tt>  <tt class="py-line">  <tt class="py-comment"># also sets a 'media_body' parameter.</tt> </tt>
-<a name="L573"></a><tt class="py-lineno"> 573</tt>  <tt class="py-line">  <tt id="link-152" class="py-name"><a title="googleapiclient.model.BaseModel.accept
+googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-157', 'accept', 'link-150');">accept</a></tt><tt class="py-op">,</tt> <tt class="py-name">max_size</tt><tt class="py-op">,</tt> <tt class="py-name">media_path_url</tt> </tt>
+</div><a name="L537"></a><tt class="py-lineno"> 537</tt>  <tt class="py-line"> </tt>
+<a name="_fix_up_method_description"></a><div id="_fix_up_method_description-def"><a name="L538"></a><tt class="py-lineno"> 538</tt>  <tt class="py-line"> </tt>
+<a name="L539"></a><tt class="py-lineno"> 539</tt> <a class="py-toggle" href="#" id="_fix_up_method_description-toggle" onclick="return toggle('_fix_up_method_description');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_fix_up_method_description">_fix_up_method_description</a><tt class="py-op">(</tt><tt class="py-param">method_desc</tt><tt class="py-op">,</tt> <tt class="py-param">root_desc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_fix_up_method_description-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_fix_up_method_description-expanded"><a name="L540"></a><tt class="py-lineno"> 540</tt>  <tt class="py-line">  <tt class="py-docstring">"""Updates a method description in a discovery document.</tt> </tt>
+<a name="L541"></a><tt class="py-lineno"> 541</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L542"></a><tt class="py-lineno"> 542</tt>  <tt class="py-line"><tt class="py-docstring">  SIDE EFFECTS: Changes the parameters dictionary in the method description with</tt> </tt>
+<a name="L543"></a><tt class="py-lineno"> 543</tt>  <tt class="py-line"><tt class="py-docstring">  extra parameters which are used locally.</tt> </tt>
+<a name="L544"></a><tt class="py-lineno"> 544</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L545"></a><tt class="py-lineno"> 545</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L546"></a><tt class="py-lineno"> 546</tt>  <tt class="py-line"><tt class="py-docstring">    method_desc: Dictionary with metadata describing an API method. Value comes</tt> </tt>
+<a name="L547"></a><tt class="py-lineno"> 547</tt>  <tt class="py-line"><tt class="py-docstring">        from the dictionary of methods stored in the 'methods' key in the</tt> </tt>
+<a name="L548"></a><tt class="py-lineno"> 548</tt>  <tt class="py-line"><tt class="py-docstring">        deserialized discovery document.</tt> </tt>
+<a name="L549"></a><tt class="py-lineno"> 549</tt>  <tt class="py-line"><tt class="py-docstring">    root_desc: Dictionary; the entire original deserialized discovery document.</tt> </tt>
+<a name="L550"></a><tt class="py-lineno"> 550</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L551"></a><tt class="py-lineno"> 551</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L552"></a><tt class="py-lineno"> 552</tt>  <tt class="py-line"><tt class="py-docstring">    Tuple (path_url, http_method, method_id, accept, max_size, media_path_url)</tt> </tt>
+<a name="L553"></a><tt class="py-lineno"> 553</tt>  <tt class="py-line"><tt class="py-docstring">    where:</tt> </tt>
+<a name="L554"></a><tt class="py-lineno"> 554</tt>  <tt class="py-line"><tt class="py-docstring">      - path_url is a String; the relative URL for the API method. Relative to</tt> </tt>
+<a name="L555"></a><tt class="py-lineno"> 555</tt>  <tt class="py-line"><tt class="py-docstring">        the API root, which is specified in the discovery document.</tt> </tt>
+<a name="L556"></a><tt class="py-lineno"> 556</tt>  <tt class="py-line"><tt class="py-docstring">      - http_method is a String; the HTTP method used to call the API method</tt> </tt>
+<a name="L557"></a><tt class="py-lineno"> 557</tt>  <tt class="py-line"><tt class="py-docstring">        described in the method description.</tt> </tt>
+<a name="L558"></a><tt class="py-lineno"> 558</tt>  <tt class="py-line"><tt class="py-docstring">      - method_id is a String; the name of the RPC method associated with the</tt> </tt>
+<a name="L559"></a><tt class="py-lineno"> 559</tt>  <tt class="py-line"><tt class="py-docstring">        API method, and is in the method description in the 'id' key.</tt> </tt>
+<a name="L560"></a><tt class="py-lineno"> 560</tt>  <tt class="py-line"><tt class="py-docstring">      - accept is a list of strings representing what content types are</tt> </tt>
+<a name="L561"></a><tt class="py-lineno"> 561</tt>  <tt class="py-line"><tt class="py-docstring">        accepted for media upload. Defaults to empty list if not in the</tt> </tt>
+<a name="L562"></a><tt class="py-lineno"> 562</tt>  <tt class="py-line"><tt class="py-docstring">        discovery document.</tt> </tt>
+<a name="L563"></a><tt class="py-lineno"> 563</tt>  <tt class="py-line"><tt class="py-docstring">      - max_size is a long representing the max size in bytes allowed for a</tt> </tt>
+<a name="L564"></a><tt class="py-lineno"> 564</tt>  <tt class="py-line"><tt class="py-docstring">        media upload. Defaults to 0L if not in the discovery document.</tt> </tt>
+<a name="L565"></a><tt class="py-lineno"> 565</tt>  <tt class="py-line"><tt class="py-docstring">      - media_path_url is a String; the absolute URI for media upload for the</tt> </tt>
+<a name="L566"></a><tt class="py-lineno"> 566</tt>  <tt class="py-line"><tt class="py-docstring">        API method. Constructed using the API root URI and service path from</tt> </tt>
+<a name="L567"></a><tt class="py-lineno"> 567</tt>  <tt class="py-line"><tt class="py-docstring">        the discovery document and the relative path for the API method. If</tt> </tt>
+<a name="L568"></a><tt class="py-lineno"> 568</tt>  <tt class="py-line"><tt class="py-docstring">        media upload is not supported, this is None.</tt> </tt>
+<a name="L569"></a><tt class="py-lineno"> 569</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L570"></a><tt class="py-lineno"> 570</tt>  <tt class="py-line">  <tt class="py-name">path_url</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'path'</tt><tt class="py-op">]</tt> </tt>
+<a name="L571"></a><tt class="py-lineno"> 571</tt>  <tt class="py-line">  <tt class="py-name">http_method</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'httpMethod'</tt><tt class="py-op">]</tt> </tt>
+<a name="L572"></a><tt class="py-lineno"> 572</tt>  <tt class="py-line">  <tt class="py-name">method_id</tt> <tt class="py-op">=</tt> <tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'id'</tt><tt class="py-op">]</tt> </tt>
+<a name="L573"></a><tt class="py-lineno"> 573</tt>  <tt class="py-line"> </tt>
+<a name="L574"></a><tt class="py-lineno"> 574</tt>  <tt class="py-line">  <tt class="py-name">parameters</tt> <tt class="py-op">=</tt> <tt id="link-158" class="py-name" targets="Function googleapiclient.discovery._fix_up_parameters()=googleapiclient.discovery-module.html#_fix_up_parameters"><a title="googleapiclient.discovery._fix_up_parameters" class="py-name" href="#" onclick="return doclink('link-158', '_fix_up_parameters', 'link-158');">_fix_up_parameters</a></tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">,</tt> <tt class="py-name">root_desc</tt><tt class="py-op">,</tt> <tt class="py-name">http_method</tt><tt class="py-op">)</tt> </tt>
+<a name="L575"></a><tt class="py-lineno"> 575</tt>  <tt class="py-line">  <tt class="py-comment"># Order is important. `_fix_up_media_upload` needs `method_desc` to have a</tt> </tt>
+<a name="L576"></a><tt class="py-lineno"> 576</tt>  <tt class="py-line">  <tt class="py-comment"># 'parameters' key and needs to know if there is a 'body' parameter because it</tt> </tt>
+<a name="L577"></a><tt class="py-lineno"> 577</tt>  <tt class="py-line">  <tt class="py-comment"># also sets a 'media_body' parameter.</tt> </tt>
+<a name="L578"></a><tt class="py-lineno"> 578</tt>  <tt class="py-line">  <tt id="link-159" class="py-name"><a title="googleapiclient.model.BaseModel.accept
 googleapiclient.model.JsonModel.accept
 googleapiclient.model.MediaModel.accept
 googleapiclient.model.ProtocolBufferModel.accept
-googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-152', 'accept', 'link-143');">accept</a></tt><tt class="py-op">,</tt> <tt class="py-name">max_size</tt><tt class="py-op">,</tt> <tt class="py-name">media_path_url</tt> <tt class="py-op">=</tt> <tt id="link-153" class="py-name" targets="Function googleapiclient.discovery._fix_up_media_upload()=googleapiclient.discovery-module.html#_fix_up_media_upload"><a title="googleapiclient.discovery._fix_up_media_upload" class="py-name" href="#" onclick="return doclink('link-153', '_fix_up_media_upload', 'link-153');">_fix_up_media_upload</a></tt><tt class="py-op">(</tt> </tt>
-<a name="L574"></a><tt class="py-lineno"> 574</tt>  <tt class="py-line">      <tt class="py-name">method_desc</tt><tt class="py-op">,</tt> <tt class="py-name">root_desc</tt><tt class="py-op">,</tt> <tt class="py-name">path_url</tt><tt class="py-op">,</tt> <tt class="py-name">parameters</tt><tt class="py-op">)</tt> </tt>
-<a name="L575"></a><tt class="py-lineno"> 575</tt>  <tt class="py-line"> </tt>
-<a name="L576"></a><tt class="py-lineno"> 576</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-name">path_url</tt><tt class="py-op">,</tt> <tt class="py-name">http_method</tt><tt class="py-op">,</tt> <tt class="py-name">method_id</tt><tt class="py-op">,</tt> <tt id="link-154" class="py-name"><a title="googleapiclient.model.BaseModel.accept
+googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-159', 'accept', 'link-150');">accept</a></tt><tt class="py-op">,</tt> <tt class="py-name">max_size</tt><tt class="py-op">,</tt> <tt class="py-name">media_path_url</tt> <tt class="py-op">=</tt> <tt id="link-160" class="py-name" targets="Function googleapiclient.discovery._fix_up_media_upload()=googleapiclient.discovery-module.html#_fix_up_media_upload"><a title="googleapiclient.discovery._fix_up_media_upload" class="py-name" href="#" onclick="return doclink('link-160', '_fix_up_media_upload', 'link-160');">_fix_up_media_upload</a></tt><tt class="py-op">(</tt> </tt>
+<a name="L579"></a><tt class="py-lineno"> 579</tt>  <tt class="py-line">      <tt class="py-name">method_desc</tt><tt class="py-op">,</tt> <tt class="py-name">root_desc</tt><tt class="py-op">,</tt> <tt class="py-name">path_url</tt><tt class="py-op">,</tt> <tt class="py-name">parameters</tt><tt class="py-op">)</tt> </tt>
+<a name="L580"></a><tt class="py-lineno"> 580</tt>  <tt class="py-line"> </tt>
+<a name="L581"></a><tt class="py-lineno"> 581</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-name">path_url</tt><tt class="py-op">,</tt> <tt class="py-name">http_method</tt><tt class="py-op">,</tt> <tt class="py-name">method_id</tt><tt class="py-op">,</tt> <tt id="link-161" class="py-name"><a title="googleapiclient.model.BaseModel.accept
 googleapiclient.model.JsonModel.accept
 googleapiclient.model.MediaModel.accept
 googleapiclient.model.ProtocolBufferModel.accept
-googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-154', 'accept', 'link-143');">accept</a></tt><tt class="py-op">,</tt> <tt class="py-name">max_size</tt><tt class="py-op">,</tt> <tt class="py-name">media_path_url</tt> </tt>
-</div><a name="L577"></a><tt class="py-lineno"> 577</tt>  <tt class="py-line"> </tt>
-<a name="_urljoin"></a><div id="_urljoin-def"><a name="L578"></a><tt class="py-lineno"> 578</tt>  <tt class="py-line"> </tt>
-<a name="L579"></a><tt class="py-lineno"> 579</tt> <a class="py-toggle" href="#" id="_urljoin-toggle" onclick="return toggle('_urljoin');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_urljoin">_urljoin</a><tt class="py-op">(</tt><tt class="py-param">base</tt><tt class="py-op">,</tt> <tt class="py-param">url</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="_urljoin-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_urljoin-expanded"><a name="L580"></a><tt class="py-lineno"> 580</tt>  <tt class="py-line">  <tt class="py-docstring">"""Custom urljoin replacement supporting : before / in url."""</tt> </tt>
-<a name="L581"></a><tt class="py-lineno"> 581</tt>  <tt class="py-line">  <tt class="py-comment"># In general, it's unsafe to simply join base and url. However, for</tt> </tt>
-<a name="L582"></a><tt class="py-lineno"> 582</tt>  <tt class="py-line">  <tt class="py-comment"># the case of discovery documents, we know:</tt> </tt>
-<a name="L583"></a><tt class="py-lineno"> 583</tt>  <tt class="py-line">  <tt class="py-comment">#  * base will never contain params, query, or fragment</tt> </tt>
-<a name="L584"></a><tt class="py-lineno"> 584</tt>  <tt class="py-line">  <tt class="py-comment">#  * url will never contain a scheme or net_loc.</tt> </tt>
-<a name="L585"></a><tt class="py-lineno"> 585</tt>  <tt class="py-line">  <tt class="py-comment"># In general, this means we can safely join on /; we just need to</tt> </tt>
-<a name="L586"></a><tt class="py-lineno"> 586</tt>  <tt class="py-line">  <tt class="py-comment"># ensure we end up with precisely one / joining base and url. The</tt> </tt>
-<a name="L587"></a><tt class="py-lineno"> 587</tt>  <tt class="py-line">  <tt class="py-comment"># exception here is the case of media uploads, where url will be an</tt> </tt>
-<a name="L588"></a><tt class="py-lineno"> 588</tt>  <tt class="py-line">  <tt class="py-comment"># absolute url.</tt> </tt>
-<a name="L589"></a><tt class="py-lineno"> 589</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">url</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'http://'</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">url</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'https://'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L590"></a><tt class="py-lineno"> 590</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">urljoin</tt><tt class="py-op">(</tt><tt id="link-155" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-155', 'base', 'link-77');">base</a></tt><tt class="py-op">,</tt> <tt class="py-name">url</tt><tt class="py-op">)</tt> </tt>
-<a name="L591"></a><tt class="py-lineno"> 591</tt>  <tt class="py-line">  <tt class="py-name">new_base</tt> <tt class="py-op">=</tt> <tt id="link-156" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-156', 'base', 'link-77');">base</a></tt> <tt class="py-keyword">if</tt> <tt id="link-157" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-157', 'base', 'link-77');">base</a></tt><tt class="py-op">.</tt><tt class="py-name">endswith</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt> <tt class="py-keyword">else</tt> <tt id="link-158" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-158', 'base', 'link-77');">base</a></tt> <tt class="py-op">+</tt> <tt class="py-string">'/'</tt> </tt>
-<a name="L592"></a><tt class="py-lineno"> 592</tt>  <tt class="py-line">  <tt class="py-name">new_url</tt> <tt class="py-op">=</tt> <tt class="py-name">url</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> <tt class="py-keyword">if</tt> <tt class="py-name">url</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt> <tt class="py-keyword">else</tt> <tt class="py-name">url</tt> </tt>
-<a name="L593"></a><tt class="py-lineno"> 593</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-name">new_base</tt> <tt class="py-op">+</tt> <tt class="py-name">new_url</tt> </tt>
-</div><a name="L594"></a><tt class="py-lineno"> 594</tt>  <tt class="py-line"> </tt>
-<a name="ResourceMethodParameters"></a><div id="ResourceMethodParameters-def"><a name="L595"></a><tt class="py-lineno"> 595</tt>  <tt class="py-line"> </tt>
-<a name="L596"></a><tt class="py-lineno"> 596</tt>  <tt class="py-line"><tt class="py-comment"># TODO(dhermes): Convert this class to ResourceMethod and make it callable</tt> </tt>
-<a name="L597"></a><tt class="py-lineno"> 597</tt> <a class="py-toggle" href="#" id="ResourceMethodParameters-toggle" onclick="return toggle('ResourceMethodParameters');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.discovery.ResourceMethodParameters-class.html">ResourceMethodParameters</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="ResourceMethodParameters-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="ResourceMethodParameters-expanded"><a name="L598"></a><tt class="py-lineno"> 598</tt>  <tt class="py-line">  <tt class="py-docstring">"""Represents the parameters associated with a method.</tt> </tt>
-<a name="L599"></a><tt class="py-lineno"> 599</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L600"></a><tt class="py-lineno"> 600</tt>  <tt class="py-line"><tt class="py-docstring">  Attributes:</tt> </tt>
-<a name="L601"></a><tt class="py-lineno"> 601</tt>  <tt class="py-line"><tt class="py-docstring">    argmap: Map from method parameter name (string) to query parameter name</tt> </tt>
-<a name="L602"></a><tt class="py-lineno"> 602</tt>  <tt class="py-line"><tt class="py-docstring">        (string).</tt> </tt>
-<a name="L603"></a><tt class="py-lineno"> 603</tt>  <tt class="py-line"><tt class="py-docstring">    required_params: List of required parameters (represented by parameter</tt> </tt>
-<a name="L604"></a><tt class="py-lineno"> 604</tt>  <tt class="py-line"><tt class="py-docstring">        name as string).</tt> </tt>
-<a name="L605"></a><tt class="py-lineno"> 605</tt>  <tt class="py-line"><tt class="py-docstring">    repeated_params: List of repeated parameters (represented by parameter</tt> </tt>
-<a name="L606"></a><tt class="py-lineno"> 606</tt>  <tt class="py-line"><tt class="py-docstring">        name as string).</tt> </tt>
-<a name="L607"></a><tt class="py-lineno"> 607</tt>  <tt class="py-line"><tt class="py-docstring">    pattern_params: Map from method parameter name (string) to regular</tt> </tt>
-<a name="L608"></a><tt class="py-lineno"> 608</tt>  <tt class="py-line"><tt class="py-docstring">        expression (as a string). If the pattern is set for a parameter, the</tt> </tt>
-<a name="L609"></a><tt class="py-lineno"> 609</tt>  <tt class="py-line"><tt class="py-docstring">        value for that parameter must match the regular expression.</tt> </tt>
-<a name="L610"></a><tt class="py-lineno"> 610</tt>  <tt class="py-line"><tt class="py-docstring">    query_params: List of parameters (represented by parameter name as string)</tt> </tt>
-<a name="L611"></a><tt class="py-lineno"> 611</tt>  <tt class="py-line"><tt class="py-docstring">        that will be used in the query string.</tt> </tt>
-<a name="L612"></a><tt class="py-lineno"> 612</tt>  <tt class="py-line"><tt class="py-docstring">    path_params: Set of parameters (represented by parameter name as string)</tt> </tt>
-<a name="L613"></a><tt class="py-lineno"> 613</tt>  <tt class="py-line"><tt class="py-docstring">        that will be used in the base URL path.</tt> </tt>
-<a name="L614"></a><tt class="py-lineno"> 614</tt>  <tt class="py-line"><tt class="py-docstring">    param_types: Map from method parameter name (string) to parameter type. Type</tt> </tt>
-<a name="L615"></a><tt class="py-lineno"> 615</tt>  <tt class="py-line"><tt class="py-docstring">        can be any valid JSON schema type; valid values are 'any', 'array',</tt> </tt>
-<a name="L616"></a><tt class="py-lineno"> 616</tt>  <tt class="py-line"><tt class="py-docstring">        'boolean', 'integer', 'number', 'object', or 'string'. Reference:</tt> </tt>
-<a name="L617"></a><tt class="py-lineno"> 617</tt>  <tt class="py-line"><tt class="py-docstring">        http://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.1</tt> </tt>
-<a name="L618"></a><tt class="py-lineno"> 618</tt>  <tt class="py-line"><tt class="py-docstring">    enum_params: Map from method parameter name (string) to list of strings,</tt> </tt>
-<a name="L619"></a><tt class="py-lineno"> 619</tt>  <tt class="py-line"><tt class="py-docstring">       where each list of strings is the list of acceptable enum values.</tt> </tt>
-<a name="L620"></a><tt class="py-lineno"> 620</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L621"></a><tt class="py-lineno"> 621</tt>  <tt class="py-line"> </tt>
-<a name="ResourceMethodParameters.__init__"></a><div id="ResourceMethodParameters.__init__-def"><a name="L622"></a><tt class="py-lineno"> 622</tt> <a class="py-toggle" href="#" id="ResourceMethodParameters.__init__-toggle" onclick="return toggle('ResourceMethodParameters.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.ResourceMethodParameters-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">method_desc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="ResourceMethodParameters.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="ResourceMethodParameters.__init__-expanded"><a name="L623"></a><tt class="py-lineno"> 623</tt>  <tt class="py-line">    <tt class="py-docstring">"""Constructor for ResourceMethodParameters.</tt> </tt>
-<a name="L624"></a><tt class="py-lineno"> 624</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L625"></a><tt class="py-lineno"> 625</tt>  <tt class="py-line"><tt class="py-docstring">    Sets default values and defers to set_parameters to populate.</tt> </tt>
-<a name="L626"></a><tt class="py-lineno"> 626</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L627"></a><tt class="py-lineno"> 627</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L628"></a><tt class="py-lineno"> 628</tt>  <tt class="py-line"><tt class="py-docstring">      method_desc: Dictionary with metadata describing an API method. Value</tt> </tt>
-<a name="L629"></a><tt class="py-lineno"> 629</tt>  <tt class="py-line"><tt class="py-docstring">          comes from the dictionary of methods stored in the 'methods' key in</tt> </tt>
-<a name="L630"></a><tt class="py-lineno"> 630</tt>  <tt class="py-line"><tt class="py-docstring">          the deserialized discovery document.</tt> </tt>
-<a name="L631"></a><tt class="py-lineno"> 631</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L632"></a><tt class="py-lineno"> 632</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L633"></a><tt class="py-lineno"> 633</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">required_params</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
-<a name="L634"></a><tt class="py-lineno"> 634</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
-<a name="L635"></a><tt class="py-lineno"> 635</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">pattern_params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L636"></a><tt class="py-lineno"> 636</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
-<a name="L637"></a><tt class="py-lineno"> 637</tt>  <tt class="py-line">    <tt class="py-comment"># TODO(dhermes): Change path_params to a list if the extra URITEMPLATE</tt> </tt>
-<a name="L638"></a><tt class="py-lineno"> 638</tt>  <tt class="py-line">    <tt class="py-comment">#                parsing is gotten rid of.</tt> </tt>
-<a name="L639"></a><tt class="py-lineno"> 639</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">path_params</tt> <tt class="py-op">=</tt> <tt id="link-159" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.set
+googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-161', 'accept', 'link-150');">accept</a></tt><tt class="py-op">,</tt> <tt class="py-name">max_size</tt><tt class="py-op">,</tt> <tt class="py-name">media_path_url</tt> </tt>
+</div><a name="L582"></a><tt class="py-lineno"> 582</tt>  <tt class="py-line"> </tt>
+<a name="_urljoin"></a><div id="_urljoin-def"><a name="L583"></a><tt class="py-lineno"> 583</tt>  <tt class="py-line"> </tt>
+<a name="L584"></a><tt class="py-lineno"> 584</tt> <a class="py-toggle" href="#" id="_urljoin-toggle" onclick="return toggle('_urljoin');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#_urljoin">_urljoin</a><tt class="py-op">(</tt><tt class="py-param">base</tt><tt class="py-op">,</tt> <tt class="py-param">url</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="_urljoin-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="_urljoin-expanded"><a name="L585"></a><tt class="py-lineno"> 585</tt>  <tt class="py-line">  <tt class="py-docstring">"""Custom urljoin replacement supporting : before / in url."""</tt> </tt>
+<a name="L586"></a><tt class="py-lineno"> 586</tt>  <tt class="py-line">  <tt class="py-comment"># In general, it's unsafe to simply join base and url. However, for</tt> </tt>
+<a name="L587"></a><tt class="py-lineno"> 587</tt>  <tt class="py-line">  <tt class="py-comment"># the case of discovery documents, we know:</tt> </tt>
+<a name="L588"></a><tt class="py-lineno"> 588</tt>  <tt class="py-line">  <tt class="py-comment">#  * base will never contain params, query, or fragment</tt> </tt>
+<a name="L589"></a><tt class="py-lineno"> 589</tt>  <tt class="py-line">  <tt class="py-comment">#  * url will never contain a scheme or net_loc.</tt> </tt>
+<a name="L590"></a><tt class="py-lineno"> 590</tt>  <tt class="py-line">  <tt class="py-comment"># In general, this means we can safely join on /; we just need to</tt> </tt>
+<a name="L591"></a><tt class="py-lineno"> 591</tt>  <tt class="py-line">  <tt class="py-comment"># ensure we end up with precisely one / joining base and url. The</tt> </tt>
+<a name="L592"></a><tt class="py-lineno"> 592</tt>  <tt class="py-line">  <tt class="py-comment"># exception here is the case of media uploads, where url will be an</tt> </tt>
+<a name="L593"></a><tt class="py-lineno"> 593</tt>  <tt class="py-line">  <tt class="py-comment"># absolute url.</tt> </tt>
+<a name="L594"></a><tt class="py-lineno"> 594</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">url</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'http://'</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">url</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'https://'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L595"></a><tt class="py-lineno"> 595</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">urljoin</tt><tt class="py-op">(</tt><tt id="link-162" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-162', 'base', 'link-78');">base</a></tt><tt class="py-op">,</tt> <tt class="py-name">url</tt><tt class="py-op">)</tt> </tt>
+<a name="L596"></a><tt class="py-lineno"> 596</tt>  <tt class="py-line">  <tt class="py-name">new_base</tt> <tt class="py-op">=</tt> <tt id="link-163" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-163', 'base', 'link-78');">base</a></tt> <tt class="py-keyword">if</tt> <tt id="link-164" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-164', 'base', 'link-78');">base</a></tt><tt class="py-op">.</tt><tt class="py-name">endswith</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt> <tt class="py-keyword">else</tt> <tt id="link-165" class="py-name"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-165', 'base', 'link-78');">base</a></tt> <tt class="py-op">+</tt> <tt class="py-string">'/'</tt> </tt>
+<a name="L597"></a><tt class="py-lineno"> 597</tt>  <tt class="py-line">  <tt class="py-name">new_url</tt> <tt class="py-op">=</tt> <tt class="py-name">url</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> <tt class="py-keyword">if</tt> <tt class="py-name">url</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt> <tt class="py-keyword">else</tt> <tt class="py-name">url</tt> </tt>
+<a name="L598"></a><tt class="py-lineno"> 598</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-name">new_base</tt> <tt class="py-op">+</tt> <tt class="py-name">new_url</tt> </tt>
+</div><a name="L599"></a><tt class="py-lineno"> 599</tt>  <tt class="py-line"> </tt>
+<a name="ResourceMethodParameters"></a><div id="ResourceMethodParameters-def"><a name="L600"></a><tt class="py-lineno"> 600</tt>  <tt class="py-line"> </tt>
+<a name="L601"></a><tt class="py-lineno"> 601</tt>  <tt class="py-line"><tt class="py-comment"># TODO(dhermes): Convert this class to ResourceMethod and make it callable</tt> </tt>
+<a name="L602"></a><tt class="py-lineno"> 602</tt> <a class="py-toggle" href="#" id="ResourceMethodParameters-toggle" onclick="return toggle('ResourceMethodParameters');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.discovery.ResourceMethodParameters-class.html">ResourceMethodParameters</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="ResourceMethodParameters-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="ResourceMethodParameters-expanded"><a name="L603"></a><tt class="py-lineno"> 603</tt>  <tt class="py-line">  <tt class="py-docstring">"""Represents the parameters associated with a method.</tt> </tt>
+<a name="L604"></a><tt class="py-lineno"> 604</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L605"></a><tt class="py-lineno"> 605</tt>  <tt class="py-line"><tt class="py-docstring">  Attributes:</tt> </tt>
+<a name="L606"></a><tt class="py-lineno"> 606</tt>  <tt class="py-line"><tt class="py-docstring">    argmap: Map from method parameter name (string) to query parameter name</tt> </tt>
+<a name="L607"></a><tt class="py-lineno"> 607</tt>  <tt class="py-line"><tt class="py-docstring">        (string).</tt> </tt>
+<a name="L608"></a><tt class="py-lineno"> 608</tt>  <tt class="py-line"><tt class="py-docstring">    required_params: List of required parameters (represented by parameter</tt> </tt>
+<a name="L609"></a><tt class="py-lineno"> 609</tt>  <tt class="py-line"><tt class="py-docstring">        name as string).</tt> </tt>
+<a name="L610"></a><tt class="py-lineno"> 610</tt>  <tt class="py-line"><tt class="py-docstring">    repeated_params: List of repeated parameters (represented by parameter</tt> </tt>
+<a name="L611"></a><tt class="py-lineno"> 611</tt>  <tt class="py-line"><tt class="py-docstring">        name as string).</tt> </tt>
+<a name="L612"></a><tt class="py-lineno"> 612</tt>  <tt class="py-line"><tt class="py-docstring">    pattern_params: Map from method parameter name (string) to regular</tt> </tt>
+<a name="L613"></a><tt class="py-lineno"> 613</tt>  <tt class="py-line"><tt class="py-docstring">        expression (as a string). If the pattern is set for a parameter, the</tt> </tt>
+<a name="L614"></a><tt class="py-lineno"> 614</tt>  <tt class="py-line"><tt class="py-docstring">        value for that parameter must match the regular expression.</tt> </tt>
+<a name="L615"></a><tt class="py-lineno"> 615</tt>  <tt class="py-line"><tt class="py-docstring">    query_params: List of parameters (represented by parameter name as string)</tt> </tt>
+<a name="L616"></a><tt class="py-lineno"> 616</tt>  <tt class="py-line"><tt class="py-docstring">        that will be used in the query string.</tt> </tt>
+<a name="L617"></a><tt class="py-lineno"> 617</tt>  <tt class="py-line"><tt class="py-docstring">    path_params: Set of parameters (represented by parameter name as string)</tt> </tt>
+<a name="L618"></a><tt class="py-lineno"> 618</tt>  <tt class="py-line"><tt class="py-docstring">        that will be used in the base URL path.</tt> </tt>
+<a name="L619"></a><tt class="py-lineno"> 619</tt>  <tt class="py-line"><tt class="py-docstring">    param_types: Map from method parameter name (string) to parameter type. Type</tt> </tt>
+<a name="L620"></a><tt class="py-lineno"> 620</tt>  <tt class="py-line"><tt class="py-docstring">        can be any valid JSON schema type; valid values are 'any', 'array',</tt> </tt>
+<a name="L621"></a><tt class="py-lineno"> 621</tt>  <tt class="py-line"><tt class="py-docstring">        'boolean', 'integer', 'number', 'object', or 'string'. Reference:</tt> </tt>
+<a name="L622"></a><tt class="py-lineno"> 622</tt>  <tt class="py-line"><tt class="py-docstring">        http://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.1</tt> </tt>
+<a name="L623"></a><tt class="py-lineno"> 623</tt>  <tt class="py-line"><tt class="py-docstring">    enum_params: Map from method parameter name (string) to list of strings,</tt> </tt>
+<a name="L624"></a><tt class="py-lineno"> 624</tt>  <tt class="py-line"><tt class="py-docstring">       where each list of strings is the list of acceptable enum values.</tt> </tt>
+<a name="L625"></a><tt class="py-lineno"> 625</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L626"></a><tt class="py-lineno"> 626</tt>  <tt class="py-line"> </tt>
+<a name="ResourceMethodParameters.__init__"></a><div id="ResourceMethodParameters.__init__-def"><a name="L627"></a><tt class="py-lineno"> 627</tt> <a class="py-toggle" href="#" id="ResourceMethodParameters.__init__-toggle" onclick="return toggle('ResourceMethodParameters.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.ResourceMethodParameters-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">method_desc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="ResourceMethodParameters.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="ResourceMethodParameters.__init__-expanded"><a name="L628"></a><tt class="py-lineno"> 628</tt>  <tt class="py-line">    <tt class="py-docstring">"""Constructor for ResourceMethodParameters.</tt> </tt>
+<a name="L629"></a><tt class="py-lineno"> 629</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L630"></a><tt class="py-lineno"> 630</tt>  <tt class="py-line"><tt class="py-docstring">    Sets default values and defers to set_parameters to populate.</tt> </tt>
+<a name="L631"></a><tt class="py-lineno"> 631</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L632"></a><tt class="py-lineno"> 632</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L633"></a><tt class="py-lineno"> 633</tt>  <tt class="py-line"><tt class="py-docstring">      method_desc: Dictionary with metadata describing an API method. Value</tt> </tt>
+<a name="L634"></a><tt class="py-lineno"> 634</tt>  <tt class="py-line"><tt class="py-docstring">          comes from the dictionary of methods stored in the 'methods' key in</tt> </tt>
+<a name="L635"></a><tt class="py-lineno"> 635</tt>  <tt class="py-line"><tt class="py-docstring">          the deserialized discovery document.</tt> </tt>
+<a name="L636"></a><tt class="py-lineno"> 636</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L637"></a><tt class="py-lineno"> 637</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L638"></a><tt class="py-lineno"> 638</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">required_params</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+<a name="L639"></a><tt class="py-lineno"> 639</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+<a name="L640"></a><tt class="py-lineno"> 640</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">pattern_params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L641"></a><tt class="py-lineno"> 641</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+<a name="L642"></a><tt class="py-lineno"> 642</tt>  <tt class="py-line">    <tt class="py-comment"># TODO(dhermes): Change path_params to a list if the extra URITEMPLATE</tt> </tt>
+<a name="L643"></a><tt class="py-lineno"> 643</tt>  <tt class="py-line">    <tt class="py-comment">#                parsing is gotten rid of.</tt> </tt>
+<a name="L644"></a><tt class="py-lineno"> 644</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">path_params</tt> <tt class="py-op">=</tt> <tt id="link-166" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.set
 googleapiclient.discovery_cache.base.Cache.set
-googleapiclient.discovery_cache.file_cache.Cache.set" class="py-name" href="#" onclick="return doclink('link-159', 'set', 'link-102');">set</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L640"></a><tt class="py-lineno"> 640</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">param_types</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L641"></a><tt class="py-lineno"> 641</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">enum_params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L642"></a><tt class="py-lineno"> 642</tt>  <tt class="py-line"> </tt>
-<a name="L643"></a><tt class="py-lineno"> 643</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-160" class="py-name" targets="Method googleapiclient.discovery.ResourceMethodParameters.set_parameters()=googleapiclient.discovery.ResourceMethodParameters-class.html#set_parameters"><a title="googleapiclient.discovery.ResourceMethodParameters.set_parameters" class="py-name" href="#" onclick="return doclink('link-160', 'set_parameters', 'link-160');">set_parameters</a></tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L644"></a><tt class="py-lineno"> 644</tt>  <tt class="py-line"> </tt>
-<a name="ResourceMethodParameters.set_parameters"></a><div id="ResourceMethodParameters.set_parameters-def"><a name="L645"></a><tt class="py-lineno"> 645</tt> <a class="py-toggle" href="#" id="ResourceMethodParameters.set_parameters-toggle" onclick="return toggle('ResourceMethodParameters.set_parameters');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.ResourceMethodParameters-class.html#set_parameters">set_parameters</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">method_desc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="ResourceMethodParameters.set_parameters-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="ResourceMethodParameters.set_parameters-expanded"><a name="L646"></a><tt class="py-lineno"> 646</tt>  <tt class="py-line">    <tt class="py-docstring">"""Populates maps and lists based on method description.</tt> </tt>
-<a name="L647"></a><tt class="py-lineno"> 647</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L648"></a><tt class="py-lineno"> 648</tt>  <tt class="py-line"><tt class="py-docstring">    Iterates through each parameter for the method and parses the values from</tt> </tt>
-<a name="L649"></a><tt class="py-lineno"> 649</tt>  <tt class="py-line"><tt class="py-docstring">    the parameter dictionary.</tt> </tt>
-<a name="L650"></a><tt class="py-lineno"> 650</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L651"></a><tt class="py-lineno"> 651</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L652"></a><tt class="py-lineno"> 652</tt>  <tt class="py-line"><tt class="py-docstring">      method_desc: Dictionary with metadata describing an API method. Value</tt> </tt>
-<a name="L653"></a><tt class="py-lineno"> 653</tt>  <tt class="py-line"><tt class="py-docstring">          comes from the dictionary of methods stored in the 'methods' key in</tt> </tt>
-<a name="L654"></a><tt class="py-lineno"> 654</tt>  <tt class="py-line"><tt class="py-docstring">          the deserialized discovery document.</tt> </tt>
-<a name="L655"></a><tt class="py-lineno"> 655</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L656"></a><tt class="py-lineno"> 656</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">arg</tt><tt class="py-op">,</tt> <tt class="py-name">desc</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">.</tt><tt id="link-161" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.discovery_cache.file_cache.Cache.set" class="py-name" href="#" onclick="return doclink('link-166', 'set', 'link-103');">set</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L645"></a><tt class="py-lineno"> 645</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">param_types</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L646"></a><tt class="py-lineno"> 646</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">enum_params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L647"></a><tt class="py-lineno"> 647</tt>  <tt class="py-line"> </tt>
+<a name="L648"></a><tt class="py-lineno"> 648</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-167" class="py-name" targets="Method googleapiclient.discovery.ResourceMethodParameters.set_parameters()=googleapiclient.discovery.ResourceMethodParameters-class.html#set_parameters"><a title="googleapiclient.discovery.ResourceMethodParameters.set_parameters" class="py-name" href="#" onclick="return doclink('link-167', 'set_parameters', 'link-167');">set_parameters</a></tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L649"></a><tt class="py-lineno"> 649</tt>  <tt class="py-line"> </tt>
+<a name="ResourceMethodParameters.set_parameters"></a><div id="ResourceMethodParameters.set_parameters-def"><a name="L650"></a><tt class="py-lineno"> 650</tt> <a class="py-toggle" href="#" id="ResourceMethodParameters.set_parameters-toggle" onclick="return toggle('ResourceMethodParameters.set_parameters');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.ResourceMethodParameters-class.html#set_parameters">set_parameters</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">method_desc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="ResourceMethodParameters.set_parameters-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="ResourceMethodParameters.set_parameters-expanded"><a name="L651"></a><tt class="py-lineno"> 651</tt>  <tt class="py-line">    <tt class="py-docstring">"""Populates maps and lists based on method description.</tt> </tt>
+<a name="L652"></a><tt class="py-lineno"> 652</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L653"></a><tt class="py-lineno"> 653</tt>  <tt class="py-line"><tt class="py-docstring">    Iterates through each parameter for the method and parses the values from</tt> </tt>
+<a name="L654"></a><tt class="py-lineno"> 654</tt>  <tt class="py-line"><tt class="py-docstring">    the parameter dictionary.</tt> </tt>
+<a name="L655"></a><tt class="py-lineno"> 655</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L656"></a><tt class="py-lineno"> 656</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L657"></a><tt class="py-lineno"> 657</tt>  <tt class="py-line"><tt class="py-docstring">      method_desc: Dictionary with metadata describing an API method. Value</tt> </tt>
+<a name="L658"></a><tt class="py-lineno"> 658</tt>  <tt class="py-line"><tt class="py-docstring">          comes from the dictionary of methods stored in the 'methods' key in</tt> </tt>
+<a name="L659"></a><tt class="py-lineno"> 659</tt>  <tt class="py-line"><tt class="py-docstring">          the deserialized discovery document.</tt> </tt>
+<a name="L660"></a><tt class="py-lineno"> 660</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L661"></a><tt class="py-lineno"> 661</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">arg</tt><tt class="py-op">,</tt> <tt class="py-name">desc</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">.</tt><tt id="link-168" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-161', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L657"></a><tt class="py-lineno"> 657</tt>  <tt class="py-line">      <tt class="py-name">param</tt> <tt class="py-op">=</tt> <tt id="link-162" class="py-name" targets="Function googleapiclient.discovery.key2param()=googleapiclient.discovery-module.html#key2param"><a title="googleapiclient.discovery.key2param" class="py-name" href="#" onclick="return doclink('link-162', 'key2param', 'link-162');">key2param</a></tt><tt class="py-op">(</tt><tt class="py-name">arg</tt><tt class="py-op">)</tt> </tt>
-<a name="L658"></a><tt class="py-lineno"> 658</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">[</tt><tt class="py-name">param</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">arg</tt> </tt>
-<a name="L659"></a><tt class="py-lineno"> 659</tt>  <tt class="py-line"> </tt>
-<a name="L660"></a><tt class="py-lineno"> 660</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-163" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-168', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L662"></a><tt class="py-lineno"> 662</tt>  <tt class="py-line">      <tt class="py-name">param</tt> <tt class="py-op">=</tt> <tt id="link-169" class="py-name" targets="Function googleapiclient.discovery.key2param()=googleapiclient.discovery-module.html#key2param"><a title="googleapiclient.discovery.key2param" class="py-name" href="#" onclick="return doclink('link-169', 'key2param', 'link-169');">key2param</a></tt><tt class="py-op">(</tt><tt class="py-name">arg</tt><tt class="py-op">)</tt> </tt>
+<a name="L663"></a><tt class="py-lineno"> 663</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">[</tt><tt class="py-name">param</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">arg</tt> </tt>
+<a name="L664"></a><tt class="py-lineno"> 664</tt>  <tt class="py-line"> </tt>
+<a name="L665"></a><tt class="py-lineno"> 665</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-170" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-163', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'pattern'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L661"></a><tt class="py-lineno"> 661</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">pattern_params</tt><tt class="py-op">[</tt><tt class="py-name">param</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">desc</tt><tt class="py-op">[</tt><tt class="py-string">'pattern'</tt><tt class="py-op">]</tt> </tt>
-<a name="L662"></a><tt class="py-lineno"> 662</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-164" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-170', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'pattern'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L666"></a><tt class="py-lineno"> 666</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">pattern_params</tt><tt class="py-op">[</tt><tt class="py-name">param</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">desc</tt><tt class="py-op">[</tt><tt class="py-string">'pattern'</tt><tt class="py-op">]</tt> </tt>
+<a name="L667"></a><tt class="py-lineno"> 667</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-171" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-164', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'enum'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L663"></a><tt class="py-lineno"> 663</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">enum_params</tt><tt class="py-op">[</tt><tt class="py-name">param</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">desc</tt><tt class="py-op">[</tt><tt class="py-string">'enum'</tt><tt class="py-op">]</tt> </tt>
-<a name="L664"></a><tt class="py-lineno"> 664</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-165" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-171', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'enum'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L668"></a><tt class="py-lineno"> 668</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">enum_params</tt><tt class="py-op">[</tt><tt class="py-name">param</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">desc</tt><tt class="py-op">[</tt><tt class="py-string">'enum'</tt><tt class="py-op">]</tt> </tt>
+<a name="L669"></a><tt class="py-lineno"> 669</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-172" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-165', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'required'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L665"></a><tt class="py-lineno"> 665</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">required_params</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">param</tt><tt class="py-op">)</tt> </tt>
-<a name="L666"></a><tt class="py-lineno"> 666</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-166" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-172', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'required'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L670"></a><tt class="py-lineno"> 670</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">required_params</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">param</tt><tt class="py-op">)</tt> </tt>
+<a name="L671"></a><tt class="py-lineno"> 671</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-173" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-166', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'repeated'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L667"></a><tt class="py-lineno"> 667</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">param</tt><tt class="py-op">)</tt> </tt>
-<a name="L668"></a><tt class="py-lineno"> 668</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-167" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-173', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'repeated'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L672"></a><tt class="py-lineno"> 672</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">param</tt><tt class="py-op">)</tt> </tt>
+<a name="L673"></a><tt class="py-lineno"> 673</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-174" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-167', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'location'</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-string">'query'</tt><tt class="py-op">:</tt> </tt>
-<a name="L669"></a><tt class="py-lineno"> 669</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">param</tt><tt class="py-op">)</tt> </tt>
-<a name="L670"></a><tt class="py-lineno"> 670</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-168" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-174', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'location'</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-string">'query'</tt><tt class="py-op">:</tt> </tt>
+<a name="L674"></a><tt class="py-lineno"> 674</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">param</tt><tt class="py-op">)</tt> </tt>
+<a name="L675"></a><tt class="py-lineno"> 675</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-175" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-168', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'location'</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-string">'path'</tt><tt class="py-op">:</tt> </tt>
-<a name="L671"></a><tt class="py-lineno"> 671</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">path_params</tt><tt class="py-op">.</tt><tt id="link-169" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest.add()=googleapiclient.http.BatchHttpRequest-class.html#add"><a title="googleapiclient.http.BatchHttpRequest.add" class="py-name" href="#" onclick="return doclink('link-169', 'add', 'link-169');">add</a></tt><tt class="py-op">(</tt><tt class="py-name">param</tt><tt class="py-op">)</tt> </tt>
-<a name="L672"></a><tt class="py-lineno"> 672</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">param_types</tt><tt class="py-op">[</tt><tt class="py-name">param</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-170" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-175', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'location'</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-string">'path'</tt><tt class="py-op">:</tt> </tt>
+<a name="L676"></a><tt class="py-lineno"> 676</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">path_params</tt><tt class="py-op">.</tt><tt id="link-176" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest.add()=googleapiclient.http.BatchHttpRequest-class.html#add"><a title="googleapiclient.http.BatchHttpRequest.add" class="py-name" href="#" onclick="return doclink('link-176', 'add', 'link-176');">add</a></tt><tt class="py-op">(</tt><tt class="py-name">param</tt><tt class="py-op">)</tt> </tt>
+<a name="L677"></a><tt class="py-lineno"> 677</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">param_types</tt><tt class="py-op">[</tt><tt class="py-name">param</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">desc</tt><tt class="py-op">.</tt><tt id="link-177" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-170', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'type'</tt><tt class="py-op">,</tt> <tt class="py-string">'string'</tt><tt class="py-op">)</tt> </tt>
-<a name="L673"></a><tt class="py-lineno"> 673</tt>  <tt class="py-line"> </tt>
-<a name="L674"></a><tt class="py-lineno"> 674</tt>  <tt class="py-line">    <tt class="py-comment"># TODO(dhermes): Determine if this is still necessary. Discovery based APIs</tt> </tt>
-<a name="L675"></a><tt class="py-lineno"> 675</tt>  <tt class="py-line">    <tt class="py-comment">#                should have all path parameters already marked with</tt> </tt>
-<a name="L676"></a><tt class="py-lineno"> 676</tt>  <tt class="py-line">    <tt class="py-comment">#                'location: path'.</tt> </tt>
-<a name="L677"></a><tt class="py-lineno"> 677</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">match</tt> <tt class="py-keyword">in</tt> <tt id="link-171" class="py-name"><a title="googleapiclient.discovery.URITEMPLATE" class="py-name" href="#" onclick="return doclink('link-171', 'URITEMPLATE', 'link-51');">URITEMPLATE</a></tt><tt class="py-op">.</tt><tt class="py-name">finditer</tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'path'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L678"></a><tt class="py-lineno"> 678</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">namematch</tt> <tt class="py-keyword">in</tt> <tt id="link-172" class="py-name"><a title="googleapiclient.discovery.VARNAME" class="py-name" href="#" onclick="return doclink('link-172', 'VARNAME', 'link-52');">VARNAME</a></tt><tt class="py-op">.</tt><tt class="py-name">finditer</tt><tt class="py-op">(</tt><tt class="py-name">match</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L679"></a><tt class="py-lineno"> 679</tt>  <tt class="py-line">        <tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt id="link-173" class="py-name"><a title="googleapiclient.discovery.key2param" class="py-name" href="#" onclick="return doclink('link-173', 'key2param', 'link-162');">key2param</a></tt><tt class="py-op">(</tt><tt class="py-name">namematch</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L680"></a><tt class="py-lineno"> 680</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">path_params</tt><tt class="py-op">.</tt><tt id="link-174" class="py-name"><a title="googleapiclient.http.BatchHttpRequest.add" class="py-name" href="#" onclick="return doclink('link-174', 'add', 'link-169');">add</a></tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
-<a name="L681"></a><tt class="py-lineno"> 681</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt><tt class="py-op">:</tt> </tt>
-<a name="L682"></a><tt class="py-lineno"> 682</tt>  <tt class="py-line">          <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt><tt class="py-op">.</tt><tt class="py-name">remove</tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
-</div></div><a name="L683"></a><tt class="py-lineno"> 683</tt>  <tt class="py-line"> </tt>
-<a name="createMethod"></a><div id="createMethod-def"><a name="L684"></a><tt class="py-lineno"> 684</tt>  <tt class="py-line"> </tt>
-<a name="L685"></a><tt class="py-lineno"> 685</tt> <a class="py-toggle" href="#" id="createMethod-toggle" onclick="return toggle('createMethod');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#createMethod">createMethod</a><tt class="py-op">(</tt><tt class="py-param">methodName</tt><tt class="py-op">,</tt> <tt class="py-param">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-param">rootDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="createMethod-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="createMethod-expanded"><a name="L686"></a><tt class="py-lineno"> 686</tt>  <tt class="py-line">  <tt class="py-docstring">"""Creates a method for attaching to a Resource.</tt> </tt>
-<a name="L687"></a><tt class="py-lineno"> 687</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L688"></a><tt class="py-lineno"> 688</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L689"></a><tt class="py-lineno"> 689</tt>  <tt class="py-line"><tt class="py-docstring">    methodName: string, name of the method to use.</tt> </tt>
-<a name="L690"></a><tt class="py-lineno"> 690</tt>  <tt class="py-line"><tt class="py-docstring">    methodDesc: object, fragment of deserialized discovery document that</tt> </tt>
-<a name="L691"></a><tt class="py-lineno"> 691</tt>  <tt class="py-line"><tt class="py-docstring">      describes the method.</tt> </tt>
-<a name="L692"></a><tt class="py-lineno"> 692</tt>  <tt class="py-line"><tt class="py-docstring">    rootDesc: object, the entire deserialized discovery document.</tt> </tt>
-<a name="L693"></a><tt class="py-lineno"> 693</tt>  <tt class="py-line"><tt class="py-docstring">    schema: object, mapping of schema names to schema descriptions.</tt> </tt>
-<a name="L694"></a><tt class="py-lineno"> 694</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L695"></a><tt class="py-lineno"> 695</tt>  <tt class="py-line">  <tt class="py-name">methodName</tt> <tt class="py-op">=</tt> <tt id="link-175" class="py-name" targets="Function googleapiclient.discovery.fix_method_name()=googleapiclient.discovery-module.html#fix_method_name"><a title="googleapiclient.discovery.fix_method_name" class="py-name" href="#" onclick="return doclink('link-175', 'fix_method_name', 'link-175');">fix_method_name</a></tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">)</tt> </tt>
-<a name="L696"></a><tt class="py-lineno"> 696</tt>  <tt class="py-line">  <tt class="py-op">(</tt><tt class="py-name">pathUrl</tt><tt class="py-op">,</tt> <tt class="py-name">httpMethod</tt><tt class="py-op">,</tt> <tt class="py-name">methodId</tt><tt class="py-op">,</tt> <tt id="link-176" class="py-name"><a title="googleapiclient.model.BaseModel.accept
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-177', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'type'</tt><tt class="py-op">,</tt> <tt class="py-string">'string'</tt><tt class="py-op">)</tt> </tt>
+<a name="L678"></a><tt class="py-lineno"> 678</tt>  <tt class="py-line"> </tt>
+<a name="L679"></a><tt class="py-lineno"> 679</tt>  <tt class="py-line">    <tt class="py-comment"># TODO(dhermes): Determine if this is still necessary. Discovery based APIs</tt> </tt>
+<a name="L680"></a><tt class="py-lineno"> 680</tt>  <tt class="py-line">    <tt class="py-comment">#                should have all path parameters already marked with</tt> </tt>
+<a name="L681"></a><tt class="py-lineno"> 681</tt>  <tt class="py-line">    <tt class="py-comment">#                'location: path'.</tt> </tt>
+<a name="L682"></a><tt class="py-lineno"> 682</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">match</tt> <tt class="py-keyword">in</tt> <tt id="link-178" class="py-name"><a title="googleapiclient.discovery.URITEMPLATE" class="py-name" href="#" onclick="return doclink('link-178', 'URITEMPLATE', 'link-53');">URITEMPLATE</a></tt><tt class="py-op">.</tt><tt class="py-name">finditer</tt><tt class="py-op">(</tt><tt class="py-name">method_desc</tt><tt class="py-op">[</tt><tt class="py-string">'path'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L683"></a><tt class="py-lineno"> 683</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">namematch</tt> <tt class="py-keyword">in</tt> <tt id="link-179" class="py-name"><a title="googleapiclient.discovery.VARNAME" class="py-name" href="#" onclick="return doclink('link-179', 'VARNAME', 'link-54');">VARNAME</a></tt><tt class="py-op">.</tt><tt class="py-name">finditer</tt><tt class="py-op">(</tt><tt class="py-name">match</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L684"></a><tt class="py-lineno"> 684</tt>  <tt class="py-line">        <tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt id="link-180" class="py-name"><a title="googleapiclient.discovery.key2param" class="py-name" href="#" onclick="return doclink('link-180', 'key2param', 'link-169');">key2param</a></tt><tt class="py-op">(</tt><tt class="py-name">namematch</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L685"></a><tt class="py-lineno"> 685</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">path_params</tt><tt class="py-op">.</tt><tt id="link-181" class="py-name"><a title="googleapiclient.http.BatchHttpRequest.add" class="py-name" href="#" onclick="return doclink('link-181', 'add', 'link-176');">add</a></tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
+<a name="L686"></a><tt class="py-lineno"> 686</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt><tt class="py-op">:</tt> </tt>
+<a name="L687"></a><tt class="py-lineno"> 687</tt>  <tt class="py-line">          <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt><tt class="py-op">.</tt><tt class="py-name">remove</tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
+</div></div><a name="L688"></a><tt class="py-lineno"> 688</tt>  <tt class="py-line"> </tt>
+<a name="createMethod"></a><div id="createMethod-def"><a name="L689"></a><tt class="py-lineno"> 689</tt>  <tt class="py-line"> </tt>
+<a name="L690"></a><tt class="py-lineno"> 690</tt> <a class="py-toggle" href="#" id="createMethod-toggle" onclick="return toggle('createMethod');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#createMethod">createMethod</a><tt class="py-op">(</tt><tt class="py-param">methodName</tt><tt class="py-op">,</tt> <tt class="py-param">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-param">rootDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="createMethod-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="createMethod-expanded"><a name="L691"></a><tt class="py-lineno"> 691</tt>  <tt class="py-line">  <tt class="py-docstring">"""Creates a method for attaching to a Resource.</tt> </tt>
+<a name="L692"></a><tt class="py-lineno"> 692</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L693"></a><tt class="py-lineno"> 693</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L694"></a><tt class="py-lineno"> 694</tt>  <tt class="py-line"><tt class="py-docstring">    methodName: string, name of the method to use.</tt> </tt>
+<a name="L695"></a><tt class="py-lineno"> 695</tt>  <tt class="py-line"><tt class="py-docstring">    methodDesc: object, fragment of deserialized discovery document that</tt> </tt>
+<a name="L696"></a><tt class="py-lineno"> 696</tt>  <tt class="py-line"><tt class="py-docstring">      describes the method.</tt> </tt>
+<a name="L697"></a><tt class="py-lineno"> 697</tt>  <tt class="py-line"><tt class="py-docstring">    rootDesc: object, the entire deserialized discovery document.</tt> </tt>
+<a name="L698"></a><tt class="py-lineno"> 698</tt>  <tt class="py-line"><tt class="py-docstring">    schema: object, mapping of schema names to schema descriptions.</tt> </tt>
+<a name="L699"></a><tt class="py-lineno"> 699</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L700"></a><tt class="py-lineno"> 700</tt>  <tt class="py-line">  <tt class="py-name">methodName</tt> <tt class="py-op">=</tt> <tt id="link-182" class="py-name" targets="Function googleapiclient.discovery.fix_method_name()=googleapiclient.discovery-module.html#fix_method_name"><a title="googleapiclient.discovery.fix_method_name" class="py-name" href="#" onclick="return doclink('link-182', 'fix_method_name', 'link-182');">fix_method_name</a></tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">)</tt> </tt>
+<a name="L701"></a><tt class="py-lineno"> 701</tt>  <tt class="py-line">  <tt class="py-op">(</tt><tt class="py-name">pathUrl</tt><tt class="py-op">,</tt> <tt class="py-name">httpMethod</tt><tt class="py-op">,</tt> <tt class="py-name">methodId</tt><tt class="py-op">,</tt> <tt id="link-183" class="py-name"><a title="googleapiclient.model.BaseModel.accept
 googleapiclient.model.JsonModel.accept
 googleapiclient.model.MediaModel.accept
 googleapiclient.model.ProtocolBufferModel.accept
-googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-176', 'accept', 'link-143');">accept</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L697"></a><tt class="py-lineno"> 697</tt>  <tt class="py-line">   <tt class="py-name">maxSize</tt><tt class="py-op">,</tt> <tt class="py-name">mediaPathUrl</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt id="link-177" class="py-name" targets="Function googleapiclient.discovery._fix_up_method_description()=googleapiclient.discovery-module.html#_fix_up_method_description"><a title="googleapiclient.discovery._fix_up_method_description" class="py-name" href="#" onclick="return doclink('link-177', '_fix_up_method_description', 'link-177');">_fix_up_method_description</a></tt><tt class="py-op">(</tt><tt class="py-name">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">)</tt> </tt>
-<a name="L698"></a><tt class="py-lineno"> 698</tt>  <tt class="py-line"> </tt>
-<a name="L699"></a><tt class="py-lineno"> 699</tt>  <tt class="py-line">  <tt class="py-name">parameters</tt> <tt class="py-op">=</tt> <tt id="link-178" class="py-name" targets="Class googleapiclient.discovery.ResourceMethodParameters=googleapiclient.discovery.ResourceMethodParameters-class.html"><a title="googleapiclient.discovery.ResourceMethodParameters" class="py-name" href="#" onclick="return doclink('link-178', 'ResourceMethodParameters', 'link-178');">ResourceMethodParameters</a></tt><tt class="py-op">(</tt><tt class="py-name">methodDesc</tt><tt class="py-op">)</tt> </tt>
-<a name="L700"></a><tt class="py-lineno"> 700</tt>  <tt class="py-line"> </tt>
-<a name="L701"></a><tt class="py-lineno"> 701</tt>  <tt class="py-line">  <tt class="py-keyword">def</tt> <tt class="py-def-name">method</tt><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-param">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L702"></a><tt class="py-lineno"> 702</tt>  <tt class="py-line">    <tt class="py-comment"># Don't bother with doc string, it will be over-written by createMethod.</tt> </tt>
+googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-183', 'accept', 'link-150');">accept</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L702"></a><tt class="py-lineno"> 702</tt>  <tt class="py-line">   <tt class="py-name">maxSize</tt><tt class="py-op">,</tt> <tt class="py-name">mediaPathUrl</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt id="link-184" class="py-name" targets="Function googleapiclient.discovery._fix_up_method_description()=googleapiclient.discovery-module.html#_fix_up_method_description"><a title="googleapiclient.discovery._fix_up_method_description" class="py-name" href="#" onclick="return doclink('link-184', '_fix_up_method_description', 'link-184');">_fix_up_method_description</a></tt><tt class="py-op">(</tt><tt class="py-name">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">)</tt> </tt>
 <a name="L703"></a><tt class="py-lineno"> 703</tt>  <tt class="py-line"> </tt>
-<a name="L704"></a><tt class="py-lineno"> 704</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iterkeys</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L705"></a><tt class="py-lineno"> 705</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">:</tt> </tt>
-<a name="L706"></a><tt class="py-lineno"> 706</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Got an unexpected keyword argument "%s"'</tt> <tt class="py-op">%</tt> <tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
-<a name="L707"></a><tt class="py-lineno"> 707</tt>  <tt class="py-line"> </tt>
-<a name="L708"></a><tt class="py-lineno"> 708</tt>  <tt class="py-line">    <tt class="py-comment"># Remove args that have a value of None.</tt> </tt>
-<a name="L709"></a><tt class="py-lineno"> 709</tt>  <tt class="py-line">    <tt class="py-name">keys</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L710"></a><tt class="py-lineno"> 710</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">keys</tt><tt class="py-op">:</tt> </tt>
-<a name="L711"></a><tt class="py-lineno"> 711</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L712"></a><tt class="py-lineno"> 712</tt>  <tt class="py-line">        <tt class="py-keyword">del</tt> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> </tt>
-<a name="L713"></a><tt class="py-lineno"> 713</tt>  <tt class="py-line"> </tt>
-<a name="L714"></a><tt class="py-lineno"> 714</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">required_params</tt><tt class="py-op">:</tt> </tt>
-<a name="L715"></a><tt class="py-lineno"> 715</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">kwargs</tt><tt class="py-op">:</tt> </tt>
-<a name="L716"></a><tt class="py-lineno"> 716</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Missing required parameter "%s"'</tt> <tt class="py-op">%</tt> <tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
-<a name="L717"></a><tt class="py-lineno"> 717</tt>  <tt class="py-line"> </tt>
-<a name="L718"></a><tt class="py-lineno"> 718</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">regex</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">pattern_params</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L719"></a><tt class="py-lineno"> 719</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">kwargs</tt><tt class="py-op">:</tt> </tt>
-<a name="L720"></a><tt class="py-lineno"> 720</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">string_types</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L721"></a><tt class="py-lineno"> 721</tt>  <tt class="py-line">          <tt class="py-name">pvalues</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
-<a name="L722"></a><tt class="py-lineno"> 722</tt>  <tt class="py-line">        <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L723"></a><tt class="py-lineno"> 723</tt>  <tt class="py-line">          <tt class="py-name">pvalues</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> </tt>
-<a name="L724"></a><tt class="py-lineno"> 724</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">pvalue</tt> <tt class="py-keyword">in</tt> <tt class="py-name">pvalues</tt><tt class="py-op">:</tt> </tt>
-<a name="L725"></a><tt class="py-lineno"> 725</tt>  <tt class="py-line">          <tt class="py-keyword">if</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">match</tt><tt class="py-op">(</tt><tt class="py-name">regex</tt><tt class="py-op">,</tt> <tt class="py-name">pvalue</tt><tt class="py-op">)</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L726"></a><tt class="py-lineno"> 726</tt>  <tt class="py-line">            <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt> </tt>
-<a name="L727"></a><tt class="py-lineno"> 727</tt>  <tt class="py-line">                <tt class="py-string">'Parameter "%s" value "%s" does not match the pattern "%s"'</tt> <tt class="py-op">%</tt> </tt>
-<a name="L728"></a><tt class="py-lineno"> 728</tt>  <tt class="py-line">                <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">pvalue</tt><tt class="py-op">,</tt> <tt class="py-name">regex</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L729"></a><tt class="py-lineno"> 729</tt>  <tt class="py-line"> </tt>
-<a name="L730"></a><tt class="py-lineno"> 730</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">enums</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">enum_params</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L731"></a><tt class="py-lineno"> 731</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">kwargs</tt><tt class="py-op">:</tt> </tt>
-<a name="L732"></a><tt class="py-lineno"> 732</tt>  <tt class="py-line">        <tt class="py-comment"># We need to handle the case of a repeated enum</tt> </tt>
-<a name="L733"></a><tt class="py-lineno"> 733</tt>  <tt class="py-line">        <tt class="py-comment"># name differently, since we want to handle both</tt> </tt>
-<a name="L734"></a><tt class="py-lineno"> 734</tt>  <tt class="py-line">        <tt class="py-comment"># arg='value' and arg=['value1', 'value2']</tt> </tt>
-<a name="L735"></a><tt class="py-lineno"> 735</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt> <tt class="py-keyword">and</tt> </tt>
-<a name="L736"></a><tt class="py-lineno"> 736</tt>  <tt class="py-line">            <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">string_types</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L737"></a><tt class="py-lineno"> 737</tt>  <tt class="py-line">          <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> </tt>
-<a name="L738"></a><tt class="py-lineno"> 738</tt>  <tt class="py-line">        <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L739"></a><tt class="py-lineno"> 739</tt>  <tt class="py-line">          <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
-<a name="L740"></a><tt class="py-lineno"> 740</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">value</tt> <tt class="py-keyword">in</tt> <tt class="py-name">values</tt><tt class="py-op">:</tt> </tt>
-<a name="L741"></a><tt class="py-lineno"> 741</tt>  <tt class="py-line">          <tt class="py-keyword">if</tt> <tt class="py-name">value</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">enums</tt><tt class="py-op">:</tt> </tt>
-<a name="L742"></a><tt class="py-lineno"> 742</tt>  <tt class="py-line">            <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt> </tt>
-<a name="L743"></a><tt class="py-lineno"> 743</tt>  <tt class="py-line">                <tt class="py-string">'Parameter "%s" value "%s" is not an allowed value in "%s"'</tt> <tt class="py-op">%</tt> </tt>
-<a name="L744"></a><tt class="py-lineno"> 744</tt>  <tt class="py-line">                <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">enums</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L745"></a><tt class="py-lineno"> 745</tt>  <tt class="py-line"> </tt>
-<a name="L746"></a><tt class="py-lineno"> 746</tt>  <tt class="py-line">    <tt class="py-name">actual_query_params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L747"></a><tt class="py-lineno"> 747</tt>  <tt class="py-line">    <tt class="py-name">actual_path_params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L748"></a><tt class="py-lineno"> 748</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L749"></a><tt class="py-lineno"> 749</tt>  <tt class="py-line">      <tt class="py-name">to_type</tt> <tt class="py-op">=</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">param_types</tt><tt class="py-op">.</tt><tt id="link-179" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="L704"></a><tt class="py-lineno"> 704</tt>  <tt class="py-line">  <tt class="py-name">parameters</tt> <tt class="py-op">=</tt> <tt id="link-185" class="py-name" targets="Class googleapiclient.discovery.ResourceMethodParameters=googleapiclient.discovery.ResourceMethodParameters-class.html"><a title="googleapiclient.discovery.ResourceMethodParameters" class="py-name" href="#" onclick="return doclink('link-185', 'ResourceMethodParameters', 'link-185');">ResourceMethodParameters</a></tt><tt class="py-op">(</tt><tt class="py-name">methodDesc</tt><tt class="py-op">)</tt> </tt>
+<a name="L705"></a><tt class="py-lineno"> 705</tt>  <tt class="py-line"> </tt>
+<a name="L706"></a><tt class="py-lineno"> 706</tt>  <tt class="py-line">  <tt class="py-keyword">def</tt> <tt class="py-def-name">method</tt><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-param">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L707"></a><tt class="py-lineno"> 707</tt>  <tt class="py-line">    <tt class="py-comment"># Don't bother with doc string, it will be over-written by createMethod.</tt> </tt>
+<a name="L708"></a><tt class="py-lineno"> 708</tt>  <tt class="py-line"> </tt>
+<a name="L709"></a><tt class="py-lineno"> 709</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iterkeys</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L710"></a><tt class="py-lineno"> 710</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">:</tt> </tt>
+<a name="L711"></a><tt class="py-lineno"> 711</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Got an unexpected keyword argument "%s"'</tt> <tt class="py-op">%</tt> <tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
+<a name="L712"></a><tt class="py-lineno"> 712</tt>  <tt class="py-line"> </tt>
+<a name="L713"></a><tt class="py-lineno"> 713</tt>  <tt class="py-line">    <tt class="py-comment"># Remove args that have a value of None.</tt> </tt>
+<a name="L714"></a><tt class="py-lineno"> 714</tt>  <tt class="py-line">    <tt class="py-name">keys</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L715"></a><tt class="py-lineno"> 715</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">keys</tt><tt class="py-op">:</tt> </tt>
+<a name="L716"></a><tt class="py-lineno"> 716</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L717"></a><tt class="py-lineno"> 717</tt>  <tt class="py-line">        <tt class="py-keyword">del</tt> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> </tt>
+<a name="L718"></a><tt class="py-lineno"> 718</tt>  <tt class="py-line"> </tt>
+<a name="L719"></a><tt class="py-lineno"> 719</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">required_params</tt><tt class="py-op">:</tt> </tt>
+<a name="L720"></a><tt class="py-lineno"> 720</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">kwargs</tt><tt class="py-op">:</tt> </tt>
+<a name="L721"></a><tt class="py-lineno"> 721</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Missing required parameter "%s"'</tt> <tt class="py-op">%</tt> <tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
+<a name="L722"></a><tt class="py-lineno"> 722</tt>  <tt class="py-line"> </tt>
+<a name="L723"></a><tt class="py-lineno"> 723</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">regex</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">pattern_params</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L724"></a><tt class="py-lineno"> 724</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">kwargs</tt><tt class="py-op">:</tt> </tt>
+<a name="L725"></a><tt class="py-lineno"> 725</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">string_types</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L726"></a><tt class="py-lineno"> 726</tt>  <tt class="py-line">          <tt class="py-name">pvalues</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
+<a name="L727"></a><tt class="py-lineno"> 727</tt>  <tt class="py-line">        <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L728"></a><tt class="py-lineno"> 728</tt>  <tt class="py-line">          <tt class="py-name">pvalues</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> </tt>
+<a name="L729"></a><tt class="py-lineno"> 729</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">pvalue</tt> <tt class="py-keyword">in</tt> <tt class="py-name">pvalues</tt><tt class="py-op">:</tt> </tt>
+<a name="L730"></a><tt class="py-lineno"> 730</tt>  <tt class="py-line">          <tt class="py-keyword">if</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">match</tt><tt class="py-op">(</tt><tt class="py-name">regex</tt><tt class="py-op">,</tt> <tt class="py-name">pvalue</tt><tt class="py-op">)</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L731"></a><tt class="py-lineno"> 731</tt>  <tt class="py-line">            <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt> </tt>
+<a name="L732"></a><tt class="py-lineno"> 732</tt>  <tt class="py-line">                <tt class="py-string">'Parameter "%s" value "%s" does not match the pattern "%s"'</tt> <tt class="py-op">%</tt> </tt>
+<a name="L733"></a><tt class="py-lineno"> 733</tt>  <tt class="py-line">                <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">pvalue</tt><tt class="py-op">,</tt> <tt class="py-name">regex</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L734"></a><tt class="py-lineno"> 734</tt>  <tt class="py-line"> </tt>
+<a name="L735"></a><tt class="py-lineno"> 735</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">enums</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">enum_params</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L736"></a><tt class="py-lineno"> 736</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">kwargs</tt><tt class="py-op">:</tt> </tt>
+<a name="L737"></a><tt class="py-lineno"> 737</tt>  <tt class="py-line">        <tt class="py-comment"># We need to handle the case of a repeated enum</tt> </tt>
+<a name="L738"></a><tt class="py-lineno"> 738</tt>  <tt class="py-line">        <tt class="py-comment"># name differently, since we want to handle both</tt> </tt>
+<a name="L739"></a><tt class="py-lineno"> 739</tt>  <tt class="py-line">        <tt class="py-comment"># arg='value' and arg=['value1', 'value2']</tt> </tt>
+<a name="L740"></a><tt class="py-lineno"> 740</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt> <tt class="py-keyword">and</tt> </tt>
+<a name="L741"></a><tt class="py-lineno"> 741</tt>  <tt class="py-line">            <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">string_types</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L742"></a><tt class="py-lineno"> 742</tt>  <tt class="py-line">          <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> </tt>
+<a name="L743"></a><tt class="py-lineno"> 743</tt>  <tt class="py-line">        <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L744"></a><tt class="py-lineno"> 744</tt>  <tt class="py-line">          <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
+<a name="L745"></a><tt class="py-lineno"> 745</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">value</tt> <tt class="py-keyword">in</tt> <tt class="py-name">values</tt><tt class="py-op">:</tt> </tt>
+<a name="L746"></a><tt class="py-lineno"> 746</tt>  <tt class="py-line">          <tt class="py-keyword">if</tt> <tt class="py-name">value</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">enums</tt><tt class="py-op">:</tt> </tt>
+<a name="L747"></a><tt class="py-lineno"> 747</tt>  <tt class="py-line">            <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt> </tt>
+<a name="L748"></a><tt class="py-lineno"> 748</tt>  <tt class="py-line">                <tt class="py-string">'Parameter "%s" value "%s" is not an allowed value in "%s"'</tt> <tt class="py-op">%</tt> </tt>
+<a name="L749"></a><tt class="py-lineno"> 749</tt>  <tt class="py-line">                <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">enums</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L750"></a><tt class="py-lineno"> 750</tt>  <tt class="py-line"> </tt>
+<a name="L751"></a><tt class="py-lineno"> 751</tt>  <tt class="py-line">    <tt class="py-name">actual_query_params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L752"></a><tt class="py-lineno"> 752</tt>  <tt class="py-line">    <tt class="py-name">actual_path_params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L753"></a><tt class="py-lineno"> 753</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L754"></a><tt class="py-lineno"> 754</tt>  <tt class="py-line">      <tt class="py-name">to_type</tt> <tt class="py-op">=</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">param_types</tt><tt class="py-op">.</tt><tt id="link-186" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-179', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-string">'string'</tt><tt class="py-op">)</tt> </tt>
-<a name="L750"></a><tt class="py-lineno"> 750</tt>  <tt class="py-line">      <tt class="py-comment"># For repeated parameters we cast each member of the list.</tt> </tt>
-<a name="L751"></a><tt class="py-lineno"> 751</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt> <tt class="py-keyword">and</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L752"></a><tt class="py-lineno"> 752</tt>  <tt class="py-line">        <tt class="py-name">cast_value</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt id="link-180" class="py-name" targets="Function googleapiclient.discovery._cast()=googleapiclient.discovery-module.html#_cast"><a title="googleapiclient.discovery._cast" class="py-name" href="#" onclick="return doclink('link-180', '_cast', 'link-180');">_cast</a></tt><tt class="py-op">(</tt><tt class="py-name">x</tt><tt class="py-op">,</tt> <tt class="py-name">to_type</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">x</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">]</tt> </tt>
-<a name="L753"></a><tt class="py-lineno"> 753</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L754"></a><tt class="py-lineno"> 754</tt>  <tt class="py-line">        <tt class="py-name">cast_value</tt> <tt class="py-op">=</tt> <tt id="link-181" class="py-name"><a title="googleapiclient.discovery._cast" class="py-name" href="#" onclick="return doclink('link-181', '_cast', 'link-180');">_cast</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">to_type</tt><tt class="py-op">)</tt> </tt>
-<a name="L755"></a><tt class="py-lineno"> 755</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt><tt class="py-op">:</tt> </tt>
-<a name="L756"></a><tt class="py-lineno"> 756</tt>  <tt class="py-line">        <tt class="py-name">actual_query_params</tt><tt class="py-op">[</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">cast_value</tt> </tt>
-<a name="L757"></a><tt class="py-lineno"> 757</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">path_params</tt><tt class="py-op">:</tt> </tt>
-<a name="L758"></a><tt class="py-lineno"> 758</tt>  <tt class="py-line">        <tt class="py-name">actual_path_params</tt><tt class="py-op">[</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">cast_value</tt> </tt>
-<a name="L759"></a><tt class="py-lineno"> 759</tt>  <tt class="py-line">    <tt class="py-name">body_value</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">.</tt><tt id="link-182" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-186', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-string">'string'</tt><tt class="py-op">)</tt> </tt>
+<a name="L755"></a><tt class="py-lineno"> 755</tt>  <tt class="py-line">      <tt class="py-comment"># For repeated parameters we cast each member of the list.</tt> </tt>
+<a name="L756"></a><tt class="py-lineno"> 756</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt> <tt class="py-keyword">and</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L757"></a><tt class="py-lineno"> 757</tt>  <tt class="py-line">        <tt class="py-name">cast_value</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt id="link-187" class="py-name" targets="Function googleapiclient.discovery._cast()=googleapiclient.discovery-module.html#_cast"><a title="googleapiclient.discovery._cast" class="py-name" href="#" onclick="return doclink('link-187', '_cast', 'link-187');">_cast</a></tt><tt class="py-op">(</tt><tt class="py-name">x</tt><tt class="py-op">,</tt> <tt class="py-name">to_type</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">x</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">]</tt> </tt>
+<a name="L758"></a><tt class="py-lineno"> 758</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L759"></a><tt class="py-lineno"> 759</tt>  <tt class="py-line">        <tt class="py-name">cast_value</tt> <tt class="py-op">=</tt> <tt id="link-188" class="py-name"><a title="googleapiclient.discovery._cast" class="py-name" href="#" onclick="return doclink('link-188', '_cast', 'link-187');">_cast</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">to_type</tt><tt class="py-op">)</tt> </tt>
+<a name="L760"></a><tt class="py-lineno"> 760</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">query_params</tt><tt class="py-op">:</tt> </tt>
+<a name="L761"></a><tt class="py-lineno"> 761</tt>  <tt class="py-line">        <tt class="py-name">actual_query_params</tt><tt class="py-op">[</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">cast_value</tt> </tt>
+<a name="L762"></a><tt class="py-lineno"> 762</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">path_params</tt><tt class="py-op">:</tt> </tt>
+<a name="L763"></a><tt class="py-lineno"> 763</tt>  <tt class="py-line">        <tt class="py-name">actual_path_params</tt><tt class="py-op">[</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">cast_value</tt> </tt>
+<a name="L764"></a><tt class="py-lineno"> 764</tt>  <tt class="py-line">    <tt class="py-name">body_value</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">.</tt><tt id="link-189" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-182', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'body'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
-<a name="L760"></a><tt class="py-lineno"> 760</tt>  <tt class="py-line">    <tt class="py-name">media_filename</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">.</tt><tt id="link-183" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-189', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'body'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
+<a name="L765"></a><tt class="py-lineno"> 765</tt>  <tt class="py-line">    <tt class="py-name">media_filename</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">.</tt><tt id="link-190" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-183', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'media_body'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
-<a name="L761"></a><tt class="py-lineno"> 761</tt>  <tt class="py-line">    <tt class="py-name">media_mime_type</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">.</tt><tt id="link-184" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-190', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'media_body'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
+<a name="L766"></a><tt class="py-lineno"> 766</tt>  <tt class="py-line">    <tt class="py-name">media_mime_type</tt> <tt class="py-op">=</tt> <tt class="py-name">kwargs</tt><tt class="py-op">.</tt><tt id="link-191" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-184', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'media_mime_type'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
-<a name="L762"></a><tt class="py-lineno"> 762</tt>  <tt class="py-line"> </tt>
-<a name="L763"></a><tt class="py-lineno"> 763</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_developerKey</tt><tt class="py-op">:</tt> </tt>
-<a name="L764"></a><tt class="py-lineno"> 764</tt>  <tt class="py-line">      <tt class="py-name">actual_query_params</tt><tt class="py-op">[</tt><tt class="py-string">'key'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_developerKey</tt> </tt>
-<a name="L765"></a><tt class="py-lineno"> 765</tt>  <tt class="py-line"> </tt>
-<a name="L766"></a><tt class="py-lineno"> 766</tt>  <tt class="py-line">    <tt id="link-185" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-185', 'model', 'link-39');">model</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_model</tt> </tt>
-<a name="L767"></a><tt class="py-lineno"> 767</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">methodName</tt><tt class="py-op">.</tt><tt class="py-name">endswith</tt><tt class="py-op">(</tt><tt class="py-string">'_media'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L768"></a><tt class="py-lineno"> 768</tt>  <tt class="py-line">      <tt id="link-186" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-186', 'model', 'link-39');">model</a></tt> <tt class="py-op">=</tt> <tt id="link-187" class="py-name"><a title="googleapiclient.model.MediaModel" class="py-name" href="#" onclick="return doclink('link-187', 'MediaModel', 'link-43');">MediaModel</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L769"></a><tt class="py-lineno"> 769</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-string">'response'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L770"></a><tt class="py-lineno"> 770</tt>  <tt class="py-line">      <tt id="link-188" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-188', 'model', 'link-39');">model</a></tt> <tt class="py-op">=</tt> <tt id="link-189" class="py-name"><a title="googleapiclient.model.RawModel" class="py-name" href="#" onclick="return doclink('link-189', 'RawModel', 'link-46');">RawModel</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L771"></a><tt class="py-lineno"> 771</tt>  <tt class="py-line"> </tt>
-<a name="L772"></a><tt class="py-lineno"> 772</tt>  <tt class="py-line">    <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L773"></a><tt class="py-lineno"> 773</tt>  <tt class="py-line">    <tt class="py-name">headers</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">,</tt> <tt class="py-name">query</tt><tt class="py-op">,</tt> <tt id="link-190" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-190', 'body', 'link-137');">body</a></tt> <tt class="py-op">=</tt> <tt id="link-191" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-191', 'model', 'link-39');">model</a></tt><tt class="py-op">.</tt><tt id="link-192" class="py-name"><a title="googleapiclient.http.HttpMock.request
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-191', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'media_mime_type'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
+<a name="L767"></a><tt class="py-lineno"> 767</tt>  <tt class="py-line"> </tt>
+<a name="L768"></a><tt class="py-lineno"> 768</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_developerKey</tt><tt class="py-op">:</tt> </tt>
+<a name="L769"></a><tt class="py-lineno"> 769</tt>  <tt class="py-line">      <tt class="py-name">actual_query_params</tt><tt class="py-op">[</tt><tt class="py-string">'key'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_developerKey</tt> </tt>
+<a name="L770"></a><tt class="py-lineno"> 770</tt>  <tt class="py-line"> </tt>
+<a name="L771"></a><tt class="py-lineno"> 771</tt>  <tt class="py-line">    <tt id="link-192" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-192', 'model', 'link-41');">model</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_model</tt> </tt>
+<a name="L772"></a><tt class="py-lineno"> 772</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">methodName</tt><tt class="py-op">.</tt><tt class="py-name">endswith</tt><tt class="py-op">(</tt><tt class="py-string">'_media'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L773"></a><tt class="py-lineno"> 773</tt>  <tt class="py-line">      <tt id="link-193" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-193', 'model', 'link-41');">model</a></tt> <tt class="py-op">=</tt> <tt id="link-194" class="py-name"><a title="googleapiclient.model.MediaModel" class="py-name" href="#" onclick="return doclink('link-194', 'MediaModel', 'link-45');">MediaModel</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L774"></a><tt class="py-lineno"> 774</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-string">'response'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L775"></a><tt class="py-lineno"> 775</tt>  <tt class="py-line">      <tt id="link-195" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-195', 'model', 'link-41');">model</a></tt> <tt class="py-op">=</tt> <tt id="link-196" class="py-name"><a title="googleapiclient.model.RawModel" class="py-name" href="#" onclick="return doclink('link-196', 'RawModel', 'link-48');">RawModel</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L776"></a><tt class="py-lineno"> 776</tt>  <tt class="py-line"> </tt>
+<a name="L777"></a><tt class="py-lineno"> 777</tt>  <tt class="py-line">    <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L778"></a><tt class="py-lineno"> 778</tt>  <tt class="py-line">    <tt class="py-name">headers</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">,</tt> <tt class="py-name">query</tt><tt class="py-op">,</tt> <tt id="link-197" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-197', 'body', 'link-144');">body</a></tt> <tt class="py-op">=</tt> <tt id="link-198" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-198', 'model', 'link-41');">model</a></tt><tt class="py-op">.</tt><tt id="link-199" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
-googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-192', 'request', 'link-96');">request</a></tt><tt class="py-op">(</tt><tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
-<a name="L774"></a><tt class="py-lineno"> 774</tt>  <tt class="py-line">        <tt class="py-name">actual_path_params</tt><tt class="py-op">,</tt> <tt class="py-name">actual_query_params</tt><tt class="py-op">,</tt> <tt class="py-name">body_value</tt><tt class="py-op">)</tt> </tt>
-<a name="L775"></a><tt class="py-lineno"> 775</tt>  <tt class="py-line"> </tt>
-<a name="L776"></a><tt class="py-lineno"> 776</tt>  <tt class="py-line">    <tt class="py-name">expanded_url</tt> <tt class="py-op">=</tt> <tt class="py-name">uritemplate</tt><tt class="py-op">.</tt><tt class="py-name">expand</tt><tt class="py-op">(</tt><tt class="py-name">pathUrl</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">)</tt> </tt>
-<a name="L777"></a><tt class="py-lineno"> 777</tt>  <tt class="py-line">    <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt id="link-193" class="py-name" targets="Function googleapiclient.discovery._urljoin()=googleapiclient.discovery-module.html#_urljoin"><a title="googleapiclient.discovery._urljoin" class="py-name" href="#" onclick="return doclink('link-193', '_urljoin', 'link-193');">_urljoin</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_baseUrl</tt><tt class="py-op">,</tt> <tt class="py-name">expanded_url</tt> <tt class="py-op">+</tt> <tt class="py-name">query</tt><tt class="py-op">)</tt> </tt>
-<a name="L778"></a><tt class="py-lineno"> 778</tt>  <tt class="py-line"> </tt>
-<a name="L779"></a><tt class="py-lineno"> 779</tt>  <tt class="py-line">    <tt id="link-194" class="py-name" targets="Method googleapiclient.http.MediaIoBaseUpload.resumable()=googleapiclient.http.MediaIoBaseUpload-class.html#resumable,Method googleapiclient.http.MediaUpload.resumable()=googleapiclient.http.MediaUpload-class.html#resumable"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
-googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-194', 'resumable', 'link-194');">resumable</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L780"></a><tt class="py-lineno"> 780</tt>  <tt class="py-line">    <tt class="py-name">multipart_boundary</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
-<a name="L781"></a><tt class="py-lineno"> 781</tt>  <tt class="py-line"> </tt>
-<a name="L782"></a><tt class="py-lineno"> 782</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">media_filename</tt><tt class="py-op">:</tt> </tt>
-<a name="L783"></a><tt class="py-lineno"> 783</tt>  <tt class="py-line">      <tt class="py-comment"># Ensure we end up with a valid MediaUpload object.</tt> </tt>
-<a name="L784"></a><tt class="py-lineno"> 784</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">string_types</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L785"></a><tt class="py-lineno"> 785</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">media_mime_type</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L786"></a><tt class="py-lineno"> 786</tt>  <tt class="py-line">          <tt id="link-195" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-195', 'logger', 'link-50');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">warning</tt><tt class="py-op">(</tt> </tt>
-<a name="L787"></a><tt class="py-lineno"> 787</tt>  <tt class="py-line">              <tt class="py-string">'media_mime_type argument not specified: trying to auto-detect for %s'</tt><tt class="py-op">,</tt> </tt>
-<a name="L788"></a><tt class="py-lineno"> 788</tt>  <tt class="py-line">              <tt class="py-name">media_filename</tt><tt class="py-op">)</tt> </tt>
-<a name="L789"></a><tt class="py-lineno"> 789</tt>  <tt class="py-line">          <tt class="py-name">media_mime_type</tt><tt class="py-op">,</tt> <tt class="py-name">_</tt> <tt class="py-op">=</tt> <tt class="py-name">mimetypes</tt><tt class="py-op">.</tt><tt class="py-name">guess_type</tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">)</tt> </tt>
+googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-199', 'request', 'link-97');">request</a></tt><tt class="py-op">(</tt><tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
+<a name="L779"></a><tt class="py-lineno"> 779</tt>  <tt class="py-line">        <tt class="py-name">actual_path_params</tt><tt class="py-op">,</tt> <tt class="py-name">actual_query_params</tt><tt class="py-op">,</tt> <tt class="py-name">body_value</tt><tt class="py-op">)</tt> </tt>
+<a name="L780"></a><tt class="py-lineno"> 780</tt>  <tt class="py-line"> </tt>
+<a name="L781"></a><tt class="py-lineno"> 781</tt>  <tt class="py-line">    <tt class="py-name">expanded_url</tt> <tt class="py-op">=</tt> <tt class="py-name">uritemplate</tt><tt class="py-op">.</tt><tt class="py-name">expand</tt><tt class="py-op">(</tt><tt class="py-name">pathUrl</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">)</tt> </tt>
+<a name="L782"></a><tt class="py-lineno"> 782</tt>  <tt class="py-line">    <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt id="link-200" class="py-name" targets="Function googleapiclient.discovery._urljoin()=googleapiclient.discovery-module.html#_urljoin"><a title="googleapiclient.discovery._urljoin" class="py-name" href="#" onclick="return doclink('link-200', '_urljoin', 'link-200');">_urljoin</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_baseUrl</tt><tt class="py-op">,</tt> <tt class="py-name">expanded_url</tt> <tt class="py-op">+</tt> <tt class="py-name">query</tt><tt class="py-op">)</tt> </tt>
+<a name="L783"></a><tt class="py-lineno"> 783</tt>  <tt class="py-line"> </tt>
+<a name="L784"></a><tt class="py-lineno"> 784</tt>  <tt class="py-line">    <tt id="link-201" class="py-name" targets="Method googleapiclient.http.MediaIoBaseUpload.resumable()=googleapiclient.http.MediaIoBaseUpload-class.html#resumable,Method googleapiclient.http.MediaUpload.resumable()=googleapiclient.http.MediaUpload-class.html#resumable"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-201', 'resumable', 'link-201');">resumable</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L785"></a><tt class="py-lineno"> 785</tt>  <tt class="py-line">    <tt class="py-name">multipart_boundary</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
+<a name="L786"></a><tt class="py-lineno"> 786</tt>  <tt class="py-line"> </tt>
+<a name="L787"></a><tt class="py-lineno"> 787</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">media_filename</tt><tt class="py-op">:</tt> </tt>
+<a name="L788"></a><tt class="py-lineno"> 788</tt>  <tt class="py-line">      <tt class="py-comment"># Ensure we end up with a valid MediaUpload object.</tt> </tt>
+<a name="L789"></a><tt class="py-lineno"> 789</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">string_types</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
 <a name="L790"></a><tt class="py-lineno"> 790</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">media_mime_type</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L791"></a><tt class="py-lineno"> 791</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-196" class="py-name"><a title="googleapiclient.errors.UnknownFileType" class="py-name" href="#" onclick="return doclink('link-196', 'UnknownFileType', 'link-19');">UnknownFileType</a></tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">)</tt> </tt>
-<a name="L792"></a><tt class="py-lineno"> 792</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt id="link-197" class="py-name"><a title="googleapiclient.mimeparse" class="py-name" href="#" onclick="return doclink('link-197', 'mimeparse', 'link-1');">mimeparse</a></tt><tt class="py-op">.</tt><tt id="link-198" class="py-name" targets="Function googleapiclient.mimeparse.best_match()=googleapiclient.mimeparse-module.html#best_match"><a title="googleapiclient.mimeparse.best_match" class="py-name" href="#" onclick="return doclink('link-198', 'best_match', 'link-198');">best_match</a></tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">media_mime_type</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-string">','</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt id="link-199" class="py-name"><a title="googleapiclient.model.BaseModel.accept
+<a name="L791"></a><tt class="py-lineno"> 791</tt>  <tt class="py-line">          <tt id="link-202" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-202', 'logger', 'link-52');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">warning</tt><tt class="py-op">(</tt> </tt>
+<a name="L792"></a><tt class="py-lineno"> 792</tt>  <tt class="py-line">              <tt class="py-string">'media_mime_type argument not specified: trying to auto-detect for %s'</tt><tt class="py-op">,</tt> </tt>
+<a name="L793"></a><tt class="py-lineno"> 793</tt>  <tt class="py-line">              <tt class="py-name">media_filename</tt><tt class="py-op">)</tt> </tt>
+<a name="L794"></a><tt class="py-lineno"> 794</tt>  <tt class="py-line">          <tt class="py-name">media_mime_type</tt><tt class="py-op">,</tt> <tt class="py-name">_</tt> <tt class="py-op">=</tt> <tt class="py-name">mimetypes</tt><tt class="py-op">.</tt><tt class="py-name">guess_type</tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">)</tt> </tt>
+<a name="L795"></a><tt class="py-lineno"> 795</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">media_mime_type</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L796"></a><tt class="py-lineno"> 796</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-203" class="py-name"><a title="googleapiclient.errors.UnknownFileType" class="py-name" href="#" onclick="return doclink('link-203', 'UnknownFileType', 'link-21');">UnknownFileType</a></tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">)</tt> </tt>
+<a name="L797"></a><tt class="py-lineno"> 797</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt id="link-204" class="py-name"><a title="googleapiclient.mimeparse" class="py-name" href="#" onclick="return doclink('link-204', 'mimeparse', 'link-3');">mimeparse</a></tt><tt class="py-op">.</tt><tt id="link-205" class="py-name" targets="Function googleapiclient.mimeparse.best_match()=googleapiclient.mimeparse-module.html#best_match"><a title="googleapiclient.mimeparse.best_match" class="py-name" href="#" onclick="return doclink('link-205', 'best_match', 'link-205');">best_match</a></tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">media_mime_type</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-string">','</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt id="link-206" class="py-name"><a title="googleapiclient.model.BaseModel.accept
 googleapiclient.model.JsonModel.accept
 googleapiclient.model.MediaModel.accept
 googleapiclient.model.ProtocolBufferModel.accept
-googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-199', 'accept', 'link-143');">accept</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L793"></a><tt class="py-lineno"> 793</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-200" class="py-name"><a title="googleapiclient.errors.UnacceptableMimeTypeError" class="py-name" href="#" onclick="return doclink('link-200', 'UnacceptableMimeTypeError', 'link-13');">UnacceptableMimeTypeError</a></tt><tt class="py-op">(</tt><tt class="py-name">media_mime_type</tt><tt class="py-op">)</tt> </tt>
-<a name="L794"></a><tt class="py-lineno"> 794</tt>  <tt class="py-line">        <tt class="py-name">media_upload</tt> <tt class="py-op">=</tt> <tt id="link-201" class="py-name"><a title="googleapiclient.http.MediaFileUpload" class="py-name" href="#" onclick="return doclink('link-201', 'MediaFileUpload', 'link-34');">MediaFileUpload</a></tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">,</tt> </tt>
-<a name="L795"></a><tt class="py-lineno"> 795</tt>  <tt class="py-line">                                       <tt id="link-202" class="py-name" targets="Method googleapiclient.http.MediaIoBaseUpload.mimetype()=googleapiclient.http.MediaIoBaseUpload-class.html#mimetype,Method googleapiclient.http.MediaUpload.mimetype()=googleapiclient.http.MediaUpload-class.html#mimetype"><a title="googleapiclient.http.MediaIoBaseUpload.mimetype
-googleapiclient.http.MediaUpload.mimetype" class="py-name" href="#" onclick="return doclink('link-202', 'mimetype', 'link-202');">mimetype</a></tt><tt class="py-op">=</tt><tt class="py-name">media_mime_type</tt><tt class="py-op">)</tt> </tt>
-<a name="L796"></a><tt class="py-lineno"> 796</tt>  <tt class="py-line">      <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">,</tt> <tt id="link-203" class="py-name"><a title="googleapiclient.http.MediaUpload" class="py-name" href="#" onclick="return doclink('link-203', 'MediaUpload', 'link-37');">MediaUpload</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L797"></a><tt class="py-lineno"> 797</tt>  <tt class="py-line">        <tt class="py-name">media_upload</tt> <tt class="py-op">=</tt> <tt class="py-name">media_filename</tt> </tt>
-<a name="L798"></a><tt class="py-lineno"> 798</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L799"></a><tt class="py-lineno"> 799</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'media_filename must be str or MediaUpload.'</tt><tt class="py-op">)</tt> </tt>
-<a name="L800"></a><tt class="py-lineno"> 800</tt>  <tt class="py-line"> </tt>
-<a name="L801"></a><tt class="py-lineno"> 801</tt>  <tt class="py-line">      <tt class="py-comment"># Check the maxSize</tt> </tt>
-<a name="L802"></a><tt class="py-lineno"> 802</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-204" class="py-name" targets="Method googleapiclient.http.MediaIoBaseUpload.size()=googleapiclient.http.MediaIoBaseUpload-class.html#size,Method googleapiclient.http.MediaUpload.size()=googleapiclient.http.MediaUpload-class.html#size"><a title="googleapiclient.http.MediaIoBaseUpload.size
-googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-204', 'size', 'link-204');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-205" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.size
-googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-205', 'size', 'link-204');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">&gt;</tt> <tt class="py-name">maxSize</tt> <tt class="py-op">&gt;</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
-<a name="L803"></a><tt class="py-lineno"> 803</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt id="link-206" class="py-name"><a title="googleapiclient.errors.MediaUploadSizeError" class="py-name" href="#" onclick="return doclink('link-206', 'MediaUploadSizeError', 'link-10');">MediaUploadSizeError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Media larger than: %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">maxSize</tt><tt class="py-op">)</tt> </tt>
-<a name="L804"></a><tt class="py-lineno"> 804</tt>  <tt class="py-line"> </tt>
-<a name="L805"></a><tt class="py-lineno"> 805</tt>  <tt class="py-line">      <tt class="py-comment"># Use the media path uri for media uploads</tt> </tt>
-<a name="L806"></a><tt class="py-lineno"> 806</tt>  <tt class="py-line">      <tt class="py-name">expanded_url</tt> <tt class="py-op">=</tt> <tt class="py-name">uritemplate</tt><tt class="py-op">.</tt><tt class="py-name">expand</tt><tt class="py-op">(</tt><tt class="py-name">mediaPathUrl</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">)</tt> </tt>
-<a name="L807"></a><tt class="py-lineno"> 807</tt>  <tt class="py-line">      <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt id="link-207" class="py-name"><a title="googleapiclient.discovery._urljoin" class="py-name" href="#" onclick="return doclink('link-207', '_urljoin', 'link-193');">_urljoin</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_baseUrl</tt><tt class="py-op">,</tt> <tt class="py-name">expanded_url</tt> <tt class="py-op">+</tt> <tt class="py-name">query</tt><tt class="py-op">)</tt> </tt>
-<a name="L808"></a><tt class="py-lineno"> 808</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-208" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
-googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-208', 'resumable', 'link-194');">resumable</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L809"></a><tt class="py-lineno"> 809</tt>  <tt class="py-line">        <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt class="py-name">_add_query_parameter</tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-string">'uploadType'</tt><tt class="py-op">,</tt> <tt class="py-string">'resumable'</tt><tt class="py-op">)</tt> </tt>
-<a name="L810"></a><tt class="py-lineno"> 810</tt>  <tt class="py-line"> </tt>
-<a name="L811"></a><tt class="py-lineno"> 811</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-209" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
-googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-209', 'resumable', 'link-194');">resumable</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L812"></a><tt class="py-lineno"> 812</tt>  <tt class="py-line">        <tt class="py-comment"># This is all we need to do for resumable, if the body exists it gets</tt> </tt>
-<a name="L813"></a><tt class="py-lineno"> 813</tt>  <tt class="py-line">        <tt class="py-comment"># sent in the first request, otherwise an empty body is sent.</tt> </tt>
-<a name="L814"></a><tt class="py-lineno"> 814</tt>  <tt class="py-line">        <tt id="link-210" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
-googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-210', 'resumable', 'link-194');">resumable</a></tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt> </tt>
-<a name="L815"></a><tt class="py-lineno"> 815</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L816"></a><tt class="py-lineno"> 816</tt>  <tt class="py-line">        <tt class="py-comment"># A non-resumable upload</tt> </tt>
-<a name="L817"></a><tt class="py-lineno"> 817</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt id="link-211" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-211', 'body', 'link-137');">body</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L818"></a><tt class="py-lineno"> 818</tt>  <tt class="py-line">          <tt class="py-comment"># This is a simple media upload</tt> </tt>
-<a name="L819"></a><tt class="py-lineno"> 819</tt>  <tt class="py-line">          <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-212" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.mimetype
-googleapiclient.http.MediaUpload.mimetype" class="py-name" href="#" onclick="return doclink('link-212', 'mimetype', 'link-202');">mimetype</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L820"></a><tt class="py-lineno"> 820</tt>  <tt class="py-line">          <tt id="link-213" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-213', 'body', 'link-137');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-214" class="py-name" targets="Method googleapiclient.http.MediaIoBaseUpload.getbytes()=googleapiclient.http.MediaIoBaseUpload-class.html#getbytes,Method googleapiclient.http.MediaUpload.getbytes()=googleapiclient.http.MediaUpload-class.html#getbytes"><a title="googleapiclient.http.MediaIoBaseUpload.getbytes
-googleapiclient.http.MediaUpload.getbytes" class="py-name" href="#" onclick="return doclink('link-214', 'getbytes', 'link-214');">getbytes</a></tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-215" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.size
-googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-215', 'size', 'link-204');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L821"></a><tt class="py-lineno"> 821</tt>  <tt class="py-line">          <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt class="py-name">_add_query_parameter</tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-string">'uploadType'</tt><tt class="py-op">,</tt> <tt class="py-string">'media'</tt><tt class="py-op">)</tt> </tt>
-<a name="L822"></a><tt class="py-lineno"> 822</tt>  <tt class="py-line">        <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L823"></a><tt class="py-lineno"> 823</tt>  <tt class="py-line">          <tt class="py-comment"># This is a multipart/related upload.</tt> </tt>
-<a name="L824"></a><tt class="py-lineno"> 824</tt>  <tt class="py-line">          <tt class="py-name">msgRoot</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMEMultipart</tt><tt class="py-op">(</tt><tt class="py-string">'related'</tt><tt class="py-op">)</tt> </tt>
-<a name="L825"></a><tt class="py-lineno"> 825</tt>  <tt class="py-line">          <tt class="py-comment"># msgRoot should not write out it's own headers</tt> </tt>
-<a name="L826"></a><tt class="py-lineno"> 826</tt>  <tt class="py-line">          <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">msgRoot</tt><tt class="py-op">,</tt> <tt class="py-string">'_write_headers'</tt><tt class="py-op">,</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
-<a name="L827"></a><tt class="py-lineno"> 827</tt>  <tt class="py-line"> </tt>
-<a name="L828"></a><tt class="py-lineno"> 828</tt>  <tt class="py-line">          <tt class="py-comment"># attach the body as one part</tt> </tt>
-<a name="L829"></a><tt class="py-lineno"> 829</tt>  <tt class="py-line">          <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMENonMultipart</tt><tt class="py-op">(</tt><tt class="py-op">*</tt><tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L830"></a><tt class="py-lineno"> 830</tt>  <tt class="py-line">          <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_payload</tt><tt class="py-op">(</tt><tt id="link-216" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-216', 'body', 'link-137');">body</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L831"></a><tt class="py-lineno"> 831</tt>  <tt class="py-line">          <tt class="py-name">msgRoot</tt><tt class="py-op">.</tt><tt class="py-name">attach</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
+googleapiclient.model.RawModel.accept" class="py-name" href="#" onclick="return doclink('link-206', 'accept', 'link-150');">accept</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L798"></a><tt class="py-lineno"> 798</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-207" class="py-name"><a title="googleapiclient.errors.UnacceptableMimeTypeError" class="py-name" href="#" onclick="return doclink('link-207', 'UnacceptableMimeTypeError', 'link-15');">UnacceptableMimeTypeError</a></tt><tt class="py-op">(</tt><tt class="py-name">media_mime_type</tt><tt class="py-op">)</tt> </tt>
+<a name="L799"></a><tt class="py-lineno"> 799</tt>  <tt class="py-line">        <tt class="py-name">media_upload</tt> <tt class="py-op">=</tt> <tt id="link-208" class="py-name"><a title="googleapiclient.http.MediaFileUpload" class="py-name" href="#" onclick="return doclink('link-208', 'MediaFileUpload', 'link-36');">MediaFileUpload</a></tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">,</tt> </tt>
+<a name="L800"></a><tt class="py-lineno"> 800</tt>  <tt class="py-line">                                       <tt id="link-209" class="py-name" targets="Method googleapiclient.http.MediaIoBaseUpload.mimetype()=googleapiclient.http.MediaIoBaseUpload-class.html#mimetype,Method googleapiclient.http.MediaUpload.mimetype()=googleapiclient.http.MediaUpload-class.html#mimetype"><a title="googleapiclient.http.MediaIoBaseUpload.mimetype
+googleapiclient.http.MediaUpload.mimetype" class="py-name" href="#" onclick="return doclink('link-209', 'mimetype', 'link-209');">mimetype</a></tt><tt class="py-op">=</tt><tt class="py-name">media_mime_type</tt><tt class="py-op">)</tt> </tt>
+<a name="L801"></a><tt class="py-lineno"> 801</tt>  <tt class="py-line">      <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">media_filename</tt><tt class="py-op">,</tt> <tt id="link-210" class="py-name"><a title="googleapiclient.http.MediaUpload" class="py-name" href="#" onclick="return doclink('link-210', 'MediaUpload', 'link-39');">MediaUpload</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L802"></a><tt class="py-lineno"> 802</tt>  <tt class="py-line">        <tt class="py-name">media_upload</tt> <tt class="py-op">=</tt> <tt class="py-name">media_filename</tt> </tt>
+<a name="L803"></a><tt class="py-lineno"> 803</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L804"></a><tt class="py-lineno"> 804</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'media_filename must be str or MediaUpload.'</tt><tt class="py-op">)</tt> </tt>
+<a name="L805"></a><tt class="py-lineno"> 805</tt>  <tt class="py-line"> </tt>
+<a name="L806"></a><tt class="py-lineno"> 806</tt>  <tt class="py-line">      <tt class="py-comment"># Check the maxSize</tt> </tt>
+<a name="L807"></a><tt class="py-lineno"> 807</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-211" class="py-name" targets="Method googleapiclient.http.MediaIoBaseUpload.size()=googleapiclient.http.MediaIoBaseUpload-class.html#size,Method googleapiclient.http.MediaUpload.size()=googleapiclient.http.MediaUpload-class.html#size"><a title="googleapiclient.http.MediaIoBaseUpload.size
+googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-211', 'size', 'link-211');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-212" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.size
+googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-212', 'size', 'link-211');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">&gt;</tt> <tt class="py-name">maxSize</tt> <tt class="py-op">&gt;</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
+<a name="L808"></a><tt class="py-lineno"> 808</tt>  <tt class="py-line">        <tt class="py-keyword">raise</tt> <tt id="link-213" class="py-name"><a title="googleapiclient.errors.MediaUploadSizeError" class="py-name" href="#" onclick="return doclink('link-213', 'MediaUploadSizeError', 'link-12');">MediaUploadSizeError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Media larger than: %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">maxSize</tt><tt class="py-op">)</tt> </tt>
+<a name="L809"></a><tt class="py-lineno"> 809</tt>  <tt class="py-line"> </tt>
+<a name="L810"></a><tt class="py-lineno"> 810</tt>  <tt class="py-line">      <tt class="py-comment"># Use the media path uri for media uploads</tt> </tt>
+<a name="L811"></a><tt class="py-lineno"> 811</tt>  <tt class="py-line">      <tt class="py-name">expanded_url</tt> <tt class="py-op">=</tt> <tt class="py-name">uritemplate</tt><tt class="py-op">.</tt><tt class="py-name">expand</tt><tt class="py-op">(</tt><tt class="py-name">mediaPathUrl</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">)</tt> </tt>
+<a name="L812"></a><tt class="py-lineno"> 812</tt>  <tt class="py-line">      <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt id="link-214" class="py-name"><a title="googleapiclient.discovery._urljoin" class="py-name" href="#" onclick="return doclink('link-214', '_urljoin', 'link-200');">_urljoin</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_baseUrl</tt><tt class="py-op">,</tt> <tt class="py-name">expanded_url</tt> <tt class="py-op">+</tt> <tt class="py-name">query</tt><tt class="py-op">)</tt> </tt>
+<a name="L813"></a><tt class="py-lineno"> 813</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-215" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-215', 'resumable', 'link-201');">resumable</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L814"></a><tt class="py-lineno"> 814</tt>  <tt class="py-line">        <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt class="py-name">_add_query_parameter</tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-string">'uploadType'</tt><tt class="py-op">,</tt> <tt class="py-string">'resumable'</tt><tt class="py-op">)</tt> </tt>
+<a name="L815"></a><tt class="py-lineno"> 815</tt>  <tt class="py-line"> </tt>
+<a name="L816"></a><tt class="py-lineno"> 816</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-216" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-216', 'resumable', 'link-201');">resumable</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L817"></a><tt class="py-lineno"> 817</tt>  <tt class="py-line">        <tt class="py-comment"># This is all we need to do for resumable, if the body exists it gets</tt> </tt>
+<a name="L818"></a><tt class="py-lineno"> 818</tt>  <tt class="py-line">        <tt class="py-comment"># sent in the first request, otherwise an empty body is sent.</tt> </tt>
+<a name="L819"></a><tt class="py-lineno"> 819</tt>  <tt class="py-line">        <tt id="link-217" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-217', 'resumable', 'link-201');">resumable</a></tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt> </tt>
+<a name="L820"></a><tt class="py-lineno"> 820</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L821"></a><tt class="py-lineno"> 821</tt>  <tt class="py-line">        <tt class="py-comment"># A non-resumable upload</tt> </tt>
+<a name="L822"></a><tt class="py-lineno"> 822</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt id="link-218" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-218', 'body', 'link-144');">body</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L823"></a><tt class="py-lineno"> 823</tt>  <tt class="py-line">          <tt class="py-comment"># This is a simple media upload</tt> </tt>
+<a name="L824"></a><tt class="py-lineno"> 824</tt>  <tt class="py-line">          <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-219" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.mimetype
+googleapiclient.http.MediaUpload.mimetype" class="py-name" href="#" onclick="return doclink('link-219', 'mimetype', 'link-209');">mimetype</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L825"></a><tt class="py-lineno"> 825</tt>  <tt class="py-line">          <tt id="link-220" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-220', 'body', 'link-144');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-221" class="py-name" targets="Method googleapiclient.http.MediaIoBaseUpload.getbytes()=googleapiclient.http.MediaIoBaseUpload-class.html#getbytes,Method googleapiclient.http.MediaUpload.getbytes()=googleapiclient.http.MediaUpload-class.html#getbytes"><a title="googleapiclient.http.MediaIoBaseUpload.getbytes
+googleapiclient.http.MediaUpload.getbytes" class="py-name" href="#" onclick="return doclink('link-221', 'getbytes', 'link-221');">getbytes</a></tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-222" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.size
+googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-222', 'size', 'link-211');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L826"></a><tt class="py-lineno"> 826</tt>  <tt class="py-line">          <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt class="py-name">_add_query_parameter</tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-string">'uploadType'</tt><tt class="py-op">,</tt> <tt class="py-string">'media'</tt><tt class="py-op">)</tt> </tt>
+<a name="L827"></a><tt class="py-lineno"> 827</tt>  <tt class="py-line">        <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L828"></a><tt class="py-lineno"> 828</tt>  <tt class="py-line">          <tt class="py-comment"># This is a multipart/related upload.</tt> </tt>
+<a name="L829"></a><tt class="py-lineno"> 829</tt>  <tt class="py-line">          <tt class="py-name">msgRoot</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMEMultipart</tt><tt class="py-op">(</tt><tt class="py-string">'related'</tt><tt class="py-op">)</tt> </tt>
+<a name="L830"></a><tt class="py-lineno"> 830</tt>  <tt class="py-line">          <tt class="py-comment"># msgRoot should not write out it's own headers</tt> </tt>
+<a name="L831"></a><tt class="py-lineno"> 831</tt>  <tt class="py-line">          <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">msgRoot</tt><tt class="py-op">,</tt> <tt class="py-string">'_write_headers'</tt><tt class="py-op">,</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
 <a name="L832"></a><tt class="py-lineno"> 832</tt>  <tt class="py-line"> </tt>
-<a name="L833"></a><tt class="py-lineno"> 833</tt>  <tt class="py-line">          <tt class="py-comment"># attach the media as the second part</tt> </tt>
-<a name="L834"></a><tt class="py-lineno"> 834</tt>  <tt class="py-line">          <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMENonMultipart</tt><tt class="py-op">(</tt><tt class="py-op">*</tt><tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-217" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.mimetype
-googleapiclient.http.MediaUpload.mimetype" class="py-name" href="#" onclick="return doclink('link-217', 'mimetype', 'link-202');">mimetype</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L835"></a><tt class="py-lineno"> 835</tt>  <tt class="py-line">          <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'Content-Transfer-Encoding'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'binary'</tt> </tt>
-<a name="L836"></a><tt class="py-lineno"> 836</tt>  <tt class="py-line"> </tt>
-<a name="L837"></a><tt class="py-lineno"> 837</tt>  <tt class="py-line">          <tt class="py-name">payload</tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-218" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.getbytes
-googleapiclient.http.MediaUpload.getbytes" class="py-name" href="#" onclick="return doclink('link-218', 'getbytes', 'link-214');">getbytes</a></tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-219" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.size
-googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-219', 'size', 'link-204');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L838"></a><tt class="py-lineno"> 838</tt>  <tt class="py-line">          <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_payload</tt><tt class="py-op">(</tt><tt class="py-name">payload</tt><tt class="py-op">)</tt> </tt>
-<a name="L839"></a><tt class="py-lineno"> 839</tt>  <tt class="py-line">          <tt class="py-name">msgRoot</tt><tt class="py-op">.</tt><tt class="py-name">attach</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
-<a name="L840"></a><tt class="py-lineno"> 840</tt>  <tt class="py-line">          <tt class="py-comment"># encode the body: note that we can't use `as_string`, because</tt> </tt>
-<a name="L841"></a><tt class="py-lineno"> 841</tt>  <tt class="py-line">          <tt class="py-comment"># it plays games with `From ` lines.</tt> </tt>
-<a name="L842"></a><tt class="py-lineno"> 842</tt>  <tt class="py-line">          <tt class="py-name">fp</tt> <tt class="py-op">=</tt> <tt class="py-name">BytesIO</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L843"></a><tt class="py-lineno"> 843</tt>  <tt class="py-line">          <tt class="py-name">g</tt> <tt class="py-op">=</tt> <tt id="link-220" class="py-name" targets="Class googleapiclient.discovery._BytesGenerator=googleapiclient.discovery._BytesGenerator-class.html"><a title="googleapiclient.discovery._BytesGenerator" class="py-name" href="#" onclick="return doclink('link-220', '_BytesGenerator', 'link-220');">_BytesGenerator</a></tt><tt class="py-op">(</tt><tt class="py-name">fp</tt><tt class="py-op">,</tt> <tt class="py-name">mangle_from_</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
-<a name="L844"></a><tt class="py-lineno"> 844</tt>  <tt class="py-line">          <tt class="py-name">g</tt><tt class="py-op">.</tt><tt class="py-name">flatten</tt><tt class="py-op">(</tt><tt class="py-name">msgRoot</tt><tt class="py-op">,</tt> <tt class="py-name">unixfrom</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
-<a name="L845"></a><tt class="py-lineno"> 845</tt>  <tt class="py-line">          <tt id="link-221" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-221', 'body', 'link-137');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">fp</tt><tt class="py-op">.</tt><tt class="py-name">getvalue</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L846"></a><tt class="py-lineno"> 846</tt>  <tt class="py-line"> </tt>
-<a name="L847"></a><tt class="py-lineno"> 847</tt>  <tt class="py-line">          <tt class="py-name">multipart_boundary</tt> <tt class="py-op">=</tt> <tt class="py-name">msgRoot</tt><tt class="py-op">.</tt><tt class="py-name">get_boundary</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L848"></a><tt class="py-lineno"> 848</tt>  <tt class="py-line">          <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'multipart/related; '</tt> </tt>
-<a name="L849"></a><tt class="py-lineno"> 849</tt>  <tt class="py-line">                                     <tt class="py-string">'boundary="%s"'</tt><tt class="py-op">)</tt> <tt class="py-op">%</tt> <tt class="py-name">multipart_boundary</tt> </tt>
-<a name="L850"></a><tt class="py-lineno"> 850</tt>  <tt class="py-line">          <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt class="py-name">_add_query_parameter</tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-string">'uploadType'</tt><tt class="py-op">,</tt> <tt class="py-string">'multipart'</tt><tt class="py-op">)</tt> </tt>
+<a name="L833"></a><tt class="py-lineno"> 833</tt>  <tt class="py-line">          <tt class="py-comment"># attach the body as one part</tt> </tt>
+<a name="L834"></a><tt class="py-lineno"> 834</tt>  <tt class="py-line">          <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMENonMultipart</tt><tt class="py-op">(</tt><tt class="py-op">*</tt><tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L835"></a><tt class="py-lineno"> 835</tt>  <tt class="py-line">          <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_payload</tt><tt class="py-op">(</tt><tt id="link-223" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-223', 'body', 'link-144');">body</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L836"></a><tt class="py-lineno"> 836</tt>  <tt class="py-line">          <tt class="py-name">msgRoot</tt><tt class="py-op">.</tt><tt class="py-name">attach</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
+<a name="L837"></a><tt class="py-lineno"> 837</tt>  <tt class="py-line"> </tt>
+<a name="L838"></a><tt class="py-lineno"> 838</tt>  <tt class="py-line">          <tt class="py-comment"># attach the media as the second part</tt> </tt>
+<a name="L839"></a><tt class="py-lineno"> 839</tt>  <tt class="py-line">          <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMENonMultipart</tt><tt class="py-op">(</tt><tt class="py-op">*</tt><tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-224" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.mimetype
+googleapiclient.http.MediaUpload.mimetype" class="py-name" href="#" onclick="return doclink('link-224', 'mimetype', 'link-209');">mimetype</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L840"></a><tt class="py-lineno"> 840</tt>  <tt class="py-line">          <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'Content-Transfer-Encoding'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'binary'</tt> </tt>
+<a name="L841"></a><tt class="py-lineno"> 841</tt>  <tt class="py-line"> </tt>
+<a name="L842"></a><tt class="py-lineno"> 842</tt>  <tt class="py-line">          <tt class="py-name">payload</tt> <tt class="py-op">=</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-225" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.getbytes
+googleapiclient.http.MediaUpload.getbytes" class="py-name" href="#" onclick="return doclink('link-225', 'getbytes', 'link-221');">getbytes</a></tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-name">media_upload</tt><tt class="py-op">.</tt><tt id="link-226" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.size
+googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-226', 'size', 'link-211');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L843"></a><tt class="py-lineno"> 843</tt>  <tt class="py-line">          <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_payload</tt><tt class="py-op">(</tt><tt class="py-name">payload</tt><tt class="py-op">)</tt> </tt>
+<a name="L844"></a><tt class="py-lineno"> 844</tt>  <tt class="py-line">          <tt class="py-name">msgRoot</tt><tt class="py-op">.</tt><tt class="py-name">attach</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
+<a name="L845"></a><tt class="py-lineno"> 845</tt>  <tt class="py-line">          <tt class="py-comment"># encode the body: note that we can't use `as_string`, because</tt> </tt>
+<a name="L846"></a><tt class="py-lineno"> 846</tt>  <tt class="py-line">          <tt class="py-comment"># it plays games with `From ` lines.</tt> </tt>
+<a name="L847"></a><tt class="py-lineno"> 847</tt>  <tt class="py-line">          <tt class="py-name">fp</tt> <tt class="py-op">=</tt> <tt class="py-name">BytesIO</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L848"></a><tt class="py-lineno"> 848</tt>  <tt class="py-line">          <tt class="py-name">g</tt> <tt class="py-op">=</tt> <tt id="link-227" class="py-name" targets="Class googleapiclient.discovery._BytesGenerator=googleapiclient.discovery._BytesGenerator-class.html"><a title="googleapiclient.discovery._BytesGenerator" class="py-name" href="#" onclick="return doclink('link-227', '_BytesGenerator', 'link-227');">_BytesGenerator</a></tt><tt class="py-op">(</tt><tt class="py-name">fp</tt><tt class="py-op">,</tt> <tt class="py-name">mangle_from_</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
+<a name="L849"></a><tt class="py-lineno"> 849</tt>  <tt class="py-line">          <tt class="py-name">g</tt><tt class="py-op">.</tt><tt class="py-name">flatten</tt><tt class="py-op">(</tt><tt class="py-name">msgRoot</tt><tt class="py-op">,</tt> <tt class="py-name">unixfrom</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
+<a name="L850"></a><tt class="py-lineno"> 850</tt>  <tt class="py-line">          <tt id="link-228" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-228', 'body', 'link-144');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">fp</tt><tt class="py-op">.</tt><tt class="py-name">getvalue</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
 <a name="L851"></a><tt class="py-lineno"> 851</tt>  <tt class="py-line"> </tt>
-<a name="L852"></a><tt class="py-lineno"> 852</tt>  <tt class="py-line">    <tt id="link-222" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-222', 'logger', 'link-50');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">info</tt><tt class="py-op">(</tt><tt class="py-string">'URL being requested: %s %s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">httpMethod</tt><tt class="py-op">,</tt><tt class="py-name">url</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L853"></a><tt class="py-lineno"> 853</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requestBuilder</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_http</tt><tt class="py-op">,</tt> </tt>
-<a name="L854"></a><tt class="py-lineno"> 854</tt>  <tt class="py-line">                                <tt id="link-223" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-223', 'model', 'link-39');">model</a></tt><tt class="py-op">.</tt><tt id="link-224" class="py-name" targets="Method googleapiclient.model.BaseModel.response()=googleapiclient.model.BaseModel-class.html#response,Method googleapiclient.model.Model.response()=googleapiclient.model.Model-class.html#response"><a title="googleapiclient.model.BaseModel.response
-googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-224', 'response', 'link-224');">response</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L855"></a><tt class="py-lineno"> 855</tt>  <tt class="py-line">                                <tt class="py-name">url</tt><tt class="py-op">,</tt> </tt>
-<a name="L856"></a><tt class="py-lineno"> 856</tt>  <tt class="py-line">                                <tt class="py-name">method</tt><tt class="py-op">=</tt><tt class="py-name">httpMethod</tt><tt class="py-op">,</tt> </tt>
-<a name="L857"></a><tt class="py-lineno"> 857</tt>  <tt class="py-line">                                <tt id="link-225" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-225', 'body', 'link-137');">body</a></tt><tt class="py-op">=</tt><tt id="link-226" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-226', 'body', 'link-137');">body</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L858"></a><tt class="py-lineno"> 858</tt>  <tt class="py-line">                                <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
-<a name="L859"></a><tt class="py-lineno"> 859</tt>  <tt class="py-line">                                <tt class="py-name">methodId</tt><tt class="py-op">=</tt><tt class="py-name">methodId</tt><tt class="py-op">,</tt> </tt>
-<a name="L860"></a><tt class="py-lineno"> 860</tt>  <tt class="py-line">                                <tt id="link-227" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
-googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-227', 'resumable', 'link-194');">resumable</a></tt><tt class="py-op">=</tt><tt id="link-228" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
-googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-228', 'resumable', 'link-194');">resumable</a></tt><tt class="py-op">)</tt> </tt>
-</div><a name="L861"></a><tt class="py-lineno"> 861</tt>  <tt class="py-line"> </tt>
-<a name="L862"></a><tt class="py-lineno"> 862</tt>  <tt class="py-line">  <tt class="py-name">docs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">methodDesc</tt><tt class="py-op">.</tt><tt id="link-229" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="L852"></a><tt class="py-lineno"> 852</tt>  <tt class="py-line">          <tt class="py-name">multipart_boundary</tt> <tt class="py-op">=</tt> <tt class="py-name">msgRoot</tt><tt class="py-op">.</tt><tt class="py-name">get_boundary</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L853"></a><tt class="py-lineno"> 853</tt>  <tt class="py-line">          <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'multipart/related; '</tt> </tt>
+<a name="L854"></a><tt class="py-lineno"> 854</tt>  <tt class="py-line">                                     <tt class="py-string">'boundary="%s"'</tt><tt class="py-op">)</tt> <tt class="py-op">%</tt> <tt class="py-name">multipart_boundary</tt> </tt>
+<a name="L855"></a><tt class="py-lineno"> 855</tt>  <tt class="py-line">          <tt class="py-name">url</tt> <tt class="py-op">=</tt> <tt class="py-name">_add_query_parameter</tt><tt class="py-op">(</tt><tt class="py-name">url</tt><tt class="py-op">,</tt> <tt class="py-string">'uploadType'</tt><tt class="py-op">,</tt> <tt class="py-string">'multipart'</tt><tt class="py-op">)</tt> </tt>
+<a name="L856"></a><tt class="py-lineno"> 856</tt>  <tt class="py-line"> </tt>
+<a name="L857"></a><tt class="py-lineno"> 857</tt>  <tt class="py-line">    <tt id="link-229" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-229', 'logger', 'link-52');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">info</tt><tt class="py-op">(</tt><tt class="py-string">'URL being requested: %s %s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">httpMethod</tt><tt class="py-op">,</tt><tt class="py-name">url</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L858"></a><tt class="py-lineno"> 858</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requestBuilder</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_http</tt><tt class="py-op">,</tt> </tt>
+<a name="L859"></a><tt class="py-lineno"> 859</tt>  <tt class="py-line">                                <tt id="link-230" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-230', 'model', 'link-41');">model</a></tt><tt class="py-op">.</tt><tt id="link-231" class="py-name" targets="Method googleapiclient.model.BaseModel.response()=googleapiclient.model.BaseModel-class.html#response,Method googleapiclient.model.Model.response()=googleapiclient.model.Model-class.html#response"><a title="googleapiclient.model.BaseModel.response
+googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-231', 'response', 'link-231');">response</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L860"></a><tt class="py-lineno"> 860</tt>  <tt class="py-line">                                <tt class="py-name">url</tt><tt class="py-op">,</tt> </tt>
+<a name="L861"></a><tt class="py-lineno"> 861</tt>  <tt class="py-line">                                <tt class="py-name">method</tt><tt class="py-op">=</tt><tt class="py-name">httpMethod</tt><tt class="py-op">,</tt> </tt>
+<a name="L862"></a><tt class="py-lineno"> 862</tt>  <tt class="py-line">                                <tt id="link-232" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-232', 'body', 'link-144');">body</a></tt><tt class="py-op">=</tt><tt id="link-233" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-233', 'body', 'link-144');">body</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L863"></a><tt class="py-lineno"> 863</tt>  <tt class="py-line">                                <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
+<a name="L864"></a><tt class="py-lineno"> 864</tt>  <tt class="py-line">                                <tt class="py-name">methodId</tt><tt class="py-op">=</tt><tt class="py-name">methodId</tt><tt class="py-op">,</tt> </tt>
+<a name="L865"></a><tt class="py-lineno"> 865</tt>  <tt class="py-line">                                <tt id="link-234" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-234', 'resumable', 'link-201');">resumable</a></tt><tt class="py-op">=</tt><tt id="link-235" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-235', 'resumable', 'link-201');">resumable</a></tt><tt class="py-op">)</tt> </tt>
+</div><a name="L866"></a><tt class="py-lineno"> 866</tt>  <tt class="py-line"> </tt>
+<a name="L867"></a><tt class="py-lineno"> 867</tt>  <tt class="py-line">  <tt class="py-name">docs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">methodDesc</tt><tt class="py-op">.</tt><tt id="link-236" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-229', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'description'</tt><tt class="py-op">,</tt> <tt id="link-230" class="py-name"><a title="googleapiclient.discovery.DEFAULT_METHOD_DOC" class="py-name" href="#" onclick="return doclink('link-230', 'DEFAULT_METHOD_DOC', 'link-57');">DEFAULT_METHOD_DOC</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-string">'\n\n'</tt><tt class="py-op">]</tt> </tt>
-<a name="L863"></a><tt class="py-lineno"> 863</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">)</tt> <tt class="py-op">&gt;</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
-<a name="L864"></a><tt class="py-lineno"> 864</tt>  <tt class="py-line">    <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'Args:\n'</tt><tt class="py-op">)</tt> </tt>
-<a name="L865"></a><tt class="py-lineno"> 865</tt>  <tt class="py-line"> </tt>
-<a name="L866"></a><tt class="py-lineno"> 866</tt>  <tt class="py-line">  <tt class="py-comment"># Skip undocumented params and params common to all methods.</tt> </tt>
-<a name="L867"></a><tt class="py-lineno"> 867</tt>  <tt class="py-line">  <tt class="py-name">skip_parameters</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">rootDesc</tt><tt class="py-op">.</tt><tt id="link-231" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-236', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'description'</tt><tt class="py-op">,</tt> <tt id="link-237" class="py-name"><a title="googleapiclient.discovery.DEFAULT_METHOD_DOC" class="py-name" href="#" onclick="return doclink('link-237', 'DEFAULT_METHOD_DOC', 'link-59');">DEFAULT_METHOD_DOC</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-string">'\n\n'</tt><tt class="py-op">]</tt> </tt>
+<a name="L868"></a><tt class="py-lineno"> 868</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">)</tt> <tt class="py-op">&gt;</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
+<a name="L869"></a><tt class="py-lineno"> 869</tt>  <tt class="py-line">    <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'Args:\n'</tt><tt class="py-op">)</tt> </tt>
+<a name="L870"></a><tt class="py-lineno"> 870</tt>  <tt class="py-line"> </tt>
+<a name="L871"></a><tt class="py-lineno"> 871</tt>  <tt class="py-line">  <tt class="py-comment"># Skip undocumented params and params common to all methods.</tt> </tt>
+<a name="L872"></a><tt class="py-lineno"> 872</tt>  <tt class="py-line">  <tt class="py-name">skip_parameters</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">rootDesc</tt><tt class="py-op">.</tt><tt id="link-238" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-231', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L868"></a><tt class="py-lineno"> 868</tt>  <tt class="py-line">  <tt class="py-name">skip_parameters</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt id="link-232" class="py-name"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETERS" class="py-name" href="#" onclick="return doclink('link-232', 'STACK_QUERY_PARAMETERS', 'link-63');">STACK_QUERY_PARAMETERS</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L869"></a><tt class="py-lineno"> 869</tt>  <tt class="py-line"> </tt>
-<a name="L870"></a><tt class="py-lineno"> 870</tt>  <tt class="py-line">  <tt class="py-name">all_args</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L871"></a><tt class="py-lineno"> 871</tt>  <tt class="py-line">  <tt class="py-name">args_ordered</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt id="link-233" class="py-name"><a title="googleapiclient.discovery.key2param" class="py-name" href="#" onclick="return doclink('link-233', 'key2param', 'link-162');">key2param</a></tt><tt class="py-op">(</tt><tt class="py-name">s</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">s</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">.</tt><tt id="link-234" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-238', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L873"></a><tt class="py-lineno"> 873</tt>  <tt class="py-line">  <tt class="py-name">skip_parameters</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt id="link-239" class="py-name"><a title="googleapiclient.discovery.STACK_QUERY_PARAMETERS" class="py-name" href="#" onclick="return doclink('link-239', 'STACK_QUERY_PARAMETERS', 'link-65');">STACK_QUERY_PARAMETERS</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L874"></a><tt class="py-lineno"> 874</tt>  <tt class="py-line"> </tt>
+<a name="L875"></a><tt class="py-lineno"> 875</tt>  <tt class="py-line">  <tt class="py-name">all_args</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">.</tt><tt class="py-name">keys</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L876"></a><tt class="py-lineno"> 876</tt>  <tt class="py-line">  <tt class="py-name">args_ordered</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt id="link-240" class="py-name"><a title="googleapiclient.discovery.key2param" class="py-name" href="#" onclick="return doclink('link-240', 'key2param', 'link-169');">key2param</a></tt><tt class="py-op">(</tt><tt class="py-name">s</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">s</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">.</tt><tt id="link-241" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-234', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameterOrder'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt>
-<a name="L872"></a><tt class="py-lineno"> 872</tt>  <tt class="py-line"> </tt>
-<a name="L873"></a><tt class="py-lineno"> 873</tt>  <tt class="py-line">  <tt class="py-comment"># Move body to the front of the line.</tt> </tt>
-<a name="L874"></a><tt class="py-lineno"> 874</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-string">'body'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">all_args</tt><tt class="py-op">:</tt> </tt>
-<a name="L875"></a><tt class="py-lineno"> 875</tt>  <tt class="py-line">    <tt class="py-name">args_ordered</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'body'</tt><tt class="py-op">)</tt> </tt>
-<a name="L876"></a><tt class="py-lineno"> 876</tt>  <tt class="py-line"> </tt>
-<a name="L877"></a><tt class="py-lineno"> 877</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">all_args</tt><tt class="py-op">:</tt> </tt>
-<a name="L878"></a><tt class="py-lineno"> 878</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">args_ordered</tt><tt class="py-op">:</tt> </tt>
-<a name="L879"></a><tt class="py-lineno"> 879</tt>  <tt class="py-line">      <tt class="py-name">args_ordered</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
-<a name="L880"></a><tt class="py-lineno"> 880</tt>  <tt class="py-line"> </tt>
-<a name="L881"></a><tt class="py-lineno"> 881</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">arg</tt> <tt class="py-keyword">in</tt> <tt class="py-name">args_ordered</tt><tt class="py-op">:</tt> </tt>
-<a name="L882"></a><tt class="py-lineno"> 882</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">arg</tt> <tt class="py-keyword">in</tt> <tt class="py-name">skip_parameters</tt><tt class="py-op">:</tt> </tt>
-<a name="L883"></a><tt class="py-lineno"> 883</tt>  <tt class="py-line">      <tt class="py-keyword">continue</tt> </tt>
-<a name="L884"></a><tt class="py-lineno"> 884</tt>  <tt class="py-line"> </tt>
-<a name="L885"></a><tt class="py-lineno"> 885</tt>  <tt class="py-line">    <tt class="py-name">repeated</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
-<a name="L886"></a><tt class="py-lineno"> 886</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">arg</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt><tt class="py-op">:</tt> </tt>
-<a name="L887"></a><tt class="py-lineno"> 887</tt>  <tt class="py-line">      <tt class="py-name">repeated</tt> <tt class="py-op">=</tt> <tt class="py-string">' (repeated)'</tt> </tt>
-<a name="L888"></a><tt class="py-lineno"> 888</tt>  <tt class="py-line">    <tt class="py-name">required</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
-<a name="L889"></a><tt class="py-lineno"> 889</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">arg</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">required_params</tt><tt class="py-op">:</tt> </tt>
-<a name="L890"></a><tt class="py-lineno"> 890</tt>  <tt class="py-line">      <tt class="py-name">required</tt> <tt class="py-op">=</tt> <tt class="py-string">' (required)'</tt> </tt>
-<a name="L891"></a><tt class="py-lineno"> 891</tt>  <tt class="py-line">    <tt class="py-name">paramdesc</tt> <tt class="py-op">=</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">[</tt><tt class="py-string">'parameters'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">[</tt><tt class="py-name">arg</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
-<a name="L892"></a><tt class="py-lineno"> 892</tt>  <tt class="py-line">    <tt class="py-name">paramdoc</tt> <tt class="py-op">=</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">.</tt><tt id="link-235" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-241', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameterOrder'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt>
+<a name="L877"></a><tt class="py-lineno"> 877</tt>  <tt class="py-line"> </tt>
+<a name="L878"></a><tt class="py-lineno"> 878</tt>  <tt class="py-line">  <tt class="py-comment"># Move body to the front of the line.</tt> </tt>
+<a name="L879"></a><tt class="py-lineno"> 879</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-string">'body'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">all_args</tt><tt class="py-op">:</tt> </tt>
+<a name="L880"></a><tt class="py-lineno"> 880</tt>  <tt class="py-line">    <tt class="py-name">args_ordered</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'body'</tt><tt class="py-op">)</tt> </tt>
+<a name="L881"></a><tt class="py-lineno"> 881</tt>  <tt class="py-line"> </tt>
+<a name="L882"></a><tt class="py-lineno"> 882</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">all_args</tt><tt class="py-op">:</tt> </tt>
+<a name="L883"></a><tt class="py-lineno"> 883</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">args_ordered</tt><tt class="py-op">:</tt> </tt>
+<a name="L884"></a><tt class="py-lineno"> 884</tt>  <tt class="py-line">      <tt class="py-name">args_ordered</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> </tt>
+<a name="L885"></a><tt class="py-lineno"> 885</tt>  <tt class="py-line"> </tt>
+<a name="L886"></a><tt class="py-lineno"> 886</tt>  <tt class="py-line">  <tt class="py-keyword">for</tt> <tt class="py-name">arg</tt> <tt class="py-keyword">in</tt> <tt class="py-name">args_ordered</tt><tt class="py-op">:</tt> </tt>
+<a name="L887"></a><tt class="py-lineno"> 887</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">arg</tt> <tt class="py-keyword">in</tt> <tt class="py-name">skip_parameters</tt><tt class="py-op">:</tt> </tt>
+<a name="L888"></a><tt class="py-lineno"> 888</tt>  <tt class="py-line">      <tt class="py-keyword">continue</tt> </tt>
+<a name="L889"></a><tt class="py-lineno"> 889</tt>  <tt class="py-line"> </tt>
+<a name="L890"></a><tt class="py-lineno"> 890</tt>  <tt class="py-line">    <tt class="py-name">repeated</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
+<a name="L891"></a><tt class="py-lineno"> 891</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">arg</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">repeated_params</tt><tt class="py-op">:</tt> </tt>
+<a name="L892"></a><tt class="py-lineno"> 892</tt>  <tt class="py-line">      <tt class="py-name">repeated</tt> <tt class="py-op">=</tt> <tt class="py-string">' (repeated)'</tt> </tt>
+<a name="L893"></a><tt class="py-lineno"> 893</tt>  <tt class="py-line">    <tt class="py-name">required</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
+<a name="L894"></a><tt class="py-lineno"> 894</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">arg</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">required_params</tt><tt class="py-op">:</tt> </tt>
+<a name="L895"></a><tt class="py-lineno"> 895</tt>  <tt class="py-line">      <tt class="py-name">required</tt> <tt class="py-op">=</tt> <tt class="py-string">' (required)'</tt> </tt>
+<a name="L896"></a><tt class="py-lineno"> 896</tt>  <tt class="py-line">    <tt class="py-name">paramdesc</tt> <tt class="py-op">=</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">[</tt><tt class="py-string">'parameters'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-name">parameters</tt><tt class="py-op">.</tt><tt class="py-name">argmap</tt><tt class="py-op">[</tt><tt class="py-name">arg</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
+<a name="L897"></a><tt class="py-lineno"> 897</tt>  <tt class="py-line">    <tt class="py-name">paramdoc</tt> <tt class="py-op">=</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">.</tt><tt id="link-242" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-235', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'description'</tt><tt class="py-op">,</tt> <tt class="py-string">'A parameter'</tt><tt class="py-op">)</tt> </tt>
-<a name="L893"></a><tt class="py-lineno"> 893</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'$ref'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L894"></a><tt class="py-lineno"> 894</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt>
-<a name="L895"></a><tt class="py-lineno"> 895</tt>  <tt class="py-line">          <tt class="py-op">(</tt><tt class="py-string">'  %s: object, %s%s%s\n    The object takes the'</tt> </tt>
-<a name="L896"></a><tt class="py-lineno"> 896</tt>  <tt class="py-line">          <tt class="py-string">' form of:\n\n%s\n\n'</tt><tt class="py-op">)</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">arg</tt><tt class="py-op">,</tt> <tt class="py-name">paramdoc</tt><tt class="py-op">,</tt> <tt class="py-name">required</tt><tt class="py-op">,</tt> <tt class="py-name">repeated</tt><tt class="py-op">,</tt> </tt>
-<a name="L897"></a><tt class="py-lineno"> 897</tt>  <tt class="py-line">            <tt id="link-236" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-236', 'schema', 'link-48');">schema</a></tt><tt class="py-op">.</tt><tt id="link-237" class="py-name" targets="Method googleapiclient.schema.Schemas.prettyPrintByName()=googleapiclient.schema.Schemas-class.html#prettyPrintByName"><a title="googleapiclient.schema.Schemas.prettyPrintByName" class="py-name" href="#" onclick="return doclink('link-237', 'prettyPrintByName', 'link-237');">prettyPrintByName</a></tt><tt class="py-op">(</tt><tt class="py-name">paramdesc</tt><tt class="py-op">[</tt><tt class="py-string">'$ref'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L898"></a><tt class="py-lineno"> 898</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L899"></a><tt class="py-lineno"> 899</tt>  <tt class="py-line">      <tt class="py-name">paramtype</tt> <tt class="py-op">=</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">.</tt><tt id="link-238" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-242', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'description'</tt><tt class="py-op">,</tt> <tt class="py-string">'A parameter'</tt><tt class="py-op">)</tt> </tt>
+<a name="L898"></a><tt class="py-lineno"> 898</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'$ref'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L899"></a><tt class="py-lineno"> 899</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt>
+<a name="L900"></a><tt class="py-lineno"> 900</tt>  <tt class="py-line">          <tt class="py-op">(</tt><tt class="py-string">'  %s: object, %s%s%s\n    The object takes the'</tt> </tt>
+<a name="L901"></a><tt class="py-lineno"> 901</tt>  <tt class="py-line">          <tt class="py-string">' form of:\n\n%s\n\n'</tt><tt class="py-op">)</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">arg</tt><tt class="py-op">,</tt> <tt class="py-name">paramdoc</tt><tt class="py-op">,</tt> <tt class="py-name">required</tt><tt class="py-op">,</tt> <tt class="py-name">repeated</tt><tt class="py-op">,</tt> </tt>
+<a name="L902"></a><tt class="py-lineno"> 902</tt>  <tt class="py-line">            <tt id="link-243" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-243', 'schema', 'link-50');">schema</a></tt><tt class="py-op">.</tt><tt id="link-244" class="py-name" targets="Method googleapiclient.schema.Schemas.prettyPrintByName()=googleapiclient.schema.Schemas-class.html#prettyPrintByName"><a title="googleapiclient.schema.Schemas.prettyPrintByName" class="py-name" href="#" onclick="return doclink('link-244', 'prettyPrintByName', 'link-244');">prettyPrintByName</a></tt><tt class="py-op">(</tt><tt class="py-name">paramdesc</tt><tt class="py-op">[</tt><tt class="py-string">'$ref'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L903"></a><tt class="py-lineno"> 903</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L904"></a><tt class="py-lineno"> 904</tt>  <tt class="py-line">      <tt class="py-name">paramtype</tt> <tt class="py-op">=</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">.</tt><tt id="link-245" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-238', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'type'</tt><tt class="py-op">,</tt> <tt class="py-string">'string'</tt><tt class="py-op">)</tt> </tt>
-<a name="L900"></a><tt class="py-lineno"> 900</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'  %s: %s, %s%s%s\n'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">arg</tt><tt class="py-op">,</tt> <tt class="py-name">paramtype</tt><tt class="py-op">,</tt> <tt class="py-name">paramdoc</tt><tt class="py-op">,</tt> <tt class="py-name">required</tt><tt class="py-op">,</tt> </tt>
-<a name="L901"></a><tt class="py-lineno"> 901</tt>  <tt class="py-line">                                          <tt class="py-name">repeated</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L902"></a><tt class="py-lineno"> 902</tt>  <tt class="py-line">    <tt class="py-name">enum</tt> <tt class="py-op">=</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">.</tt><tt id="link-239" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-245', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'type'</tt><tt class="py-op">,</tt> <tt class="py-string">'string'</tt><tt class="py-op">)</tt> </tt>
+<a name="L905"></a><tt class="py-lineno"> 905</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'  %s: %s, %s%s%s\n'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">arg</tt><tt class="py-op">,</tt> <tt class="py-name">paramtype</tt><tt class="py-op">,</tt> <tt class="py-name">paramdoc</tt><tt class="py-op">,</tt> <tt class="py-name">required</tt><tt class="py-op">,</tt> </tt>
+<a name="L906"></a><tt class="py-lineno"> 906</tt>  <tt class="py-line">                                          <tt class="py-name">repeated</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L907"></a><tt class="py-lineno"> 907</tt>  <tt class="py-line">    <tt class="py-name">enum</tt> <tt class="py-op">=</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">.</tt><tt id="link-246" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-239', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'enum'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L903"></a><tt class="py-lineno"> 903</tt>  <tt class="py-line">    <tt class="py-name">enumDesc</tt> <tt class="py-op">=</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">.</tt><tt id="link-240" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-246', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'enum'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L908"></a><tt class="py-lineno"> 908</tt>  <tt class="py-line">    <tt class="py-name">enumDesc</tt> <tt class="py-op">=</tt> <tt class="py-name">paramdesc</tt><tt class="py-op">.</tt><tt id="link-247" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-240', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'enumDescriptions'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L904"></a><tt class="py-lineno"> 904</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">enum</tt> <tt class="py-keyword">and</tt> <tt class="py-name">enumDesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L905"></a><tt class="py-lineno"> 905</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'    Allowed values\n'</tt><tt class="py-op">)</tt> </tt>
-<a name="L906"></a><tt class="py-lineno"> 906</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">desc</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">zip</tt><tt class="py-op">(</tt><tt class="py-name">enum</tt><tt class="py-op">,</tt> <tt class="py-name">enumDesc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L907"></a><tt class="py-lineno"> 907</tt>  <tt class="py-line">        <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'      %s - %s\n'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">desc</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L908"></a><tt class="py-lineno"> 908</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-string">'response'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L909"></a><tt class="py-lineno"> 909</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">methodName</tt><tt class="py-op">.</tt><tt class="py-name">endswith</tt><tt class="py-op">(</tt><tt class="py-string">'_media'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L910"></a><tt class="py-lineno"> 910</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'\nReturns:\n  The media object as a string.\n\n    '</tt><tt class="py-op">)</tt> </tt>
-<a name="L911"></a><tt class="py-lineno"> 911</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L912"></a><tt class="py-lineno"> 912</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'\nReturns:\n  An object of the form:\n\n    '</tt><tt class="py-op">)</tt> </tt>
-<a name="L913"></a><tt class="py-lineno"> 913</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-241" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-241', 'schema', 'link-48');">schema</a></tt><tt class="py-op">.</tt><tt id="link-242" class="py-name" targets="Method googleapiclient.schema.Schemas.prettyPrintSchema()=googleapiclient.schema.Schemas-class.html#prettyPrintSchema"><a title="googleapiclient.schema.Schemas.prettyPrintSchema" class="py-name" href="#" onclick="return doclink('link-242', 'prettyPrintSchema', 'link-242');">prettyPrintSchema</a></tt><tt class="py-op">(</tt><tt class="py-name">methodDesc</tt><tt class="py-op">[</tt><tt class="py-string">'response'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L914"></a><tt class="py-lineno"> 914</tt>  <tt class="py-line"> </tt>
-<a name="L915"></a><tt class="py-lineno"> 915</tt>  <tt class="py-line">  <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">method</tt><tt class="py-op">,</tt> <tt class="py-string">'__doc__'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">docs</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L916"></a><tt class="py-lineno"> 916</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L917"></a><tt class="py-lineno"> 917</tt>  <tt class="py-line"> </tt>
-<a name="createNextMethod"></a><div id="createNextMethod-def"><a name="L918"></a><tt class="py-lineno"> 918</tt>  <tt class="py-line"> </tt>
-<a name="L919"></a><tt class="py-lineno"> 919</tt> <a class="py-toggle" href="#" id="createNextMethod-toggle" onclick="return toggle('createNextMethod');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#createNextMethod">createNextMethod</a><tt class="py-op">(</tt><tt class="py-param">methodName</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="createNextMethod-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="createNextMethod-expanded"><a name="L920"></a><tt class="py-lineno"> 920</tt>  <tt class="py-line">  <tt class="py-docstring">"""Creates any _next methods for attaching to a Resource.</tt> </tt>
-<a name="L921"></a><tt class="py-lineno"> 921</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L922"></a><tt class="py-lineno"> 922</tt>  <tt class="py-line"><tt class="py-docstring">  The _next methods allow for easy iteration through list() responses.</tt> </tt>
-<a name="L923"></a><tt class="py-lineno"> 923</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L924"></a><tt class="py-lineno"> 924</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L925"></a><tt class="py-lineno"> 925</tt>  <tt class="py-line"><tt class="py-docstring">    methodName: string, name of the method to use.</tt> </tt>
-<a name="L926"></a><tt class="py-lineno"> 926</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L927"></a><tt class="py-lineno"> 927</tt>  <tt class="py-line">  <tt class="py-name">methodName</tt> <tt class="py-op">=</tt> <tt id="link-243" class="py-name"><a title="googleapiclient.discovery.fix_method_name" class="py-name" href="#" onclick="return doclink('link-243', 'fix_method_name', 'link-175');">fix_method_name</a></tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">)</tt> </tt>
-<a name="L928"></a><tt class="py-lineno"> 928</tt>  <tt class="py-line"> </tt>
-<a name="L929"></a><tt class="py-lineno"> 929</tt>  <tt class="py-line">  <tt class="py-keyword">def</tt> <tt class="py-def-name">methodNext</tt><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">previous_request</tt><tt class="py-op">,</tt> <tt class="py-param">previous_response</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L930"></a><tt class="py-lineno"> 930</tt>  <tt class="py-line">    <tt class="py-docstring">"""Retrieves the next page of results.</tt> </tt>
-<a name="L931"></a><tt class="py-lineno"> 931</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L932"></a><tt class="py-lineno"> 932</tt>  <tt class="py-line"><tt class="py-docstring">Args:</tt> </tt>
-<a name="L933"></a><tt class="py-lineno"> 933</tt>  <tt class="py-line"><tt class="py-docstring">  previous_request: The request for the previous page. (required)</tt> </tt>
-<a name="L934"></a><tt class="py-lineno"> 934</tt>  <tt class="py-line"><tt class="py-docstring">  previous_response: The response from the request for the previous page. (required)</tt> </tt>
-<a name="L935"></a><tt class="py-lineno"> 935</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L936"></a><tt class="py-lineno"> 936</tt>  <tt class="py-line"><tt class="py-docstring">Returns:</tt> </tt>
-<a name="L937"></a><tt class="py-lineno"> 937</tt>  <tt class="py-line"><tt class="py-docstring">  A request object that you can call 'execute()' on to request the next</tt> </tt>
-<a name="L938"></a><tt class="py-lineno"> 938</tt>  <tt class="py-line"><tt class="py-docstring">  page. Returns None if there are no more items in the collection.</tt> </tt>
-<a name="L939"></a><tt class="py-lineno"> 939</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L940"></a><tt class="py-lineno"> 940</tt>  <tt class="py-line">    <tt class="py-comment"># Retrieve nextPageToken from previous_response</tt> </tt>
-<a name="L941"></a><tt class="py-lineno"> 941</tt>  <tt class="py-line">    <tt class="py-comment"># Use as pageToken in previous_request to create new request.</tt> </tt>
-<a name="L942"></a><tt class="py-lineno"> 942</tt>  <tt class="py-line"> </tt>
-<a name="L943"></a><tt class="py-lineno"> 943</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'nextPageToken'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">previous_response</tt> <tt class="py-keyword">or</tt> <tt class="py-keyword">not</tt> <tt class="py-name">previous_response</tt><tt class="py-op">[</tt><tt class="py-string">'nextPageToken'</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt>
-<a name="L944"></a><tt class="py-lineno"> 944</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt>
-<a name="L945"></a><tt class="py-lineno"> 945</tt>  <tt class="py-line"> </tt>
-<a name="L946"></a><tt class="py-lineno"> 946</tt>  <tt class="py-line">    <tt id="link-244" class="py-name"><a title="googleapiclient.http.HttpMock.request
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-247', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'enumDescriptions'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L909"></a><tt class="py-lineno"> 909</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">enum</tt> <tt class="py-keyword">and</tt> <tt class="py-name">enumDesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L910"></a><tt class="py-lineno"> 910</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'    Allowed values\n'</tt><tt class="py-op">)</tt> </tt>
+<a name="L911"></a><tt class="py-lineno"> 911</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">desc</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">zip</tt><tt class="py-op">(</tt><tt class="py-name">enum</tt><tt class="py-op">,</tt> <tt class="py-name">enumDesc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L912"></a><tt class="py-lineno"> 912</tt>  <tt class="py-line">        <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'      %s - %s\n'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">desc</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L913"></a><tt class="py-lineno"> 913</tt>  <tt class="py-line">  <tt class="py-keyword">if</tt> <tt class="py-string">'response'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L914"></a><tt class="py-lineno"> 914</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">methodName</tt><tt class="py-op">.</tt><tt class="py-name">endswith</tt><tt class="py-op">(</tt><tt class="py-string">'_media'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L915"></a><tt class="py-lineno"> 915</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'\nReturns:\n  The media object as a string.\n\n    '</tt><tt class="py-op">)</tt> </tt>
+<a name="L916"></a><tt class="py-lineno"> 916</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L917"></a><tt class="py-lineno"> 917</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'\nReturns:\n  An object of the form:\n\n    '</tt><tt class="py-op">)</tt> </tt>
+<a name="L918"></a><tt class="py-lineno"> 918</tt>  <tt class="py-line">      <tt class="py-name">docs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-248" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-248', 'schema', 'link-50');">schema</a></tt><tt class="py-op">.</tt><tt id="link-249" class="py-name" targets="Method googleapiclient.schema.Schemas.prettyPrintSchema()=googleapiclient.schema.Schemas-class.html#prettyPrintSchema"><a title="googleapiclient.schema.Schemas.prettyPrintSchema" class="py-name" href="#" onclick="return doclink('link-249', 'prettyPrintSchema', 'link-249');">prettyPrintSchema</a></tt><tt class="py-op">(</tt><tt class="py-name">methodDesc</tt><tt class="py-op">[</tt><tt class="py-string">'response'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L919"></a><tt class="py-lineno"> 919</tt>  <tt class="py-line"> </tt>
+<a name="L920"></a><tt class="py-lineno"> 920</tt>  <tt class="py-line">  <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">method</tt><tt class="py-op">,</tt> <tt class="py-string">'__doc__'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">docs</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L921"></a><tt class="py-lineno"> 921</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L922"></a><tt class="py-lineno"> 922</tt>  <tt class="py-line"> </tt>
+<a name="createNextMethod"></a><div id="createNextMethod-def"><a name="L923"></a><tt class="py-lineno"> 923</tt>  <tt class="py-line"> </tt>
+<a name="L924"></a><tt class="py-lineno"> 924</tt> <a class="py-toggle" href="#" id="createNextMethod-toggle" onclick="return toggle('createNextMethod');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery-module.html#createNextMethod">createNextMethod</a><tt class="py-op">(</tt><tt class="py-param">methodName</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="createNextMethod-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="createNextMethod-expanded"><a name="L925"></a><tt class="py-lineno"> 925</tt>  <tt class="py-line">  <tt class="py-docstring">"""Creates any _next methods for attaching to a Resource.</tt> </tt>
+<a name="L926"></a><tt class="py-lineno"> 926</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L927"></a><tt class="py-lineno"> 927</tt>  <tt class="py-line"><tt class="py-docstring">  The _next methods allow for easy iteration through list() responses.</tt> </tt>
+<a name="L928"></a><tt class="py-lineno"> 928</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L929"></a><tt class="py-lineno"> 929</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L930"></a><tt class="py-lineno"> 930</tt>  <tt class="py-line"><tt class="py-docstring">    methodName: string, name of the method to use.</tt> </tt>
+<a name="L931"></a><tt class="py-lineno"> 931</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L932"></a><tt class="py-lineno"> 932</tt>  <tt class="py-line">  <tt class="py-name">methodName</tt> <tt class="py-op">=</tt> <tt id="link-250" class="py-name"><a title="googleapiclient.discovery.fix_method_name" class="py-name" href="#" onclick="return doclink('link-250', 'fix_method_name', 'link-182');">fix_method_name</a></tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">)</tt> </tt>
+<a name="L933"></a><tt class="py-lineno"> 933</tt>  <tt class="py-line"> </tt>
+<a name="L934"></a><tt class="py-lineno"> 934</tt>  <tt class="py-line">  <tt class="py-keyword">def</tt> <tt class="py-def-name">methodNext</tt><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">previous_request</tt><tt class="py-op">,</tt> <tt class="py-param">previous_response</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L935"></a><tt class="py-lineno"> 935</tt>  <tt class="py-line">    <tt class="py-docstring">"""Retrieves the next page of results.</tt> </tt>
+<a name="L936"></a><tt class="py-lineno"> 936</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L937"></a><tt class="py-lineno"> 937</tt>  <tt class="py-line"><tt class="py-docstring">Args:</tt> </tt>
+<a name="L938"></a><tt class="py-lineno"> 938</tt>  <tt class="py-line"><tt class="py-docstring">  previous_request: The request for the previous page. (required)</tt> </tt>
+<a name="L939"></a><tt class="py-lineno"> 939</tt>  <tt class="py-line"><tt class="py-docstring">  previous_response: The response from the request for the previous page. (required)</tt> </tt>
+<a name="L940"></a><tt class="py-lineno"> 940</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L941"></a><tt class="py-lineno"> 941</tt>  <tt class="py-line"><tt class="py-docstring">Returns:</tt> </tt>
+<a name="L942"></a><tt class="py-lineno"> 942</tt>  <tt class="py-line"><tt class="py-docstring">  A request object that you can call 'execute()' on to request the next</tt> </tt>
+<a name="L943"></a><tt class="py-lineno"> 943</tt>  <tt class="py-line"><tt class="py-docstring">  page. Returns None if there are no more items in the collection.</tt> </tt>
+<a name="L944"></a><tt class="py-lineno"> 944</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L945"></a><tt class="py-lineno"> 945</tt>  <tt class="py-line">    <tt class="py-comment"># Retrieve nextPageToken from previous_response</tt> </tt>
+<a name="L946"></a><tt class="py-lineno"> 946</tt>  <tt class="py-line">    <tt class="py-comment"># Use as pageToken in previous_request to create new request.</tt> </tt>
+<a name="L947"></a><tt class="py-lineno"> 947</tt>  <tt class="py-line"> </tt>
+<a name="L948"></a><tt class="py-lineno"> 948</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'nextPageToken'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">previous_response</tt> <tt class="py-keyword">or</tt> <tt class="py-keyword">not</tt> <tt class="py-name">previous_response</tt><tt class="py-op">[</tt><tt class="py-string">'nextPageToken'</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt>
+<a name="L949"></a><tt class="py-lineno"> 949</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt>
+<a name="L950"></a><tt class="py-lineno"> 950</tt>  <tt class="py-line"> </tt>
+<a name="L951"></a><tt class="py-lineno"> 951</tt>  <tt class="py-line">    <tt id="link-251" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
-googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-244', 'request', 'link-96');">request</a></tt> <tt class="py-op">=</tt> <tt class="py-name">copy</tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-name">previous_request</tt><tt class="py-op">)</tt> </tt>
-<a name="L947"></a><tt class="py-lineno"> 947</tt>  <tt class="py-line"> </tt>
-<a name="L948"></a><tt class="py-lineno"> 948</tt>  <tt class="py-line">    <tt class="py-name">pageToken</tt> <tt class="py-op">=</tt> <tt class="py-name">previous_response</tt><tt class="py-op">[</tt><tt class="py-string">'nextPageToken'</tt><tt class="py-op">]</tt> </tt>
-<a name="L949"></a><tt class="py-lineno"> 949</tt>  <tt class="py-line">    <tt class="py-name">parsed</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">urlparse</tt><tt class="py-op">(</tt><tt id="link-245" class="py-name"><a title="googleapiclient.http.HttpMock.request
+googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-251', 'request', 'link-97');">request</a></tt> <tt class="py-op">=</tt> <tt class="py-name">copy</tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-name">previous_request</tt><tt class="py-op">)</tt> </tt>
+<a name="L952"></a><tt class="py-lineno"> 952</tt>  <tt class="py-line"> </tt>
+<a name="L953"></a><tt class="py-lineno"> 953</tt>  <tt class="py-line">    <tt class="py-name">pageToken</tt> <tt class="py-op">=</tt> <tt class="py-name">previous_response</tt><tt class="py-op">[</tt><tt class="py-string">'nextPageToken'</tt><tt class="py-op">]</tt> </tt>
+<a name="L954"></a><tt class="py-lineno"> 954</tt>  <tt class="py-line">    <tt class="py-name">parsed</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">urlparse</tt><tt class="py-op">(</tt><tt id="link-252" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
-googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-245', 'request', 'link-96');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">uri</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L950"></a><tt class="py-lineno"> 950</tt>  <tt class="py-line">    <tt class="py-name">q</tt> <tt class="py-op">=</tt> <tt class="py-name">parse_qsl</tt><tt class="py-op">(</tt><tt class="py-name">parsed</tt><tt class="py-op">[</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L951"></a><tt class="py-lineno"> 951</tt>  <tt class="py-line"> </tt>
-<a name="L952"></a><tt class="py-lineno"> 952</tt>  <tt class="py-line">    <tt class="py-comment"># Find and remove old 'pageToken' value from URI</tt> </tt>
-<a name="L953"></a><tt class="py-lineno"> 953</tt>  <tt class="py-line">    <tt class="py-name">newq</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">q</tt> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-op">!=</tt> <tt class="py-string">'pageToken'</tt><tt class="py-op">]</tt> </tt>
-<a name="L954"></a><tt class="py-lineno"> 954</tt>  <tt class="py-line">    <tt class="py-name">newq</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-string">'pageToken'</tt><tt class="py-op">,</tt> <tt class="py-name">pageToken</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L955"></a><tt class="py-lineno"> 955</tt>  <tt class="py-line">    <tt class="py-name">parsed</tt><tt class="py-op">[</tt><tt class="py-number">4</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">urlencode</tt><tt class="py-op">(</tt><tt class="py-name">newq</tt><tt class="py-op">)</tt> </tt>
-<a name="L956"></a><tt class="py-lineno"> 956</tt>  <tt class="py-line">    <tt class="py-name">uri</tt> <tt class="py-op">=</tt> <tt class="py-name">urlunparse</tt><tt class="py-op">(</tt><tt class="py-name">parsed</tt><tt class="py-op">)</tt> </tt>
-<a name="L957"></a><tt class="py-lineno"> 957</tt>  <tt class="py-line"> </tt>
-<a name="L958"></a><tt class="py-lineno"> 958</tt>  <tt class="py-line">    <tt id="link-246" class="py-name"><a title="googleapiclient.http.HttpMock.request
+googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-252', 'request', 'link-97');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">uri</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L955"></a><tt class="py-lineno"> 955</tt>  <tt class="py-line">    <tt class="py-name">q</tt> <tt class="py-op">=</tt> <tt class="py-name">parse_qsl</tt><tt class="py-op">(</tt><tt class="py-name">parsed</tt><tt class="py-op">[</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L956"></a><tt class="py-lineno"> 956</tt>  <tt class="py-line"> </tt>
+<a name="L957"></a><tt class="py-lineno"> 957</tt>  <tt class="py-line">    <tt class="py-comment"># Find and remove old 'pageToken' value from URI</tt> </tt>
+<a name="L958"></a><tt class="py-lineno"> 958</tt>  <tt class="py-line">    <tt class="py-name">newq</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">q</tt> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-op">!=</tt> <tt class="py-string">'pageToken'</tt><tt class="py-op">]</tt> </tt>
+<a name="L959"></a><tt class="py-lineno"> 959</tt>  <tt class="py-line">    <tt class="py-name">newq</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-string">'pageToken'</tt><tt class="py-op">,</tt> <tt class="py-name">pageToken</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L960"></a><tt class="py-lineno"> 960</tt>  <tt class="py-line">    <tt class="py-name">parsed</tt><tt class="py-op">[</tt><tt class="py-number">4</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">urlencode</tt><tt class="py-op">(</tt><tt class="py-name">newq</tt><tt class="py-op">)</tt> </tt>
+<a name="L961"></a><tt class="py-lineno"> 961</tt>  <tt class="py-line">    <tt class="py-name">uri</tt> <tt class="py-op">=</tt> <tt class="py-name">urlunparse</tt><tt class="py-op">(</tt><tt class="py-name">parsed</tt><tt class="py-op">)</tt> </tt>
+<a name="L962"></a><tt class="py-lineno"> 962</tt>  <tt class="py-line"> </tt>
+<a name="L963"></a><tt class="py-lineno"> 963</tt>  <tt class="py-line">    <tt id="link-253" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
-googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-246', 'request', 'link-96');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">uri</tt> <tt class="py-op">=</tt> <tt class="py-name">uri</tt> </tt>
-<a name="L959"></a><tt class="py-lineno"> 959</tt>  <tt class="py-line"> </tt>
-<a name="L960"></a><tt class="py-lineno"> 960</tt>  <tt class="py-line">    <tt id="link-247" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-247', 'logger', 'link-50');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">info</tt><tt class="py-op">(</tt><tt class="py-string">'URL being requested: %s %s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt><tt class="py-name">uri</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L961"></a><tt class="py-lineno"> 961</tt>  <tt class="py-line"> </tt>
-<a name="L962"></a><tt class="py-lineno"> 962</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt id="link-248" class="py-name"><a title="googleapiclient.http.HttpMock.request
+googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-253', 'request', 'link-97');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">uri</tt> <tt class="py-op">=</tt> <tt class="py-name">uri</tt> </tt>
+<a name="L964"></a><tt class="py-lineno"> 964</tt>  <tt class="py-line"> </tt>
+<a name="L965"></a><tt class="py-lineno"> 965</tt>  <tt class="py-line">    <tt id="link-254" class="py-name"><a title="googleapiclient.discovery.logger" class="py-name" href="#" onclick="return doclink('link-254', 'logger', 'link-52');">logger</a></tt><tt class="py-op">.</tt><tt class="py-name">info</tt><tt class="py-op">(</tt><tt class="py-string">'URL being requested: %s %s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt><tt class="py-name">uri</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L966"></a><tt class="py-lineno"> 966</tt>  <tt class="py-line"> </tt>
+<a name="L967"></a><tt class="py-lineno"> 967</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt id="link-255" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
-googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-248', 'request', 'link-96');">request</a></tt> </tt>
-</div><a name="L963"></a><tt class="py-lineno"> 963</tt>  <tt class="py-line"> </tt>
-<a name="L964"></a><tt class="py-lineno"> 964</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodNext</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L965"></a><tt class="py-lineno"> 965</tt>  <tt class="py-line"> </tt>
-<a name="Resource"></a><div id="Resource-def"><a name="L966"></a><tt class="py-lineno"> 966</tt>  <tt class="py-line"> </tt>
-<a name="L967"></a><tt class="py-lineno"> 967</tt> <a class="py-toggle" href="#" id="Resource-toggle" onclick="return toggle('Resource');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html">Resource</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="Resource-expanded"><a name="L968"></a><tt class="py-lineno"> 968</tt>  <tt class="py-line">  <tt class="py-docstring">"""A class for interacting with a resource."""</tt> </tt>
-<a name="L969"></a><tt class="py-lineno"> 969</tt>  <tt class="py-line"> </tt>
-<a name="Resource.__init__"></a><div id="Resource.__init__-def"><a name="L970"></a><tt class="py-lineno"> 970</tt> <a class="py-toggle" href="#" id="Resource.__init__-toggle" onclick="return toggle('Resource.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">baseUrl</tt><tt class="py-op">,</tt> <tt class="py-param">model</tt><tt class="py-op">,</tt> <tt class="py-param">requestBuilder</tt><tt class="py-op">,</tt> <tt class="py-param">developerKey</tt><tt class="py-op">,</tt> </tt>
-<a name="L971"></a><tt class="py-lineno"> 971</tt>  <tt class="py-line">               <tt class="py-param">resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-param">rootDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource.__init__-expanded"><a name="L972"></a><tt class="py-lineno"> 972</tt>  <tt class="py-line">    <tt class="py-docstring">"""Build a Resource from the API description.</tt> </tt>
-<a name="L973"></a><tt class="py-lineno"> 973</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L974"></a><tt class="py-lineno"> 974</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L975"></a><tt class="py-lineno"> 975</tt>  <tt class="py-line"><tt class="py-docstring">      http: httplib2.Http, Object to make http requests with.</tt> </tt>
-<a name="L976"></a><tt class="py-lineno"> 976</tt>  <tt class="py-line"><tt class="py-docstring">      baseUrl: string, base URL for the API. All requests are relative to this</tt> </tt>
-<a name="L977"></a><tt class="py-lineno"> 977</tt>  <tt class="py-line"><tt class="py-docstring">          URI.</tt> </tt>
-<a name="L978"></a><tt class="py-lineno"> 978</tt>  <tt class="py-line"><tt class="py-docstring">      model: googleapiclient.Model, converts to and from the wire format.</tt> </tt>
-<a name="L979"></a><tt class="py-lineno"> 979</tt>  <tt class="py-line"><tt class="py-docstring">      requestBuilder: class or callable that instantiates an</tt> </tt>
-<a name="L980"></a><tt class="py-lineno"> 980</tt>  <tt class="py-line"><tt class="py-docstring">          googleapiclient.HttpRequest object.</tt> </tt>
-<a name="L981"></a><tt class="py-lineno"> 981</tt>  <tt class="py-line"><tt class="py-docstring">      developerKey: string, key obtained from</tt> </tt>
-<a name="L982"></a><tt class="py-lineno"> 982</tt>  <tt class="py-line"><tt class="py-docstring">          https://code.google.com/apis/console</tt> </tt>
-<a name="L983"></a><tt class="py-lineno"> 983</tt>  <tt class="py-line"><tt class="py-docstring">      resourceDesc: object, section of deserialized discovery document that</tt> </tt>
-<a name="L984"></a><tt class="py-lineno"> 984</tt>  <tt class="py-line"><tt class="py-docstring">          describes a resource. Note that the top level discovery document</tt> </tt>
-<a name="L985"></a><tt class="py-lineno"> 985</tt>  <tt class="py-line"><tt class="py-docstring">          is considered a resource.</tt> </tt>
-<a name="L986"></a><tt class="py-lineno"> 986</tt>  <tt class="py-line"><tt class="py-docstring">      rootDesc: object, the entire deserialized discovery document.</tt> </tt>
-<a name="L987"></a><tt class="py-lineno"> 987</tt>  <tt class="py-line"><tt class="py-docstring">      schema: object, mapping of schema names to schema descriptions.</tt> </tt>
-<a name="L988"></a><tt class="py-lineno"> 988</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L989"></a><tt class="py-lineno"> 989</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_dynamic_attrs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
-<a name="L990"></a><tt class="py-lineno"> 990</tt>  <tt class="py-line"> </tt>
-<a name="L991"></a><tt class="py-lineno"> 991</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_http</tt> <tt class="py-op">=</tt> <tt id="link-249" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-249', 'http', 'link-21');">http</a></tt> </tt>
-<a name="L992"></a><tt class="py-lineno"> 992</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_baseUrl</tt> <tt class="py-op">=</tt> <tt class="py-name">baseUrl</tt> </tt>
-<a name="L993"></a><tt class="py-lineno"> 993</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_model</tt> <tt class="py-op">=</tt> <tt id="link-250" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-250', 'model', 'link-39');">model</a></tt> </tt>
-<a name="L994"></a><tt class="py-lineno"> 994</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_developerKey</tt> <tt class="py-op">=</tt> <tt class="py-name">developerKey</tt> </tt>
-<a name="L995"></a><tt class="py-lineno"> 995</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requestBuilder</tt> <tt class="py-op">=</tt> <tt class="py-name">requestBuilder</tt> </tt>
-<a name="L996"></a><tt class="py-lineno"> 996</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_resourceDesc</tt> <tt class="py-op">=</tt> <tt class="py-name">resourceDesc</tt> </tt>
-<a name="L997"></a><tt class="py-lineno"> 997</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_rootDesc</tt> <tt class="py-op">=</tt> <tt class="py-name">rootDesc</tt> </tt>
-<a name="L998"></a><tt class="py-lineno"> 998</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_schema</tt> <tt class="py-op">=</tt> <tt id="link-251" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-251', 'schema', 'link-48');">schema</a></tt> </tt>
-<a name="L999"></a><tt class="py-lineno"> 999</tt>  <tt class="py-line"> </tt>
-<a name="L1000"></a><tt class="py-lineno">1000</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-252" class="py-name" targets="Method googleapiclient.discovery.Resource._set_service_methods()=googleapiclient.discovery.Resource-class.html#_set_service_methods"><a title="googleapiclient.discovery.Resource._set_service_methods" class="py-name" href="#" onclick="return doclink('link-252', '_set_service_methods', 'link-252');">_set_service_methods</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1001"></a><tt class="py-lineno">1001</tt>  <tt class="py-line"> </tt>
-<a name="Resource._set_dynamic_attr"></a><div id="Resource._set_dynamic_attr-def"><a name="L1002"></a><tt class="py-lineno">1002</tt> <a class="py-toggle" href="#" id="Resource._set_dynamic_attr-toggle" onclick="return toggle('Resource._set_dynamic_attr');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_set_dynamic_attr">_set_dynamic_attr</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">attr_name</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource._set_dynamic_attr-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._set_dynamic_attr-expanded"><a name="L1003"></a><tt class="py-lineno">1003</tt>  <tt class="py-line">    <tt class="py-docstring">"""Sets an instance attribute and tracks it in a list of dynamic attributes.</tt> </tt>
-<a name="L1004"></a><tt class="py-lineno">1004</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1005"></a><tt class="py-lineno">1005</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1006"></a><tt class="py-lineno">1006</tt>  <tt class="py-line"><tt class="py-docstring">      attr_name: string; The name of the attribute to be set</tt> </tt>
-<a name="L1007"></a><tt class="py-lineno">1007</tt>  <tt class="py-line"><tt class="py-docstring">      value: The value being set on the object and tracked in the dynamic cache.</tt> </tt>
-<a name="L1008"></a><tt class="py-lineno">1008</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1009"></a><tt class="py-lineno">1009</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_dynamic_attrs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">attr_name</tt><tt class="py-op">)</tt> </tt>
-<a name="L1010"></a><tt class="py-lineno">1010</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-name">attr_name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt> </tt>
-</div><a name="L1011"></a><tt class="py-lineno">1011</tt>  <tt class="py-line"> </tt>
-<a name="Resource.__getstate__"></a><div id="Resource.__getstate__-def"><a name="L1012"></a><tt class="py-lineno">1012</tt> <a class="py-toggle" href="#" id="Resource.__getstate__-toggle" onclick="return toggle('Resource.__getstate__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#__getstate__">__getstate__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource.__getstate__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource.__getstate__-expanded"><a name="L1013"></a><tt class="py-lineno">1013</tt>  <tt class="py-line">    <tt class="py-docstring">"""Trim the state down to something that can be pickled.</tt> </tt>
-<a name="L1014"></a><tt class="py-lineno">1014</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1015"></a><tt class="py-lineno">1015</tt>  <tt class="py-line"><tt class="py-docstring">    Uses the fact that the instance variable _dynamic_attrs holds attrs that</tt> </tt>
-<a name="L1016"></a><tt class="py-lineno">1016</tt>  <tt class="py-line"><tt class="py-docstring">    will be wiped and restored on pickle serialization.</tt> </tt>
-<a name="L1017"></a><tt class="py-lineno">1017</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1018"></a><tt class="py-lineno">1018</tt>  <tt class="py-line">    <tt class="py-name">state_dict</tt> <tt class="py-op">=</tt> <tt class="py-name">copy</tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">)</tt> </tt>
-<a name="L1019"></a><tt class="py-lineno">1019</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">dynamic_attr</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_dynamic_attrs</tt><tt class="py-op">:</tt> </tt>
-<a name="L1020"></a><tt class="py-lineno">1020</tt>  <tt class="py-line">      <tt class="py-keyword">del</tt> <tt class="py-name">state_dict</tt><tt class="py-op">[</tt><tt class="py-name">dynamic_attr</tt><tt class="py-op">]</tt> </tt>
-<a name="L1021"></a><tt class="py-lineno">1021</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">state_dict</tt><tt class="py-op">[</tt><tt class="py-string">'_dynamic_attrs'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1022"></a><tt class="py-lineno">1022</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">state_dict</tt> </tt>
-</div><a name="L1023"></a><tt class="py-lineno">1023</tt>  <tt class="py-line"> </tt>
-<a name="Resource.__setstate__"></a><div id="Resource.__setstate__-def"><a name="L1024"></a><tt class="py-lineno">1024</tt> <a class="py-toggle" href="#" id="Resource.__setstate__-toggle" onclick="return toggle('Resource.__setstate__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#__setstate__">__setstate__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">state</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource.__setstate__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource.__setstate__-expanded"><a name="L1025"></a><tt class="py-lineno">1025</tt>  <tt class="py-line">    <tt class="py-docstring">"""Reconstitute the state of the object from being pickled.</tt> </tt>
-<a name="L1026"></a><tt class="py-lineno">1026</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1027"></a><tt class="py-lineno">1027</tt>  <tt class="py-line"><tt class="py-docstring">    Uses the fact that the instance variable _dynamic_attrs holds attrs that</tt> </tt>
-<a name="L1028"></a><tt class="py-lineno">1028</tt>  <tt class="py-line"><tt class="py-docstring">    will be wiped and restored on pickle serialization.</tt> </tt>
-<a name="L1029"></a><tt class="py-lineno">1029</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1030"></a><tt class="py-lineno">1030</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">.</tt><tt id="link-253" class="py-name"><a title="googleapiclient.channel.Channel.update" class="py-name" href="#" onclick="return doclink('link-253', 'update', 'link-140');">update</a></tt><tt class="py-op">(</tt><tt class="py-name">state</tt><tt class="py-op">)</tt> </tt>
-<a name="L1031"></a><tt class="py-lineno">1031</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_dynamic_attrs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
-<a name="L1032"></a><tt class="py-lineno">1032</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-254" class="py-name"><a title="googleapiclient.discovery.Resource._set_service_methods" class="py-name" href="#" onclick="return doclink('link-254', '_set_service_methods', 'link-252');">_set_service_methods</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1033"></a><tt class="py-lineno">1033</tt>  <tt class="py-line"> </tt>
-<a name="Resource._set_service_methods"></a><div id="Resource._set_service_methods-def"><a name="L1034"></a><tt class="py-lineno">1034</tt> <a class="py-toggle" href="#" id="Resource._set_service_methods-toggle" onclick="return toggle('Resource._set_service_methods');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_set_service_methods">_set_service_methods</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource._set_service_methods-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._set_service_methods-expanded"><a name="L1035"></a><tt class="py-lineno">1035</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-255" class="py-name" targets="Method googleapiclient.discovery.Resource._add_basic_methods()=googleapiclient.discovery.Resource-class.html#_add_basic_methods"><a title="googleapiclient.discovery.Resource._add_basic_methods" class="py-name" href="#" onclick="return doclink('link-255', '_add_basic_methods', 'link-255');">_add_basic_methods</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_rootDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_schema</tt><tt class="py-op">)</tt> </tt>
-<a name="L1036"></a><tt class="py-lineno">1036</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-256" class="py-name" targets="Method googleapiclient.discovery.Resource._add_nested_resources()=googleapiclient.discovery.Resource-class.html#_add_nested_resources"><a title="googleapiclient.discovery.Resource._add_nested_resources" class="py-name" href="#" onclick="return doclink('link-256', '_add_nested_resources', 'link-256');">_add_nested_resources</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_rootDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_schema</tt><tt class="py-op">)</tt> </tt>
-<a name="L1037"></a><tt class="py-lineno">1037</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-257" class="py-name" targets="Method googleapiclient.discovery.Resource._add_next_methods()=googleapiclient.discovery.Resource-class.html#_add_next_methods"><a title="googleapiclient.discovery.Resource._add_next_methods" class="py-name" href="#" onclick="return doclink('link-257', '_add_next_methods', 'link-257');">_add_next_methods</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_schema</tt><tt class="py-op">)</tt> </tt>
+googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-255', 'request', 'link-97');">request</a></tt> </tt>
+</div><a name="L968"></a><tt class="py-lineno"> 968</tt>  <tt class="py-line"> </tt>
+<a name="L969"></a><tt class="py-lineno"> 969</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodNext</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L970"></a><tt class="py-lineno"> 970</tt>  <tt class="py-line"> </tt>
+<a name="Resource"></a><div id="Resource-def"><a name="L971"></a><tt class="py-lineno"> 971</tt>  <tt class="py-line"> </tt>
+<a name="L972"></a><tt class="py-lineno"> 972</tt> <a class="py-toggle" href="#" id="Resource-toggle" onclick="return toggle('Resource');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html">Resource</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="Resource-expanded"><a name="L973"></a><tt class="py-lineno"> 973</tt>  <tt class="py-line">  <tt class="py-docstring">"""A class for interacting with a resource."""</tt> </tt>
+<a name="L974"></a><tt class="py-lineno"> 974</tt>  <tt class="py-line"> </tt>
+<a name="Resource.__init__"></a><div id="Resource.__init__-def"><a name="L975"></a><tt class="py-lineno"> 975</tt> <a class="py-toggle" href="#" id="Resource.__init__-toggle" onclick="return toggle('Resource.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">baseUrl</tt><tt class="py-op">,</tt> <tt class="py-param">model</tt><tt class="py-op">,</tt> <tt class="py-param">requestBuilder</tt><tt class="py-op">,</tt> <tt class="py-param">developerKey</tt><tt class="py-op">,</tt> </tt>
+<a name="L976"></a><tt class="py-lineno"> 976</tt>  <tt class="py-line">               <tt class="py-param">resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-param">rootDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource.__init__-expanded"><a name="L977"></a><tt class="py-lineno"> 977</tt>  <tt class="py-line">    <tt class="py-docstring">"""Build a Resource from the API description.</tt> </tt>
+<a name="L978"></a><tt class="py-lineno"> 978</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L979"></a><tt class="py-lineno"> 979</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L980"></a><tt class="py-lineno"> 980</tt>  <tt class="py-line"><tt class="py-docstring">      http: httplib2.Http, Object to make http requests with.</tt> </tt>
+<a name="L981"></a><tt class="py-lineno"> 981</tt>  <tt class="py-line"><tt class="py-docstring">      baseUrl: string, base URL for the API. All requests are relative to this</tt> </tt>
+<a name="L982"></a><tt class="py-lineno"> 982</tt>  <tt class="py-line"><tt class="py-docstring">          URI.</tt> </tt>
+<a name="L983"></a><tt class="py-lineno"> 983</tt>  <tt class="py-line"><tt class="py-docstring">      model: googleapiclient.Model, converts to and from the wire format.</tt> </tt>
+<a name="L984"></a><tt class="py-lineno"> 984</tt>  <tt class="py-line"><tt class="py-docstring">      requestBuilder: class or callable that instantiates an</tt> </tt>
+<a name="L985"></a><tt class="py-lineno"> 985</tt>  <tt class="py-line"><tt class="py-docstring">          googleapiclient.HttpRequest object.</tt> </tt>
+<a name="L986"></a><tt class="py-lineno"> 986</tt>  <tt class="py-line"><tt class="py-docstring">      developerKey: string, key obtained from</tt> </tt>
+<a name="L987"></a><tt class="py-lineno"> 987</tt>  <tt class="py-line"><tt class="py-docstring">          https://code.google.com/apis/console</tt> </tt>
+<a name="L988"></a><tt class="py-lineno"> 988</tt>  <tt class="py-line"><tt class="py-docstring">      resourceDesc: object, section of deserialized discovery document that</tt> </tt>
+<a name="L989"></a><tt class="py-lineno"> 989</tt>  <tt class="py-line"><tt class="py-docstring">          describes a resource. Note that the top level discovery document</tt> </tt>
+<a name="L990"></a><tt class="py-lineno"> 990</tt>  <tt class="py-line"><tt class="py-docstring">          is considered a resource.</tt> </tt>
+<a name="L991"></a><tt class="py-lineno"> 991</tt>  <tt class="py-line"><tt class="py-docstring">      rootDesc: object, the entire deserialized discovery document.</tt> </tt>
+<a name="L992"></a><tt class="py-lineno"> 992</tt>  <tt class="py-line"><tt class="py-docstring">      schema: object, mapping of schema names to schema descriptions.</tt> </tt>
+<a name="L993"></a><tt class="py-lineno"> 993</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L994"></a><tt class="py-lineno"> 994</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_dynamic_attrs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+<a name="L995"></a><tt class="py-lineno"> 995</tt>  <tt class="py-line"> </tt>
+<a name="L996"></a><tt class="py-lineno"> 996</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_http</tt> <tt class="py-op">=</tt> <tt id="link-256" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-256', 'http', 'link-23');">http</a></tt> </tt>
+<a name="L997"></a><tt class="py-lineno"> 997</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_baseUrl</tt> <tt class="py-op">=</tt> <tt class="py-name">baseUrl</tt> </tt>
+<a name="L998"></a><tt class="py-lineno"> 998</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_model</tt> <tt class="py-op">=</tt> <tt id="link-257" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-257', 'model', 'link-41');">model</a></tt> </tt>
+<a name="L999"></a><tt class="py-lineno"> 999</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_developerKey</tt> <tt class="py-op">=</tt> <tt class="py-name">developerKey</tt> </tt>
+<a name="L1000"></a><tt class="py-lineno">1000</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requestBuilder</tt> <tt class="py-op">=</tt> <tt class="py-name">requestBuilder</tt> </tt>
+<a name="L1001"></a><tt class="py-lineno">1001</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_resourceDesc</tt> <tt class="py-op">=</tt> <tt class="py-name">resourceDesc</tt> </tt>
+<a name="L1002"></a><tt class="py-lineno">1002</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_rootDesc</tt> <tt class="py-op">=</tt> <tt class="py-name">rootDesc</tt> </tt>
+<a name="L1003"></a><tt class="py-lineno">1003</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_schema</tt> <tt class="py-op">=</tt> <tt id="link-258" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-258', 'schema', 'link-50');">schema</a></tt> </tt>
+<a name="L1004"></a><tt class="py-lineno">1004</tt>  <tt class="py-line"> </tt>
+<a name="L1005"></a><tt class="py-lineno">1005</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-259" class="py-name" targets="Method googleapiclient.discovery.Resource._set_service_methods()=googleapiclient.discovery.Resource-class.html#_set_service_methods"><a title="googleapiclient.discovery.Resource._set_service_methods" class="py-name" href="#" onclick="return doclink('link-259', '_set_service_methods', 'link-259');">_set_service_methods</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1006"></a><tt class="py-lineno">1006</tt>  <tt class="py-line"> </tt>
+<a name="Resource._set_dynamic_attr"></a><div id="Resource._set_dynamic_attr-def"><a name="L1007"></a><tt class="py-lineno">1007</tt> <a class="py-toggle" href="#" id="Resource._set_dynamic_attr-toggle" onclick="return toggle('Resource._set_dynamic_attr');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_set_dynamic_attr">_set_dynamic_attr</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">attr_name</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource._set_dynamic_attr-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._set_dynamic_attr-expanded"><a name="L1008"></a><tt class="py-lineno">1008</tt>  <tt class="py-line">    <tt class="py-docstring">"""Sets an instance attribute and tracks it in a list of dynamic attributes.</tt> </tt>
+<a name="L1009"></a><tt class="py-lineno">1009</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1010"></a><tt class="py-lineno">1010</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1011"></a><tt class="py-lineno">1011</tt>  <tt class="py-line"><tt class="py-docstring">      attr_name: string; The name of the attribute to be set</tt> </tt>
+<a name="L1012"></a><tt class="py-lineno">1012</tt>  <tt class="py-line"><tt class="py-docstring">      value: The value being set on the object and tracked in the dynamic cache.</tt> </tt>
+<a name="L1013"></a><tt class="py-lineno">1013</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1014"></a><tt class="py-lineno">1014</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_dynamic_attrs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">attr_name</tt><tt class="py-op">)</tt> </tt>
+<a name="L1015"></a><tt class="py-lineno">1015</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-name">attr_name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt> </tt>
+</div><a name="L1016"></a><tt class="py-lineno">1016</tt>  <tt class="py-line"> </tt>
+<a name="Resource.__getstate__"></a><div id="Resource.__getstate__-def"><a name="L1017"></a><tt class="py-lineno">1017</tt> <a class="py-toggle" href="#" id="Resource.__getstate__-toggle" onclick="return toggle('Resource.__getstate__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#__getstate__">__getstate__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource.__getstate__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource.__getstate__-expanded"><a name="L1018"></a><tt class="py-lineno">1018</tt>  <tt class="py-line">    <tt class="py-docstring">"""Trim the state down to something that can be pickled.</tt> </tt>
+<a name="L1019"></a><tt class="py-lineno">1019</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1020"></a><tt class="py-lineno">1020</tt>  <tt class="py-line"><tt class="py-docstring">    Uses the fact that the instance variable _dynamic_attrs holds attrs that</tt> </tt>
+<a name="L1021"></a><tt class="py-lineno">1021</tt>  <tt class="py-line"><tt class="py-docstring">    will be wiped and restored on pickle serialization.</tt> </tt>
+<a name="L1022"></a><tt class="py-lineno">1022</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1023"></a><tt class="py-lineno">1023</tt>  <tt class="py-line">    <tt class="py-name">state_dict</tt> <tt class="py-op">=</tt> <tt class="py-name">copy</tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">)</tt> </tt>
+<a name="L1024"></a><tt class="py-lineno">1024</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">dynamic_attr</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_dynamic_attrs</tt><tt class="py-op">:</tt> </tt>
+<a name="L1025"></a><tt class="py-lineno">1025</tt>  <tt class="py-line">      <tt class="py-keyword">del</tt> <tt class="py-name">state_dict</tt><tt class="py-op">[</tt><tt class="py-name">dynamic_attr</tt><tt class="py-op">]</tt> </tt>
+<a name="L1026"></a><tt class="py-lineno">1026</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">state_dict</tt><tt class="py-op">[</tt><tt class="py-string">'_dynamic_attrs'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1027"></a><tt class="py-lineno">1027</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">state_dict</tt> </tt>
+</div><a name="L1028"></a><tt class="py-lineno">1028</tt>  <tt class="py-line"> </tt>
+<a name="Resource.__setstate__"></a><div id="Resource.__setstate__-def"><a name="L1029"></a><tt class="py-lineno">1029</tt> <a class="py-toggle" href="#" id="Resource.__setstate__-toggle" onclick="return toggle('Resource.__setstate__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#__setstate__">__setstate__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">state</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource.__setstate__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource.__setstate__-expanded"><a name="L1030"></a><tt class="py-lineno">1030</tt>  <tt class="py-line">    <tt class="py-docstring">"""Reconstitute the state of the object from being pickled.</tt> </tt>
+<a name="L1031"></a><tt class="py-lineno">1031</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1032"></a><tt class="py-lineno">1032</tt>  <tt class="py-line"><tt class="py-docstring">    Uses the fact that the instance variable _dynamic_attrs holds attrs that</tt> </tt>
+<a name="L1033"></a><tt class="py-lineno">1033</tt>  <tt class="py-line"><tt class="py-docstring">    will be wiped and restored on pickle serialization.</tt> </tt>
+<a name="L1034"></a><tt class="py-lineno">1034</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1035"></a><tt class="py-lineno">1035</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">.</tt><tt id="link-260" class="py-name"><a title="googleapiclient.channel.Channel.update" class="py-name" href="#" onclick="return doclink('link-260', 'update', 'link-147');">update</a></tt><tt class="py-op">(</tt><tt class="py-name">state</tt><tt class="py-op">)</tt> </tt>
+<a name="L1036"></a><tt class="py-lineno">1036</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_dynamic_attrs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+<a name="L1037"></a><tt class="py-lineno">1037</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-261" class="py-name"><a title="googleapiclient.discovery.Resource._set_service_methods" class="py-name" href="#" onclick="return doclink('link-261', '_set_service_methods', 'link-259');">_set_service_methods</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
 </div><a name="L1038"></a><tt class="py-lineno">1038</tt>  <tt class="py-line"> </tt>
-<a name="Resource._add_basic_methods"></a><div id="Resource._add_basic_methods-def"><a name="L1039"></a><tt class="py-lineno">1039</tt> <a class="py-toggle" href="#" id="Resource._add_basic_methods-toggle" onclick="return toggle('Resource._add_basic_methods');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_add_basic_methods">_add_basic_methods</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-param">rootDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource._add_basic_methods-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._add_basic_methods-expanded"><a name="L1040"></a><tt class="py-lineno">1040</tt>  <tt class="py-line">    <tt class="py-comment"># If this is the root Resource, add a new_batch_http_request() method.</tt> </tt>
-<a name="L1041"></a><tt class="py-lineno">1041</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">resourceDesc</tt> <tt class="py-op">==</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L1042"></a><tt class="py-lineno">1042</tt>  <tt class="py-line">      <tt class="py-name">batch_uri</tt> <tt class="py-op">=</tt> <tt class="py-string">'%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt> </tt>
-<a name="L1043"></a><tt class="py-lineno">1043</tt>  <tt class="py-line">        <tt class="py-name">rootDesc</tt><tt class="py-op">[</tt><tt class="py-string">'rootUrl'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">.</tt><tt id="link-258" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="Resource._set_service_methods"></a><div id="Resource._set_service_methods-def"><a name="L1039"></a><tt class="py-lineno">1039</tt> <a class="py-toggle" href="#" id="Resource._set_service_methods-toggle" onclick="return toggle('Resource._set_service_methods');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_set_service_methods">_set_service_methods</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource._set_service_methods-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._set_service_methods-expanded"><a name="L1040"></a><tt class="py-lineno">1040</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-262" class="py-name" targets="Method googleapiclient.discovery.Resource._add_basic_methods()=googleapiclient.discovery.Resource-class.html#_add_basic_methods"><a title="googleapiclient.discovery.Resource._add_basic_methods" class="py-name" href="#" onclick="return doclink('link-262', '_add_basic_methods', 'link-262');">_add_basic_methods</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_rootDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_schema</tt><tt class="py-op">)</tt> </tt>
+<a name="L1041"></a><tt class="py-lineno">1041</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-263" class="py-name" targets="Method googleapiclient.discovery.Resource._add_nested_resources()=googleapiclient.discovery.Resource-class.html#_add_nested_resources"><a title="googleapiclient.discovery.Resource._add_nested_resources" class="py-name" href="#" onclick="return doclink('link-263', '_add_nested_resources', 'link-263');">_add_nested_resources</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_rootDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_schema</tt><tt class="py-op">)</tt> </tt>
+<a name="L1042"></a><tt class="py-lineno">1042</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-264" class="py-name" targets="Method googleapiclient.discovery.Resource._add_next_methods()=googleapiclient.discovery.Resource-class.html#_add_next_methods"><a title="googleapiclient.discovery.Resource._add_next_methods" class="py-name" href="#" onclick="return doclink('link-264', '_add_next_methods', 'link-264');">_add_next_methods</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_schema</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1043"></a><tt class="py-lineno">1043</tt>  <tt class="py-line"> </tt>
+<a name="Resource._add_basic_methods"></a><div id="Resource._add_basic_methods-def"><a name="L1044"></a><tt class="py-lineno">1044</tt> <a class="py-toggle" href="#" id="Resource._add_basic_methods-toggle" onclick="return toggle('Resource._add_basic_methods');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_add_basic_methods">_add_basic_methods</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-param">rootDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource._add_basic_methods-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._add_basic_methods-expanded"><a name="L1045"></a><tt class="py-lineno">1045</tt>  <tt class="py-line">    <tt class="py-comment"># If this is the root Resource, add a new_batch_http_request() method.</tt> </tt>
+<a name="L1046"></a><tt class="py-lineno">1046</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">resourceDesc</tt> <tt class="py-op">==</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L1047"></a><tt class="py-lineno">1047</tt>  <tt class="py-line">      <tt class="py-name">batch_uri</tt> <tt class="py-op">=</tt> <tt class="py-string">'%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt> </tt>
+<a name="L1048"></a><tt class="py-lineno">1048</tt>  <tt class="py-line">        <tt class="py-name">rootDesc</tt><tt class="py-op">[</tt><tt class="py-string">'rootUrl'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">.</tt><tt id="link-265" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-258', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'batchPath'</tt><tt class="py-op">,</tt> <tt class="py-string">'batch'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L1044"></a><tt class="py-lineno">1044</tt>  <tt class="py-line">      <tt class="py-keyword">def</tt> <tt class="py-def-name">new_batch_http_request</tt><tt class="py-op">(</tt><tt class="py-param">callback</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1045"></a><tt class="py-lineno">1045</tt>  <tt class="py-line">        <tt class="py-docstring">"""Create a BatchHttpRequest object based on the discovery document.</tt> </tt>
-<a name="L1046"></a><tt class="py-lineno">1046</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1047"></a><tt class="py-lineno">1047</tt>  <tt class="py-line"><tt class="py-docstring">        Args:</tt> </tt>
-<a name="L1048"></a><tt class="py-lineno">1048</tt>  <tt class="py-line"><tt class="py-docstring">          callback: callable, A callback to be called for each response, of the</tt> </tt>
-<a name="L1049"></a><tt class="py-lineno">1049</tt>  <tt class="py-line"><tt class="py-docstring">            form callback(id, response, exception). The first parameter is the</tt> </tt>
-<a name="L1050"></a><tt class="py-lineno">1050</tt>  <tt class="py-line"><tt class="py-docstring">            request id, and the second is the deserialized response object. The</tt> </tt>
-<a name="L1051"></a><tt class="py-lineno">1051</tt>  <tt class="py-line"><tt class="py-docstring">            third is an apiclient.errors.HttpError exception object if an HTTP</tt> </tt>
-<a name="L1052"></a><tt class="py-lineno">1052</tt>  <tt class="py-line"><tt class="py-docstring">            error occurred while processing the request, or None if no error</tt> </tt>
-<a name="L1053"></a><tt class="py-lineno">1053</tt>  <tt class="py-line"><tt class="py-docstring">            occurred.</tt> </tt>
-<a name="L1054"></a><tt class="py-lineno">1054</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1055"></a><tt class="py-lineno">1055</tt>  <tt class="py-line"><tt class="py-docstring">        Returns:</tt> </tt>
-<a name="L1056"></a><tt class="py-lineno">1056</tt>  <tt class="py-line"><tt class="py-docstring">          A BatchHttpRequest object based on the discovery document.</tt> </tt>
-<a name="L1057"></a><tt class="py-lineno">1057</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
-<a name="L1058"></a><tt class="py-lineno">1058</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt id="link-259" class="py-name"><a title="googleapiclient.http.BatchHttpRequest" class="py-name" href="#" onclick="return doclink('link-259', 'BatchHttpRequest', 'link-22');">BatchHttpRequest</a></tt><tt class="py-op">(</tt><tt class="py-name">callback</tt><tt class="py-op">=</tt><tt class="py-name">callback</tt><tt class="py-op">,</tt> <tt class="py-name">batch_uri</tt><tt class="py-op">=</tt><tt class="py-name">batch_uri</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1059"></a><tt class="py-lineno">1059</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-260" class="py-name" targets="Method googleapiclient.discovery.Resource._set_dynamic_attr()=googleapiclient.discovery.Resource-class.html#_set_dynamic_attr"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-260', '_set_dynamic_attr', 'link-260');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-string">'new_batch_http_request'</tt><tt class="py-op">,</tt> <tt class="py-name">new_batch_http_request</tt><tt class="py-op">)</tt> </tt>
-<a name="L1060"></a><tt class="py-lineno">1060</tt>  <tt class="py-line"> </tt>
-<a name="L1061"></a><tt class="py-lineno">1061</tt>  <tt class="py-line">    <tt class="py-comment"># Add basic methods to Resource</tt> </tt>
-<a name="L1062"></a><tt class="py-lineno">1062</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'methods'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">resourceDesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L1063"></a><tt class="py-lineno">1063</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">resourceDesc</tt><tt class="py-op">[</tt><tt class="py-string">'methods'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1064"></a><tt class="py-lineno">1064</tt>  <tt class="py-line">        <tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt id="link-261" class="py-name" targets="Function googleapiclient.discovery.createMethod()=googleapiclient.discovery-module.html#createMethod"><a title="googleapiclient.discovery.createMethod" class="py-name" href="#" onclick="return doclink('link-261', 'createMethod', 'link-261');">createMethod</a></tt><tt class="py-op">(</tt> </tt>
-<a name="L1065"></a><tt class="py-lineno">1065</tt>  <tt class="py-line">            <tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">,</tt> <tt id="link-262" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-262', 'schema', 'link-48');">schema</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1066"></a><tt class="py-lineno">1066</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-263" class="py-name"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-263', '_set_dynamic_attr', 'link-260');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> </tt>
-<a name="L1067"></a><tt class="py-lineno">1067</tt>  <tt class="py-line">                               <tt class="py-name">method</tt><tt class="py-op">.</tt><tt class="py-name">__get__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L1068"></a><tt class="py-lineno">1068</tt>  <tt class="py-line">        <tt class="py-comment"># Add in _media methods. The functionality of the attached method will</tt> </tt>
-<a name="L1069"></a><tt class="py-lineno">1069</tt>  <tt class="py-line">        <tt class="py-comment"># change when it sees that the method name ends in _media.</tt> </tt>
-<a name="L1070"></a><tt class="py-lineno">1070</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">.</tt><tt id="link-264" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-265', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'batchPath'</tt><tt class="py-op">,</tt> <tt class="py-string">'batch'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L1049"></a><tt class="py-lineno">1049</tt>  <tt class="py-line">      <tt class="py-keyword">def</tt> <tt class="py-def-name">new_batch_http_request</tt><tt class="py-op">(</tt><tt class="py-param">callback</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1050"></a><tt class="py-lineno">1050</tt>  <tt class="py-line">        <tt class="py-docstring">"""Create a BatchHttpRequest object based on the discovery document.</tt> </tt>
+<a name="L1051"></a><tt class="py-lineno">1051</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1052"></a><tt class="py-lineno">1052</tt>  <tt class="py-line"><tt class="py-docstring">        Args:</tt> </tt>
+<a name="L1053"></a><tt class="py-lineno">1053</tt>  <tt class="py-line"><tt class="py-docstring">          callback: callable, A callback to be called for each response, of the</tt> </tt>
+<a name="L1054"></a><tt class="py-lineno">1054</tt>  <tt class="py-line"><tt class="py-docstring">            form callback(id, response, exception). The first parameter is the</tt> </tt>
+<a name="L1055"></a><tt class="py-lineno">1055</tt>  <tt class="py-line"><tt class="py-docstring">            request id, and the second is the deserialized response object. The</tt> </tt>
+<a name="L1056"></a><tt class="py-lineno">1056</tt>  <tt class="py-line"><tt class="py-docstring">            third is an apiclient.errors.HttpError exception object if an HTTP</tt> </tt>
+<a name="L1057"></a><tt class="py-lineno">1057</tt>  <tt class="py-line"><tt class="py-docstring">            error occurred while processing the request, or None if no error</tt> </tt>
+<a name="L1058"></a><tt class="py-lineno">1058</tt>  <tt class="py-line"><tt class="py-docstring">            occurred.</tt> </tt>
+<a name="L1059"></a><tt class="py-lineno">1059</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1060"></a><tt class="py-lineno">1060</tt>  <tt class="py-line"><tt class="py-docstring">        Returns:</tt> </tt>
+<a name="L1061"></a><tt class="py-lineno">1061</tt>  <tt class="py-line"><tt class="py-docstring">          A BatchHttpRequest object based on the discovery document.</tt> </tt>
+<a name="L1062"></a><tt class="py-lineno">1062</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
+<a name="L1063"></a><tt class="py-lineno">1063</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt id="link-266" class="py-name"><a title="googleapiclient.http.BatchHttpRequest" class="py-name" href="#" onclick="return doclink('link-266', 'BatchHttpRequest', 'link-24');">BatchHttpRequest</a></tt><tt class="py-op">(</tt><tt class="py-name">callback</tt><tt class="py-op">=</tt><tt class="py-name">callback</tt><tt class="py-op">,</tt> <tt class="py-name">batch_uri</tt><tt class="py-op">=</tt><tt class="py-name">batch_uri</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1064"></a><tt class="py-lineno">1064</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-267" class="py-name" targets="Method googleapiclient.discovery.Resource._set_dynamic_attr()=googleapiclient.discovery.Resource-class.html#_set_dynamic_attr"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-267', '_set_dynamic_attr', 'link-267');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-string">'new_batch_http_request'</tt><tt class="py-op">,</tt> <tt class="py-name">new_batch_http_request</tt><tt class="py-op">)</tt> </tt>
+<a name="L1065"></a><tt class="py-lineno">1065</tt>  <tt class="py-line"> </tt>
+<a name="L1066"></a><tt class="py-lineno">1066</tt>  <tt class="py-line">    <tt class="py-comment"># Add basic methods to Resource</tt> </tt>
+<a name="L1067"></a><tt class="py-lineno">1067</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'methods'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">resourceDesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L1068"></a><tt class="py-lineno">1068</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">resourceDesc</tt><tt class="py-op">[</tt><tt class="py-string">'methods'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1069"></a><tt class="py-lineno">1069</tt>  <tt class="py-line">        <tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt id="link-268" class="py-name" targets="Function googleapiclient.discovery.createMethod()=googleapiclient.discovery-module.html#createMethod"><a title="googleapiclient.discovery.createMethod" class="py-name" href="#" onclick="return doclink('link-268', 'createMethod', 'link-268');">createMethod</a></tt><tt class="py-op">(</tt> </tt>
+<a name="L1070"></a><tt class="py-lineno">1070</tt>  <tt class="py-line">            <tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">,</tt> <tt id="link-269" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-269', 'schema', 'link-50');">schema</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L1071"></a><tt class="py-lineno">1071</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-270" class="py-name"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-270', '_set_dynamic_attr', 'link-267');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> </tt>
+<a name="L1072"></a><tt class="py-lineno">1072</tt>  <tt class="py-line">                               <tt class="py-name">method</tt><tt class="py-op">.</tt><tt class="py-name">__get__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L1073"></a><tt class="py-lineno">1073</tt>  <tt class="py-line">        <tt class="py-comment"># Add in _media methods. The functionality of the attached method will</tt> </tt>
+<a name="L1074"></a><tt class="py-lineno">1074</tt>  <tt class="py-line">        <tt class="py-comment"># change when it sees that the method name ends in _media.</tt> </tt>
+<a name="L1075"></a><tt class="py-lineno">1075</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">.</tt><tt id="link-271" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-264', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'supportsMediaDownload'</tt><tt class="py-op">,</tt> <tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1071"></a><tt class="py-lineno">1071</tt>  <tt class="py-line">          <tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt id="link-265" class="py-name"><a title="googleapiclient.discovery.createMethod" class="py-name" href="#" onclick="return doclink('link-265', 'createMethod', 'link-261');">createMethod</a></tt><tt class="py-op">(</tt> </tt>
-<a name="L1072"></a><tt class="py-lineno">1072</tt>  <tt class="py-line">              <tt class="py-name">methodName</tt> <tt class="py-op">+</tt> <tt class="py-string">'_media'</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">,</tt> <tt id="link-266" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-266', 'schema', 'link-48');">schema</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1073"></a><tt class="py-lineno">1073</tt>  <tt class="py-line">          <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-267" class="py-name"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-267', '_set_dynamic_attr', 'link-260');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> </tt>
-<a name="L1074"></a><tt class="py-lineno">1074</tt>  <tt class="py-line">                                 <tt class="py-name">method</tt><tt class="py-op">.</tt><tt class="py-name">__get__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1075"></a><tt class="py-lineno">1075</tt>  <tt class="py-line"> </tt>
-<a name="Resource._add_nested_resources"></a><div id="Resource._add_nested_resources-def"><a name="L1076"></a><tt class="py-lineno">1076</tt> <a class="py-toggle" href="#" id="Resource._add_nested_resources-toggle" onclick="return toggle('Resource._add_nested_resources');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_add_nested_resources">_add_nested_resources</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-param">rootDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource._add_nested_resources-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._add_nested_resources-expanded"><a name="L1077"></a><tt class="py-lineno">1077</tt>  <tt class="py-line">    <tt class="py-comment"># Add in nested resources</tt> </tt>
-<a name="L1078"></a><tt class="py-lineno">1078</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'resources'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">resourceDesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L1079"></a><tt class="py-lineno">1079</tt>  <tt class="py-line"> </tt>
-<a name="L1080"></a><tt class="py-lineno">1080</tt>  <tt class="py-line">      <tt class="py-keyword">def</tt> <tt class="py-def-name">createResourceMethod</tt><tt class="py-op">(</tt><tt class="py-param">methodName</tt><tt class="py-op">,</tt> <tt class="py-param">methodDesc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1081"></a><tt class="py-lineno">1081</tt>  <tt class="py-line">        <tt class="py-docstring">"""Create a method on the Resource to access a nested Resource.</tt> </tt>
-<a name="L1082"></a><tt class="py-lineno">1082</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1083"></a><tt class="py-lineno">1083</tt>  <tt class="py-line"><tt class="py-docstring">        Args:</tt> </tt>
-<a name="L1084"></a><tt class="py-lineno">1084</tt>  <tt class="py-line"><tt class="py-docstring">          methodName: string, name of the method to use.</tt> </tt>
-<a name="L1085"></a><tt class="py-lineno">1085</tt>  <tt class="py-line"><tt class="py-docstring">          methodDesc: object, fragment of deserialized discovery document that</tt> </tt>
-<a name="L1086"></a><tt class="py-lineno">1086</tt>  <tt class="py-line"><tt class="py-docstring">            describes the method.</tt> </tt>
-<a name="L1087"></a><tt class="py-lineno">1087</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
-<a name="L1088"></a><tt class="py-lineno">1088</tt>  <tt class="py-line">        <tt class="py-name">methodName</tt> <tt class="py-op">=</tt> <tt id="link-268" class="py-name"><a title="googleapiclient.discovery.fix_method_name" class="py-name" href="#" onclick="return doclink('link-268', 'fix_method_name', 'link-175');">fix_method_name</a></tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">)</tt> </tt>
-<a name="L1089"></a><tt class="py-lineno">1089</tt>  <tt class="py-line"> </tt>
-<a name="L1090"></a><tt class="py-lineno">1090</tt>  <tt class="py-line">        <tt class="py-keyword">def</tt> <tt class="py-def-name">methodResource</tt><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1091"></a><tt class="py-lineno">1091</tt>  <tt class="py-line">          <tt class="py-keyword">return</tt> <tt id="link-269" class="py-name"><a title="googleapiclient.discovery.Resource" class="py-name" href="#" onclick="return doclink('link-269', 'Resource', 'link-123');">Resource</a></tt><tt class="py-op">(</tt><tt id="link-270" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-270', 'http', 'link-21');">http</a></tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_http</tt><tt class="py-op">,</tt> <tt class="py-name">baseUrl</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_baseUrl</tt><tt class="py-op">,</tt> </tt>
-<a name="L1092"></a><tt class="py-lineno">1092</tt>  <tt class="py-line">                          <tt id="link-271" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-271', 'model', 'link-39');">model</a></tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_model</tt><tt class="py-op">,</tt> <tt class="py-name">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_developerKey</tt><tt class="py-op">,</tt> </tt>
-<a name="L1093"></a><tt class="py-lineno">1093</tt>  <tt class="py-line">                          <tt class="py-name">requestBuilder</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requestBuilder</tt><tt class="py-op">,</tt> </tt>
-<a name="L1094"></a><tt class="py-lineno">1094</tt>  <tt class="py-line">                          <tt class="py-name">resourceDesc</tt><tt class="py-op">=</tt><tt class="py-name">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">=</tt><tt class="py-name">rootDesc</tt><tt class="py-op">,</tt> </tt>
-<a name="L1095"></a><tt class="py-lineno">1095</tt>  <tt class="py-line">                          <tt id="link-272" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-272', 'schema', 'link-48');">schema</a></tt><tt class="py-op">=</tt><tt id="link-273" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-273', 'schema', 'link-48');">schema</a></tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1096"></a><tt class="py-lineno">1096</tt>  <tt class="py-line"> </tt>
-<a name="L1097"></a><tt class="py-lineno">1097</tt>  <tt class="py-line">        <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">methodResource</tt><tt class="py-op">,</tt> <tt class="py-string">'__doc__'</tt><tt class="py-op">,</tt> <tt class="py-string">'A collection resource.'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1098"></a><tt class="py-lineno">1098</tt>  <tt class="py-line">        <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">methodResource</tt><tt class="py-op">,</tt> <tt class="py-string">'__is_resource__'</tt><tt class="py-op">,</tt> <tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
-<a name="L1099"></a><tt class="py-lineno">1099</tt>  <tt class="py-line"> </tt>
-<a name="L1100"></a><tt class="py-lineno">1100</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodResource</tt><tt class="py-op">)</tt> </tt>
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-271', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'supportsMediaDownload'</tt><tt class="py-op">,</tt> <tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1076"></a><tt class="py-lineno">1076</tt>  <tt class="py-line">          <tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt id="link-272" class="py-name"><a title="googleapiclient.discovery.createMethod" class="py-name" href="#" onclick="return doclink('link-272', 'createMethod', 'link-268');">createMethod</a></tt><tt class="py-op">(</tt> </tt>
+<a name="L1077"></a><tt class="py-lineno">1077</tt>  <tt class="py-line">              <tt class="py-name">methodName</tt> <tt class="py-op">+</tt> <tt class="py-string">'_media'</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">,</tt> <tt id="link-273" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-273', 'schema', 'link-50');">schema</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L1078"></a><tt class="py-lineno">1078</tt>  <tt class="py-line">          <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-274" class="py-name"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-274', '_set_dynamic_attr', 'link-267');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> </tt>
+<a name="L1079"></a><tt class="py-lineno">1079</tt>  <tt class="py-line">                                 <tt class="py-name">method</tt><tt class="py-op">.</tt><tt class="py-name">__get__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1080"></a><tt class="py-lineno">1080</tt>  <tt class="py-line"> </tt>
+<a name="Resource._add_nested_resources"></a><div id="Resource._add_nested_resources-def"><a name="L1081"></a><tt class="py-lineno">1081</tt> <a class="py-toggle" href="#" id="Resource._add_nested_resources-toggle" onclick="return toggle('Resource._add_nested_resources');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_add_nested_resources">_add_nested_resources</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-param">rootDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource._add_nested_resources-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._add_nested_resources-expanded"><a name="L1082"></a><tt class="py-lineno">1082</tt>  <tt class="py-line">    <tt class="py-comment"># Add in nested resources</tt> </tt>
+<a name="L1083"></a><tt class="py-lineno">1083</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'resources'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">resourceDesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L1084"></a><tt class="py-lineno">1084</tt>  <tt class="py-line"> </tt>
+<a name="L1085"></a><tt class="py-lineno">1085</tt>  <tt class="py-line">      <tt class="py-keyword">def</tt> <tt class="py-def-name">createResourceMethod</tt><tt class="py-op">(</tt><tt class="py-param">methodName</tt><tt class="py-op">,</tt> <tt class="py-param">methodDesc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1086"></a><tt class="py-lineno">1086</tt>  <tt class="py-line">        <tt class="py-docstring">"""Create a method on the Resource to access a nested Resource.</tt> </tt>
+<a name="L1087"></a><tt class="py-lineno">1087</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1088"></a><tt class="py-lineno">1088</tt>  <tt class="py-line"><tt class="py-docstring">        Args:</tt> </tt>
+<a name="L1089"></a><tt class="py-lineno">1089</tt>  <tt class="py-line"><tt class="py-docstring">          methodName: string, name of the method to use.</tt> </tt>
+<a name="L1090"></a><tt class="py-lineno">1090</tt>  <tt class="py-line"><tt class="py-docstring">          methodDesc: object, fragment of deserialized discovery document that</tt> </tt>
+<a name="L1091"></a><tt class="py-lineno">1091</tt>  <tt class="py-line"><tt class="py-docstring">            describes the method.</tt> </tt>
+<a name="L1092"></a><tt class="py-lineno">1092</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
+<a name="L1093"></a><tt class="py-lineno">1093</tt>  <tt class="py-line">        <tt class="py-name">methodName</tt> <tt class="py-op">=</tt> <tt id="link-275" class="py-name"><a title="googleapiclient.discovery.fix_method_name" class="py-name" href="#" onclick="return doclink('link-275', 'fix_method_name', 'link-182');">fix_method_name</a></tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">)</tt> </tt>
+<a name="L1094"></a><tt class="py-lineno">1094</tt>  <tt class="py-line"> </tt>
+<a name="L1095"></a><tt class="py-lineno">1095</tt>  <tt class="py-line">        <tt class="py-keyword">def</tt> <tt class="py-def-name">methodResource</tt><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1096"></a><tt class="py-lineno">1096</tt>  <tt class="py-line">          <tt class="py-keyword">return</tt> <tt id="link-276" class="py-name"><a title="googleapiclient.discovery.Resource" class="py-name" href="#" onclick="return doclink('link-276', 'Resource', 'link-130');">Resource</a></tt><tt class="py-op">(</tt><tt id="link-277" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-277', 'http', 'link-23');">http</a></tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_http</tt><tt class="py-op">,</tt> <tt class="py-name">baseUrl</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_baseUrl</tt><tt class="py-op">,</tt> </tt>
+<a name="L1097"></a><tt class="py-lineno">1097</tt>  <tt class="py-line">                          <tt id="link-278" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-278', 'model', 'link-41');">model</a></tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_model</tt><tt class="py-op">,</tt> <tt class="py-name">developerKey</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_developerKey</tt><tt class="py-op">,</tt> </tt>
+<a name="L1098"></a><tt class="py-lineno">1098</tt>  <tt class="py-line">                          <tt class="py-name">requestBuilder</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requestBuilder</tt><tt class="py-op">,</tt> </tt>
+<a name="L1099"></a><tt class="py-lineno">1099</tt>  <tt class="py-line">                          <tt class="py-name">resourceDesc</tt><tt class="py-op">=</tt><tt class="py-name">methodDesc</tt><tt class="py-op">,</tt> <tt class="py-name">rootDesc</tt><tt class="py-op">=</tt><tt class="py-name">rootDesc</tt><tt class="py-op">,</tt> </tt>
+<a name="L1100"></a><tt class="py-lineno">1100</tt>  <tt class="py-line">                          <tt id="link-279" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-279', 'schema', 'link-50');">schema</a></tt><tt class="py-op">=</tt><tt id="link-280" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-280', 'schema', 'link-50');">schema</a></tt><tt class="py-op">)</tt> </tt>
 </div><a name="L1101"></a><tt class="py-lineno">1101</tt>  <tt class="py-line"> </tt>
-<a name="L1102"></a><tt class="py-lineno">1102</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">resourceDesc</tt><tt class="py-op">[</tt><tt class="py-string">'resources'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1103"></a><tt class="py-lineno">1103</tt>  <tt class="py-line">        <tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt class="py-name">createResourceMethod</tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">)</tt> </tt>
-<a name="L1104"></a><tt class="py-lineno">1104</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-274" class="py-name"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-274', '_set_dynamic_attr', 'link-260');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> </tt>
-<a name="L1105"></a><tt class="py-lineno">1105</tt>  <tt class="py-line">                               <tt class="py-name">method</tt><tt class="py-op">.</tt><tt class="py-name">__get__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L1102"></a><tt class="py-lineno">1102</tt>  <tt class="py-line">        <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">methodResource</tt><tt class="py-op">,</tt> <tt class="py-string">'__doc__'</tt><tt class="py-op">,</tt> <tt class="py-string">'A collection resource.'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1103"></a><tt class="py-lineno">1103</tt>  <tt class="py-line">        <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">methodResource</tt><tt class="py-op">,</tt> <tt class="py-string">'__is_resource__'</tt><tt class="py-op">,</tt> <tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
+<a name="L1104"></a><tt class="py-lineno">1104</tt>  <tt class="py-line"> </tt>
+<a name="L1105"></a><tt class="py-lineno">1105</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodResource</tt><tt class="py-op">)</tt> </tt>
 </div><a name="L1106"></a><tt class="py-lineno">1106</tt>  <tt class="py-line"> </tt>
-<a name="Resource._add_next_methods"></a><div id="Resource._add_next_methods-def"><a name="L1107"></a><tt class="py-lineno">1107</tt> <a class="py-toggle" href="#" id="Resource._add_next_methods-toggle" onclick="return toggle('Resource._add_next_methods');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_add_next_methods">_add_next_methods</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="Resource._add_next_methods-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._add_next_methods-expanded"><a name="L1108"></a><tt class="py-lineno">1108</tt>  <tt class="py-line">    <tt class="py-comment"># Add _next() methods</tt> </tt>
-<a name="L1109"></a><tt class="py-lineno">1109</tt>  <tt class="py-line">    <tt class="py-comment"># Look for response bodies in schema that contain nextPageToken, and methods</tt> </tt>
-<a name="L1110"></a><tt class="py-lineno">1110</tt>  <tt class="py-line">    <tt class="py-comment"># that take a pageToken parameter.</tt> </tt>
-<a name="L1111"></a><tt class="py-lineno">1111</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'methods'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">resourceDesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L1112"></a><tt class="py-lineno">1112</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">resourceDesc</tt><tt class="py-op">[</tt><tt class="py-string">'methods'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1113"></a><tt class="py-lineno">1113</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-string">'response'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">:</tt> </tt>
-<a name="L1114"></a><tt class="py-lineno">1114</tt>  <tt class="py-line">          <tt class="py-name">responseSchema</tt> <tt class="py-op">=</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">[</tt><tt class="py-string">'response'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1115"></a><tt class="py-lineno">1115</tt>  <tt class="py-line">          <tt class="py-keyword">if</tt> <tt class="py-string">'$ref'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">responseSchema</tt><tt class="py-op">:</tt> </tt>
-<a name="L1116"></a><tt class="py-lineno">1116</tt>  <tt class="py-line">            <tt class="py-name">responseSchema</tt> <tt class="py-op">=</tt> <tt id="link-275" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-275', 'schema', 'link-48');">schema</a></tt><tt class="py-op">.</tt><tt id="link-276" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="L1107"></a><tt class="py-lineno">1107</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">resourceDesc</tt><tt class="py-op">[</tt><tt class="py-string">'resources'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1108"></a><tt class="py-lineno">1108</tt>  <tt class="py-line">        <tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt class="py-name">createResourceMethod</tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">)</tt> </tt>
+<a name="L1109"></a><tt class="py-lineno">1109</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-281" class="py-name"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-281', '_set_dynamic_attr', 'link-267');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> </tt>
+<a name="L1110"></a><tt class="py-lineno">1110</tt>  <tt class="py-line">                               <tt class="py-name">method</tt><tt class="py-op">.</tt><tt class="py-name">__get__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1111"></a><tt class="py-lineno">1111</tt>  <tt class="py-line"> </tt>
+<a name="Resource._add_next_methods"></a><div id="Resource._add_next_methods-def"><a name="L1112"></a><tt class="py-lineno">1112</tt> <a class="py-toggle" href="#" id="Resource._add_next_methods-toggle" onclick="return toggle('Resource._add_next_methods');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.discovery.Resource-class.html#_add_next_methods">_add_next_methods</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">resourceDesc</tt><tt class="py-op">,</tt> <tt class="py-param">schema</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Resource._add_next_methods-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="Resource._add_next_methods-expanded"><a name="L1113"></a><tt class="py-lineno">1113</tt>  <tt class="py-line">    <tt class="py-comment"># Add _next() methods</tt> </tt>
+<a name="L1114"></a><tt class="py-lineno">1114</tt>  <tt class="py-line">    <tt class="py-comment"># Look for response bodies in schema that contain nextPageToken, and methods</tt> </tt>
+<a name="L1115"></a><tt class="py-lineno">1115</tt>  <tt class="py-line">    <tt class="py-comment"># that take a pageToken parameter.</tt> </tt>
+<a name="L1116"></a><tt class="py-lineno">1116</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'methods'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">resourceDesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L1117"></a><tt class="py-lineno">1117</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">methodName</tt><tt class="py-op">,</tt> <tt class="py-name">methodDesc</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">resourceDesc</tt><tt class="py-op">[</tt><tt class="py-string">'methods'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1118"></a><tt class="py-lineno">1118</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-string">'response'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">:</tt> </tt>
+<a name="L1119"></a><tt class="py-lineno">1119</tt>  <tt class="py-line">          <tt class="py-name">responseSchema</tt> <tt class="py-op">=</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">[</tt><tt class="py-string">'response'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1120"></a><tt class="py-lineno">1120</tt>  <tt class="py-line">          <tt class="py-keyword">if</tt> <tt class="py-string">'$ref'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">responseSchema</tt><tt class="py-op">:</tt> </tt>
+<a name="L1121"></a><tt class="py-lineno">1121</tt>  <tt class="py-line">            <tt class="py-name">responseSchema</tt> <tt class="py-op">=</tt> <tt id="link-282" class="py-name"><a title="googleapiclient.schema" class="py-name" href="#" onclick="return doclink('link-282', 'schema', 'link-50');">schema</a></tt><tt class="py-op">.</tt><tt id="link-283" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-276', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">responseSchema</tt><tt class="py-op">[</tt><tt class="py-string">'$ref'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L1117"></a><tt class="py-lineno">1117</tt>  <tt class="py-line">          <tt class="py-name">hasNextPageToken</tt> <tt class="py-op">=</tt> <tt class="py-string">'nextPageToken'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">responseSchema</tt><tt class="py-op">.</tt><tt id="link-277" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-283', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">responseSchema</tt><tt class="py-op">[</tt><tt class="py-string">'$ref'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L1122"></a><tt class="py-lineno">1122</tt>  <tt class="py-line">          <tt class="py-name">hasNextPageToken</tt> <tt class="py-op">=</tt> <tt class="py-string">'nextPageToken'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">responseSchema</tt><tt class="py-op">.</tt><tt id="link-284" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-277', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'properties'</tt><tt class="py-op">,</tt> </tt>
-<a name="L1118"></a><tt class="py-lineno">1118</tt>  <tt class="py-line">                                                                   <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
-<a name="L1119"></a><tt class="py-lineno">1119</tt>  <tt class="py-line">          <tt class="py-name">hasPageToken</tt> <tt class="py-op">=</tt> <tt class="py-string">'pageToken'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">.</tt><tt id="link-278" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-284', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'properties'</tt><tt class="py-op">,</tt> </tt>
+<a name="L1123"></a><tt class="py-lineno">1123</tt>  <tt class="py-line">                                                                   <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
+<a name="L1124"></a><tt class="py-lineno">1124</tt>  <tt class="py-line">          <tt class="py-name">hasPageToken</tt> <tt class="py-op">=</tt> <tt class="py-string">'pageToken'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">methodDesc</tt><tt class="py-op">.</tt><tt id="link-285" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
-googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-278', 'get', 'link-93');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
-<a name="L1120"></a><tt class="py-lineno">1120</tt>  <tt class="py-line">          <tt class="py-keyword">if</tt> <tt class="py-name">hasNextPageToken</tt> <tt class="py-keyword">and</tt> <tt class="py-name">hasPageToken</tt><tt class="py-op">:</tt> </tt>
-<a name="L1121"></a><tt class="py-lineno">1121</tt>  <tt class="py-line">            <tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt id="link-279" class="py-name" targets="Function googleapiclient.discovery.createNextMethod()=googleapiclient.discovery-module.html#createNextMethod"><a title="googleapiclient.discovery.createNextMethod" class="py-name" href="#" onclick="return doclink('link-279', 'createNextMethod', 'link-279');">createNextMethod</a></tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt> <tt class="py-op">+</tt> <tt class="py-string">'_next'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1122"></a><tt class="py-lineno">1122</tt>  <tt class="py-line">            <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-280" class="py-name"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-280', '_set_dynamic_attr', 'link-260');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> </tt>
-<a name="L1123"></a><tt class="py-lineno">1123</tt>  <tt class="py-line">                                   <tt class="py-name">method</tt><tt class="py-op">.</tt><tt class="py-name">__get__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-</div></div><a name="L1124"></a><tt class="py-lineno">1124</tt>  <tt class="py-line"> </tt><script type="text/javascript">
+googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-285', 'get', 'link-94');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'parameters'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
+<a name="L1125"></a><tt class="py-lineno">1125</tt>  <tt class="py-line">          <tt class="py-keyword">if</tt> <tt class="py-name">hasNextPageToken</tt> <tt class="py-keyword">and</tt> <tt class="py-name">hasPageToken</tt><tt class="py-op">:</tt> </tt>
+<a name="L1126"></a><tt class="py-lineno">1126</tt>  <tt class="py-line">            <tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt id="link-286" class="py-name" targets="Function googleapiclient.discovery.createNextMethod()=googleapiclient.discovery-module.html#createNextMethod"><a title="googleapiclient.discovery.createNextMethod" class="py-name" href="#" onclick="return doclink('link-286', 'createNextMethod', 'link-286');">createNextMethod</a></tt><tt class="py-op">(</tt><tt class="py-name">methodName</tt> <tt class="py-op">+</tt> <tt class="py-string">'_next'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1127"></a><tt class="py-lineno">1127</tt>  <tt class="py-line">            <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-287" class="py-name"><a title="googleapiclient.discovery.Resource._set_dynamic_attr" class="py-name" href="#" onclick="return doclink('link-287', '_set_dynamic_attr', 'link-267');">_set_dynamic_attr</a></tt><tt class="py-op">(</tt><tt class="py-name">fixedMethodName</tt><tt class="py-op">,</tt> </tt>
+<a name="L1128"></a><tt class="py-lineno">1128</tt>  <tt class="py-line">                                   <tt class="py-name">method</tt><tt class="py-op">.</tt><tt class="py-name">__get__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+</div></div><a name="L1129"></a><tt class="py-lineno">1129</tt>  <tt class="py-line"> </tt><script type="text/javascript">
 <!--
 expandto(location.href);
 // -->
@@ -1383,7 +1388,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.discovery-module.htm
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery.Resource-class.html b/docs/epy/googleapiclient.discovery.Resource-class.html
index c60bac49f4b..1326df1be1a 100644
--- a/docs/epy/googleapiclient.discovery.Resource-class.html
+++ b/docs/epy/googleapiclient.discovery.Resource-class.html
@@ -59,10 +59,10 @@
 <h1 class="epydoc">Class Resource</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_4" name="uml_class_diagram_for_googleap_4">
-<area shape="rect" id="node1_3" href="googleapiclient.discovery.Resource-class.html#__init__" title="Build a Resource from the API description." alt="" coords="16,40,605,60"/>
-<area shape="rect" id="node1_4" href="googleapiclient.discovery.Resource-class.html#__getstate__" title="Trim the state down to something that can be pickled." alt="" coords="16,60,605,80"/>
-<area shape="rect" id="node1_5" href="googleapiclient.discovery.Resource-class.html#__setstate__" title="Reconstitute the state of the object from being pickled." alt="" coords="16,80,605,100"/>
-<area shape="rect" id="node1" href="googleapiclient.discovery.Resource-class.html" title="A class for interacting with a resource." alt="" coords="4,6,617,106"/>
+<area shape="rect" id="node1_3" href="googleapiclient.discovery.Resource-class.html#__init__" title="Build a Resource from the API description." alt="" coords="18,36,611,55"/>
+<area shape="rect" id="node1_4" href="googleapiclient.discovery.Resource-class.html#__getstate__" title="Trim the state down to something that can be pickled." alt="" coords="18,55,611,73"/>
+<area shape="rect" id="node1_5" href="googleapiclient.discovery.Resource-class.html#__setstate__" title="Reconstitute the state of the object from being pickled." alt="" coords="18,73,611,92"/>
+<area shape="rect" id="node1" href="googleapiclient.discovery.Resource-class.html" title="A class for interacting with a resource." alt="" coords="5,5,623,99"/>
 </map>
   <img src="uml_class_diagram_for_googleap_4.gif" alt='' usemap="#uml_class_diagram_for_googleap_4" ismap="ismap" class="graph-without-title" />
 </center>
@@ -458,7 +458,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__setstate__</span>(
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery.ResourceMethodParameters-class.html b/docs/epy/googleapiclient.discovery.ResourceMethodParameters-class.html
index 59fb7ffb412..3c71039809a 100644
--- a/docs/epy/googleapiclient.discovery.ResourceMethodParameters-class.html
+++ b/docs/epy/googleapiclient.discovery.ResourceMethodParameters-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class ResourceMethodParameters</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#ResourceMethodParameters">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_5" name="uml_class_diagram_for_googleap_5">
-<area shape="rect" id="node1_2" href="googleapiclient.discovery.ResourceMethodParameters-class.html#__init__" title="Constructor for ResourceMethodParameters." alt="" coords="17,39,229,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.discovery.ResourceMethodParameters-class.html#set_parameters" title="Populates maps and lists based on method description." alt="" coords="17,59,229,79"/>
-<area shape="rect" id="node1" href="googleapiclient.discovery.ResourceMethodParameters-class.html" title="Represents the parameters associated with a method." alt="" coords="5,5,241,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.discovery.ResourceMethodParameters-class.html#__init__" title="Constructor for ResourceMethodParameters." alt="" coords="18,36,233,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.discovery.ResourceMethodParameters-class.html#set_parameters" title="Populates maps and lists based on method description." alt="" coords="18,55,233,73"/>
+<area shape="rect" id="node1" href="googleapiclient.discovery.ResourceMethodParameters-class.html" title="Represents the parameters associated with a method." alt="" coords="5,5,244,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_5.gif" alt='' usemap="#uml_class_diagram_for_googleap_5" ismap="ismap" class="graph-without-title" />
 </center>
@@ -300,7 +300,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">set_parameters</span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery._BytesGenerator-class.html b/docs/epy/googleapiclient.discovery._BytesGenerator-class.html
index 6a0630f7f6b..6edca215753 100644
--- a/docs/epy/googleapiclient.discovery._BytesGenerator-class.html
+++ b/docs/epy/googleapiclient.discovery._BytesGenerator-class.html
@@ -59,7 +59,7 @@
 <h1 class="epydoc">Class _BytesGenerator</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#_BytesGenerator">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_6" name="uml_class_diagram_for_googleap_6">
-<area shape="rect" id="node1" href="googleapiclient.discovery._BytesGenerator-class.html" title="googleapiclient.discovery._BytesGenerator" alt="" coords="5,5,129,51"/>
+<area shape="rect" id="node1" href="googleapiclient.discovery._BytesGenerator-class.html" title="googleapiclient.discovery._BytesGenerator" alt="" coords="5,5,129,48"/>
 </map>
   <img src="uml_class_diagram_for_googleap_6.gif" alt='' usemap="#uml_class_diagram_for_googleap_6" ismap="ismap" class="graph-without-title" />
 </center>
@@ -116,7 +116,7 @@ <h1 class="epydoc">Class _BytesGenerator</h1><p class="nomargin-top"><span class
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache-module.html b/docs/epy/googleapiclient.discovery_cache-module.html
index 9876ab7e96c..4348198a2f4 100644
--- a/docs/epy/googleapiclient.discovery_cache-module.html
+++ b/docs/epy/googleapiclient.discovery_cache-module.html
@@ -225,7 +225,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">autodetect</span>()<
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache-pysrc.html b/docs/epy/googleapiclient.discovery_cache-pysrc.html
index 3f54a8d8464..9e77de27df0 100644
--- a/docs/epy/googleapiclient.discovery_cache-pysrc.html
+++ b/docs/epy/googleapiclient.discovery_cache-pysrc.html
@@ -144,7 +144,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.discovery_cache-modu
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.appengine_memcache-module.html b/docs/epy/googleapiclient.discovery_cache.appengine_memcache-module.html
index 33716e43f95..def97575510 100644
--- a/docs/epy/googleapiclient.discovery_cache.appengine_memcache-module.html
+++ b/docs/epy/googleapiclient.discovery_cache.appengine_memcache-module.html
@@ -153,7 +153,7 @@ <h1 class="epydoc">Module appengine_memcache</h1><p class="nomargin-top"><span c
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.appengine_memcache-pysrc.html b/docs/epy/googleapiclient.discovery_cache.appengine_memcache-pysrc.html
index f6149786301..de474821b6a 100644
--- a/docs/epy/googleapiclient.discovery_cache.appengine_memcache-pysrc.html
+++ b/docs/epy/googleapiclient.discovery_cache.appengine_memcache-pysrc.html
@@ -165,7 +165,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.discovery_cache.appe
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.appengine_memcache.Cache-class.html b/docs/epy/googleapiclient.discovery_cache.appengine_memcache.Cache-class.html
index 55e19bf0220..773ab4d5c1c 100644
--- a/docs/epy/googleapiclient.discovery_cache.appengine_memcache.Cache-class.html
+++ b/docs/epy/googleapiclient.discovery_cache.appengine_memcache.Cache-class.html
@@ -60,12 +60,12 @@
 <h1 class="epydoc">Class Cache</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.discovery_cache.appengine_memcache-pysrc.html#Cache">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_7" name="uml_class_diagram_for_googleap_7">
-<area shape="rect" id="node1_4" href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#__init__" title="Constructor." alt="" coords="17,120,160,140"/>
-<area shape="rect" id="node1_5" href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#get" title="Gets the content from the memcache with a given key." alt="" coords="17,140,160,160"/>
-<area shape="rect" id="node1_6" href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#set" title="Sets the given key and content in the cache." alt="" coords="17,160,160,180"/>
-<area shape="rect" id="node1" href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html" title="A cache with app engine memcache API." alt="" coords="5,86,171,186"/>
-<area shape="rect" id="node2_7" href="googleapiclient.discovery_cache.base.Cache-class.html#__metaclass__" title="googleapiclient.discovery_cache.base.Cache.__metaclass__" alt="" coords="41,32,137,52"/>
-<area shape="rect" id="node2" href="googleapiclient.discovery_cache.base.Cache-class.html" title="A base abstract cache class." alt="" coords="29,6,149,66"/>
+<area shape="rect" id="node1_4" href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#__init__" title="Constructor." alt="" coords="18,111,161,129"/>
+<area shape="rect" id="node1_5" href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#get" title="Gets the content from the memcache with a given key." alt="" coords="18,129,161,148"/>
+<area shape="rect" id="node1_6" href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#set" title="Sets the given key and content in the cache." alt="" coords="18,148,161,167"/>
+<area shape="rect" id="node1" href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html" title="A cache with app engine memcache API." alt="" coords="5,80,172,173"/>
+<area shape="rect" id="node2_7" href="googleapiclient.discovery_cache.base.Cache-class.html#__metaclass__" title="googleapiclient.discovery_cache.base.Cache.__metaclass__" alt="" coords="42,28,137,47"/>
+<area shape="rect" id="node2" href="googleapiclient.discovery_cache.base.Cache-class.html" title="A base abstract cache class." alt="" coords="29,5,148,61"/>
 </map>
   <img src="uml_class_diagram_for_googleap_7.gif" alt='' usemap="#uml_class_diagram_for_googleap_7" ismap="ismap" class="graph-without-title" />
 </center>
@@ -358,7 +358,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">set</span>(<span cla
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.base-module.html b/docs/epy/googleapiclient.discovery_cache.base-module.html
index 7907d7b5467..575ce400014 100644
--- a/docs/epy/googleapiclient.discovery_cache.base-module.html
+++ b/docs/epy/googleapiclient.discovery_cache.base-module.html
@@ -114,7 +114,7 @@ <h1 class="epydoc">Module base</h1><p class="nomargin-top"><span class="codelink
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.base-pysrc.html b/docs/epy/googleapiclient.discovery_cache.base-pysrc.html
index 08c5012c4a1..d36406ac961 100644
--- a/docs/epy/googleapiclient.discovery_cache.base-pysrc.html
+++ b/docs/epy/googleapiclient.discovery_cache.base-pysrc.html
@@ -135,7 +135,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.discovery_cache.base
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.base.Cache-class.html b/docs/epy/googleapiclient.discovery_cache.base.Cache-class.html
index fd48c54ead3..c9d85d27bf9 100644
--- a/docs/epy/googleapiclient.discovery_cache.base.Cache-class.html
+++ b/docs/epy/googleapiclient.discovery_cache.base.Cache-class.html
@@ -60,10 +60,10 @@
 <h1 class="epydoc">Class Cache</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.discovery_cache.base-pysrc.html#Cache">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_8" name="uml_class_diagram_for_googleap_8">
-<area shape="rect" id="node1_3" href="googleapiclient.discovery_cache.base.Cache-class.html#__metaclass__" title="googleapiclient.discovery_cache.base.Cache.__metaclass__" alt="" coords="17,32,145,52"/>
-<area shape="rect" id="node1_4" href="googleapiclient.discovery_cache.base.Cache-class.html#get" title="Gets the content from the memcache with a given key." alt="" coords="17,55,145,75"/>
-<area shape="rect" id="node1_5" href="googleapiclient.discovery_cache.base.Cache-class.html#set" title="Sets the given key and content in the cache." alt="" coords="17,75,145,95"/>
-<area shape="rect" id="node1" href="googleapiclient.discovery_cache.base.Cache-class.html" title="A base abstract cache class." alt="" coords="5,6,157,101"/>
+<area shape="rect" id="node1_3" href="googleapiclient.discovery_cache.base.Cache-class.html#__metaclass__" title="googleapiclient.discovery_cache.base.Cache.__metaclass__" alt="" coords="17,28,143,47"/>
+<area shape="rect" id="node1_4" href="googleapiclient.discovery_cache.base.Cache-class.html#get" title="Gets the content from the memcache with a given key." alt="" coords="17,49,143,68"/>
+<area shape="rect" id="node1_5" href="googleapiclient.discovery_cache.base.Cache-class.html#set" title="Sets the given key and content in the cache." alt="" coords="17,68,143,87"/>
+<area shape="rect" id="node1" href="googleapiclient.discovery_cache.base.Cache-class.html" title="A base abstract cache class." alt="" coords="5,5,155,93"/>
 </map>
   <img src="uml_class_diagram_for_googleap_8.gif" alt='' usemap="#uml_class_diagram_for_googleap_8" ismap="ismap" class="graph-without-title" />
 </center>
@@ -309,7 +309,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">set</span>(<span cla
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.file_cache-module.html b/docs/epy/googleapiclient.discovery_cache.file_cache-module.html
index d6b71df3d60..5def35067cf 100644
--- a/docs/epy/googleapiclient.discovery_cache.file_cache-module.html
+++ b/docs/epy/googleapiclient.discovery_cache.file_cache-module.html
@@ -215,7 +215,7 @@ <h1 class="epydoc">Module file_cache</h1><p class="nomargin-top"><span class="co
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.file_cache-pysrc.html b/docs/epy/googleapiclient.discovery_cache.file_cache-pysrc.html
index cd97143ae41..5c76f1dff83 100644
--- a/docs/epy/googleapiclient.discovery_cache.file_cache-pysrc.html
+++ b/docs/epy/googleapiclient.discovery_cache.file_cache-pysrc.html
@@ -276,7 +276,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.discovery_cache.file
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:51 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.discovery_cache.file_cache.Cache-class.html b/docs/epy/googleapiclient.discovery_cache.file_cache.Cache-class.html
index e54bb855044..31be0a4a2b8 100644
--- a/docs/epy/googleapiclient.discovery_cache.file_cache.Cache-class.html
+++ b/docs/epy/googleapiclient.discovery_cache.file_cache.Cache-class.html
@@ -60,12 +60,12 @@
 <h1 class="epydoc">Class Cache</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.discovery_cache.file_cache-pysrc.html#Cache">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_9" name="uml_class_diagram_for_googleap_9">
-<area shape="rect" id="node1_4" href="googleapiclient.discovery_cache.file_cache.Cache-class.html#__init__" title="Constructor." alt="" coords="17,120,160,140"/>
-<area shape="rect" id="node1_5" href="googleapiclient.discovery_cache.file_cache.Cache-class.html#get" title="Gets the content from the memcache with a given key." alt="" coords="17,140,160,160"/>
-<area shape="rect" id="node1_6" href="googleapiclient.discovery_cache.file_cache.Cache-class.html#set" title="Sets the given key and content in the cache." alt="" coords="17,160,160,180"/>
-<area shape="rect" id="node1" href="googleapiclient.discovery_cache.file_cache.Cache-class.html" title="A file based cache for the discovery documents." alt="" coords="5,86,171,186"/>
-<area shape="rect" id="node2_7" href="googleapiclient.discovery_cache.base.Cache-class.html#__metaclass__" title="googleapiclient.discovery_cache.base.Cache.__metaclass__" alt="" coords="41,32,137,52"/>
-<area shape="rect" id="node2" href="googleapiclient.discovery_cache.base.Cache-class.html" title="A base abstract cache class." alt="" coords="29,6,149,66"/>
+<area shape="rect" id="node1_4" href="googleapiclient.discovery_cache.file_cache.Cache-class.html#__init__" title="Constructor." alt="" coords="18,111,161,129"/>
+<area shape="rect" id="node1_5" href="googleapiclient.discovery_cache.file_cache.Cache-class.html#get" title="Gets the content from the memcache with a given key." alt="" coords="18,129,161,148"/>
+<area shape="rect" id="node1_6" href="googleapiclient.discovery_cache.file_cache.Cache-class.html#set" title="Sets the given key and content in the cache." alt="" coords="18,148,161,167"/>
+<area shape="rect" id="node1" href="googleapiclient.discovery_cache.file_cache.Cache-class.html" title="A file based cache for the discovery documents." alt="" coords="5,80,172,173"/>
+<area shape="rect" id="node2_7" href="googleapiclient.discovery_cache.base.Cache-class.html#__metaclass__" title="googleapiclient.discovery_cache.base.Cache.__metaclass__" alt="" coords="42,28,137,47"/>
+<area shape="rect" id="node2" href="googleapiclient.discovery_cache.base.Cache-class.html" title="A base abstract cache class." alt="" coords="29,5,148,61"/>
 </map>
   <img src="uml_class_diagram_for_googleap_9.gif" alt='' usemap="#uml_class_diagram_for_googleap_9" ismap="ismap" class="graph-without-title" />
 </center>
@@ -358,7 +358,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">set</span>(<span cla
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors-module.html b/docs/epy/googleapiclient.errors-module.html
index b8acabd8a6c..beaf83e431a 100644
--- a/docs/epy/googleapiclient.errors-module.html
+++ b/docs/epy/googleapiclient.errors-module.html
@@ -224,7 +224,7 @@ <h1 class="epydoc">Module errors</h1><p class="nomargin-top"><span class="codeli
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors-pysrc.html b/docs/epy/googleapiclient.errors-pysrc.html
index f1fe1c42c05..b75e2726795 100644
--- a/docs/epy/googleapiclient.errors-pysrc.html
+++ b/docs/epy/googleapiclient.errors-pysrc.html
@@ -296,7 +296,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.errors-module.html">
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.BatchError-class.html b/docs/epy/googleapiclient.errors.BatchError-class.html
index 8f6fee956c1..af95d2dfcb7 100644
--- a/docs/epy/googleapiclient.errors.BatchError-class.html
+++ b/docs/epy/googleapiclient.errors.BatchError-class.html
@@ -59,25 +59,25 @@
 <h1 class="epydoc">Class BatchError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#BatchError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_10" name="uml_class_diagram_for_googleap_10">
-<area shape="rect" id="node1_14" href="googleapiclient.errors.BatchError-class.html#__init__" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="17,501,308,521"/>
-<area shape="rect" id="node1_15" href="googleapiclient.errors.BatchError-class.html#__repr__" title="str(x)" alt="" coords="17,521,308,541"/>
-<area shape="rect" id="node1_16" href="googleapiclient.errors.BatchError-class.html#__str__" title="str(x)" alt="" coords="17,541,308,561"/>
-<area shape="rect" id="node1" href="googleapiclient.errors.BatchError-class.html" title="Error occured during batch operations." alt="" coords="5,467,320,567"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.HttpError-class.html" title="HTTP data was invalid or unexpected." alt="" coords="122,403,201,448"/>
-<area shape="rect" id="node3" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="134,339,189,384"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="84,31,241,51"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="84,51,241,71"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="84,73,241,93"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="84,93,241,113"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[y]" alt="" coords="84,113,241,133"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="x[i:j]" alt="" coords="84,133,241,153"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="helper for pickle" alt="" coords="84,153,241,173"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="84,173,241,193"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="84,193,241,213"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="84,213,241,233"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="72,5,253,240"/>
-<area shape="rect" id="node5_27" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="99,293,225,313"/>
-<area shape="rect" id="node5" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="86,259,237,319"/>
+<area shape="rect" id="node1_14" href="googleapiclient.errors.BatchError-class.html#__init__" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="17,471,311,489"/>
+<area shape="rect" id="node1_15" href="googleapiclient.errors.BatchError-class.html#__repr__" title="str(x)" alt="" coords="17,489,311,508"/>
+<area shape="rect" id="node1_16" href="googleapiclient.errors.BatchError-class.html#__str__" title="str(x)" alt="" coords="17,508,311,527"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.BatchError-class.html" title="Error occured during batch operations." alt="" coords="5,440,323,533"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.HttpError-class.html" title="HTTP data was invalid or unexpected." alt="" coords="125,379,203,421"/>
+<area shape="rect" id="node3_17" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="101,273,227,292"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="89,243,239,299"/>
+<area shape="rect" id="node5" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="137,317,191,360"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="85,28,241,47"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="85,47,241,65"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="85,68,241,87"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="85,87,241,105"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="x[y]" alt="" coords="85,105,241,124"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="x[i:j]" alt="" coords="85,124,241,143"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="helper for pickle" alt="" coords="85,143,241,161"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="85,161,241,180"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="85,180,241,199"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="85,199,241,217"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="73,5,253,224"/>
 </map>
   <img src="uml_class_diagram_for_googleap_10.gif" alt='' usemap="#uml_class_diagram_for_googleap_10" ismap="ismap" class="graph-without-title" />
 </center>
@@ -349,7 +349,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__str__</span>(<span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.Error-class.html b/docs/epy/googleapiclient.errors.Error-class.html
index 59ce260147a..7ff585c0be2 100644
--- a/docs/epy/googleapiclient.errors.Error-class.html
+++ b/docs/epy/googleapiclient.errors.Error-class.html
@@ -59,23 +59,23 @@
 <h1 class="epydoc">Class Error</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#Error">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_11" name="uml_class_diagram_for_googleap_11">
-<area shape="rect" id="node1" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="67,397,122,443"/>
-<area shape="rect" id="node2_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="32,332,159,352"/>
-<area shape="rect" id="node2_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="32,352,159,372"/>
-<area shape="rect" id="node2" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="19,299,170,379"/>
-<area shape="rect" id="node3_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="17,31,175,51"/>
-<area shape="rect" id="node3_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="17,51,175,71"/>
-<area shape="rect" id="node3_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="17,73,175,93"/>
-<area shape="rect" id="node3_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="17,93,175,113"/>
-<area shape="rect" id="node3_20" href="javascript:void(0);" title="x[y]" alt="" coords="17,113,175,133"/>
-<area shape="rect" id="node3_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="17,133,175,153"/>
-<area shape="rect" id="node3_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="17,153,175,173"/>
-<area shape="rect" id="node3_23" href="javascript:void(0);" title="repr(x)" alt="" coords="17,173,175,193"/>
-<area shape="rect" id="node3_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="17,193,175,213"/>
-<area shape="rect" id="node3_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="17,213,175,233"/>
-<area shape="rect" id="node3_26" href="javascript:void(0);" title="str(x)" alt="" coords="17,233,175,253"/>
-<area shape="rect" id="node3_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="17,253,175,273"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,187,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="70,373,123,416"/>
+<area shape="rect" id="node2_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="34,311,159,329"/>
+<area shape="rect" id="node2_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="34,329,159,348"/>
+<area shape="rect" id="node2" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="22,280,171,355"/>
+<area shape="rect" id="node3_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="18,28,174,47"/>
+<area shape="rect" id="node3_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="18,47,174,65"/>
+<area shape="rect" id="node3_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="18,68,174,87"/>
+<area shape="rect" id="node3_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="18,87,174,105"/>
+<area shape="rect" id="node3_20" href="javascript:void(0);" title="x[y]" alt="" coords="18,105,174,124"/>
+<area shape="rect" id="node3_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="18,124,174,143"/>
+<area shape="rect" id="node3_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="18,143,174,161"/>
+<area shape="rect" id="node3_23" href="javascript:void(0);" title="repr(x)" alt="" coords="18,161,174,180"/>
+<area shape="rect" id="node3_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="18,180,174,199"/>
+<area shape="rect" id="node3_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="18,199,174,217"/>
+<area shape="rect" id="node3_26" href="javascript:void(0);" title="str(x)" alt="" coords="18,217,174,236"/>
+<area shape="rect" id="node3_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="18,236,174,255"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,185,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_11.gif" alt='' usemap="#uml_class_diagram_for_googleap_11" ismap="ismap" class="graph-without-title" />
 </center>
@@ -186,7 +186,7 @@ <h1 class="epydoc">Class Error</h1><p class="nomargin-top"><span class="codelink
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.HttpError-class.html b/docs/epy/googleapiclient.errors.HttpError-class.html
index 9608bf498c8..ee959cfa98f 100644
--- a/docs/epy/googleapiclient.errors.HttpError-class.html
+++ b/docs/epy/googleapiclient.errors.HttpError-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class HttpError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#HttpError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_12" name="uml_class_diagram_for_googleap_12">
-<area shape="rect" id="node1_14" href="googleapiclient.errors.HttpError-class.html#__init__" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="17,437,244,457"/>
-<area shape="rect" id="node1_15" href="googleapiclient.errors.HttpError-class.html#__repr__" title="str(x)" alt="" coords="17,457,244,477"/>
-<area shape="rect" id="node1_16" href="googleapiclient.errors.HttpError-class.html#__str__" title="str(x)" alt="" coords="17,477,244,497"/>
-<area shape="rect" id="node1" href="googleapiclient.errors.HttpError-class.html" title="HTTP data was invalid or unexpected." alt="" coords="5,403,256,503"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="102,339,157,384"/>
-<area shape="rect" id="node3_17" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="67,293,193,313"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="54,259,205,319"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="52,31,209,51"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="52,51,209,71"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="52,73,209,93"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="52,93,209,113"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="x[y]" alt="" coords="52,113,209,133"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="x[i:j]" alt="" coords="52,133,209,153"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="helper for pickle" alt="" coords="52,153,209,173"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="52,173,209,193"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="52,193,209,213"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="52,213,209,233"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="40,5,221,240"/>
+<area shape="rect" id="node1_14" href="googleapiclient.errors.HttpError-class.html#__init__" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="18,409,246,428"/>
+<area shape="rect" id="node1_15" href="googleapiclient.errors.HttpError-class.html#__repr__" title="str(x)" alt="" coords="18,428,246,447"/>
+<area shape="rect" id="node1_16" href="googleapiclient.errors.HttpError-class.html#__str__" title="str(x)" alt="" coords="18,447,246,465"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.HttpError-class.html" title="HTTP data was invalid or unexpected." alt="" coords="5,379,257,472"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="106,317,159,360"/>
+<area shape="rect" id="node3_17" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="70,273,195,292"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="58,243,207,299"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="54,28,210,47"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="54,47,210,65"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="54,68,210,87"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="54,87,210,105"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="x[y]" alt="" coords="54,105,210,124"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="x[i:j]" alt="" coords="54,124,210,143"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="helper for pickle" alt="" coords="54,143,210,161"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="54,161,210,180"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="54,180,210,199"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="54,199,210,217"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="41,5,221,224"/>
 </map>
   <img src="uml_class_diagram_for_googleap_12.gif" alt='' usemap="#uml_class_diagram_for_googleap_12" ismap="ismap" class="graph-without-title" />
 </center>
@@ -362,7 +362,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__str__</span>(<span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.InvalidChunkSizeError-class.html b/docs/epy/googleapiclient.errors.InvalidChunkSizeError-class.html
index 84dcb3c03df..9129948ce53 100644
--- a/docs/epy/googleapiclient.errors.InvalidChunkSizeError-class.html
+++ b/docs/epy/googleapiclient.errors.InvalidChunkSizeError-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class InvalidChunkSizeError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#InvalidChunkSizeError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_13" name="uml_class_diagram_for_googleap_13">
-<area shape="rect" id="node1" href="googleapiclient.errors.InvalidChunkSizeError-class.html" title="The given chunksize is not valid." alt="" coords="17,461,173,507"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="67,397,122,443"/>
-<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="32,332,159,352"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="32,352,159,372"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="19,299,170,379"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="17,31,175,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="17,51,175,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="17,73,175,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="17,93,175,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="17,113,175,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="17,133,175,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="17,153,175,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="17,173,175,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="17,193,175,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="17,213,175,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="17,233,175,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="17,253,175,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,187,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.InvalidChunkSizeError-class.html" title="The given chunksize is not valid." alt="" coords="17,435,173,477"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="70,373,123,416"/>
+<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="34,311,159,329"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="34,329,159,348"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="22,280,171,355"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="18,28,174,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="18,47,174,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="18,68,174,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="18,87,174,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="18,105,174,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="18,124,174,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="18,143,174,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="18,161,174,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="18,180,174,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="18,199,174,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="18,217,174,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="18,236,174,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,185,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_13.gif" alt='' usemap="#uml_class_diagram_for_googleap_13" ismap="ismap" class="graph-without-title" />
 </center>
@@ -187,7 +187,7 @@ <h1 class="epydoc">Class InvalidChunkSizeError</h1><p class="nomargin-top"><span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.InvalidJsonError-class.html b/docs/epy/googleapiclient.errors.InvalidJsonError-class.html
index 0f53fd5b4a3..a703042fd42 100644
--- a/docs/epy/googleapiclient.errors.InvalidJsonError-class.html
+++ b/docs/epy/googleapiclient.errors.InvalidJsonError-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class InvalidJsonError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#InvalidJsonError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_14" name="uml_class_diagram_for_googleap_14">
-<area shape="rect" id="node1" href="googleapiclient.errors.InvalidJsonError-class.html" title="The JSON returned could not be parsed." alt="" coords="36,461,156,507"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="67,397,122,443"/>
-<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="32,332,159,352"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="32,352,159,372"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="19,299,170,379"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="17,31,175,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="17,51,175,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="17,73,175,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="17,93,175,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="17,113,175,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="17,133,175,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="17,153,175,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="17,173,175,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="17,193,175,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="17,213,175,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="17,233,175,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="17,253,175,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,187,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.InvalidJsonError-class.html" title="The JSON returned could not be parsed." alt="" coords="37,435,157,477"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="70,373,123,416"/>
+<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="34,311,159,329"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="34,329,159,348"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="22,280,171,355"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="18,28,174,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="18,47,174,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="18,68,174,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="18,87,174,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="18,105,174,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="18,124,174,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="18,143,174,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="18,161,174,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="18,180,174,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="18,199,174,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="18,217,174,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="18,236,174,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,185,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_14.gif" alt='' usemap="#uml_class_diagram_for_googleap_14" ismap="ismap" class="graph-without-title" />
 </center>
@@ -187,7 +187,7 @@ <h1 class="epydoc">Class InvalidJsonError</h1><p class="nomargin-top"><span clas
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.InvalidNotificationError-class.html b/docs/epy/googleapiclient.errors.InvalidNotificationError-class.html
index 775cc5b0ed7..dc56e58a41d 100644
--- a/docs/epy/googleapiclient.errors.InvalidNotificationError-class.html
+++ b/docs/epy/googleapiclient.errors.InvalidNotificationError-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class InvalidNotificationError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#InvalidNotificationError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_15" name="uml_class_diagram_for_googleap_15">
-<area shape="rect" id="node1" href="googleapiclient.errors.InvalidNotificationError-class.html" title="The channel Notification is invalid." alt="" coords="15,461,174,507"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="67,397,122,443"/>
-<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="32,332,159,352"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="32,352,159,372"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="19,299,170,379"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="17,31,175,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="17,51,175,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="17,73,175,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="17,93,175,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="17,113,175,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="17,133,175,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="17,153,175,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="17,173,175,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="17,193,175,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="17,213,175,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="17,233,175,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="17,253,175,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,187,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.InvalidNotificationError-class.html" title="The channel Notification is invalid." alt="" coords="18,435,175,477"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="70,373,123,416"/>
+<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="34,311,159,329"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="34,329,159,348"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="22,280,171,355"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="18,28,174,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="18,47,174,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="18,68,174,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="18,87,174,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="18,105,174,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="18,124,174,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="18,143,174,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="18,161,174,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="18,180,174,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="18,199,174,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="18,217,174,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="18,236,174,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,185,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_15.gif" alt='' usemap="#uml_class_diagram_for_googleap_15" ismap="ismap" class="graph-without-title" />
 </center>
@@ -187,7 +187,7 @@ <h1 class="epydoc">Class InvalidNotificationError</h1><p class="nomargin-top"><s
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.MediaUploadSizeError-class.html b/docs/epy/googleapiclient.errors.MediaUploadSizeError-class.html
index 4c57ad23801..be6285b403b 100644
--- a/docs/epy/googleapiclient.errors.MediaUploadSizeError-class.html
+++ b/docs/epy/googleapiclient.errors.MediaUploadSizeError-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class MediaUploadSizeError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#MediaUploadSizeError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_16" name="uml_class_diagram_for_googleap_16">
-<area shape="rect" id="node1" href="googleapiclient.errors.MediaUploadSizeError-class.html" title="Media is larger than the method can accept." alt="" coords="17,461,173,507"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="67,397,122,443"/>
-<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="32,332,159,352"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="32,352,159,372"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="19,299,170,379"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="17,31,175,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="17,51,175,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="17,73,175,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="17,93,175,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="17,113,175,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="17,133,175,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="17,153,175,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="17,173,175,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="17,193,175,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="17,213,175,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="17,233,175,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="17,253,175,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,187,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.MediaUploadSizeError-class.html" title="Media is larger than the method can accept." alt="" coords="18,435,175,477"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="70,373,123,416"/>
+<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="34,311,159,329"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="34,329,159,348"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="22,280,171,355"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="18,28,174,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="18,47,174,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="18,68,174,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="18,87,174,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="18,105,174,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="18,124,174,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="18,143,174,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="18,161,174,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="18,180,174,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="18,199,174,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="18,217,174,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="18,236,174,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,185,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_16.gif" alt='' usemap="#uml_class_diagram_for_googleap_16" ismap="ismap" class="graph-without-title" />
 </center>
@@ -187,7 +187,7 @@ <h1 class="epydoc">Class MediaUploadSizeError</h1><p class="nomargin-top"><span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.ResumableUploadError-class.html b/docs/epy/googleapiclient.errors.ResumableUploadError-class.html
index 34802acdab4..7a41d454c8b 100644
--- a/docs/epy/googleapiclient.errors.ResumableUploadError-class.html
+++ b/docs/epy/googleapiclient.errors.ResumableUploadError-class.html
@@ -59,25 +59,25 @@
 <h1 class="epydoc">Class ResumableUploadError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#ResumableUploadError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_17" name="uml_class_diagram_for_googleap_17">
-<area shape="rect" id="node1" href="googleapiclient.errors.ResumableUploadError-class.html" title="Error occured during resumable upload." alt="" coords="49,523,210,568"/>
-<area shape="rect" id="node2_14" href="googleapiclient.errors.HttpError-class.html#__init__" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="17,437,244,457"/>
-<area shape="rect" id="node2_15" href="googleapiclient.errors.HttpError-class.html#__repr__" title="str(x)" alt="" coords="17,457,244,477"/>
-<area shape="rect" id="node2_16" href="googleapiclient.errors.HttpError-class.html#__str__" title="str(x)" alt="" coords="17,477,244,497"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.HttpError-class.html" title="HTTP data was invalid or unexpected." alt="" coords="5,403,256,503"/>
-<area shape="rect" id="node3" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="102,339,157,384"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="52,31,209,51"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="52,51,209,71"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="52,73,209,93"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="52,93,209,113"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[y]" alt="" coords="52,113,209,133"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="x[i:j]" alt="" coords="52,133,209,153"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="helper for pickle" alt="" coords="52,153,209,173"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="52,173,209,193"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="52,193,209,213"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="52,213,209,233"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="40,5,221,240"/>
-<area shape="rect" id="node5_27" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="67,293,193,313"/>
-<area shape="rect" id="node5" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="54,259,205,319"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.ResumableUploadError-class.html" title="Error occured during resumable upload." alt="" coords="51,491,214,533"/>
+<area shape="rect" id="node2_14" href="googleapiclient.errors.HttpError-class.html#__init__" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="18,409,246,428"/>
+<area shape="rect" id="node2_15" href="googleapiclient.errors.HttpError-class.html#__repr__" title="str(x)" alt="" coords="18,428,246,447"/>
+<area shape="rect" id="node2_16" href="googleapiclient.errors.HttpError-class.html#__str__" title="str(x)" alt="" coords="18,447,246,465"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.HttpError-class.html" title="HTTP data was invalid or unexpected." alt="" coords="5,379,257,472"/>
+<area shape="rect" id="node3_17" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="70,273,195,292"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="58,243,207,299"/>
+<area shape="rect" id="node5" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="106,317,159,360"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="54,28,210,47"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="54,47,210,65"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="54,68,210,87"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="54,87,210,105"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="x[y]" alt="" coords="54,105,210,124"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="x[i:j]" alt="" coords="54,124,210,143"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="helper for pickle" alt="" coords="54,143,210,161"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="54,161,210,180"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="54,180,210,199"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="54,199,210,217"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="41,5,221,224"/>
 </map>
   <img src="uml_class_diagram_for_googleap_17.gif" alt='' usemap="#uml_class_diagram_for_googleap_17" ismap="ismap" class="graph-without-title" />
 </center>
@@ -193,7 +193,7 @@ <h1 class="epydoc">Class ResumableUploadError</h1><p class="nomargin-top"><span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.UnacceptableMimeTypeError-class.html b/docs/epy/googleapiclient.errors.UnacceptableMimeTypeError-class.html
index 267e8cd2ec4..5d100b92348 100644
--- a/docs/epy/googleapiclient.errors.UnacceptableMimeTypeError-class.html
+++ b/docs/epy/googleapiclient.errors.UnacceptableMimeTypeError-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class UnacceptableMimeTypeError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#UnacceptableMimeTypeError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_18" name="uml_class_diagram_for_googleap_18">
-<area shape="rect" id="node1" href="googleapiclient.errors.UnacceptableMimeTypeError-class.html" title="That is an unacceptable mimetype for this operation." alt="" coords="5,461,200,507"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="74,397,129,443"/>
-<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="39,332,165,352"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="39,352,165,372"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="26,299,177,379"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="24,31,181,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="24,51,181,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="24,73,181,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="24,93,181,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="24,113,181,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="24,133,181,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="24,153,181,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="24,173,181,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="24,193,181,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="24,213,181,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="24,233,181,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="24,253,181,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="12,5,193,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.UnacceptableMimeTypeError-class.html" title="That is an unacceptable mimetype for this operation." alt="" coords="5,435,201,477"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="78,373,131,416"/>
+<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="42,311,167,329"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="42,329,167,348"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="30,280,179,355"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="26,28,182,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="26,47,182,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="26,68,182,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="26,87,182,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="26,105,182,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="26,124,182,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="26,143,182,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="26,161,182,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="26,180,182,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="26,199,182,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="26,217,182,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="26,236,182,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="13,5,193,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_18.gif" alt='' usemap="#uml_class_diagram_for_googleap_18" ismap="ismap" class="graph-without-title" />
 </center>
@@ -187,7 +187,7 @@ <h1 class="epydoc">Class UnacceptableMimeTypeError</h1><p class="nomargin-top"><
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.UnexpectedBodyError-class.html b/docs/epy/googleapiclient.errors.UnexpectedBodyError-class.html
index 455eb81a530..8c1b148ad58 100644
--- a/docs/epy/googleapiclient.errors.UnexpectedBodyError-class.html
+++ b/docs/epy/googleapiclient.errors.UnexpectedBodyError-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class UnexpectedBodyError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#UnexpectedBodyError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_19" name="uml_class_diagram_for_googleap_19">
-<area shape="rect" id="node1_14" href="googleapiclient.errors.UnexpectedBodyError-class.html#__init__" title="Constructor for an UnexpectedMethodError." alt="" coords="16,477,216,497"/>
-<area shape="rect" id="node1" href="googleapiclient.errors.UnexpectedBodyError-class.html" title="Exception raised by RequestMockBuilder on unexpected bodies." alt="" coords="4,443,228,503"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="87,379,142,424"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="52,333,179,353"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="39,299,190,359"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="37,31,195,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="37,51,195,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="37,73,195,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="37,93,195,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="37,113,195,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="37,133,195,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="37,153,195,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="37,173,195,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="37,193,195,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="37,213,195,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="37,233,195,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="37,253,195,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="25,5,207,280"/>
+<area shape="rect" id="node1_14" href="googleapiclient.errors.UnexpectedBodyError-class.html#__init__" title="Constructor for an UnexpectedMethodError." alt="" coords="18,447,219,465"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.UnexpectedBodyError-class.html" title="Exception raised by RequestMockBuilder on unexpected bodies." alt="" coords="5,416,231,472"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="93,355,146,397"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="57,311,182,329"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="45,280,194,336"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="41,28,197,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="41,47,197,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="41,68,197,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="41,87,197,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="41,105,197,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="41,124,197,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="41,143,197,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="41,161,197,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="41,180,197,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="41,199,197,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="41,217,197,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="41,236,197,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="28,5,208,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_19.gif" alt='' usemap="#uml_class_diagram_for_googleap_19" ismap="ismap" class="graph-without-title" />
 </center>
@@ -252,7 +252,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.UnexpectedMethodError-class.html b/docs/epy/googleapiclient.errors.UnexpectedMethodError-class.html
index a99b5c0f130..d3a038a7a39 100644
--- a/docs/epy/googleapiclient.errors.UnexpectedMethodError-class.html
+++ b/docs/epy/googleapiclient.errors.UnexpectedMethodError-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class UnexpectedMethodError</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#UnexpectedMethodError">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_20" name="uml_class_diagram_for_googleap_20">
-<area shape="rect" id="node1_14" href="googleapiclient.errors.UnexpectedMethodError-class.html#__init__" title="Constructor for an UnexpectedMethodError." alt="" coords="17,477,200,497"/>
-<area shape="rect" id="node1" href="googleapiclient.errors.UnexpectedMethodError-class.html" title="Exception raised by RequestMockBuilder on unexpected calls." alt="" coords="5,443,211,503"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="81,379,135,424"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="45,333,172,353"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="33,299,183,359"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="31,31,188,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="31,51,188,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="31,73,188,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="31,93,188,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="31,113,188,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="31,133,188,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="31,153,188,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="31,173,188,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="31,193,188,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="31,213,188,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="31,233,188,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="31,253,188,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="19,5,200,280"/>
+<area shape="rect" id="node1_14" href="googleapiclient.errors.UnexpectedMethodError-class.html#__init__" title="Constructor for an UnexpectedMethodError." alt="" coords="17,447,201,465"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.UnexpectedMethodError-class.html" title="Exception raised by RequestMockBuilder on unexpected calls." alt="" coords="5,416,213,472"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="83,355,136,397"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="47,311,172,329"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="35,280,184,336"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="31,28,187,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="31,47,187,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="31,68,187,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="31,87,187,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="31,105,187,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="31,124,187,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="31,143,187,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="31,161,187,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="31,180,187,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="31,199,187,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="31,217,187,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="31,236,187,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="18,5,198,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_20.gif" alt='' usemap="#uml_class_diagram_for_googleap_20" ismap="ismap" class="graph-without-title" />
 </center>
@@ -254,7 +254,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:03 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.UnknownApiNameOrVersion-class.html b/docs/epy/googleapiclient.errors.UnknownApiNameOrVersion-class.html
index a120d975d8c..9383c28d81a 100644
--- a/docs/epy/googleapiclient.errors.UnknownApiNameOrVersion-class.html
+++ b/docs/epy/googleapiclient.errors.UnknownApiNameOrVersion-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class UnknownApiNameOrVersion</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#UnknownApiNameOrVersion">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_21" name="uml_class_diagram_for_googleap_21">
-<area shape="rect" id="node1" href="googleapiclient.errors.UnknownApiNameOrVersion-class.html" title="No API with that name and version exists." alt="" coords="5,461,198,507"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="74,397,129,443"/>
-<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="39,332,165,352"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="39,352,165,372"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="26,299,177,379"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="24,31,181,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="24,51,181,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="24,73,181,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="24,93,181,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="24,113,181,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="24,133,181,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="24,153,181,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="24,173,181,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="24,193,181,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="24,213,181,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="24,233,181,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="24,253,181,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="12,5,193,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.UnknownApiNameOrVersion-class.html" title="No API with that name and version exists." alt="" coords="5,435,199,477"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="77,373,130,416"/>
+<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="41,311,166,329"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="41,329,166,348"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="29,280,178,355"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="25,28,181,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="25,47,181,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="25,68,181,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="25,87,181,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="25,105,181,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="25,124,181,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="25,143,181,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="25,161,181,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="25,180,181,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="25,199,181,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="25,217,181,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="25,236,181,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="12,5,192,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_21.gif" alt='' usemap="#uml_class_diagram_for_googleap_21" ismap="ismap" class="graph-without-title" />
 </center>
@@ -187,7 +187,7 @@ <h1 class="epydoc">Class UnknownApiNameOrVersion</h1><p class="nomargin-top"><sp
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.UnknownFileType-class.html b/docs/epy/googleapiclient.errors.UnknownFileType-class.html
index 5be39985575..a90269d23bf 100644
--- a/docs/epy/googleapiclient.errors.UnknownFileType-class.html
+++ b/docs/epy/googleapiclient.errors.UnknownFileType-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class UnknownFileType</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#UnknownFileType">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_22" name="uml_class_diagram_for_googleap_22">
-<area shape="rect" id="node1" href="googleapiclient.errors.UnknownFileType-class.html" title="File type unknown or unexpected." alt="" coords="31,461,161,507"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="67,397,122,443"/>
-<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="32,332,159,352"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="32,352,159,372"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="19,299,170,379"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="17,31,175,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="17,51,175,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="17,73,175,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="17,93,175,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="17,113,175,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="17,133,175,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="17,153,175,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="17,173,175,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="17,193,175,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="17,213,175,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="17,233,175,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="17,253,175,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,187,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.UnknownFileType-class.html" title="File type unknown or unexpected." alt="" coords="31,435,160,477"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="70,373,123,416"/>
+<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="34,311,159,329"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="34,329,159,348"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="22,280,171,355"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="18,28,174,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="18,47,174,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="18,68,174,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="18,87,174,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="18,105,174,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="18,124,174,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="18,143,174,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="18,161,174,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="18,180,174,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="18,199,174,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="18,217,174,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="18,236,174,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,185,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_22.gif" alt='' usemap="#uml_class_diagram_for_googleap_22" ismap="ismap" class="graph-without-title" />
 </center>
@@ -187,7 +187,7 @@ <h1 class="epydoc">Class UnknownFileType</h1><p class="nomargin-top"><span class
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.errors.UnknownLinkType-class.html b/docs/epy/googleapiclient.errors.UnknownLinkType-class.html
index 8020548b4d7..1deafd9cf98 100644
--- a/docs/epy/googleapiclient.errors.UnknownLinkType-class.html
+++ b/docs/epy/googleapiclient.errors.UnknownLinkType-class.html
@@ -59,24 +59,24 @@
 <h1 class="epydoc">Class UnknownLinkType</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.errors-pysrc.html#UnknownLinkType">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_23" name="uml_class_diagram_for_googleap_23">
-<area shape="rect" id="node1" href="googleapiclient.errors.UnknownLinkType-class.html" title="Link type unknown or unexpected." alt="" coords="27,461,162,507"/>
-<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="67,397,122,443"/>
-<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="32,332,159,352"/>
-<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="32,352,159,372"/>
-<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="19,299,170,379"/>
-<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="17,31,175,51"/>
-<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="17,51,175,71"/>
-<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="17,73,175,93"/>
-<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="17,93,175,113"/>
-<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="17,113,175,133"/>
-<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="17,133,175,153"/>
-<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="17,153,175,173"/>
-<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="17,173,175,193"/>
-<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="17,193,175,213"/>
-<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="17,213,175,233"/>
-<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="17,233,175,253"/>
-<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="17,253,175,273"/>
-<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,187,280"/>
+<area shape="rect" id="node1" href="googleapiclient.errors.UnknownLinkType-class.html" title="Link type unknown or unexpected." alt="" coords="29,435,161,477"/>
+<area shape="rect" id="node2" href="googleapiclient.errors.Error-class.html" title="Base error for this module." alt="" coords="70,373,123,416"/>
+<area shape="rect" id="node3_14" href="javascript:void(0);" title="x.__init__(...) initializes x; see help(type(x)) for signature" alt="" coords="34,311,159,329"/>
+<area shape="rect" id="node3_15" href="javascript:void(0);" title="exceptions.Exception.__new__" alt="" coords="34,329,159,348"/>
+<area shape="rect" id="node3" href="javascript:void(0);" title="Common base class for all non&#45;exit exceptions." alt="" coords="22,280,171,355"/>
+<area shape="rect" id="node4_16" href="javascript:void(0);" title="exceptions.BaseException.args" alt="" coords="18,28,174,47"/>
+<area shape="rect" id="node4_17" href="javascript:void(0);" title="exceptions.BaseException.message" alt="" coords="18,47,174,65"/>
+<area shape="rect" id="node4_18" href="javascript:void(0);" title="x.__delattr__(&#39;name&#39;) &lt;==&gt; del x.name" alt="" coords="18,68,174,87"/>
+<area shape="rect" id="node4_19" href="javascript:void(0);" title="x.__getattribute__(&#39;name&#39;) &lt;==&gt; x.name" alt="" coords="18,87,174,105"/>
+<area shape="rect" id="node4_20" href="javascript:void(0);" title="x[y]" alt="" coords="18,105,174,124"/>
+<area shape="rect" id="node4_21" href="javascript:void(0);" title="x[i:j]" alt="" coords="18,124,174,143"/>
+<area shape="rect" id="node4_22" href="javascript:void(0);" title="helper for pickle" alt="" coords="18,143,174,161"/>
+<area shape="rect" id="node4_23" href="javascript:void(0);" title="repr(x)" alt="" coords="18,161,174,180"/>
+<area shape="rect" id="node4_24" href="javascript:void(0);" title="x.__setattr__(&#39;name&#39;, value) &lt;==&gt; x.name = value" alt="" coords="18,180,174,199"/>
+<area shape="rect" id="node4_25" href="javascript:void(0);" title="exceptions.BaseException.__setstate__" alt="" coords="18,199,174,217"/>
+<area shape="rect" id="node4_26" href="javascript:void(0);" title="str(x)" alt="" coords="18,217,174,236"/>
+<area shape="rect" id="node4_27" href="javascript:void(0);" title="exceptions.BaseException.__unicode__" alt="" coords="18,236,174,255"/>
+<area shape="rect" id="node4" href="javascript:void(0);" title="Common base class for all exceptions" alt="" coords="5,5,185,261"/>
 </map>
   <img src="uml_class_diagram_for_googleap_23.gif" alt='' usemap="#uml_class_diagram_for_googleap_23" ismap="ismap" class="graph-without-title" />
 </center>
@@ -187,7 +187,7 @@ <h1 class="epydoc">Class UnknownLinkType</h1><p class="nomargin-top"><span class
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http-module.html b/docs/epy/googleapiclient.http-module.html
index 836ff2b9550..7a75b720c4a 100644
--- a/docs/epy/googleapiclient.http-module.html
+++ b/docs/epy/googleapiclient.http-module.html
@@ -544,7 +544,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">tunnel_patch</span>(
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http-pysrc.html b/docs/epy/googleapiclient.http-pysrc.html
index 366dec0f85b..8b0889a5dab 100644
--- a/docs/epy/googleapiclient.http-pysrc.html
+++ b/docs/epy/googleapiclient.http-pysrc.html
@@ -1237,137 +1237,141 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.http-module.html">Mo
 <a name="L996"></a><tt class="py-lineno"> 996</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">==</tt> <tt class="py-number">308</tt><tt class="py-op">:</tt> </tt>
 <a name="L997"></a><tt class="py-lineno"> 997</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_in_error_state</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
 <a name="L998"></a><tt class="py-lineno"> 998</tt>  <tt class="py-line">      <tt class="py-comment"># A "308 Resume Incomplete" indicates we are not done.</tt> </tt>
-<a name="L999"></a><tt class="py-lineno"> 999</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resumable_progress</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'range'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt>
-<a name="L1000"></a><tt class="py-lineno">1000</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-string">'location'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">resp</tt><tt class="py-op">:</tt> </tt>
-<a name="L1001"></a><tt class="py-lineno">1001</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resumable_uri</tt> <tt class="py-op">=</tt> <tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'location'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1002"></a><tt class="py-lineno">1002</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L1003"></a><tt class="py-lineno">1003</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_in_error_state</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
-<a name="L1004"></a><tt class="py-lineno">1004</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-173" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-173', 'HttpError', 'link-9');">HttpError</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uri</tt><tt class="py-op">)</tt> </tt>
-<a name="L1005"></a><tt class="py-lineno">1005</tt>  <tt class="py-line"> </tt>
-<a name="L1006"></a><tt class="py-lineno">1006</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt id="link-174" class="py-name" targets="Class googleapiclient.http.MediaUploadProgress=googleapiclient.http.MediaUploadProgress-class.html"><a title="googleapiclient.http.MediaUploadProgress" class="py-name" href="#" onclick="return doclink('link-174', 'MediaUploadProgress', 'link-174');">MediaUploadProgress</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resumable_progress</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-175" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+<a name="L999"></a><tt class="py-lineno"> 999</tt>  <tt class="py-line">      <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L1000"></a><tt class="py-lineno">1000</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resumable_progress</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'range'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt>
+<a name="L1001"></a><tt class="py-lineno">1001</tt>  <tt class="py-line">      <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt>
+<a name="L1002"></a><tt class="py-lineno">1002</tt>  <tt class="py-line">        <tt class="py-comment"># If resp doesn't contain range header, resumable progress is 0</tt> </tt>
+<a name="L1003"></a><tt class="py-lineno">1003</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resumable_progress</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
+<a name="L1004"></a><tt class="py-lineno">1004</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-string">'location'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">resp</tt><tt class="py-op">:</tt> </tt>
+<a name="L1005"></a><tt class="py-lineno">1005</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resumable_uri</tt> <tt class="py-op">=</tt> <tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'location'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1006"></a><tt class="py-lineno">1006</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L1007"></a><tt class="py-lineno">1007</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_in_error_state</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
+<a name="L1008"></a><tt class="py-lineno">1008</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-173" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-173', 'HttpError', 'link-9');">HttpError</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uri</tt><tt class="py-op">)</tt> </tt>
+<a name="L1009"></a><tt class="py-lineno">1009</tt>  <tt class="py-line"> </tt>
+<a name="L1010"></a><tt class="py-lineno">1010</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt id="link-174" class="py-name" targets="Class googleapiclient.http.MediaUploadProgress=googleapiclient.http.MediaUploadProgress-class.html"><a title="googleapiclient.http.MediaUploadProgress" class="py-name" href="#" onclick="return doclink('link-174', 'MediaUploadProgress', 'link-174');">MediaUploadProgress</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resumable_progress</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-175" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
 googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-175', 'resumable', 'link-49');">resumable</a></tt><tt class="py-op">.</tt><tt id="link-176" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.size
 googleapiclient.http.MediaUpload.size" class="py-name" href="#" onclick="return doclink('link-176', 'size', 'link-123');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
-<a name="L1007"></a><tt class="py-lineno">1007</tt>  <tt class="py-line">            <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1008"></a><tt class="py-lineno">1008</tt>  <tt class="py-line"> </tt>
-<a name="HttpRequest.to_json"></a><div id="HttpRequest.to_json-def"><a name="L1009"></a><tt class="py-lineno">1009</tt> <a class="py-toggle" href="#" id="HttpRequest.to_json-toggle" onclick="return toggle('HttpRequest.to_json');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequest-class.html#to_json">to_json</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpRequest.to_json-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpRequest.to_json-expanded"><a name="L1010"></a><tt class="py-lineno">1010</tt>  <tt class="py-line">    <tt class="py-docstring">"""Returns a JSON representation of the HttpRequest."""</tt> </tt>
-<a name="L1011"></a><tt class="py-lineno">1011</tt>  <tt class="py-line">    <tt class="py-name">d</tt> <tt class="py-op">=</tt> <tt class="py-name">copy</tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">)</tt> </tt>
-<a name="L1012"></a><tt class="py-lineno">1012</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1013"></a><tt class="py-lineno">1013</tt>  <tt class="py-line">      <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-177" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+<a name="L1011"></a><tt class="py-lineno">1011</tt>  <tt class="py-line">            <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1012"></a><tt class="py-lineno">1012</tt>  <tt class="py-line"> </tt>
+<a name="HttpRequest.to_json"></a><div id="HttpRequest.to_json-def"><a name="L1013"></a><tt class="py-lineno">1013</tt> <a class="py-toggle" href="#" id="HttpRequest.to_json-toggle" onclick="return toggle('HttpRequest.to_json');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequest-class.html#to_json">to_json</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpRequest.to_json-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpRequest.to_json-expanded"><a name="L1014"></a><tt class="py-lineno">1014</tt>  <tt class="py-line">    <tt class="py-docstring">"""Returns a JSON representation of the HttpRequest."""</tt> </tt>
+<a name="L1015"></a><tt class="py-lineno">1015</tt>  <tt class="py-line">    <tt class="py-name">d</tt> <tt class="py-op">=</tt> <tt class="py-name">copy</tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">)</tt> </tt>
+<a name="L1016"></a><tt class="py-lineno">1016</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1017"></a><tt class="py-lineno">1017</tt>  <tt class="py-line">      <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-177" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
 googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-177', 'resumable', 'link-49');">resumable</a></tt><tt class="py-op">.</tt><tt id="link-178" class="py-name" targets="Method googleapiclient.http.HttpRequest.to_json()=googleapiclient.http.HttpRequest-class.html#to_json,Method googleapiclient.http.MediaFileUpload.to_json()=googleapiclient.http.MediaFileUpload-class.html#to_json,Method googleapiclient.http.MediaIoBaseUpload.to_json()=googleapiclient.http.MediaIoBaseUpload-class.html#to_json,Method googleapiclient.http.MediaUpload.to_json()=googleapiclient.http.MediaUpload-class.html#to_json"><a title="googleapiclient.http.HttpRequest.to_json
 googleapiclient.http.MediaFileUpload.to_json
 googleapiclient.http.MediaIoBaseUpload.to_json
 googleapiclient.http.MediaUpload.to_json" class="py-name" href="#" onclick="return doclink('link-178', 'to_json', 'link-178');">to_json</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1014"></a><tt class="py-lineno">1014</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'http'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1015"></a><tt class="py-lineno">1015</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'postproc'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1016"></a><tt class="py-lineno">1016</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'_sleep'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1017"></a><tt class="py-lineno">1017</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'_rand'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1018"></a><tt class="py-lineno">1018</tt>  <tt class="py-line"> </tt>
-<a name="L1019"></a><tt class="py-lineno">1019</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">dumps</tt><tt class="py-op">(</tt><tt class="py-name">d</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1020"></a><tt class="py-lineno">1020</tt>  <tt class="py-line"> </tt>
-<a name="L1021"></a><tt class="py-lineno">1021</tt>  <tt class="py-line">  <tt class="py-decorator">@</tt><tt class="py-decorator">staticmethod</tt> </tt>
-<a name="HttpRequest.from_json"></a><div id="HttpRequest.from_json-def"><a name="L1022"></a><tt class="py-lineno">1022</tt> <a class="py-toggle" href="#" id="HttpRequest.from_json-toggle" onclick="return toggle('HttpRequest.from_json');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequest-class.html#from_json">from_json</a><tt class="py-op">(</tt><tt class="py-param">s</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">postproc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpRequest.from_json-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpRequest.from_json-expanded"><a name="L1023"></a><tt class="py-lineno">1023</tt>  <tt class="py-line">    <tt class="py-docstring">"""Returns an HttpRequest populated with info from a JSON object."""</tt> </tt>
-<a name="L1024"></a><tt class="py-lineno">1024</tt>  <tt class="py-line">    <tt class="py-name">d</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt class="py-name">s</tt><tt class="py-op">)</tt> </tt>
-<a name="L1025"></a><tt class="py-lineno">1025</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1026"></a><tt class="py-lineno">1026</tt>  <tt class="py-line">      <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-179" class="py-name" targets="Class googleapiclient.http.MediaUpload=googleapiclient.http.MediaUpload-class.html"><a title="googleapiclient.http.MediaUpload" class="py-name" href="#" onclick="return doclink('link-179', 'MediaUpload', 'link-179');">MediaUpload</a></tt><tt class="py-op">.</tt><tt id="link-180" class="py-name" targets="Class Method googleapiclient.http.MediaUpload.new_from_json()=googleapiclient.http.MediaUpload-class.html#new_from_json"><a title="googleapiclient.http.MediaUpload.new_from_json" class="py-name" href="#" onclick="return doclink('link-180', 'new_from_json', 'link-180');">new_from_json</a></tt><tt class="py-op">(</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L1027"></a><tt class="py-lineno">1027</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt id="link-181" class="py-name" targets="Class googleapiclient.http.HttpRequest=googleapiclient.http.HttpRequest-class.html"><a title="googleapiclient.http.HttpRequest" class="py-name" href="#" onclick="return doclink('link-181', 'HttpRequest', 'link-181');">HttpRequest</a></tt><tt class="py-op">(</tt> </tt>
-<a name="L1028"></a><tt class="py-lineno">1028</tt>  <tt class="py-line">        <tt id="link-182" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-182', 'http', 'link-33');">http</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L1029"></a><tt class="py-lineno">1029</tt>  <tt class="py-line">        <tt class="py-name">postproc</tt><tt class="py-op">,</tt> </tt>
-<a name="L1030"></a><tt class="py-lineno">1030</tt>  <tt class="py-line">        <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'uri'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
-<a name="L1031"></a><tt class="py-lineno">1031</tt>  <tt class="py-line">        <tt class="py-name">method</tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'method'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
-<a name="L1032"></a><tt class="py-lineno">1032</tt>  <tt class="py-line">        <tt id="link-183" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-183', 'body', 'link-69');">body</a></tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'body'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
-<a name="L1033"></a><tt class="py-lineno">1033</tt>  <tt class="py-line">        <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'headers'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
-<a name="L1034"></a><tt class="py-lineno">1034</tt>  <tt class="py-line">        <tt class="py-name">methodId</tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'methodId'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
-<a name="L1035"></a><tt class="py-lineno">1035</tt>  <tt class="py-line">        <tt id="link-184" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
+<a name="L1018"></a><tt class="py-lineno">1018</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'http'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1019"></a><tt class="py-lineno">1019</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'postproc'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1020"></a><tt class="py-lineno">1020</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'_sleep'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1021"></a><tt class="py-lineno">1021</tt>  <tt class="py-line">    <tt class="py-keyword">del</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'_rand'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1022"></a><tt class="py-lineno">1022</tt>  <tt class="py-line"> </tt>
+<a name="L1023"></a><tt class="py-lineno">1023</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">dumps</tt><tt class="py-op">(</tt><tt class="py-name">d</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1024"></a><tt class="py-lineno">1024</tt>  <tt class="py-line"> </tt>
+<a name="L1025"></a><tt class="py-lineno">1025</tt>  <tt class="py-line">  <tt class="py-decorator">@</tt><tt class="py-decorator">staticmethod</tt> </tt>
+<a name="HttpRequest.from_json"></a><div id="HttpRequest.from_json-def"><a name="L1026"></a><tt class="py-lineno">1026</tt> <a class="py-toggle" href="#" id="HttpRequest.from_json-toggle" onclick="return toggle('HttpRequest.from_json');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequest-class.html#from_json">from_json</a><tt class="py-op">(</tt><tt class="py-param">s</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">postproc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpRequest.from_json-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpRequest.from_json-expanded"><a name="L1027"></a><tt class="py-lineno">1027</tt>  <tt class="py-line">    <tt class="py-docstring">"""Returns an HttpRequest populated with info from a JSON object."""</tt> </tt>
+<a name="L1028"></a><tt class="py-lineno">1028</tt>  <tt class="py-line">    <tt class="py-name">d</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt class="py-name">s</tt><tt class="py-op">)</tt> </tt>
+<a name="L1029"></a><tt class="py-lineno">1029</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1030"></a><tt class="py-lineno">1030</tt>  <tt class="py-line">      <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-179" class="py-name" targets="Class googleapiclient.http.MediaUpload=googleapiclient.http.MediaUpload-class.html"><a title="googleapiclient.http.MediaUpload" class="py-name" href="#" onclick="return doclink('link-179', 'MediaUpload', 'link-179');">MediaUpload</a></tt><tt class="py-op">.</tt><tt id="link-180" class="py-name" targets="Class Method googleapiclient.http.MediaUpload.new_from_json()=googleapiclient.http.MediaUpload-class.html#new_from_json"><a title="googleapiclient.http.MediaUpload.new_from_json" class="py-name" href="#" onclick="return doclink('link-180', 'new_from_json', 'link-180');">new_from_json</a></tt><tt class="py-op">(</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L1031"></a><tt class="py-lineno">1031</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt id="link-181" class="py-name" targets="Class googleapiclient.http.HttpRequest=googleapiclient.http.HttpRequest-class.html"><a title="googleapiclient.http.HttpRequest" class="py-name" href="#" onclick="return doclink('link-181', 'HttpRequest', 'link-181');">HttpRequest</a></tt><tt class="py-op">(</tt> </tt>
+<a name="L1032"></a><tt class="py-lineno">1032</tt>  <tt class="py-line">        <tt id="link-182" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-182', 'http', 'link-33');">http</a></tt><tt class="py-op">,</tt> </tt>
+<a name="L1033"></a><tt class="py-lineno">1033</tt>  <tt class="py-line">        <tt class="py-name">postproc</tt><tt class="py-op">,</tt> </tt>
+<a name="L1034"></a><tt class="py-lineno">1034</tt>  <tt class="py-line">        <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'uri'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
+<a name="L1035"></a><tt class="py-lineno">1035</tt>  <tt class="py-line">        <tt class="py-name">method</tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'method'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
+<a name="L1036"></a><tt class="py-lineno">1036</tt>  <tt class="py-line">        <tt id="link-183" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-183', 'body', 'link-69');">body</a></tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'body'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
+<a name="L1037"></a><tt class="py-lineno">1037</tt>  <tt class="py-line">        <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'headers'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
+<a name="L1038"></a><tt class="py-lineno">1038</tt>  <tt class="py-line">        <tt class="py-name">methodId</tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'methodId'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
+<a name="L1039"></a><tt class="py-lineno">1039</tt>  <tt class="py-line">        <tt id="link-184" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
 googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-184', 'resumable', 'link-49');">resumable</a></tt><tt class="py-op">=</tt><tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-string">'resumable'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-</div></div><a name="L1036"></a><tt class="py-lineno">1036</tt>  <tt class="py-line"> </tt>
-<a name="BatchHttpRequest"></a><div id="BatchHttpRequest-def"><a name="L1037"></a><tt class="py-lineno">1037</tt>  <tt class="py-line"> </tt>
-<a name="L1038"></a><tt class="py-lineno">1038</tt> <a class="py-toggle" href="#" id="BatchHttpRequest-toggle" onclick="return toggle('BatchHttpRequest');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="BatchHttpRequest-expanded"><a name="L1039"></a><tt class="py-lineno">1039</tt>  <tt class="py-line">  <tt class="py-docstring">"""Batches multiple HttpRequest objects into a single HTTP request.</tt> </tt>
-<a name="L1040"></a><tt class="py-lineno">1040</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1041"></a><tt class="py-lineno">1041</tt>  <tt class="py-line"><tt class="py-docstring">  Example:</tt> </tt>
-<a name="L1042"></a><tt class="py-lineno">1042</tt>  <tt class="py-line"><tt class="py-docstring">    from googleapiclient.http import BatchHttpRequest</tt> </tt>
-<a name="L1043"></a><tt class="py-lineno">1043</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1044"></a><tt class="py-lineno">1044</tt>  <tt class="py-line"><tt class="py-docstring">    def list_animals(request_id, response, exception):</tt> </tt>
-<a name="L1045"></a><tt class="py-lineno">1045</tt>  <tt class="py-line"><tt class="py-docstring">      \"\"\"Do something with the animals list response.\"\"\"</tt> </tt>
-<a name="L1046"></a><tt class="py-lineno">1046</tt>  <tt class="py-line"><tt class="py-docstring">      if exception is not None:</tt> </tt>
-<a name="L1047"></a><tt class="py-lineno">1047</tt>  <tt class="py-line"><tt class="py-docstring">        # Do something with the exception.</tt> </tt>
-<a name="L1048"></a><tt class="py-lineno">1048</tt>  <tt class="py-line"><tt class="py-docstring">        pass</tt> </tt>
-<a name="L1049"></a><tt class="py-lineno">1049</tt>  <tt class="py-line"><tt class="py-docstring">      else:</tt> </tt>
-<a name="L1050"></a><tt class="py-lineno">1050</tt>  <tt class="py-line"><tt class="py-docstring">        # Do something with the response.</tt> </tt>
-<a name="L1051"></a><tt class="py-lineno">1051</tt>  <tt class="py-line"><tt class="py-docstring">        pass</tt> </tt>
-<a name="L1052"></a><tt class="py-lineno">1052</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1053"></a><tt class="py-lineno">1053</tt>  <tt class="py-line"><tt class="py-docstring">    def list_farmers(request_id, response, exception):</tt> </tt>
-<a name="L1054"></a><tt class="py-lineno">1054</tt>  <tt class="py-line"><tt class="py-docstring">      \"\"\"Do something with the farmers list response.\"\"\"</tt> </tt>
-<a name="L1055"></a><tt class="py-lineno">1055</tt>  <tt class="py-line"><tt class="py-docstring">      if exception is not None:</tt> </tt>
-<a name="L1056"></a><tt class="py-lineno">1056</tt>  <tt class="py-line"><tt class="py-docstring">        # Do something with the exception.</tt> </tt>
-<a name="L1057"></a><tt class="py-lineno">1057</tt>  <tt class="py-line"><tt class="py-docstring">        pass</tt> </tt>
-<a name="L1058"></a><tt class="py-lineno">1058</tt>  <tt class="py-line"><tt class="py-docstring">      else:</tt> </tt>
-<a name="L1059"></a><tt class="py-lineno">1059</tt>  <tt class="py-line"><tt class="py-docstring">        # Do something with the response.</tt> </tt>
-<a name="L1060"></a><tt class="py-lineno">1060</tt>  <tt class="py-line"><tt class="py-docstring">        pass</tt> </tt>
-<a name="L1061"></a><tt class="py-lineno">1061</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1062"></a><tt class="py-lineno">1062</tt>  <tt class="py-line"><tt class="py-docstring">    service = build('farm', 'v2')</tt> </tt>
-<a name="L1063"></a><tt class="py-lineno">1063</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1064"></a><tt class="py-lineno">1064</tt>  <tt class="py-line"><tt class="py-docstring">    batch = BatchHttpRequest()</tt> </tt>
+</div></div><a name="L1040"></a><tt class="py-lineno">1040</tt>  <tt class="py-line"> </tt>
+<a name="BatchHttpRequest"></a><div id="BatchHttpRequest-def"><a name="L1041"></a><tt class="py-lineno">1041</tt>  <tt class="py-line"> </tt>
+<a name="L1042"></a><tt class="py-lineno">1042</tt> <a class="py-toggle" href="#" id="BatchHttpRequest-toggle" onclick="return toggle('BatchHttpRequest');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="BatchHttpRequest-expanded"><a name="L1043"></a><tt class="py-lineno">1043</tt>  <tt class="py-line">  <tt class="py-docstring">"""Batches multiple HttpRequest objects into a single HTTP request.</tt> </tt>
+<a name="L1044"></a><tt class="py-lineno">1044</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1045"></a><tt class="py-lineno">1045</tt>  <tt class="py-line"><tt class="py-docstring">  Example:</tt> </tt>
+<a name="L1046"></a><tt class="py-lineno">1046</tt>  <tt class="py-line"><tt class="py-docstring">    from googleapiclient.http import BatchHttpRequest</tt> </tt>
+<a name="L1047"></a><tt class="py-lineno">1047</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1048"></a><tt class="py-lineno">1048</tt>  <tt class="py-line"><tt class="py-docstring">    def list_animals(request_id, response, exception):</tt> </tt>
+<a name="L1049"></a><tt class="py-lineno">1049</tt>  <tt class="py-line"><tt class="py-docstring">      \"\"\"Do something with the animals list response.\"\"\"</tt> </tt>
+<a name="L1050"></a><tt class="py-lineno">1050</tt>  <tt class="py-line"><tt class="py-docstring">      if exception is not None:</tt> </tt>
+<a name="L1051"></a><tt class="py-lineno">1051</tt>  <tt class="py-line"><tt class="py-docstring">        # Do something with the exception.</tt> </tt>
+<a name="L1052"></a><tt class="py-lineno">1052</tt>  <tt class="py-line"><tt class="py-docstring">        pass</tt> </tt>
+<a name="L1053"></a><tt class="py-lineno">1053</tt>  <tt class="py-line"><tt class="py-docstring">      else:</tt> </tt>
+<a name="L1054"></a><tt class="py-lineno">1054</tt>  <tt class="py-line"><tt class="py-docstring">        # Do something with the response.</tt> </tt>
+<a name="L1055"></a><tt class="py-lineno">1055</tt>  <tt class="py-line"><tt class="py-docstring">        pass</tt> </tt>
+<a name="L1056"></a><tt class="py-lineno">1056</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1057"></a><tt class="py-lineno">1057</tt>  <tt class="py-line"><tt class="py-docstring">    def list_farmers(request_id, response, exception):</tt> </tt>
+<a name="L1058"></a><tt class="py-lineno">1058</tt>  <tt class="py-line"><tt class="py-docstring">      \"\"\"Do something with the farmers list response.\"\"\"</tt> </tt>
+<a name="L1059"></a><tt class="py-lineno">1059</tt>  <tt class="py-line"><tt class="py-docstring">      if exception is not None:</tt> </tt>
+<a name="L1060"></a><tt class="py-lineno">1060</tt>  <tt class="py-line"><tt class="py-docstring">        # Do something with the exception.</tt> </tt>
+<a name="L1061"></a><tt class="py-lineno">1061</tt>  <tt class="py-line"><tt class="py-docstring">        pass</tt> </tt>
+<a name="L1062"></a><tt class="py-lineno">1062</tt>  <tt class="py-line"><tt class="py-docstring">      else:</tt> </tt>
+<a name="L1063"></a><tt class="py-lineno">1063</tt>  <tt class="py-line"><tt class="py-docstring">        # Do something with the response.</tt> </tt>
+<a name="L1064"></a><tt class="py-lineno">1064</tt>  <tt class="py-line"><tt class="py-docstring">        pass</tt> </tt>
 <a name="L1065"></a><tt class="py-lineno">1065</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1066"></a><tt class="py-lineno">1066</tt>  <tt class="py-line"><tt class="py-docstring">    batch.add(service.animals().list(), list_animals)</tt> </tt>
-<a name="L1067"></a><tt class="py-lineno">1067</tt>  <tt class="py-line"><tt class="py-docstring">    batch.add(service.farmers().list(), list_farmers)</tt> </tt>
-<a name="L1068"></a><tt class="py-lineno">1068</tt>  <tt class="py-line"><tt class="py-docstring">    batch.execute(http=http)</tt> </tt>
-<a name="L1069"></a><tt class="py-lineno">1069</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L1070"></a><tt class="py-lineno">1070</tt>  <tt class="py-line"> </tt>
-<a name="L1071"></a><tt class="py-lineno">1071</tt>  <tt class="py-line">  <tt class="py-decorator">@</tt><tt class="py-decorator">util</tt><tt class="py-op">.</tt><tt class="py-name">positional</tt><tt class="py-op">(</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
-<a name="BatchHttpRequest.__init__"></a><div id="BatchHttpRequest.__init__-def"><a name="L1072"></a><tt class="py-lineno">1072</tt> <a class="py-toggle" href="#" id="BatchHttpRequest.__init__-toggle" onclick="return toggle('BatchHttpRequest.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">callback</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">batch_uri</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest.__init__-expanded"><a name="L1073"></a><tt class="py-lineno">1073</tt>  <tt class="py-line">    <tt class="py-docstring">"""Constructor for a BatchHttpRequest.</tt> </tt>
-<a name="L1074"></a><tt class="py-lineno">1074</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1075"></a><tt class="py-lineno">1075</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1076"></a><tt class="py-lineno">1076</tt>  <tt class="py-line"><tt class="py-docstring">      callback: callable, A callback to be called for each response, of the</tt> </tt>
-<a name="L1077"></a><tt class="py-lineno">1077</tt>  <tt class="py-line"><tt class="py-docstring">        form callback(id, response, exception). The first parameter is the</tt> </tt>
-<a name="L1078"></a><tt class="py-lineno">1078</tt>  <tt class="py-line"><tt class="py-docstring">        request id, and the second is the deserialized response object. The</tt> </tt>
-<a name="L1079"></a><tt class="py-lineno">1079</tt>  <tt class="py-line"><tt class="py-docstring">        third is an googleapiclient.errors.HttpError exception object if an HTTP error</tt> </tt>
-<a name="L1080"></a><tt class="py-lineno">1080</tt>  <tt class="py-line"><tt class="py-docstring">        occurred while processing the request, or None if no error occurred.</tt> </tt>
-<a name="L1081"></a><tt class="py-lineno">1081</tt>  <tt class="py-line"><tt class="py-docstring">      batch_uri: string, URI to send batch requests to.</tt> </tt>
-<a name="L1082"></a><tt class="py-lineno">1082</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1083"></a><tt class="py-lineno">1083</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">batch_uri</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1084"></a><tt class="py-lineno">1084</tt>  <tt class="py-line">      <tt class="py-name">batch_uri</tt> <tt class="py-op">=</tt> <tt class="py-string">'https://www.googleapis.com/batch'</tt> </tt>
-<a name="L1085"></a><tt class="py-lineno">1085</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_batch_uri</tt> <tt class="py-op">=</tt> <tt class="py-name">batch_uri</tt> </tt>
-<a name="L1086"></a><tt class="py-lineno">1086</tt>  <tt class="py-line"> </tt>
-<a name="L1087"></a><tt class="py-lineno">1087</tt>  <tt class="py-line">    <tt class="py-comment"># Global callback to be called for each individual response in the batch.</tt> </tt>
-<a name="L1088"></a><tt class="py-lineno">1088</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callback</tt> <tt class="py-op">=</tt> <tt class="py-name">callback</tt> </tt>
-<a name="L1089"></a><tt class="py-lineno">1089</tt>  <tt class="py-line"> </tt>
-<a name="L1090"></a><tt class="py-lineno">1090</tt>  <tt class="py-line">    <tt class="py-comment"># A map from id to request.</tt> </tt>
-<a name="L1091"></a><tt class="py-lineno">1091</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L1092"></a><tt class="py-lineno">1092</tt>  <tt class="py-line"> </tt>
-<a name="L1093"></a><tt class="py-lineno">1093</tt>  <tt class="py-line">    <tt class="py-comment"># A map from id to callback.</tt> </tt>
-<a name="L1094"></a><tt class="py-lineno">1094</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callbacks</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L1095"></a><tt class="py-lineno">1095</tt>  <tt class="py-line"> </tt>
-<a name="L1096"></a><tt class="py-lineno">1096</tt>  <tt class="py-line">    <tt class="py-comment"># List of request ids, in the order in which they were added.</tt> </tt>
-<a name="L1097"></a><tt class="py-lineno">1097</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
-<a name="L1098"></a><tt class="py-lineno">1098</tt>  <tt class="py-line"> </tt>
-<a name="L1099"></a><tt class="py-lineno">1099</tt>  <tt class="py-line">    <tt class="py-comment"># The last auto generated id.</tt> </tt>
-<a name="L1100"></a><tt class="py-lineno">1100</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
-<a name="L1101"></a><tt class="py-lineno">1101</tt>  <tt class="py-line"> </tt>
-<a name="L1102"></a><tt class="py-lineno">1102</tt>  <tt class="py-line">    <tt class="py-comment"># Unique ID on which to base the Content-ID headers.</tt> </tt>
-<a name="L1103"></a><tt class="py-lineno">1103</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_base_id</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1104"></a><tt class="py-lineno">1104</tt>  <tt class="py-line"> </tt>
-<a name="L1105"></a><tt class="py-lineno">1105</tt>  <tt class="py-line">    <tt class="py-comment"># A map from request id to (httplib2.Response, content) response pairs</tt> </tt>
-<a name="L1106"></a><tt class="py-lineno">1106</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_responses</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L1107"></a><tt class="py-lineno">1107</tt>  <tt class="py-line"> </tt>
-<a name="L1108"></a><tt class="py-lineno">1108</tt>  <tt class="py-line">    <tt class="py-comment"># A map of id(Credentials) that have been refreshed.</tt> </tt>
-<a name="L1109"></a><tt class="py-lineno">1109</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_refreshed_credentials</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-</div><a name="L1110"></a><tt class="py-lineno">1110</tt>  <tt class="py-line"> </tt>
-<a name="BatchHttpRequest._refresh_and_apply_credentials"></a><div id="BatchHttpRequest._refresh_and_apply_credentials-def"><a name="L1111"></a><tt class="py-lineno">1111</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._refresh_and_apply_credentials-toggle" onclick="return toggle('BatchHttpRequest._refresh_and_apply_credentials');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_refresh_and_apply_credentials">_refresh_and_apply_credentials</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">request</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest._refresh_and_apply_credentials-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._refresh_and_apply_credentials-expanded"><a name="L1112"></a><tt class="py-lineno">1112</tt>  <tt class="py-line">    <tt class="py-docstring">"""Refresh the credentials and apply to the request.</tt> </tt>
-<a name="L1113"></a><tt class="py-lineno">1113</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1114"></a><tt class="py-lineno">1114</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1115"></a><tt class="py-lineno">1115</tt>  <tt class="py-line"><tt class="py-docstring">      request: HttpRequest, the request.</tt> </tt>
-<a name="L1116"></a><tt class="py-lineno">1116</tt>  <tt class="py-line"><tt class="py-docstring">      http: httplib2.Http, the global http object for the batch.</tt> </tt>
-<a name="L1117"></a><tt class="py-lineno">1117</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1118"></a><tt class="py-lineno">1118</tt>  <tt class="py-line">    <tt class="py-comment"># For the credentials to refresh, but only once per refresh_token</tt> </tt>
-<a name="L1119"></a><tt class="py-lineno">1119</tt>  <tt class="py-line">    <tt class="py-comment"># If there is no http per the request then refresh the http passed in</tt> </tt>
-<a name="L1120"></a><tt class="py-lineno">1120</tt>  <tt class="py-line">    <tt class="py-comment"># via execute()</tt> </tt>
-<a name="L1121"></a><tt class="py-lineno">1121</tt>  <tt class="py-line">    <tt class="py-name">creds</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1122"></a><tt class="py-lineno">1122</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-185" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1066"></a><tt class="py-lineno">1066</tt>  <tt class="py-line"><tt class="py-docstring">    service = build('farm', 'v2')</tt> </tt>
+<a name="L1067"></a><tt class="py-lineno">1067</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1068"></a><tt class="py-lineno">1068</tt>  <tt class="py-line"><tt class="py-docstring">    batch = BatchHttpRequest()</tt> </tt>
+<a name="L1069"></a><tt class="py-lineno">1069</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1070"></a><tt class="py-lineno">1070</tt>  <tt class="py-line"><tt class="py-docstring">    batch.add(service.animals().list(), list_animals)</tt> </tt>
+<a name="L1071"></a><tt class="py-lineno">1071</tt>  <tt class="py-line"><tt class="py-docstring">    batch.add(service.farmers().list(), list_farmers)</tt> </tt>
+<a name="L1072"></a><tt class="py-lineno">1072</tt>  <tt class="py-line"><tt class="py-docstring">    batch.execute(http=http)</tt> </tt>
+<a name="L1073"></a><tt class="py-lineno">1073</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L1074"></a><tt class="py-lineno">1074</tt>  <tt class="py-line"> </tt>
+<a name="L1075"></a><tt class="py-lineno">1075</tt>  <tt class="py-line">  <tt class="py-decorator">@</tt><tt class="py-decorator">util</tt><tt class="py-op">.</tt><tt class="py-name">positional</tt><tt class="py-op">(</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
+<a name="BatchHttpRequest.__init__"></a><div id="BatchHttpRequest.__init__-def"><a name="L1076"></a><tt class="py-lineno">1076</tt> <a class="py-toggle" href="#" id="BatchHttpRequest.__init__-toggle" onclick="return toggle('BatchHttpRequest.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">callback</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">batch_uri</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest.__init__-expanded"><a name="L1077"></a><tt class="py-lineno">1077</tt>  <tt class="py-line">    <tt class="py-docstring">"""Constructor for a BatchHttpRequest.</tt> </tt>
+<a name="L1078"></a><tt class="py-lineno">1078</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1079"></a><tt class="py-lineno">1079</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1080"></a><tt class="py-lineno">1080</tt>  <tt class="py-line"><tt class="py-docstring">      callback: callable, A callback to be called for each response, of the</tt> </tt>
+<a name="L1081"></a><tt class="py-lineno">1081</tt>  <tt class="py-line"><tt class="py-docstring">        form callback(id, response, exception). The first parameter is the</tt> </tt>
+<a name="L1082"></a><tt class="py-lineno">1082</tt>  <tt class="py-line"><tt class="py-docstring">        request id, and the second is the deserialized response object. The</tt> </tt>
+<a name="L1083"></a><tt class="py-lineno">1083</tt>  <tt class="py-line"><tt class="py-docstring">        third is an googleapiclient.errors.HttpError exception object if an HTTP error</tt> </tt>
+<a name="L1084"></a><tt class="py-lineno">1084</tt>  <tt class="py-line"><tt class="py-docstring">        occurred while processing the request, or None if no error occurred.</tt> </tt>
+<a name="L1085"></a><tt class="py-lineno">1085</tt>  <tt class="py-line"><tt class="py-docstring">      batch_uri: string, URI to send batch requests to.</tt> </tt>
+<a name="L1086"></a><tt class="py-lineno">1086</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1087"></a><tt class="py-lineno">1087</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">batch_uri</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1088"></a><tt class="py-lineno">1088</tt>  <tt class="py-line">      <tt class="py-name">batch_uri</tt> <tt class="py-op">=</tt> <tt class="py-string">'https://www.googleapis.com/batch'</tt> </tt>
+<a name="L1089"></a><tt class="py-lineno">1089</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_batch_uri</tt> <tt class="py-op">=</tt> <tt class="py-name">batch_uri</tt> </tt>
+<a name="L1090"></a><tt class="py-lineno">1090</tt>  <tt class="py-line"> </tt>
+<a name="L1091"></a><tt class="py-lineno">1091</tt>  <tt class="py-line">    <tt class="py-comment"># Global callback to be called for each individual response in the batch.</tt> </tt>
+<a name="L1092"></a><tt class="py-lineno">1092</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callback</tt> <tt class="py-op">=</tt> <tt class="py-name">callback</tt> </tt>
+<a name="L1093"></a><tt class="py-lineno">1093</tt>  <tt class="py-line"> </tt>
+<a name="L1094"></a><tt class="py-lineno">1094</tt>  <tt class="py-line">    <tt class="py-comment"># A map from id to request.</tt> </tt>
+<a name="L1095"></a><tt class="py-lineno">1095</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L1096"></a><tt class="py-lineno">1096</tt>  <tt class="py-line"> </tt>
+<a name="L1097"></a><tt class="py-lineno">1097</tt>  <tt class="py-line">    <tt class="py-comment"># A map from id to callback.</tt> </tt>
+<a name="L1098"></a><tt class="py-lineno">1098</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callbacks</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L1099"></a><tt class="py-lineno">1099</tt>  <tt class="py-line"> </tt>
+<a name="L1100"></a><tt class="py-lineno">1100</tt>  <tt class="py-line">    <tt class="py-comment"># List of request ids, in the order in which they were added.</tt> </tt>
+<a name="L1101"></a><tt class="py-lineno">1101</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+<a name="L1102"></a><tt class="py-lineno">1102</tt>  <tt class="py-line"> </tt>
+<a name="L1103"></a><tt class="py-lineno">1103</tt>  <tt class="py-line">    <tt class="py-comment"># The last auto generated id.</tt> </tt>
+<a name="L1104"></a><tt class="py-lineno">1104</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
+<a name="L1105"></a><tt class="py-lineno">1105</tt>  <tt class="py-line"> </tt>
+<a name="L1106"></a><tt class="py-lineno">1106</tt>  <tt class="py-line">    <tt class="py-comment"># Unique ID on which to base the Content-ID headers.</tt> </tt>
+<a name="L1107"></a><tt class="py-lineno">1107</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_base_id</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L1108"></a><tt class="py-lineno">1108</tt>  <tt class="py-line"> </tt>
+<a name="L1109"></a><tt class="py-lineno">1109</tt>  <tt class="py-line">    <tt class="py-comment"># A map from request id to (httplib2.Response, content) response pairs</tt> </tt>
+<a name="L1110"></a><tt class="py-lineno">1110</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_responses</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L1111"></a><tt class="py-lineno">1111</tt>  <tt class="py-line"> </tt>
+<a name="L1112"></a><tt class="py-lineno">1112</tt>  <tt class="py-line">    <tt class="py-comment"># A map of id(Credentials) that have been refreshed.</tt> </tt>
+<a name="L1113"></a><tt class="py-lineno">1113</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_refreshed_credentials</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+</div><a name="L1114"></a><tt class="py-lineno">1114</tt>  <tt class="py-line"> </tt>
+<a name="BatchHttpRequest._refresh_and_apply_credentials"></a><div id="BatchHttpRequest._refresh_and_apply_credentials-def"><a name="L1115"></a><tt class="py-lineno">1115</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._refresh_and_apply_credentials-toggle" onclick="return toggle('BatchHttpRequest._refresh_and_apply_credentials');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_refresh_and_apply_credentials">_refresh_and_apply_credentials</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">request</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest._refresh_and_apply_credentials-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._refresh_and_apply_credentials-expanded"><a name="L1116"></a><tt class="py-lineno">1116</tt>  <tt class="py-line">    <tt class="py-docstring">"""Refresh the credentials and apply to the request.</tt> </tt>
+<a name="L1117"></a><tt class="py-lineno">1117</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1118"></a><tt class="py-lineno">1118</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1119"></a><tt class="py-lineno">1119</tt>  <tt class="py-line"><tt class="py-docstring">      request: HttpRequest, the request.</tt> </tt>
+<a name="L1120"></a><tt class="py-lineno">1120</tt>  <tt class="py-line"><tt class="py-docstring">      http: httplib2.Http, the global http object for the batch.</tt> </tt>
+<a name="L1121"></a><tt class="py-lineno">1121</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1122"></a><tt class="py-lineno">1122</tt>  <tt class="py-line">    <tt class="py-comment"># For the credentials to refresh, but only once per refresh_token</tt> </tt>
+<a name="L1123"></a><tt class="py-lineno">1123</tt>  <tt class="py-line">    <tt class="py-comment"># If there is no http per the request then refresh the http passed in</tt> </tt>
+<a name="L1124"></a><tt class="py-lineno">1124</tt>  <tt class="py-line">    <tt class="py-comment"># via execute()</tt> </tt>
+<a name="L1125"></a><tt class="py-lineno">1125</tt>  <tt class="py-line">    <tt class="py-name">creds</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L1126"></a><tt class="py-lineno">1126</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-185" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-185', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-186" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-186', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt id="link-187" class="py-name"><a title="googleapiclient.http.HttpMock.request
@@ -1377,30 +1381,30 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.http-module.html">Mo
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-189', 'request', 'link-34');">request</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L1123"></a><tt class="py-lineno">1123</tt>  <tt class="py-line">        <tt class="py-string">'credentials'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1124"></a><tt class="py-lineno">1124</tt>  <tt class="py-line">      <tt class="py-name">creds</tt> <tt class="py-op">=</tt> <tt id="link-190" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1127"></a><tt class="py-lineno">1127</tt>  <tt class="py-line">        <tt class="py-string">'credentials'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1128"></a><tt class="py-lineno">1128</tt>  <tt class="py-line">      <tt class="py-name">creds</tt> <tt class="py-op">=</tt> <tt id="link-190" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-190', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-191" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-191', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-192" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-192', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">credentials</tt> </tt>
-<a name="L1125"></a><tt class="py-lineno">1125</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt id="link-193" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-193', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt id="link-194" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-194', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-195" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1129"></a><tt class="py-lineno">1129</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt id="link-193" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-193', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt id="link-194" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-194', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-195" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-195', 'request', 'link-34');">request</a></tt><tt class="py-op">,</tt> <tt class="py-string">'credentials'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1126"></a><tt class="py-lineno">1126</tt>  <tt class="py-line">      <tt class="py-name">creds</tt> <tt class="py-op">=</tt> <tt id="link-196" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-196', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-197" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1130"></a><tt class="py-lineno">1130</tt>  <tt class="py-line">      <tt class="py-name">creds</tt> <tt class="py-op">=</tt> <tt id="link-196" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-196', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-197" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-197', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">credentials</tt> </tt>
-<a name="L1127"></a><tt class="py-lineno">1127</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">creds</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1128"></a><tt class="py-lineno">1128</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">id</tt><tt class="py-op">(</tt><tt class="py-name">creds</tt><tt class="py-op">)</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_refreshed_credentials</tt><tt class="py-op">:</tt> </tt>
-<a name="L1129"></a><tt class="py-lineno">1129</tt>  <tt class="py-line">        <tt class="py-name">creds</tt><tt class="py-op">.</tt><tt class="py-name">refresh</tt><tt class="py-op">(</tt><tt id="link-198" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-198', 'http', 'link-33');">http</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1130"></a><tt class="py-lineno">1130</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_refreshed_credentials</tt><tt class="py-op">[</tt><tt class="py-name">id</tt><tt class="py-op">(</tt><tt class="py-name">creds</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-number">1</tt> </tt>
-<a name="L1131"></a><tt class="py-lineno">1131</tt>  <tt class="py-line"> </tt>
-<a name="L1132"></a><tt class="py-lineno">1132</tt>  <tt class="py-line">    <tt class="py-comment"># Only apply the credentials if we are using the http object passed in,</tt> </tt>
-<a name="L1133"></a><tt class="py-lineno">1133</tt>  <tt class="py-line">    <tt class="py-comment"># otherwise apply() will get called during _serialize_request().</tt> </tt>
-<a name="L1134"></a><tt class="py-lineno">1134</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-199" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1131"></a><tt class="py-lineno">1131</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">creds</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1132"></a><tt class="py-lineno">1132</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">id</tt><tt class="py-op">(</tt><tt class="py-name">creds</tt><tt class="py-op">)</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_refreshed_credentials</tt><tt class="py-op">:</tt> </tt>
+<a name="L1133"></a><tt class="py-lineno">1133</tt>  <tt class="py-line">        <tt class="py-name">creds</tt><tt class="py-op">.</tt><tt class="py-name">refresh</tt><tt class="py-op">(</tt><tt id="link-198" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-198', 'http', 'link-33');">http</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L1134"></a><tt class="py-lineno">1134</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_refreshed_credentials</tt><tt class="py-op">[</tt><tt class="py-name">id</tt><tt class="py-op">(</tt><tt class="py-name">creds</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-number">1</tt> </tt>
+<a name="L1135"></a><tt class="py-lineno">1135</tt>  <tt class="py-line"> </tt>
+<a name="L1136"></a><tt class="py-lineno">1136</tt>  <tt class="py-line">    <tt class="py-comment"># Only apply the credentials if we are using the http object passed in,</tt> </tt>
+<a name="L1137"></a><tt class="py-lineno">1137</tt>  <tt class="py-line">    <tt class="py-comment"># otherwise apply() will get called during _serialize_request().</tt> </tt>
+<a name="L1138"></a><tt class="py-lineno">1138</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-199" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-199', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-200" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-200', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt> <tt class="py-keyword">or</tt> <tt class="py-keyword">not</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt id="link-201" class="py-name"><a title="googleapiclient.http.HttpMock.request
@@ -1410,86 +1414,86 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.http-module.html">Mo
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-203', 'request', 'link-34');">request</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L1135"></a><tt class="py-lineno">1135</tt>  <tt class="py-line">        <tt class="py-string">'credentials'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1136"></a><tt class="py-lineno">1136</tt>  <tt class="py-line">      <tt class="py-name">creds</tt><tt class="py-op">.</tt><tt class="py-name">apply</tt><tt class="py-op">(</tt><tt id="link-204" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1139"></a><tt class="py-lineno">1139</tt>  <tt class="py-line">        <tt class="py-string">'credentials'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1140"></a><tt class="py-lineno">1140</tt>  <tt class="py-line">      <tt class="py-name">creds</tt><tt class="py-op">.</tt><tt class="py-name">apply</tt><tt class="py-op">(</tt><tt id="link-204" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-204', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1137"></a><tt class="py-lineno">1137</tt>  <tt class="py-line"> </tt>
-<a name="BatchHttpRequest._id_to_header"></a><div id="BatchHttpRequest._id_to_header-def"><a name="L1138"></a><tt class="py-lineno">1138</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._id_to_header-toggle" onclick="return toggle('BatchHttpRequest._id_to_header');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_id_to_header">_id_to_header</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">id_</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest._id_to_header-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._id_to_header-expanded"><a name="L1139"></a><tt class="py-lineno">1139</tt>  <tt class="py-line">    <tt class="py-docstring">"""Convert an id to a Content-ID header value.</tt> </tt>
-<a name="L1140"></a><tt class="py-lineno">1140</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1141"></a><tt class="py-lineno">1141</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1142"></a><tt class="py-lineno">1142</tt>  <tt class="py-line"><tt class="py-docstring">      id_: string, identifier of individual request.</tt> </tt>
-<a name="L1143"></a><tt class="py-lineno">1143</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1144"></a><tt class="py-lineno">1144</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
-<a name="L1145"></a><tt class="py-lineno">1145</tt>  <tt class="py-line"><tt class="py-docstring">      A Content-ID header with the id_ encoded into it. A UUID is prepended to</tt> </tt>
-<a name="L1146"></a><tt class="py-lineno">1146</tt>  <tt class="py-line"><tt class="py-docstring">      the value because Content-ID headers are supposed to be universally</tt> </tt>
-<a name="L1147"></a><tt class="py-lineno">1147</tt>  <tt class="py-line"><tt class="py-docstring">      unique.</tt> </tt>
-<a name="L1148"></a><tt class="py-lineno">1148</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1149"></a><tt class="py-lineno">1149</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_base_id</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1150"></a><tt class="py-lineno">1150</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_base_id</tt> <tt class="py-op">=</tt> <tt class="py-name">uuid</tt><tt class="py-op">.</tt><tt class="py-name">uuid4</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1151"></a><tt class="py-lineno">1151</tt>  <tt class="py-line"> </tt>
-<a name="L1152"></a><tt class="py-lineno">1152</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-string">'&lt;%s+%s&gt;'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_base_id</tt><tt class="py-op">,</tt> <tt class="py-name">quote</tt><tt class="py-op">(</tt><tt class="py-name">id_</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1153"></a><tt class="py-lineno">1153</tt>  <tt class="py-line"> </tt>
-<a name="BatchHttpRequest._header_to_id"></a><div id="BatchHttpRequest._header_to_id-def"><a name="L1154"></a><tt class="py-lineno">1154</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._header_to_id-toggle" onclick="return toggle('BatchHttpRequest._header_to_id');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_header_to_id">_header_to_id</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">header</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest._header_to_id-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._header_to_id-expanded"><a name="L1155"></a><tt class="py-lineno">1155</tt>  <tt class="py-line">    <tt class="py-docstring">"""Convert a Content-ID header value to an id.</tt> </tt>
-<a name="L1156"></a><tt class="py-lineno">1156</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1157"></a><tt class="py-lineno">1157</tt>  <tt class="py-line"><tt class="py-docstring">    Presumes the Content-ID header conforms to the format that _id_to_header()</tt> </tt>
-<a name="L1158"></a><tt class="py-lineno">1158</tt>  <tt class="py-line"><tt class="py-docstring">    returns.</tt> </tt>
-<a name="L1159"></a><tt class="py-lineno">1159</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1160"></a><tt class="py-lineno">1160</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1161"></a><tt class="py-lineno">1161</tt>  <tt class="py-line"><tt class="py-docstring">      header: string, Content-ID header value.</tt> </tt>
-<a name="L1162"></a><tt class="py-lineno">1162</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1163"></a><tt class="py-lineno">1163</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
-<a name="L1164"></a><tt class="py-lineno">1164</tt>  <tt class="py-line"><tt class="py-docstring">      The extracted id value.</tt> </tt>
-<a name="L1165"></a><tt class="py-lineno">1165</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1166"></a><tt class="py-lineno">1166</tt>  <tt class="py-line"><tt class="py-docstring">    Raises:</tt> </tt>
-<a name="L1167"></a><tt class="py-lineno">1167</tt>  <tt class="py-line"><tt class="py-docstring">      BatchError if the header is not in the expected format.</tt> </tt>
-<a name="L1168"></a><tt class="py-lineno">1168</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1169"></a><tt class="py-lineno">1169</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">!=</tt> <tt class="py-string">'&lt;'</tt> <tt class="py-keyword">or</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> <tt class="py-op">!=</tt> <tt class="py-string">'&gt;'</tt><tt class="py-op">:</tt> </tt>
-<a name="L1170"></a><tt class="py-lineno">1170</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-205" class="py-name"><a title="googleapiclient.errors.BatchError" class="py-name" href="#" onclick="return doclink('link-205', 'BatchError', 'link-6');">BatchError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Invalid value for Content-ID: %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">header</tt><tt class="py-op">)</tt> </tt>
-<a name="L1171"></a><tt class="py-lineno">1171</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'+'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">header</tt><tt class="py-op">:</tt> </tt>
-<a name="L1172"></a><tt class="py-lineno">1172</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-206" class="py-name"><a title="googleapiclient.errors.BatchError" class="py-name" href="#" onclick="return doclink('link-206', 'BatchError', 'link-6');">BatchError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Invalid value for Content-ID: %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">header</tt><tt class="py-op">)</tt> </tt>
-<a name="L1173"></a><tt class="py-lineno">1173</tt>  <tt class="py-line">    <tt id="link-207" class="py-name" targets="Module googleapiclient.discovery_cache.base=googleapiclient.discovery_cache.base-module.html"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-207', 'base', 'link-207');">base</a></tt><tt class="py-op">,</tt> <tt class="py-name">id_</tt> <tt class="py-op">=</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">rsplit</tt><tt class="py-op">(</tt><tt class="py-string">'+'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
-<a name="L1174"></a><tt class="py-lineno">1174</tt>  <tt class="py-line"> </tt>
-<a name="L1175"></a><tt class="py-lineno">1175</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">unquote</tt><tt class="py-op">(</tt><tt class="py-name">id_</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1176"></a><tt class="py-lineno">1176</tt>  <tt class="py-line"> </tt>
-<a name="BatchHttpRequest._serialize_request"></a><div id="BatchHttpRequest._serialize_request-def"><a name="L1177"></a><tt class="py-lineno">1177</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._serialize_request-toggle" onclick="return toggle('BatchHttpRequest._serialize_request');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_serialize_request">_serialize_request</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">request</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest._serialize_request-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._serialize_request-expanded"><a name="L1178"></a><tt class="py-lineno">1178</tt>  <tt class="py-line">    <tt class="py-docstring">"""Convert an HttpRequest object into a string.</tt> </tt>
-<a name="L1179"></a><tt class="py-lineno">1179</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1180"></a><tt class="py-lineno">1180</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1181"></a><tt class="py-lineno">1181</tt>  <tt class="py-line"><tt class="py-docstring">      request: HttpRequest, the request to serialize.</tt> </tt>
-<a name="L1182"></a><tt class="py-lineno">1182</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1183"></a><tt class="py-lineno">1183</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
-<a name="L1184"></a><tt class="py-lineno">1184</tt>  <tt class="py-line"><tt class="py-docstring">      The request as a string in application/http format.</tt> </tt>
-<a name="L1185"></a><tt class="py-lineno">1185</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1186"></a><tt class="py-lineno">1186</tt>  <tt class="py-line">    <tt class="py-comment"># Construct status line</tt> </tt>
-<a name="L1187"></a><tt class="py-lineno">1187</tt>  <tt class="py-line">    <tt class="py-name">parsed</tt> <tt class="py-op">=</tt> <tt class="py-name">urlparse</tt><tt class="py-op">(</tt><tt id="link-208" class="py-name"><a title="googleapiclient.http.HttpMock.request
+</div><a name="L1141"></a><tt class="py-lineno">1141</tt>  <tt class="py-line"> </tt>
+<a name="BatchHttpRequest._id_to_header"></a><div id="BatchHttpRequest._id_to_header-def"><a name="L1142"></a><tt class="py-lineno">1142</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._id_to_header-toggle" onclick="return toggle('BatchHttpRequest._id_to_header');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_id_to_header">_id_to_header</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">id_</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest._id_to_header-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._id_to_header-expanded"><a name="L1143"></a><tt class="py-lineno">1143</tt>  <tt class="py-line">    <tt class="py-docstring">"""Convert an id to a Content-ID header value.</tt> </tt>
+<a name="L1144"></a><tt class="py-lineno">1144</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1145"></a><tt class="py-lineno">1145</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1146"></a><tt class="py-lineno">1146</tt>  <tt class="py-line"><tt class="py-docstring">      id_: string, identifier of individual request.</tt> </tt>
+<a name="L1147"></a><tt class="py-lineno">1147</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1148"></a><tt class="py-lineno">1148</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L1149"></a><tt class="py-lineno">1149</tt>  <tt class="py-line"><tt class="py-docstring">      A Content-ID header with the id_ encoded into it. A UUID is prepended to</tt> </tt>
+<a name="L1150"></a><tt class="py-lineno">1150</tt>  <tt class="py-line"><tt class="py-docstring">      the value because Content-ID headers are supposed to be universally</tt> </tt>
+<a name="L1151"></a><tt class="py-lineno">1151</tt>  <tt class="py-line"><tt class="py-docstring">      unique.</tt> </tt>
+<a name="L1152"></a><tt class="py-lineno">1152</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1153"></a><tt class="py-lineno">1153</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_base_id</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1154"></a><tt class="py-lineno">1154</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_base_id</tt> <tt class="py-op">=</tt> <tt class="py-name">uuid</tt><tt class="py-op">.</tt><tt class="py-name">uuid4</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1155"></a><tt class="py-lineno">1155</tt>  <tt class="py-line"> </tt>
+<a name="L1156"></a><tt class="py-lineno">1156</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-string">'&lt;%s+%s&gt;'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_base_id</tt><tt class="py-op">,</tt> <tt class="py-name">quote</tt><tt class="py-op">(</tt><tt class="py-name">id_</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1157"></a><tt class="py-lineno">1157</tt>  <tt class="py-line"> </tt>
+<a name="BatchHttpRequest._header_to_id"></a><div id="BatchHttpRequest._header_to_id-def"><a name="L1158"></a><tt class="py-lineno">1158</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._header_to_id-toggle" onclick="return toggle('BatchHttpRequest._header_to_id');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_header_to_id">_header_to_id</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">header</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest._header_to_id-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._header_to_id-expanded"><a name="L1159"></a><tt class="py-lineno">1159</tt>  <tt class="py-line">    <tt class="py-docstring">"""Convert a Content-ID header value to an id.</tt> </tt>
+<a name="L1160"></a><tt class="py-lineno">1160</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1161"></a><tt class="py-lineno">1161</tt>  <tt class="py-line"><tt class="py-docstring">    Presumes the Content-ID header conforms to the format that _id_to_header()</tt> </tt>
+<a name="L1162"></a><tt class="py-lineno">1162</tt>  <tt class="py-line"><tt class="py-docstring">    returns.</tt> </tt>
+<a name="L1163"></a><tt class="py-lineno">1163</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1164"></a><tt class="py-lineno">1164</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1165"></a><tt class="py-lineno">1165</tt>  <tt class="py-line"><tt class="py-docstring">      header: string, Content-ID header value.</tt> </tt>
+<a name="L1166"></a><tt class="py-lineno">1166</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1167"></a><tt class="py-lineno">1167</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L1168"></a><tt class="py-lineno">1168</tt>  <tt class="py-line"><tt class="py-docstring">      The extracted id value.</tt> </tt>
+<a name="L1169"></a><tt class="py-lineno">1169</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1170"></a><tt class="py-lineno">1170</tt>  <tt class="py-line"><tt class="py-docstring">    Raises:</tt> </tt>
+<a name="L1171"></a><tt class="py-lineno">1171</tt>  <tt class="py-line"><tt class="py-docstring">      BatchError if the header is not in the expected format.</tt> </tt>
+<a name="L1172"></a><tt class="py-lineno">1172</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1173"></a><tt class="py-lineno">1173</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">!=</tt> <tt class="py-string">'&lt;'</tt> <tt class="py-keyword">or</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> <tt class="py-op">!=</tt> <tt class="py-string">'&gt;'</tt><tt class="py-op">:</tt> </tt>
+<a name="L1174"></a><tt class="py-lineno">1174</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-205" class="py-name"><a title="googleapiclient.errors.BatchError" class="py-name" href="#" onclick="return doclink('link-205', 'BatchError', 'link-6');">BatchError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Invalid value for Content-ID: %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">header</tt><tt class="py-op">)</tt> </tt>
+<a name="L1175"></a><tt class="py-lineno">1175</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'+'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">header</tt><tt class="py-op">:</tt> </tt>
+<a name="L1176"></a><tt class="py-lineno">1176</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-206" class="py-name"><a title="googleapiclient.errors.BatchError" class="py-name" href="#" onclick="return doclink('link-206', 'BatchError', 'link-6');">BatchError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Invalid value for Content-ID: %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">header</tt><tt class="py-op">)</tt> </tt>
+<a name="L1177"></a><tt class="py-lineno">1177</tt>  <tt class="py-line">    <tt id="link-207" class="py-name" targets="Module googleapiclient.discovery_cache.base=googleapiclient.discovery_cache.base-module.html"><a title="googleapiclient.discovery_cache.base" class="py-name" href="#" onclick="return doclink('link-207', 'base', 'link-207');">base</a></tt><tt class="py-op">,</tt> <tt class="py-name">id_</tt> <tt class="py-op">=</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">rsplit</tt><tt class="py-op">(</tt><tt class="py-string">'+'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
+<a name="L1178"></a><tt class="py-lineno">1178</tt>  <tt class="py-line"> </tt>
+<a name="L1179"></a><tt class="py-lineno">1179</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">unquote</tt><tt class="py-op">(</tt><tt class="py-name">id_</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1180"></a><tt class="py-lineno">1180</tt>  <tt class="py-line"> </tt>
+<a name="BatchHttpRequest._serialize_request"></a><div id="BatchHttpRequest._serialize_request-def"><a name="L1181"></a><tt class="py-lineno">1181</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._serialize_request-toggle" onclick="return toggle('BatchHttpRequest._serialize_request');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_serialize_request">_serialize_request</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">request</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest._serialize_request-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._serialize_request-expanded"><a name="L1182"></a><tt class="py-lineno">1182</tt>  <tt class="py-line">    <tt class="py-docstring">"""Convert an HttpRequest object into a string.</tt> </tt>
+<a name="L1183"></a><tt class="py-lineno">1183</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1184"></a><tt class="py-lineno">1184</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1185"></a><tt class="py-lineno">1185</tt>  <tt class="py-line"><tt class="py-docstring">      request: HttpRequest, the request to serialize.</tt> </tt>
+<a name="L1186"></a><tt class="py-lineno">1186</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1187"></a><tt class="py-lineno">1187</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L1188"></a><tt class="py-lineno">1188</tt>  <tt class="py-line"><tt class="py-docstring">      The request as a string in application/http format.</tt> </tt>
+<a name="L1189"></a><tt class="py-lineno">1189</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1190"></a><tt class="py-lineno">1190</tt>  <tt class="py-line">    <tt class="py-comment"># Construct status line</tt> </tt>
+<a name="L1191"></a><tt class="py-lineno">1191</tt>  <tt class="py-line">    <tt class="py-name">parsed</tt> <tt class="py-op">=</tt> <tt class="py-name">urlparse</tt><tt class="py-op">(</tt><tt id="link-208" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-208', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">uri</tt><tt class="py-op">)</tt> </tt>
-<a name="L1188"></a><tt class="py-lineno">1188</tt>  <tt class="py-line">    <tt class="py-name">request_line</tt> <tt class="py-op">=</tt> <tt class="py-name">urlunparse</tt><tt class="py-op">(</tt> </tt>
-<a name="L1189"></a><tt class="py-lineno">1189</tt>  <tt class="py-line">        <tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">,</tt> <tt class="py-name">parsed</tt><tt class="py-op">.</tt><tt class="py-name">path</tt><tt class="py-op">,</tt> <tt class="py-name">parsed</tt><tt class="py-op">.</tt><tt class="py-name">params</tt><tt class="py-op">,</tt> <tt class="py-name">parsed</tt><tt class="py-op">.</tt><tt class="py-name">query</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt>
-<a name="L1190"></a><tt class="py-lineno">1190</tt>  <tt class="py-line">        <tt class="py-op">)</tt> </tt>
-<a name="L1191"></a><tt class="py-lineno">1191</tt>  <tt class="py-line">    <tt class="py-name">status_line</tt> <tt class="py-op">=</tt> <tt id="link-209" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1192"></a><tt class="py-lineno">1192</tt>  <tt class="py-line">    <tt class="py-name">request_line</tt> <tt class="py-op">=</tt> <tt class="py-name">urlunparse</tt><tt class="py-op">(</tt> </tt>
+<a name="L1193"></a><tt class="py-lineno">1193</tt>  <tt class="py-line">        <tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">,</tt> <tt class="py-name">parsed</tt><tt class="py-op">.</tt><tt class="py-name">path</tt><tt class="py-op">,</tt> <tt class="py-name">parsed</tt><tt class="py-op">.</tt><tt class="py-name">params</tt><tt class="py-op">,</tt> <tt class="py-name">parsed</tt><tt class="py-op">.</tt><tt class="py-name">query</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt>
+<a name="L1194"></a><tt class="py-lineno">1194</tt>  <tt class="py-line">        <tt class="py-op">)</tt> </tt>
+<a name="L1195"></a><tt class="py-lineno">1195</tt>  <tt class="py-line">    <tt class="py-name">status_line</tt> <tt class="py-op">=</tt> <tt id="link-209" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-209', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">method</tt> <tt class="py-op">+</tt> <tt class="py-string">' '</tt> <tt class="py-op">+</tt> <tt class="py-name">request_line</tt> <tt class="py-op">+</tt> <tt class="py-string">' HTTP/1.1\n'</tt> </tt>
-<a name="L1192"></a><tt class="py-lineno">1192</tt>  <tt class="py-line">    <tt class="py-name">major</tt><tt class="py-op">,</tt> <tt class="py-name">minor</tt> <tt class="py-op">=</tt> <tt id="link-210" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1196"></a><tt class="py-lineno">1196</tt>  <tt class="py-line">    <tt class="py-name">major</tt><tt class="py-op">,</tt> <tt class="py-name">minor</tt> <tt class="py-op">=</tt> <tt id="link-210" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-210', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">headers</tt><tt class="py-op">.</tt><tt id="link-211" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
 googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-211', 'get', 'link-36');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'content-type'</tt><tt class="py-op">,</tt> <tt class="py-string">'application/json'</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1193"></a><tt class="py-lineno">1193</tt>  <tt class="py-line">    <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMENonMultipart</tt><tt class="py-op">(</tt><tt class="py-name">major</tt><tt class="py-op">,</tt> <tt class="py-name">minor</tt><tt class="py-op">)</tt> </tt>
-<a name="L1194"></a><tt class="py-lineno">1194</tt>  <tt class="py-line">    <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt id="link-212" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1197"></a><tt class="py-lineno">1197</tt>  <tt class="py-line">    <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMENonMultipart</tt><tt class="py-op">(</tt><tt class="py-name">major</tt><tt class="py-op">,</tt> <tt class="py-name">minor</tt><tt class="py-op">)</tt> </tt>
+<a name="L1198"></a><tt class="py-lineno">1198</tt>  <tt class="py-line">    <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt id="link-212" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-212', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">headers</tt><tt class="py-op">.</tt><tt class="py-name">copy</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1195"></a><tt class="py-lineno">1195</tt>  <tt class="py-line"> </tt>
-<a name="L1196"></a><tt class="py-lineno">1196</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-213" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1199"></a><tt class="py-lineno">1199</tt>  <tt class="py-line"> </tt>
+<a name="L1200"></a><tt class="py-lineno">1200</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-213" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-213', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-214" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-214', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt id="link-215" class="py-name"><a title="googleapiclient.http.HttpMock.request
@@ -1499,639 +1503,639 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.http-module.html">Mo
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-217', 'request', 'link-34');">request</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L1197"></a><tt class="py-lineno">1197</tt>  <tt class="py-line">        <tt class="py-string">'credentials'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1198"></a><tt class="py-lineno">1198</tt>  <tt class="py-line">      <tt id="link-218" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1201"></a><tt class="py-lineno">1201</tt>  <tt class="py-line">        <tt class="py-string">'credentials'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1202"></a><tt class="py-lineno">1202</tt>  <tt class="py-line">      <tt id="link-218" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-218', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-219" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-219', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-220" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-220', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">credentials</tt><tt class="py-op">.</tt><tt class="py-name">apply</tt><tt class="py-op">(</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt> </tt>
-<a name="L1199"></a><tt class="py-lineno">1199</tt>  <tt class="py-line"> </tt>
-<a name="L1200"></a><tt class="py-lineno">1200</tt>  <tt class="py-line">    <tt class="py-comment"># MIMENonMultipart adds its own Content-Type header.</tt> </tt>
-<a name="L1201"></a><tt class="py-lineno">1201</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'content-type'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">headers</tt><tt class="py-op">:</tt> </tt>
-<a name="L1202"></a><tt class="py-lineno">1202</tt>  <tt class="py-line">      <tt class="py-keyword">del</tt> <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> </tt>
 <a name="L1203"></a><tt class="py-lineno">1203</tt>  <tt class="py-line"> </tt>
-<a name="L1204"></a><tt class="py-lineno">1204</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1205"></a><tt class="py-lineno">1205</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt> </tt>
-<a name="L1206"></a><tt class="py-lineno">1206</tt>  <tt class="py-line">    <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'Host'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">parsed</tt><tt class="py-op">.</tt><tt class="py-name">netloc</tt> </tt>
-<a name="L1207"></a><tt class="py-lineno">1207</tt>  <tt class="py-line">    <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_unixfrom</tt><tt class="py-op">(</tt><tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
-<a name="L1208"></a><tt class="py-lineno">1208</tt>  <tt class="py-line"> </tt>
-<a name="L1209"></a><tt class="py-lineno">1209</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-221" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1204"></a><tt class="py-lineno">1204</tt>  <tt class="py-line">    <tt class="py-comment"># MIMENonMultipart adds its own Content-Type header.</tt> </tt>
+<a name="L1205"></a><tt class="py-lineno">1205</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'content-type'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">headers</tt><tt class="py-op">:</tt> </tt>
+<a name="L1206"></a><tt class="py-lineno">1206</tt>  <tt class="py-line">      <tt class="py-keyword">del</tt> <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1207"></a><tt class="py-lineno">1207</tt>  <tt class="py-line"> </tt>
+<a name="L1208"></a><tt class="py-lineno">1208</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt> <tt class="py-keyword">in</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1209"></a><tt class="py-lineno">1209</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt> </tt>
+<a name="L1210"></a><tt class="py-lineno">1210</tt>  <tt class="py-line">    <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'Host'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">parsed</tt><tt class="py-op">.</tt><tt class="py-name">netloc</tt> </tt>
+<a name="L1211"></a><tt class="py-lineno">1211</tt>  <tt class="py-line">    <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_unixfrom</tt><tt class="py-op">(</tt><tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
+<a name="L1212"></a><tt class="py-lineno">1212</tt>  <tt class="py-line"> </tt>
+<a name="L1213"></a><tt class="py-lineno">1213</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-221" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-221', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-222" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-222', 'body', 'link-69');">body</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1210"></a><tt class="py-lineno">1210</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_payload</tt><tt class="py-op">(</tt><tt id="link-223" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1214"></a><tt class="py-lineno">1214</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_payload</tt><tt class="py-op">(</tt><tt id="link-223" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-223', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-224" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-224', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1211"></a><tt class="py-lineno">1211</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'content-length'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">len</tt><tt class="py-op">(</tt><tt id="link-225" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1215"></a><tt class="py-lineno">1215</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'content-length'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">len</tt><tt class="py-op">(</tt><tt id="link-225" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-225', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-226" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-226', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L1212"></a><tt class="py-lineno">1212</tt>  <tt class="py-line"> </tt>
-<a name="L1213"></a><tt class="py-lineno">1213</tt>  <tt class="py-line">    <tt class="py-comment"># Serialize the mime message.</tt> </tt>
-<a name="L1214"></a><tt class="py-lineno">1214</tt>  <tt class="py-line">    <tt class="py-name">fp</tt> <tt class="py-op">=</tt> <tt class="py-name">StringIO</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1215"></a><tt class="py-lineno">1215</tt>  <tt class="py-line">    <tt class="py-comment"># maxheaderlen=0 means don't line wrap headers.</tt> </tt>
-<a name="L1216"></a><tt class="py-lineno">1216</tt>  <tt class="py-line">    <tt class="py-name">g</tt> <tt class="py-op">=</tt> <tt class="py-name">Generator</tt><tt class="py-op">(</tt><tt class="py-name">fp</tt><tt class="py-op">,</tt> <tt class="py-name">maxheaderlen</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt> </tt>
-<a name="L1217"></a><tt class="py-lineno">1217</tt>  <tt class="py-line">    <tt class="py-name">g</tt><tt class="py-op">.</tt><tt class="py-name">flatten</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">,</tt> <tt class="py-name">unixfrom</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
-<a name="L1218"></a><tt class="py-lineno">1218</tt>  <tt class="py-line">    <tt id="link-227" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-227', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">fp</tt><tt class="py-op">.</tt><tt class="py-name">getvalue</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1219"></a><tt class="py-lineno">1219</tt>  <tt class="py-line"> </tt>
-<a name="L1220"></a><tt class="py-lineno">1220</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">status_line</tt> <tt class="py-op">+</tt> <tt id="link-228" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-228', 'body', 'link-69');">body</a></tt> </tt>
-</div><a name="L1221"></a><tt class="py-lineno">1221</tt>  <tt class="py-line"> </tt>
-<a name="BatchHttpRequest._deserialize_response"></a><div id="BatchHttpRequest._deserialize_response-def"><a name="L1222"></a><tt class="py-lineno">1222</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._deserialize_response-toggle" onclick="return toggle('BatchHttpRequest._deserialize_response');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_deserialize_response">_deserialize_response</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">payload</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest._deserialize_response-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._deserialize_response-expanded"><a name="L1223"></a><tt class="py-lineno">1223</tt>  <tt class="py-line">    <tt class="py-docstring">"""Convert string into httplib2 response and content.</tt> </tt>
-<a name="L1224"></a><tt class="py-lineno">1224</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1225"></a><tt class="py-lineno">1225</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1226"></a><tt class="py-lineno">1226</tt>  <tt class="py-line"><tt class="py-docstring">      payload: string, headers and body as a string.</tt> </tt>
-<a name="L1227"></a><tt class="py-lineno">1227</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1228"></a><tt class="py-lineno">1228</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
-<a name="L1229"></a><tt class="py-lineno">1229</tt>  <tt class="py-line"><tt class="py-docstring">      A pair (resp, content), such as would be returned from httplib2.request.</tt> </tt>
-<a name="L1230"></a><tt class="py-lineno">1230</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1231"></a><tt class="py-lineno">1231</tt>  <tt class="py-line">    <tt class="py-comment"># Strip off the status line</tt> </tt>
-<a name="L1232"></a><tt class="py-lineno">1232</tt>  <tt class="py-line">    <tt class="py-name">status_line</tt><tt class="py-op">,</tt> <tt class="py-name">payload</tt> <tt class="py-op">=</tt> <tt class="py-name">payload</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'\n'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
-<a name="L1233"></a><tt class="py-lineno">1233</tt>  <tt class="py-line">    <tt class="py-name">protocol</tt><tt class="py-op">,</tt> <tt class="py-name">status</tt><tt class="py-op">,</tt> <tt class="py-name">reason</tt> <tt class="py-op">=</tt> <tt class="py-name">status_line</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">' '</tt><tt class="py-op">,</tt> <tt class="py-number">2</tt><tt class="py-op">)</tt> </tt>
-<a name="L1234"></a><tt class="py-lineno">1234</tt>  <tt class="py-line"> </tt>
-<a name="L1235"></a><tt class="py-lineno">1235</tt>  <tt class="py-line">    <tt class="py-comment"># Parse the rest of the response</tt> </tt>
-<a name="L1236"></a><tt class="py-lineno">1236</tt>  <tt class="py-line">    <tt class="py-name">parser</tt> <tt class="py-op">=</tt> <tt class="py-name">FeedParser</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1237"></a><tt class="py-lineno">1237</tt>  <tt class="py-line">    <tt class="py-name">parser</tt><tt class="py-op">.</tt><tt class="py-name">feed</tt><tt class="py-op">(</tt><tt class="py-name">payload</tt><tt class="py-op">)</tt> </tt>
-<a name="L1238"></a><tt class="py-lineno">1238</tt>  <tt class="py-line">    <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">parser</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1239"></a><tt class="py-lineno">1239</tt>  <tt class="py-line">    <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'status'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">status</tt> </tt>
-<a name="L1240"></a><tt class="py-lineno">1240</tt>  <tt class="py-line"> </tt>
-<a name="L1241"></a><tt class="py-lineno">1241</tt>  <tt class="py-line">    <tt class="py-comment"># Create httplib2.Response from the parsed headers.</tt> </tt>
-<a name="L1242"></a><tt class="py-lineno">1242</tt>  <tt class="py-line">    <tt class="py-name">resp</tt> <tt class="py-op">=</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Response</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
-<a name="L1243"></a><tt class="py-lineno">1243</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">reason</tt> <tt class="py-op">=</tt> <tt class="py-name">reason</tt> </tt>
-<a name="L1244"></a><tt class="py-lineno">1244</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">version</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">protocol</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L1245"></a><tt class="py-lineno">1245</tt>  <tt class="py-line"> </tt>
-<a name="L1246"></a><tt class="py-lineno">1246</tt>  <tt class="py-line">    <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">payload</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'\r\n\r\n'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt>
-<a name="L1247"></a><tt class="py-lineno">1247</tt>  <tt class="py-line"> </tt>
-<a name="L1248"></a><tt class="py-lineno">1248</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> </tt>
-</div><a name="L1249"></a><tt class="py-lineno">1249</tt>  <tt class="py-line"> </tt>
-<a name="BatchHttpRequest._new_id"></a><div id="BatchHttpRequest._new_id-def"><a name="L1250"></a><tt class="py-lineno">1250</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._new_id-toggle" onclick="return toggle('BatchHttpRequest._new_id');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_new_id">_new_id</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest._new_id-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._new_id-expanded"><a name="L1251"></a><tt class="py-lineno">1251</tt>  <tt class="py-line">    <tt class="py-docstring">"""Create a new id.</tt> </tt>
-<a name="L1252"></a><tt class="py-lineno">1252</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1253"></a><tt class="py-lineno">1253</tt>  <tt class="py-line"><tt class="py-docstring">    Auto incrementing number that avoids conflicts with ids already used.</tt> </tt>
-<a name="L1254"></a><tt class="py-lineno">1254</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1255"></a><tt class="py-lineno">1255</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
-<a name="L1256"></a><tt class="py-lineno">1256</tt>  <tt class="py-line"><tt class="py-docstring">       string, a new unique id.</tt> </tt>
-<a name="L1257"></a><tt class="py-lineno">1257</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1258"></a><tt class="py-lineno">1258</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt>
-<a name="L1259"></a><tt class="py-lineno">1259</tt>  <tt class="py-line">    <tt class="py-keyword">while</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">:</tt> </tt>
-<a name="L1260"></a><tt class="py-lineno">1260</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt>
-<a name="L1261"></a><tt class="py-lineno">1261</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1262"></a><tt class="py-lineno">1262</tt>  <tt class="py-line"> </tt>
-<a name="L1263"></a><tt class="py-lineno">1263</tt>  <tt class="py-line">  <tt class="py-decorator">@</tt><tt class="py-decorator">util</tt><tt class="py-op">.</tt><tt class="py-name">positional</tt><tt class="py-op">(</tt><tt class="py-number">2</tt><tt class="py-op">)</tt> </tt>
-<a name="BatchHttpRequest.add"></a><div id="BatchHttpRequest.add-def"><a name="L1264"></a><tt class="py-lineno">1264</tt> <a class="py-toggle" href="#" id="BatchHttpRequest.add-toggle" onclick="return toggle('BatchHttpRequest.add');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#add">add</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">request</tt><tt class="py-op">,</tt> <tt class="py-param">callback</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">request_id</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest.add-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest.add-expanded"><a name="L1265"></a><tt class="py-lineno">1265</tt>  <tt class="py-line">    <tt class="py-docstring">"""Add a new request.</tt> </tt>
-<a name="L1266"></a><tt class="py-lineno">1266</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1267"></a><tt class="py-lineno">1267</tt>  <tt class="py-line"><tt class="py-docstring">    Every callback added will be paired with a unique id, the request_id. That</tt> </tt>
-<a name="L1268"></a><tt class="py-lineno">1268</tt>  <tt class="py-line"><tt class="py-docstring">    unique id will be passed back to the callback when the response comes back</tt> </tt>
-<a name="L1269"></a><tt class="py-lineno">1269</tt>  <tt class="py-line"><tt class="py-docstring">    from the server. The default behavior is to have the library generate it's</tt> </tt>
-<a name="L1270"></a><tt class="py-lineno">1270</tt>  <tt class="py-line"><tt class="py-docstring">    own unique id. If the caller passes in a request_id then they must ensure</tt> </tt>
-<a name="L1271"></a><tt class="py-lineno">1271</tt>  <tt class="py-line"><tt class="py-docstring">    uniqueness for each request_id, and if they are not an exception is</tt> </tt>
-<a name="L1272"></a><tt class="py-lineno">1272</tt>  <tt class="py-line"><tt class="py-docstring">    raised. Callers should either supply all request_ids or nevery supply a</tt> </tt>
-<a name="L1273"></a><tt class="py-lineno">1273</tt>  <tt class="py-line"><tt class="py-docstring">    request id, to avoid such an error.</tt> </tt>
-<a name="L1274"></a><tt class="py-lineno">1274</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1275"></a><tt class="py-lineno">1275</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1276"></a><tt class="py-lineno">1276</tt>  <tt class="py-line"><tt class="py-docstring">      request: HttpRequest, Request to add to the batch.</tt> </tt>
-<a name="L1277"></a><tt class="py-lineno">1277</tt>  <tt class="py-line"><tt class="py-docstring">      callback: callable, A callback to be called for this response, of the</tt> </tt>
-<a name="L1278"></a><tt class="py-lineno">1278</tt>  <tt class="py-line"><tt class="py-docstring">        form callback(id, response, exception). The first parameter is the</tt> </tt>
-<a name="L1279"></a><tt class="py-lineno">1279</tt>  <tt class="py-line"><tt class="py-docstring">        request id, and the second is the deserialized response object. The</tt> </tt>
-<a name="L1280"></a><tt class="py-lineno">1280</tt>  <tt class="py-line"><tt class="py-docstring">        third is an googleapiclient.errors.HttpError exception object if an HTTP error</tt> </tt>
-<a name="L1281"></a><tt class="py-lineno">1281</tt>  <tt class="py-line"><tt class="py-docstring">        occurred while processing the request, or None if no errors occurred.</tt> </tt>
-<a name="L1282"></a><tt class="py-lineno">1282</tt>  <tt class="py-line"><tt class="py-docstring">      request_id: string, A unique id for the request. The id will be passed to</tt> </tt>
-<a name="L1283"></a><tt class="py-lineno">1283</tt>  <tt class="py-line"><tt class="py-docstring">        the callback with the response.</tt> </tt>
-<a name="L1284"></a><tt class="py-lineno">1284</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1285"></a><tt class="py-lineno">1285</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
-<a name="L1286"></a><tt class="py-lineno">1286</tt>  <tt class="py-line"><tt class="py-docstring">      None</tt> </tt>
-<a name="L1287"></a><tt class="py-lineno">1287</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1288"></a><tt class="py-lineno">1288</tt>  <tt class="py-line"><tt class="py-docstring">    Raises:</tt> </tt>
-<a name="L1289"></a><tt class="py-lineno">1289</tt>  <tt class="py-line"><tt class="py-docstring">      BatchError if a media request is added to a batch.</tt> </tt>
-<a name="L1290"></a><tt class="py-lineno">1290</tt>  <tt class="py-line"><tt class="py-docstring">      KeyError is the request_id is not unique.</tt> </tt>
-<a name="L1291"></a><tt class="py-lineno">1291</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1292"></a><tt class="py-lineno">1292</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1293"></a><tt class="py-lineno">1293</tt>  <tt class="py-line">      <tt class="py-name">request_id</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-229" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._new_id()=googleapiclient.http.BatchHttpRequest-class.html#_new_id"><a title="googleapiclient.http.BatchHttpRequest._new_id" class="py-name" href="#" onclick="return doclink('link-229', '_new_id', 'link-229');">_new_id</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1294"></a><tt class="py-lineno">1294</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-230" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1216"></a><tt class="py-lineno">1216</tt>  <tt class="py-line"> </tt>
+<a name="L1217"></a><tt class="py-lineno">1217</tt>  <tt class="py-line">    <tt class="py-comment"># Serialize the mime message.</tt> </tt>
+<a name="L1218"></a><tt class="py-lineno">1218</tt>  <tt class="py-line">    <tt class="py-name">fp</tt> <tt class="py-op">=</tt> <tt class="py-name">StringIO</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1219"></a><tt class="py-lineno">1219</tt>  <tt class="py-line">    <tt class="py-comment"># maxheaderlen=0 means don't line wrap headers.</tt> </tt>
+<a name="L1220"></a><tt class="py-lineno">1220</tt>  <tt class="py-line">    <tt class="py-name">g</tt> <tt class="py-op">=</tt> <tt class="py-name">Generator</tt><tt class="py-op">(</tt><tt class="py-name">fp</tt><tt class="py-op">,</tt> <tt class="py-name">maxheaderlen</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt> </tt>
+<a name="L1221"></a><tt class="py-lineno">1221</tt>  <tt class="py-line">    <tt class="py-name">g</tt><tt class="py-op">.</tt><tt class="py-name">flatten</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">,</tt> <tt class="py-name">unixfrom</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
+<a name="L1222"></a><tt class="py-lineno">1222</tt>  <tt class="py-line">    <tt id="link-227" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-227', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">fp</tt><tt class="py-op">.</tt><tt class="py-name">getvalue</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1223"></a><tt class="py-lineno">1223</tt>  <tt class="py-line"> </tt>
+<a name="L1224"></a><tt class="py-lineno">1224</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">status_line</tt> <tt class="py-op">+</tt> <tt id="link-228" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-228', 'body', 'link-69');">body</a></tt> </tt>
+</div><a name="L1225"></a><tt class="py-lineno">1225</tt>  <tt class="py-line"> </tt>
+<a name="BatchHttpRequest._deserialize_response"></a><div id="BatchHttpRequest._deserialize_response-def"><a name="L1226"></a><tt class="py-lineno">1226</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._deserialize_response-toggle" onclick="return toggle('BatchHttpRequest._deserialize_response');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_deserialize_response">_deserialize_response</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">payload</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest._deserialize_response-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._deserialize_response-expanded"><a name="L1227"></a><tt class="py-lineno">1227</tt>  <tt class="py-line">    <tt class="py-docstring">"""Convert string into httplib2 response and content.</tt> </tt>
+<a name="L1228"></a><tt class="py-lineno">1228</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1229"></a><tt class="py-lineno">1229</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1230"></a><tt class="py-lineno">1230</tt>  <tt class="py-line"><tt class="py-docstring">      payload: string, headers and body as a string.</tt> </tt>
+<a name="L1231"></a><tt class="py-lineno">1231</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1232"></a><tt class="py-lineno">1232</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L1233"></a><tt class="py-lineno">1233</tt>  <tt class="py-line"><tt class="py-docstring">      A pair (resp, content), such as would be returned from httplib2.request.</tt> </tt>
+<a name="L1234"></a><tt class="py-lineno">1234</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1235"></a><tt class="py-lineno">1235</tt>  <tt class="py-line">    <tt class="py-comment"># Strip off the status line</tt> </tt>
+<a name="L1236"></a><tt class="py-lineno">1236</tt>  <tt class="py-line">    <tt class="py-name">status_line</tt><tt class="py-op">,</tt> <tt class="py-name">payload</tt> <tt class="py-op">=</tt> <tt class="py-name">payload</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'\n'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
+<a name="L1237"></a><tt class="py-lineno">1237</tt>  <tt class="py-line">    <tt class="py-name">protocol</tt><tt class="py-op">,</tt> <tt class="py-name">status</tt><tt class="py-op">,</tt> <tt class="py-name">reason</tt> <tt class="py-op">=</tt> <tt class="py-name">status_line</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">' '</tt><tt class="py-op">,</tt> <tt class="py-number">2</tt><tt class="py-op">)</tt> </tt>
+<a name="L1238"></a><tt class="py-lineno">1238</tt>  <tt class="py-line"> </tt>
+<a name="L1239"></a><tt class="py-lineno">1239</tt>  <tt class="py-line">    <tt class="py-comment"># Parse the rest of the response</tt> </tt>
+<a name="L1240"></a><tt class="py-lineno">1240</tt>  <tt class="py-line">    <tt class="py-name">parser</tt> <tt class="py-op">=</tt> <tt class="py-name">FeedParser</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1241"></a><tt class="py-lineno">1241</tt>  <tt class="py-line">    <tt class="py-name">parser</tt><tt class="py-op">.</tt><tt class="py-name">feed</tt><tt class="py-op">(</tt><tt class="py-name">payload</tt><tt class="py-op">)</tt> </tt>
+<a name="L1242"></a><tt class="py-lineno">1242</tt>  <tt class="py-line">    <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">parser</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1243"></a><tt class="py-lineno">1243</tt>  <tt class="py-line">    <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'status'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">status</tt> </tt>
+<a name="L1244"></a><tt class="py-lineno">1244</tt>  <tt class="py-line"> </tt>
+<a name="L1245"></a><tt class="py-lineno">1245</tt>  <tt class="py-line">    <tt class="py-comment"># Create httplib2.Response from the parsed headers.</tt> </tt>
+<a name="L1246"></a><tt class="py-lineno">1246</tt>  <tt class="py-line">    <tt class="py-name">resp</tt> <tt class="py-op">=</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Response</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
+<a name="L1247"></a><tt class="py-lineno">1247</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">reason</tt> <tt class="py-op">=</tt> <tt class="py-name">reason</tt> </tt>
+<a name="L1248"></a><tt class="py-lineno">1248</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">version</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">protocol</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L1249"></a><tt class="py-lineno">1249</tt>  <tt class="py-line"> </tt>
+<a name="L1250"></a><tt class="py-lineno">1250</tt>  <tt class="py-line">    <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">payload</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'\r\n\r\n'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt>
+<a name="L1251"></a><tt class="py-lineno">1251</tt>  <tt class="py-line"> </tt>
+<a name="L1252"></a><tt class="py-lineno">1252</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> </tt>
+</div><a name="L1253"></a><tt class="py-lineno">1253</tt>  <tt class="py-line"> </tt>
+<a name="BatchHttpRequest._new_id"></a><div id="BatchHttpRequest._new_id-def"><a name="L1254"></a><tt class="py-lineno">1254</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._new_id-toggle" onclick="return toggle('BatchHttpRequest._new_id');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_new_id">_new_id</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest._new_id-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._new_id-expanded"><a name="L1255"></a><tt class="py-lineno">1255</tt>  <tt class="py-line">    <tt class="py-docstring">"""Create a new id.</tt> </tt>
+<a name="L1256"></a><tt class="py-lineno">1256</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1257"></a><tt class="py-lineno">1257</tt>  <tt class="py-line"><tt class="py-docstring">    Auto incrementing number that avoids conflicts with ids already used.</tt> </tt>
+<a name="L1258"></a><tt class="py-lineno">1258</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1259"></a><tt class="py-lineno">1259</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L1260"></a><tt class="py-lineno">1260</tt>  <tt class="py-line"><tt class="py-docstring">       string, a new unique id.</tt> </tt>
+<a name="L1261"></a><tt class="py-lineno">1261</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1262"></a><tt class="py-lineno">1262</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt>
+<a name="L1263"></a><tt class="py-lineno">1263</tt>  <tt class="py-line">    <tt class="py-keyword">while</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">:</tt> </tt>
+<a name="L1264"></a><tt class="py-lineno">1264</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt>
+<a name="L1265"></a><tt class="py-lineno">1265</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_last_auto_id</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1266"></a><tt class="py-lineno">1266</tt>  <tt class="py-line"> </tt>
+<a name="L1267"></a><tt class="py-lineno">1267</tt>  <tt class="py-line">  <tt class="py-decorator">@</tt><tt class="py-decorator">util</tt><tt class="py-op">.</tt><tt class="py-name">positional</tt><tt class="py-op">(</tt><tt class="py-number">2</tt><tt class="py-op">)</tt> </tt>
+<a name="BatchHttpRequest.add"></a><div id="BatchHttpRequest.add-def"><a name="L1268"></a><tt class="py-lineno">1268</tt> <a class="py-toggle" href="#" id="BatchHttpRequest.add-toggle" onclick="return toggle('BatchHttpRequest.add');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#add">add</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">request</tt><tt class="py-op">,</tt> <tt class="py-param">callback</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">request_id</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest.add-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest.add-expanded"><a name="L1269"></a><tt class="py-lineno">1269</tt>  <tt class="py-line">    <tt class="py-docstring">"""Add a new request.</tt> </tt>
+<a name="L1270"></a><tt class="py-lineno">1270</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1271"></a><tt class="py-lineno">1271</tt>  <tt class="py-line"><tt class="py-docstring">    Every callback added will be paired with a unique id, the request_id. That</tt> </tt>
+<a name="L1272"></a><tt class="py-lineno">1272</tt>  <tt class="py-line"><tt class="py-docstring">    unique id will be passed back to the callback when the response comes back</tt> </tt>
+<a name="L1273"></a><tt class="py-lineno">1273</tt>  <tt class="py-line"><tt class="py-docstring">    from the server. The default behavior is to have the library generate it's</tt> </tt>
+<a name="L1274"></a><tt class="py-lineno">1274</tt>  <tt class="py-line"><tt class="py-docstring">    own unique id. If the caller passes in a request_id then they must ensure</tt> </tt>
+<a name="L1275"></a><tt class="py-lineno">1275</tt>  <tt class="py-line"><tt class="py-docstring">    uniqueness for each request_id, and if they are not an exception is</tt> </tt>
+<a name="L1276"></a><tt class="py-lineno">1276</tt>  <tt class="py-line"><tt class="py-docstring">    raised. Callers should either supply all request_ids or nevery supply a</tt> </tt>
+<a name="L1277"></a><tt class="py-lineno">1277</tt>  <tt class="py-line"><tt class="py-docstring">    request id, to avoid such an error.</tt> </tt>
+<a name="L1278"></a><tt class="py-lineno">1278</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1279"></a><tt class="py-lineno">1279</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1280"></a><tt class="py-lineno">1280</tt>  <tt class="py-line"><tt class="py-docstring">      request: HttpRequest, Request to add to the batch.</tt> </tt>
+<a name="L1281"></a><tt class="py-lineno">1281</tt>  <tt class="py-line"><tt class="py-docstring">      callback: callable, A callback to be called for this response, of the</tt> </tt>
+<a name="L1282"></a><tt class="py-lineno">1282</tt>  <tt class="py-line"><tt class="py-docstring">        form callback(id, response, exception). The first parameter is the</tt> </tt>
+<a name="L1283"></a><tt class="py-lineno">1283</tt>  <tt class="py-line"><tt class="py-docstring">        request id, and the second is the deserialized response object. The</tt> </tt>
+<a name="L1284"></a><tt class="py-lineno">1284</tt>  <tt class="py-line"><tt class="py-docstring">        third is an googleapiclient.errors.HttpError exception object if an HTTP error</tt> </tt>
+<a name="L1285"></a><tt class="py-lineno">1285</tt>  <tt class="py-line"><tt class="py-docstring">        occurred while processing the request, or None if no errors occurred.</tt> </tt>
+<a name="L1286"></a><tt class="py-lineno">1286</tt>  <tt class="py-line"><tt class="py-docstring">      request_id: string, A unique id for the request. The id will be passed to</tt> </tt>
+<a name="L1287"></a><tt class="py-lineno">1287</tt>  <tt class="py-line"><tt class="py-docstring">        the callback with the response.</tt> </tt>
+<a name="L1288"></a><tt class="py-lineno">1288</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1289"></a><tt class="py-lineno">1289</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L1290"></a><tt class="py-lineno">1290</tt>  <tt class="py-line"><tt class="py-docstring">      None</tt> </tt>
+<a name="L1291"></a><tt class="py-lineno">1291</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1292"></a><tt class="py-lineno">1292</tt>  <tt class="py-line"><tt class="py-docstring">    Raises:</tt> </tt>
+<a name="L1293"></a><tt class="py-lineno">1293</tt>  <tt class="py-line"><tt class="py-docstring">      BatchError if a media request is added to a batch.</tt> </tt>
+<a name="L1294"></a><tt class="py-lineno">1294</tt>  <tt class="py-line"><tt class="py-docstring">      KeyError is the request_id is not unique.</tt> </tt>
+<a name="L1295"></a><tt class="py-lineno">1295</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1296"></a><tt class="py-lineno">1296</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1297"></a><tt class="py-lineno">1297</tt>  <tt class="py-line">      <tt class="py-name">request_id</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-229" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._new_id()=googleapiclient.http.BatchHttpRequest-class.html#_new_id"><a title="googleapiclient.http.BatchHttpRequest._new_id" class="py-name" href="#" onclick="return doclink('link-229', '_new_id', 'link-229');">_new_id</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1298"></a><tt class="py-lineno">1298</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-230" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-230', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-231" class="py-name"><a title="googleapiclient.http.MediaIoBaseUpload.resumable
 googleapiclient.http.MediaUpload.resumable" class="py-name" href="#" onclick="return doclink('link-231', 'resumable', 'link-49');">resumable</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1295"></a><tt class="py-lineno">1295</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-232" class="py-name"><a title="googleapiclient.errors.BatchError" class="py-name" href="#" onclick="return doclink('link-232', 'BatchError', 'link-6');">BatchError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Media requests cannot be used in a batch request."</tt><tt class="py-op">)</tt> </tt>
-<a name="L1296"></a><tt class="py-lineno">1296</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">:</tt> </tt>
-<a name="L1297"></a><tt class="py-lineno">1297</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt class="py-name">KeyError</tt><tt class="py-op">(</tt><tt class="py-string">"A request with this ID already exists: %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">request_id</tt><tt class="py-op">)</tt> </tt>
-<a name="L1298"></a><tt class="py-lineno">1298</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-233" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1299"></a><tt class="py-lineno">1299</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-232" class="py-name"><a title="googleapiclient.errors.BatchError" class="py-name" href="#" onclick="return doclink('link-232', 'BatchError', 'link-6');">BatchError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Media requests cannot be used in a batch request."</tt><tt class="py-op">)</tt> </tt>
+<a name="L1300"></a><tt class="py-lineno">1300</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">:</tt> </tt>
+<a name="L1301"></a><tt class="py-lineno">1301</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt class="py-name">KeyError</tt><tt class="py-op">(</tt><tt class="py-string">"A request with this ID already exists: %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">request_id</tt><tt class="py-op">)</tt> </tt>
+<a name="L1302"></a><tt class="py-lineno">1302</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-233" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-233', 'request', 'link-34');">request</a></tt> </tt>
-<a name="L1299"></a><tt class="py-lineno">1299</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callbacks</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">callback</tt> </tt>
-<a name="L1300"></a><tt class="py-lineno">1300</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1301"></a><tt class="py-lineno">1301</tt>  <tt class="py-line"> </tt>
-<a name="BatchHttpRequest._execute"></a><div id="BatchHttpRequest._execute-def"><a name="L1302"></a><tt class="py-lineno">1302</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._execute-toggle" onclick="return toggle('BatchHttpRequest._execute');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_execute">_execute</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">order</tt><tt class="py-op">,</tt> <tt class="py-param">requests</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest._execute-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._execute-expanded"><a name="L1303"></a><tt class="py-lineno">1303</tt>  <tt class="py-line">    <tt class="py-docstring">"""Serialize batch request, send to server, process response.</tt> </tt>
-<a name="L1304"></a><tt class="py-lineno">1304</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1305"></a><tt class="py-lineno">1305</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1306"></a><tt class="py-lineno">1306</tt>  <tt class="py-line"><tt class="py-docstring">      http: httplib2.Http, an http object to be used to make the request with.</tt> </tt>
-<a name="L1307"></a><tt class="py-lineno">1307</tt>  <tt class="py-line"><tt class="py-docstring">      order: list, list of request ids in the order they were added to the</tt> </tt>
-<a name="L1308"></a><tt class="py-lineno">1308</tt>  <tt class="py-line"><tt class="py-docstring">        batch.</tt> </tt>
-<a name="L1309"></a><tt class="py-lineno">1309</tt>  <tt class="py-line"><tt class="py-docstring">      request: list, list of request objects to send.</tt> </tt>
-<a name="L1310"></a><tt class="py-lineno">1310</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1311"></a><tt class="py-lineno">1311</tt>  <tt class="py-line"><tt class="py-docstring">    Raises:</tt> </tt>
-<a name="L1312"></a><tt class="py-lineno">1312</tt>  <tt class="py-line"><tt class="py-docstring">      httplib2.HttpLib2Error if a transport error has occured.</tt> </tt>
-<a name="L1313"></a><tt class="py-lineno">1313</tt>  <tt class="py-line"><tt class="py-docstring">      googleapiclient.errors.BatchError if the response is the wrong format.</tt> </tt>
-<a name="L1314"></a><tt class="py-lineno">1314</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1315"></a><tt class="py-lineno">1315</tt>  <tt class="py-line">    <tt class="py-name">message</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMEMultipart</tt><tt class="py-op">(</tt><tt class="py-string">'mixed'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1316"></a><tt class="py-lineno">1316</tt>  <tt class="py-line">    <tt class="py-comment"># Message should not write out it's own headers.</tt> </tt>
-<a name="L1317"></a><tt class="py-lineno">1317</tt>  <tt class="py-line">    <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">message</tt><tt class="py-op">,</tt> <tt class="py-string">'_write_headers'</tt><tt class="py-op">,</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
-<a name="L1318"></a><tt class="py-lineno">1318</tt>  <tt class="py-line"> </tt>
-<a name="L1319"></a><tt class="py-lineno">1319</tt>  <tt class="py-line">    <tt class="py-comment"># Add all the individual requests.</tt> </tt>
-<a name="L1320"></a><tt class="py-lineno">1320</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">order</tt><tt class="py-op">:</tt> </tt>
-<a name="L1321"></a><tt class="py-lineno">1321</tt>  <tt class="py-line">      <tt id="link-234" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1303"></a><tt class="py-lineno">1303</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callbacks</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">callback</tt> </tt>
+<a name="L1304"></a><tt class="py-lineno">1304</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L1305"></a><tt class="py-lineno">1305</tt>  <tt class="py-line"> </tt>
+<a name="BatchHttpRequest._execute"></a><div id="BatchHttpRequest._execute-def"><a name="L1306"></a><tt class="py-lineno">1306</tt> <a class="py-toggle" href="#" id="BatchHttpRequest._execute-toggle" onclick="return toggle('BatchHttpRequest._execute');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#_execute">_execute</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">order</tt><tt class="py-op">,</tt> <tt class="py-param">requests</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest._execute-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest._execute-expanded"><a name="L1307"></a><tt class="py-lineno">1307</tt>  <tt class="py-line">    <tt class="py-docstring">"""Serialize batch request, send to server, process response.</tt> </tt>
+<a name="L1308"></a><tt class="py-lineno">1308</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1309"></a><tt class="py-lineno">1309</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1310"></a><tt class="py-lineno">1310</tt>  <tt class="py-line"><tt class="py-docstring">      http: httplib2.Http, an http object to be used to make the request with.</tt> </tt>
+<a name="L1311"></a><tt class="py-lineno">1311</tt>  <tt class="py-line"><tt class="py-docstring">      order: list, list of request ids in the order they were added to the</tt> </tt>
+<a name="L1312"></a><tt class="py-lineno">1312</tt>  <tt class="py-line"><tt class="py-docstring">        batch.</tt> </tt>
+<a name="L1313"></a><tt class="py-lineno">1313</tt>  <tt class="py-line"><tt class="py-docstring">      request: list, list of request objects to send.</tt> </tt>
+<a name="L1314"></a><tt class="py-lineno">1314</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1315"></a><tt class="py-lineno">1315</tt>  <tt class="py-line"><tt class="py-docstring">    Raises:</tt> </tt>
+<a name="L1316"></a><tt class="py-lineno">1316</tt>  <tt class="py-line"><tt class="py-docstring">      httplib2.HttpLib2Error if a transport error has occured.</tt> </tt>
+<a name="L1317"></a><tt class="py-lineno">1317</tt>  <tt class="py-line"><tt class="py-docstring">      googleapiclient.errors.BatchError if the response is the wrong format.</tt> </tt>
+<a name="L1318"></a><tt class="py-lineno">1318</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1319"></a><tt class="py-lineno">1319</tt>  <tt class="py-line">    <tt class="py-name">message</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMEMultipart</tt><tt class="py-op">(</tt><tt class="py-string">'mixed'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1320"></a><tt class="py-lineno">1320</tt>  <tt class="py-line">    <tt class="py-comment"># Message should not write out it's own headers.</tt> </tt>
+<a name="L1321"></a><tt class="py-lineno">1321</tt>  <tt class="py-line">    <tt class="py-name">setattr</tt><tt class="py-op">(</tt><tt class="py-name">message</tt><tt class="py-op">,</tt> <tt class="py-string">'_write_headers'</tt><tt class="py-op">,</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
+<a name="L1322"></a><tt class="py-lineno">1322</tt>  <tt class="py-line"> </tt>
+<a name="L1323"></a><tt class="py-lineno">1323</tt>  <tt class="py-line">    <tt class="py-comment"># Add all the individual requests.</tt> </tt>
+<a name="L1324"></a><tt class="py-lineno">1324</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">order</tt><tt class="py-op">:</tt> </tt>
+<a name="L1325"></a><tt class="py-lineno">1325</tt>  <tt class="py-line">      <tt id="link-234" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-234', 'request', 'link-34');">request</a></tt> <tt class="py-op">=</tt> <tt class="py-name">requests</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
-<a name="L1322"></a><tt class="py-lineno">1322</tt>  <tt class="py-line"> </tt>
-<a name="L1323"></a><tt class="py-lineno">1323</tt>  <tt class="py-line">      <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMENonMultipart</tt><tt class="py-op">(</tt><tt class="py-string">'application'</tt><tt class="py-op">,</tt> <tt class="py-string">'http'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1324"></a><tt class="py-lineno">1324</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'Content-Transfer-Encoding'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'binary'</tt> </tt>
-<a name="L1325"></a><tt class="py-lineno">1325</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'Content-ID'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-235" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._id_to_header()=googleapiclient.http.BatchHttpRequest-class.html#_id_to_header"><a title="googleapiclient.http.BatchHttpRequest._id_to_header" class="py-name" href="#" onclick="return doclink('link-235', '_id_to_header', 'link-235');">_id_to_header</a></tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">)</tt> </tt>
 <a name="L1326"></a><tt class="py-lineno">1326</tt>  <tt class="py-line"> </tt>
-<a name="L1327"></a><tt class="py-lineno">1327</tt>  <tt class="py-line">      <tt id="link-236" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-236', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-237" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._serialize_request()=googleapiclient.http.BatchHttpRequest-class.html#_serialize_request"><a title="googleapiclient.http.BatchHttpRequest._serialize_request" class="py-name" href="#" onclick="return doclink('link-237', '_serialize_request', 'link-237');">_serialize_request</a></tt><tt class="py-op">(</tt><tt id="link-238" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1327"></a><tt class="py-lineno">1327</tt>  <tt class="py-line">      <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-name">MIMENonMultipart</tt><tt class="py-op">(</tt><tt class="py-string">'application'</tt><tt class="py-op">,</tt> <tt class="py-string">'http'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1328"></a><tt class="py-lineno">1328</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'Content-Transfer-Encoding'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'binary'</tt> </tt>
+<a name="L1329"></a><tt class="py-lineno">1329</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">[</tt><tt class="py-string">'Content-ID'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-235" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._id_to_header()=googleapiclient.http.BatchHttpRequest-class.html#_id_to_header"><a title="googleapiclient.http.BatchHttpRequest._id_to_header" class="py-name" href="#" onclick="return doclink('link-235', '_id_to_header', 'link-235');">_id_to_header</a></tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">)</tt> </tt>
+<a name="L1330"></a><tt class="py-lineno">1330</tt>  <tt class="py-line"> </tt>
+<a name="L1331"></a><tt class="py-lineno">1331</tt>  <tt class="py-line">      <tt id="link-236" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-236', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-237" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._serialize_request()=googleapiclient.http.BatchHttpRequest-class.html#_serialize_request"><a title="googleapiclient.http.BatchHttpRequest._serialize_request" class="py-name" href="#" onclick="return doclink('link-237', '_serialize_request', 'link-237');">_serialize_request</a></tt><tt class="py-op">(</tt><tt id="link-238" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-238', 'request', 'link-34');">request</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1328"></a><tt class="py-lineno">1328</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_payload</tt><tt class="py-op">(</tt><tt id="link-239" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-239', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1329"></a><tt class="py-lineno">1329</tt>  <tt class="py-line">      <tt class="py-name">message</tt><tt class="py-op">.</tt><tt class="py-name">attach</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
-<a name="L1330"></a><tt class="py-lineno">1330</tt>  <tt class="py-line"> </tt>
-<a name="L1331"></a><tt class="py-lineno">1331</tt>  <tt class="py-line">    <tt class="py-comment"># encode the body: note that we can't use `as_string`, because</tt> </tt>
-<a name="L1332"></a><tt class="py-lineno">1332</tt>  <tt class="py-line">    <tt class="py-comment"># it plays games with `From ` lines.</tt> </tt>
-<a name="L1333"></a><tt class="py-lineno">1333</tt>  <tt class="py-line">    <tt class="py-name">fp</tt> <tt class="py-op">=</tt> <tt class="py-name">StringIO</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1334"></a><tt class="py-lineno">1334</tt>  <tt class="py-line">    <tt class="py-name">g</tt> <tt class="py-op">=</tt> <tt class="py-name">Generator</tt><tt class="py-op">(</tt><tt class="py-name">fp</tt><tt class="py-op">,</tt> <tt class="py-name">mangle_from_</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
-<a name="L1335"></a><tt class="py-lineno">1335</tt>  <tt class="py-line">    <tt class="py-name">g</tt><tt class="py-op">.</tt><tt class="py-name">flatten</tt><tt class="py-op">(</tt><tt class="py-name">message</tt><tt class="py-op">,</tt> <tt class="py-name">unixfrom</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
-<a name="L1336"></a><tt class="py-lineno">1336</tt>  <tt class="py-line">    <tt id="link-240" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-240', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">fp</tt><tt class="py-op">.</tt><tt class="py-name">getvalue</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1337"></a><tt class="py-lineno">1337</tt>  <tt class="py-line"> </tt>
-<a name="L1338"></a><tt class="py-lineno">1338</tt>  <tt class="py-line">    <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L1339"></a><tt class="py-lineno">1339</tt>  <tt class="py-line">    <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'multipart/mixed; '</tt> </tt>
-<a name="L1340"></a><tt class="py-lineno">1340</tt>  <tt class="py-line">                               <tt class="py-string">'boundary="%s"'</tt><tt class="py-op">)</tt> <tt class="py-op">%</tt> <tt class="py-name">message</tt><tt class="py-op">.</tt><tt class="py-name">get_boundary</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1332"></a><tt class="py-lineno">1332</tt>  <tt class="py-line">      <tt class="py-name">msg</tt><tt class="py-op">.</tt><tt class="py-name">set_payload</tt><tt class="py-op">(</tt><tt id="link-239" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-239', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L1333"></a><tt class="py-lineno">1333</tt>  <tt class="py-line">      <tt class="py-name">message</tt><tt class="py-op">.</tt><tt class="py-name">attach</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
+<a name="L1334"></a><tt class="py-lineno">1334</tt>  <tt class="py-line"> </tt>
+<a name="L1335"></a><tt class="py-lineno">1335</tt>  <tt class="py-line">    <tt class="py-comment"># encode the body: note that we can't use `as_string`, because</tt> </tt>
+<a name="L1336"></a><tt class="py-lineno">1336</tt>  <tt class="py-line">    <tt class="py-comment"># it plays games with `From ` lines.</tt> </tt>
+<a name="L1337"></a><tt class="py-lineno">1337</tt>  <tt class="py-line">    <tt class="py-name">fp</tt> <tt class="py-op">=</tt> <tt class="py-name">StringIO</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1338"></a><tt class="py-lineno">1338</tt>  <tt class="py-line">    <tt class="py-name">g</tt> <tt class="py-op">=</tt> <tt class="py-name">Generator</tt><tt class="py-op">(</tt><tt class="py-name">fp</tt><tt class="py-op">,</tt> <tt class="py-name">mangle_from_</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
+<a name="L1339"></a><tt class="py-lineno">1339</tt>  <tt class="py-line">    <tt class="py-name">g</tt><tt class="py-op">.</tt><tt class="py-name">flatten</tt><tt class="py-op">(</tt><tt class="py-name">message</tt><tt class="py-op">,</tt> <tt class="py-name">unixfrom</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
+<a name="L1340"></a><tt class="py-lineno">1340</tt>  <tt class="py-line">    <tt id="link-240" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-240', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">fp</tt><tt class="py-op">.</tt><tt class="py-name">getvalue</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
 <a name="L1341"></a><tt class="py-lineno">1341</tt>  <tt class="py-line"> </tt>
-<a name="L1342"></a><tt class="py-lineno">1342</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-241" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-241', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-242" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1342"></a><tt class="py-lineno">1342</tt>  <tt class="py-line">    <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L1343"></a><tt class="py-lineno">1343</tt>  <tt class="py-line">    <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'multipart/mixed; '</tt> </tt>
+<a name="L1344"></a><tt class="py-lineno">1344</tt>  <tt class="py-line">                               <tt class="py-string">'boundary="%s"'</tt><tt class="py-op">)</tt> <tt class="py-op">%</tt> <tt class="py-name">message</tt><tt class="py-op">.</tt><tt class="py-name">get_boundary</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1345"></a><tt class="py-lineno">1345</tt>  <tt class="py-line"> </tt>
+<a name="L1346"></a><tt class="py-lineno">1346</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-241" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-241', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-242" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-242', 'request', 'link-34');">request</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_batch_uri</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt><tt class="py-op">=</tt><tt class="py-string">'POST'</tt><tt class="py-op">,</tt> <tt id="link-243" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-243', 'body', 'link-69');">body</a></tt><tt class="py-op">=</tt><tt id="link-244" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-244', 'body', 'link-69');">body</a></tt><tt class="py-op">,</tt> </tt>
-<a name="L1343"></a><tt class="py-lineno">1343</tt>  <tt class="py-line">                                 <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt> </tt>
-<a name="L1344"></a><tt class="py-lineno">1344</tt>  <tt class="py-line"> </tt>
-<a name="L1345"></a><tt class="py-lineno">1345</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">&gt;=</tt> <tt class="py-number">300</tt><tt class="py-op">:</tt> </tt>
-<a name="L1346"></a><tt class="py-lineno">1346</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-245" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-245', 'HttpError', 'link-9');">HttpError</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_batch_uri</tt><tt class="py-op">)</tt> </tt>
-<a name="L1347"></a><tt class="py-lineno">1347</tt>  <tt class="py-line"> </tt>
-<a name="L1348"></a><tt class="py-lineno">1348</tt>  <tt class="py-line">    <tt class="py-comment"># Prepend with a content-type header so FeedParser can handle it.</tt> </tt>
-<a name="L1349"></a><tt class="py-lineno">1349</tt>  <tt class="py-line">    <tt class="py-name">header</tt> <tt class="py-op">=</tt> <tt class="py-string">'content-type: %s\r\n\r\n'</tt> <tt class="py-op">%</tt> <tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1350"></a><tt class="py-lineno">1350</tt>  <tt class="py-line">    <tt class="py-comment"># PY3's FeedParser only accepts unicode. So we should decode content</tt> </tt>
-<a name="L1351"></a><tt class="py-lineno">1351</tt>  <tt class="py-line">    <tt class="py-comment"># here, and encode each payload again.</tt> </tt>
-<a name="L1352"></a><tt class="py-lineno">1352</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">PY3</tt><tt class="py-op">:</tt> </tt>
-<a name="L1353"></a><tt class="py-lineno">1353</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt><tt class="py-op">.</tt><tt class="py-name">decode</tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1354"></a><tt class="py-lineno">1354</tt>  <tt class="py-line">    <tt class="py-name">for_parser</tt> <tt class="py-op">=</tt> <tt class="py-name">header</tt> <tt class="py-op">+</tt> <tt class="py-name">content</tt> </tt>
-<a name="L1355"></a><tt class="py-lineno">1355</tt>  <tt class="py-line"> </tt>
-<a name="L1356"></a><tt class="py-lineno">1356</tt>  <tt class="py-line">    <tt class="py-name">parser</tt> <tt class="py-op">=</tt> <tt class="py-name">FeedParser</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1357"></a><tt class="py-lineno">1357</tt>  <tt class="py-line">    <tt class="py-name">parser</tt><tt class="py-op">.</tt><tt class="py-name">feed</tt><tt class="py-op">(</tt><tt class="py-name">for_parser</tt><tt class="py-op">)</tt> </tt>
-<a name="L1358"></a><tt class="py-lineno">1358</tt>  <tt class="py-line">    <tt class="py-name">mime_response</tt> <tt class="py-op">=</tt> <tt class="py-name">parser</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1347"></a><tt class="py-lineno">1347</tt>  <tt class="py-line">                                 <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt> </tt>
+<a name="L1348"></a><tt class="py-lineno">1348</tt>  <tt class="py-line"> </tt>
+<a name="L1349"></a><tt class="py-lineno">1349</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">&gt;=</tt> <tt class="py-number">300</tt><tt class="py-op">:</tt> </tt>
+<a name="L1350"></a><tt class="py-lineno">1350</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-245" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-245', 'HttpError', 'link-9');">HttpError</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_batch_uri</tt><tt class="py-op">)</tt> </tt>
+<a name="L1351"></a><tt class="py-lineno">1351</tt>  <tt class="py-line"> </tt>
+<a name="L1352"></a><tt class="py-lineno">1352</tt>  <tt class="py-line">    <tt class="py-comment"># Prepend with a content-type header so FeedParser can handle it.</tt> </tt>
+<a name="L1353"></a><tt class="py-lineno">1353</tt>  <tt class="py-line">    <tt class="py-name">header</tt> <tt class="py-op">=</tt> <tt class="py-string">'content-type: %s\r\n\r\n'</tt> <tt class="py-op">%</tt> <tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'content-type'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1354"></a><tt class="py-lineno">1354</tt>  <tt class="py-line">    <tt class="py-comment"># PY3's FeedParser only accepts unicode. So we should decode content</tt> </tt>
+<a name="L1355"></a><tt class="py-lineno">1355</tt>  <tt class="py-line">    <tt class="py-comment"># here, and encode each payload again.</tt> </tt>
+<a name="L1356"></a><tt class="py-lineno">1356</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">PY3</tt><tt class="py-op">:</tt> </tt>
+<a name="L1357"></a><tt class="py-lineno">1357</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt><tt class="py-op">.</tt><tt class="py-name">decode</tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1358"></a><tt class="py-lineno">1358</tt>  <tt class="py-line">    <tt class="py-name">for_parser</tt> <tt class="py-op">=</tt> <tt class="py-name">header</tt> <tt class="py-op">+</tt> <tt class="py-name">content</tt> </tt>
 <a name="L1359"></a><tt class="py-lineno">1359</tt>  <tt class="py-line"> </tt>
-<a name="L1360"></a><tt class="py-lineno">1360</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">mime_response</tt><tt class="py-op">.</tt><tt class="py-name">is_multipart</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1361"></a><tt class="py-lineno">1361</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-246" class="py-name"><a title="googleapiclient.errors.BatchError" class="py-name" href="#" onclick="return doclink('link-246', 'BatchError', 'link-6');">BatchError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Response not in multipart/mixed format."</tt><tt class="py-op">,</tt> <tt class="py-name">resp</tt><tt class="py-op">=</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> </tt>
-<a name="L1362"></a><tt class="py-lineno">1362</tt>  <tt class="py-line">                       <tt class="py-name">content</tt><tt class="py-op">=</tt><tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
+<a name="L1360"></a><tt class="py-lineno">1360</tt>  <tt class="py-line">    <tt class="py-name">parser</tt> <tt class="py-op">=</tt> <tt class="py-name">FeedParser</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1361"></a><tt class="py-lineno">1361</tt>  <tt class="py-line">    <tt class="py-name">parser</tt><tt class="py-op">.</tt><tt class="py-name">feed</tt><tt class="py-op">(</tt><tt class="py-name">for_parser</tt><tt class="py-op">)</tt> </tt>
+<a name="L1362"></a><tt class="py-lineno">1362</tt>  <tt class="py-line">    <tt class="py-name">mime_response</tt> <tt class="py-op">=</tt> <tt class="py-name">parser</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
 <a name="L1363"></a><tt class="py-lineno">1363</tt>  <tt class="py-line"> </tt>
-<a name="L1364"></a><tt class="py-lineno">1364</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">part</tt> <tt class="py-keyword">in</tt> <tt class="py-name">mime_response</tt><tt class="py-op">.</tt><tt class="py-name">get_payload</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1365"></a><tt class="py-lineno">1365</tt>  <tt class="py-line">      <tt class="py-name">request_id</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-247" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._header_to_id()=googleapiclient.http.BatchHttpRequest-class.html#_header_to_id"><a title="googleapiclient.http.BatchHttpRequest._header_to_id" class="py-name" href="#" onclick="return doclink('link-247', '_header_to_id', 'link-247');">_header_to_id</a></tt><tt class="py-op">(</tt><tt class="py-name">part</tt><tt class="py-op">[</tt><tt class="py-string">'Content-ID'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
-<a name="L1366"></a><tt class="py-lineno">1366</tt>  <tt class="py-line">      <tt id="link-248" class="py-name" targets="Method googleapiclient.model.BaseModel.response()=googleapiclient.model.BaseModel-class.html#response,Method googleapiclient.model.Model.response()=googleapiclient.model.Model-class.html#response"><a title="googleapiclient.model.BaseModel.response
+<a name="L1364"></a><tt class="py-lineno">1364</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">mime_response</tt><tt class="py-op">.</tt><tt class="py-name">is_multipart</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1365"></a><tt class="py-lineno">1365</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-246" class="py-name"><a title="googleapiclient.errors.BatchError" class="py-name" href="#" onclick="return doclink('link-246', 'BatchError', 'link-6');">BatchError</a></tt><tt class="py-op">(</tt><tt class="py-string">"Response not in multipart/mixed format."</tt><tt class="py-op">,</tt> <tt class="py-name">resp</tt><tt class="py-op">=</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> </tt>
+<a name="L1366"></a><tt class="py-lineno">1366</tt>  <tt class="py-line">                       <tt class="py-name">content</tt><tt class="py-op">=</tt><tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
+<a name="L1367"></a><tt class="py-lineno">1367</tt>  <tt class="py-line"> </tt>
+<a name="L1368"></a><tt class="py-lineno">1368</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">part</tt> <tt class="py-keyword">in</tt> <tt class="py-name">mime_response</tt><tt class="py-op">.</tt><tt class="py-name">get_payload</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1369"></a><tt class="py-lineno">1369</tt>  <tt class="py-line">      <tt class="py-name">request_id</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-247" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._header_to_id()=googleapiclient.http.BatchHttpRequest-class.html#_header_to_id"><a title="googleapiclient.http.BatchHttpRequest._header_to_id" class="py-name" href="#" onclick="return doclink('link-247', '_header_to_id', 'link-247');">_header_to_id</a></tt><tt class="py-op">(</tt><tt class="py-name">part</tt><tt class="py-op">[</tt><tt class="py-string">'Content-ID'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+<a name="L1370"></a><tt class="py-lineno">1370</tt>  <tt class="py-line">      <tt id="link-248" class="py-name" targets="Method googleapiclient.model.BaseModel.response()=googleapiclient.model.BaseModel-class.html#response,Method googleapiclient.model.Model.response()=googleapiclient.model.Model-class.html#response"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-248', 'response', 'link-248');">response</a></tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-249" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._deserialize_response()=googleapiclient.http.BatchHttpRequest-class.html#_deserialize_response"><a title="googleapiclient.http.BatchHttpRequest._deserialize_response" class="py-name" href="#" onclick="return doclink('link-249', '_deserialize_response', 'link-249');">_deserialize_response</a></tt><tt class="py-op">(</tt><tt class="py-name">part</tt><tt class="py-op">.</tt><tt class="py-name">get_payload</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
-<a name="L1367"></a><tt class="py-lineno">1367</tt>  <tt class="py-line">      <tt class="py-comment"># We encode content here to emulate normal http response.</tt> </tt>
-<a name="L1368"></a><tt class="py-lineno">1368</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">text_type</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1369"></a><tt class="py-lineno">1369</tt>  <tt class="py-line">        <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt><tt class="py-op">.</tt><tt class="py-name">encode</tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1370"></a><tt class="py-lineno">1370</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_responses</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-250" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1371"></a><tt class="py-lineno">1371</tt>  <tt class="py-line">      <tt class="py-comment"># We encode content here to emulate normal http response.</tt> </tt>
+<a name="L1372"></a><tt class="py-lineno">1372</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">text_type</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1373"></a><tt class="py-lineno">1373</tt>  <tt class="py-line">        <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt><tt class="py-op">.</tt><tt class="py-name">encode</tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1374"></a><tt class="py-lineno">1374</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_responses</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-250" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-250', 'response', 'link-248');">response</a></tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
-</div><a name="L1371"></a><tt class="py-lineno">1371</tt>  <tt class="py-line"> </tt>
-<a name="L1372"></a><tt class="py-lineno">1372</tt>  <tt class="py-line">  <tt class="py-decorator">@</tt><tt class="py-decorator">util</tt><tt class="py-op">.</tt><tt class="py-name">positional</tt><tt class="py-op">(</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
-<a name="BatchHttpRequest.execute"></a><div id="BatchHttpRequest.execute-def"><a name="L1373"></a><tt class="py-lineno">1373</tt> <a class="py-toggle" href="#" id="BatchHttpRequest.execute-toggle" onclick="return toggle('BatchHttpRequest.execute');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#execute">execute</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="BatchHttpRequest.execute-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest.execute-expanded"><a name="L1374"></a><tt class="py-lineno">1374</tt>  <tt class="py-line">    <tt class="py-docstring">"""Execute all the requests as a single batched HTTP request.</tt> </tt>
-<a name="L1375"></a><tt class="py-lineno">1375</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1376"></a><tt class="py-lineno">1376</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1377"></a><tt class="py-lineno">1377</tt>  <tt class="py-line"><tt class="py-docstring">      http: httplib2.Http, an http object to be used in place of the one the</tt> </tt>
-<a name="L1378"></a><tt class="py-lineno">1378</tt>  <tt class="py-line"><tt class="py-docstring">        HttpRequest request object was constructed with. If one isn't supplied</tt> </tt>
-<a name="L1379"></a><tt class="py-lineno">1379</tt>  <tt class="py-line"><tt class="py-docstring">        then use a http object from the requests in this batch.</tt> </tt>
-<a name="L1380"></a><tt class="py-lineno">1380</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1381"></a><tt class="py-lineno">1381</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
-<a name="L1382"></a><tt class="py-lineno">1382</tt>  <tt class="py-line"><tt class="py-docstring">      None</tt> </tt>
-<a name="L1383"></a><tt class="py-lineno">1383</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1384"></a><tt class="py-lineno">1384</tt>  <tt class="py-line"><tt class="py-docstring">    Raises:</tt> </tt>
-<a name="L1385"></a><tt class="py-lineno">1385</tt>  <tt class="py-line"><tt class="py-docstring">      httplib2.HttpLib2Error if a transport error has occured.</tt> </tt>
-<a name="L1386"></a><tt class="py-lineno">1386</tt>  <tt class="py-line"><tt class="py-docstring">      googleapiclient.errors.BatchError if the response is the wrong format.</tt> </tt>
-<a name="L1387"></a><tt class="py-lineno">1387</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1388"></a><tt class="py-lineno">1388</tt>  <tt class="py-line">    <tt class="py-comment"># If we have no requests return</tt> </tt>
-<a name="L1389"></a><tt class="py-lineno">1389</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
-<a name="L1390"></a><tt class="py-lineno">1390</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1391"></a><tt class="py-lineno">1391</tt>  <tt class="py-line"> </tt>
-<a name="L1392"></a><tt class="py-lineno">1392</tt>  <tt class="py-line">    <tt class="py-comment"># If http is not supplied use the first valid one given in the requests.</tt> </tt>
-<a name="L1393"></a><tt class="py-lineno">1393</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-251" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-251', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1394"></a><tt class="py-lineno">1394</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">:</tt> </tt>
-<a name="L1395"></a><tt class="py-lineno">1395</tt>  <tt class="py-line">        <tt id="link-252" class="py-name"><a title="googleapiclient.http.HttpMock.request
+</div><a name="L1375"></a><tt class="py-lineno">1375</tt>  <tt class="py-line"> </tt>
+<a name="L1376"></a><tt class="py-lineno">1376</tt>  <tt class="py-line">  <tt class="py-decorator">@</tt><tt class="py-decorator">util</tt><tt class="py-op">.</tt><tt class="py-name">positional</tt><tt class="py-op">(</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
+<a name="BatchHttpRequest.execute"></a><div id="BatchHttpRequest.execute-def"><a name="L1377"></a><tt class="py-lineno">1377</tt> <a class="py-toggle" href="#" id="BatchHttpRequest.execute-toggle" onclick="return toggle('BatchHttpRequest.execute');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.BatchHttpRequest-class.html#execute">execute</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="BatchHttpRequest.execute-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="BatchHttpRequest.execute-expanded"><a name="L1378"></a><tt class="py-lineno">1378</tt>  <tt class="py-line">    <tt class="py-docstring">"""Execute all the requests as a single batched HTTP request.</tt> </tt>
+<a name="L1379"></a><tt class="py-lineno">1379</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1380"></a><tt class="py-lineno">1380</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1381"></a><tt class="py-lineno">1381</tt>  <tt class="py-line"><tt class="py-docstring">      http: httplib2.Http, an http object to be used in place of the one the</tt> </tt>
+<a name="L1382"></a><tt class="py-lineno">1382</tt>  <tt class="py-line"><tt class="py-docstring">        HttpRequest request object was constructed with. If one isn't supplied</tt> </tt>
+<a name="L1383"></a><tt class="py-lineno">1383</tt>  <tt class="py-line"><tt class="py-docstring">        then use a http object from the requests in this batch.</tt> </tt>
+<a name="L1384"></a><tt class="py-lineno">1384</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1385"></a><tt class="py-lineno">1385</tt>  <tt class="py-line"><tt class="py-docstring">    Returns:</tt> </tt>
+<a name="L1386"></a><tt class="py-lineno">1386</tt>  <tt class="py-line"><tt class="py-docstring">      None</tt> </tt>
+<a name="L1387"></a><tt class="py-lineno">1387</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1388"></a><tt class="py-lineno">1388</tt>  <tt class="py-line"><tt class="py-docstring">    Raises:</tt> </tt>
+<a name="L1389"></a><tt class="py-lineno">1389</tt>  <tt class="py-line"><tt class="py-docstring">      httplib2.HttpLib2Error if a transport error has occured.</tt> </tt>
+<a name="L1390"></a><tt class="py-lineno">1390</tt>  <tt class="py-line"><tt class="py-docstring">      googleapiclient.errors.BatchError if the response is the wrong format.</tt> </tt>
+<a name="L1391"></a><tt class="py-lineno">1391</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1392"></a><tt class="py-lineno">1392</tt>  <tt class="py-line">    <tt class="py-comment"># If we have no requests return</tt> </tt>
+<a name="L1393"></a><tt class="py-lineno">1393</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
+<a name="L1394"></a><tt class="py-lineno">1394</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt>
+<a name="L1395"></a><tt class="py-lineno">1395</tt>  <tt class="py-line"> </tt>
+<a name="L1396"></a><tt class="py-lineno">1396</tt>  <tt class="py-line">    <tt class="py-comment"># If http is not supplied use the first valid one given in the requests.</tt> </tt>
+<a name="L1397"></a><tt class="py-lineno">1397</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-251" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-251', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1398"></a><tt class="py-lineno">1398</tt>  <tt class="py-line">      <tt class="py-keyword">for</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">:</tt> </tt>
+<a name="L1399"></a><tt class="py-lineno">1399</tt>  <tt class="py-line">        <tt id="link-252" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-252', 'request', 'link-34');">request</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
-<a name="L1396"></a><tt class="py-lineno">1396</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt id="link-253" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1400"></a><tt class="py-lineno">1400</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt id="link-253" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-253', 'request', 'link-34');">request</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1397"></a><tt class="py-lineno">1397</tt>  <tt class="py-line">          <tt id="link-254" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-254', 'http', 'link-33');">http</a></tt> <tt class="py-op">=</tt> <tt id="link-255" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1401"></a><tt class="py-lineno">1401</tt>  <tt class="py-line">          <tt id="link-254" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-254', 'http', 'link-33');">http</a></tt> <tt class="py-op">=</tt> <tt id="link-255" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-255', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt id="link-256" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-256', 'http', 'link-33');">http</a></tt> </tt>
-<a name="L1398"></a><tt class="py-lineno">1398</tt>  <tt class="py-line">          <tt class="py-keyword">break</tt> </tt>
-<a name="L1399"></a><tt class="py-lineno">1399</tt>  <tt class="py-line"> </tt>
-<a name="L1400"></a><tt class="py-lineno">1400</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-257" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-257', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1401"></a><tt class="py-lineno">1401</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">"Missing a valid http object."</tt><tt class="py-op">)</tt> </tt>
-<a name="L1402"></a><tt class="py-lineno">1402</tt>  <tt class="py-line"> </tt>
-<a name="L1403"></a><tt class="py-lineno">1403</tt>  <tt class="py-line">    <tt class="py-comment"># Special case for OAuth2Credentials-style objects which have not yet been</tt> </tt>
-<a name="L1404"></a><tt class="py-lineno">1404</tt>  <tt class="py-line">    <tt class="py-comment"># refreshed with an initial access_token.</tt> </tt>
-<a name="L1405"></a><tt class="py-lineno">1405</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt id="link-258" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-258', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-259" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1402"></a><tt class="py-lineno">1402</tt>  <tt class="py-line">          <tt class="py-keyword">break</tt> </tt>
+<a name="L1403"></a><tt class="py-lineno">1403</tt>  <tt class="py-line"> </tt>
+<a name="L1404"></a><tt class="py-lineno">1404</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt id="link-257" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-257', 'http', 'link-33');">http</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1405"></a><tt class="py-lineno">1405</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">"Missing a valid http object."</tt><tt class="py-op">)</tt> </tt>
+<a name="L1406"></a><tt class="py-lineno">1406</tt>  <tt class="py-line"> </tt>
+<a name="L1407"></a><tt class="py-lineno">1407</tt>  <tt class="py-line">    <tt class="py-comment"># Special case for OAuth2Credentials-style objects which have not yet been</tt> </tt>
+<a name="L1408"></a><tt class="py-lineno">1408</tt>  <tt class="py-line">    <tt class="py-comment"># refreshed with an initial access_token.</tt> </tt>
+<a name="L1409"></a><tt class="py-lineno">1409</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt id="link-258" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-258', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-259" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-259', 'request', 'link-34');">request</a></tt><tt class="py-op">,</tt> <tt class="py-string">'credentials'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1406"></a><tt class="py-lineno">1406</tt>  <tt class="py-line">      <tt class="py-name">creds</tt> <tt class="py-op">=</tt> <tt id="link-260" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-260', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-261" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1410"></a><tt class="py-lineno">1410</tt>  <tt class="py-line">      <tt class="py-name">creds</tt> <tt class="py-op">=</tt> <tt id="link-260" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-260', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-261" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-261', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">credentials</tt> </tt>
-<a name="L1407"></a><tt class="py-lineno">1407</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt class="py-name">creds</tt><tt class="py-op">,</tt> <tt class="py-string">'access_token'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1408"></a><tt class="py-lineno">1408</tt>  <tt class="py-line">        <tt id="link-262" class="py-name"><a title="googleapiclient.discovery_cache.LOGGER
+<a name="L1411"></a><tt class="py-lineno">1411</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt class="py-name">creds</tt><tt class="py-op">,</tt> <tt class="py-string">'access_token'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1412"></a><tt class="py-lineno">1412</tt>  <tt class="py-line">        <tt id="link-262" class="py-name"><a title="googleapiclient.discovery_cache.LOGGER
 googleapiclient.discovery_cache.appengine_memcache.LOGGER
 googleapiclient.discovery_cache.file_cache.LOGGER
 googleapiclient.http.LOGGER
 googleapiclient.model.LOGGER" class="py-name" href="#" onclick="return doclink('link-262', 'LOGGER', 'link-25');">LOGGER</a></tt><tt class="py-op">.</tt><tt class="py-name">info</tt><tt class="py-op">(</tt><tt class="py-string">'Attempting refresh to obtain initial access_token'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1409"></a><tt class="py-lineno">1409</tt>  <tt class="py-line">        <tt class="py-name">creds</tt><tt class="py-op">.</tt><tt class="py-name">refresh</tt><tt class="py-op">(</tt><tt id="link-263" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-263', 'http', 'link-33');">http</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1410"></a><tt class="py-lineno">1410</tt>  <tt class="py-line"> </tt>
-<a name="L1411"></a><tt class="py-lineno">1411</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-264" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._execute()=googleapiclient.http.BatchHttpRequest-class.html#_execute"><a title="googleapiclient.http.BatchHttpRequest._execute" class="py-name" href="#" onclick="return doclink('link-264', '_execute', 'link-264');">_execute</a></tt><tt class="py-op">(</tt><tt id="link-265" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-265', 'http', 'link-33');">http</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">)</tt> </tt>
-<a name="L1412"></a><tt class="py-lineno">1412</tt>  <tt class="py-line"> </tt>
-<a name="L1413"></a><tt class="py-lineno">1413</tt>  <tt class="py-line">    <tt class="py-comment"># Loop over all the requests and check for 401s. For each 401 request the</tt> </tt>
-<a name="L1414"></a><tt class="py-lineno">1414</tt>  <tt class="py-line">    <tt class="py-comment"># credentials should be refreshed and then sent again in a separate batch.</tt> </tt>
-<a name="L1415"></a><tt class="py-lineno">1415</tt>  <tt class="py-line">    <tt class="py-name">redo_requests</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L1416"></a><tt class="py-lineno">1416</tt>  <tt class="py-line">    <tt class="py-name">redo_order</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
-<a name="L1417"></a><tt class="py-lineno">1417</tt>  <tt class="py-line"> </tt>
-<a name="L1418"></a><tt class="py-lineno">1418</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">:</tt> </tt>
-<a name="L1419"></a><tt class="py-lineno">1419</tt>  <tt class="py-line">      <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_responses</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
-<a name="L1420"></a><tt class="py-lineno">1420</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'status'</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-string">'401'</tt><tt class="py-op">:</tt> </tt>
-<a name="L1421"></a><tt class="py-lineno">1421</tt>  <tt class="py-line">        <tt class="py-name">redo_order</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">)</tt> </tt>
-<a name="L1422"></a><tt class="py-lineno">1422</tt>  <tt class="py-line">        <tt id="link-266" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1413"></a><tt class="py-lineno">1413</tt>  <tt class="py-line">        <tt class="py-name">creds</tt><tt class="py-op">.</tt><tt class="py-name">refresh</tt><tt class="py-op">(</tt><tt id="link-263" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-263', 'http', 'link-33');">http</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L1414"></a><tt class="py-lineno">1414</tt>  <tt class="py-line"> </tt>
+<a name="L1415"></a><tt class="py-lineno">1415</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-264" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._execute()=googleapiclient.http.BatchHttpRequest-class.html#_execute"><a title="googleapiclient.http.BatchHttpRequest._execute" class="py-name" href="#" onclick="return doclink('link-264', '_execute', 'link-264');">_execute</a></tt><tt class="py-op">(</tt><tt id="link-265" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-265', 'http', 'link-33');">http</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">)</tt> </tt>
+<a name="L1416"></a><tt class="py-lineno">1416</tt>  <tt class="py-line"> </tt>
+<a name="L1417"></a><tt class="py-lineno">1417</tt>  <tt class="py-line">    <tt class="py-comment"># Loop over all the requests and check for 401s. For each 401 request the</tt> </tt>
+<a name="L1418"></a><tt class="py-lineno">1418</tt>  <tt class="py-line">    <tt class="py-comment"># credentials should be refreshed and then sent again in a separate batch.</tt> </tt>
+<a name="L1419"></a><tt class="py-lineno">1419</tt>  <tt class="py-line">    <tt class="py-name">redo_requests</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L1420"></a><tt class="py-lineno">1420</tt>  <tt class="py-line">    <tt class="py-name">redo_order</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+<a name="L1421"></a><tt class="py-lineno">1421</tt>  <tt class="py-line"> </tt>
+<a name="L1422"></a><tt class="py-lineno">1422</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">:</tt> </tt>
+<a name="L1423"></a><tt class="py-lineno">1423</tt>  <tt class="py-line">      <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_responses</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
+<a name="L1424"></a><tt class="py-lineno">1424</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'status'</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-string">'401'</tt><tt class="py-op">:</tt> </tt>
+<a name="L1425"></a><tt class="py-lineno">1425</tt>  <tt class="py-line">        <tt class="py-name">redo_order</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">)</tt> </tt>
+<a name="L1426"></a><tt class="py-lineno">1426</tt>  <tt class="py-line">        <tt id="link-266" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-266', 'request', 'link-34');">request</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
-<a name="L1423"></a><tt class="py-lineno">1423</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-267" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._refresh_and_apply_credentials()=googleapiclient.http.BatchHttpRequest-class.html#_refresh_and_apply_credentials"><a title="googleapiclient.http.BatchHttpRequest._refresh_and_apply_credentials" class="py-name" href="#" onclick="return doclink('link-267', '_refresh_and_apply_credentials', 'link-267');">_refresh_and_apply_credentials</a></tt><tt class="py-op">(</tt><tt id="link-268" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1427"></a><tt class="py-lineno">1427</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-267" class="py-name" targets="Method googleapiclient.http.BatchHttpRequest._refresh_and_apply_credentials()=googleapiclient.http.BatchHttpRequest-class.html#_refresh_and_apply_credentials"><a title="googleapiclient.http.BatchHttpRequest._refresh_and_apply_credentials" class="py-name" href="#" onclick="return doclink('link-267', '_refresh_and_apply_credentials', 'link-267');">_refresh_and_apply_credentials</a></tt><tt class="py-op">(</tt><tt id="link-268" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-268', 'request', 'link-34');">request</a></tt><tt class="py-op">,</tt> <tt id="link-269" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-269', 'http', 'link-33');">http</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1424"></a><tt class="py-lineno">1424</tt>  <tt class="py-line">        <tt class="py-name">redo_requests</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-270" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1428"></a><tt class="py-lineno">1428</tt>  <tt class="py-line">        <tt class="py-name">redo_requests</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-270" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-270', 'request', 'link-34');">request</a></tt> </tt>
-<a name="L1425"></a><tt class="py-lineno">1425</tt>  <tt class="py-line"> </tt>
-<a name="L1426"></a><tt class="py-lineno">1426</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">redo_requests</tt><tt class="py-op">:</tt> </tt>
-<a name="L1427"></a><tt class="py-lineno">1427</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-271" class="py-name"><a title="googleapiclient.http.BatchHttpRequest._execute" class="py-name" href="#" onclick="return doclink('link-271', '_execute', 'link-264');">_execute</a></tt><tt class="py-op">(</tt><tt id="link-272" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-272', 'http', 'link-33');">http</a></tt><tt class="py-op">,</tt> <tt class="py-name">redo_order</tt><tt class="py-op">,</tt> <tt class="py-name">redo_requests</tt><tt class="py-op">)</tt> </tt>
-<a name="L1428"></a><tt class="py-lineno">1428</tt>  <tt class="py-line"> </tt>
-<a name="L1429"></a><tt class="py-lineno">1429</tt>  <tt class="py-line">    <tt class="py-comment"># Now process all callbacks that are erroring, and raise an exception for</tt> </tt>
-<a name="L1430"></a><tt class="py-lineno">1430</tt>  <tt class="py-line">    <tt class="py-comment"># ones that return a non-2xx response? Or add extra parameter to callback</tt> </tt>
-<a name="L1431"></a><tt class="py-lineno">1431</tt>  <tt class="py-line">    <tt class="py-comment"># that contains an HttpError?</tt> </tt>
+<a name="L1429"></a><tt class="py-lineno">1429</tt>  <tt class="py-line"> </tt>
+<a name="L1430"></a><tt class="py-lineno">1430</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">redo_requests</tt><tt class="py-op">:</tt> </tt>
+<a name="L1431"></a><tt class="py-lineno">1431</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-271" class="py-name"><a title="googleapiclient.http.BatchHttpRequest._execute" class="py-name" href="#" onclick="return doclink('link-271', '_execute', 'link-264');">_execute</a></tt><tt class="py-op">(</tt><tt id="link-272" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-272', 'http', 'link-33');">http</a></tt><tt class="py-op">,</tt> <tt class="py-name">redo_order</tt><tt class="py-op">,</tt> <tt class="py-name">redo_requests</tt><tt class="py-op">)</tt> </tt>
 <a name="L1432"></a><tt class="py-lineno">1432</tt>  <tt class="py-line"> </tt>
-<a name="L1433"></a><tt class="py-lineno">1433</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">:</tt> </tt>
-<a name="L1434"></a><tt class="py-lineno">1434</tt>  <tt class="py-line">      <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_responses</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
-<a name="L1435"></a><tt class="py-lineno">1435</tt>  <tt class="py-line"> </tt>
-<a name="L1436"></a><tt class="py-lineno">1436</tt>  <tt class="py-line">      <tt id="link-273" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1433"></a><tt class="py-lineno">1433</tt>  <tt class="py-line">    <tt class="py-comment"># Now process all callbacks that are erroring, and raise an exception for</tt> </tt>
+<a name="L1434"></a><tt class="py-lineno">1434</tt>  <tt class="py-line">    <tt class="py-comment"># ones that return a non-2xx response? Or add extra parameter to callback</tt> </tt>
+<a name="L1435"></a><tt class="py-lineno">1435</tt>  <tt class="py-line">    <tt class="py-comment"># that contains an HttpError?</tt> </tt>
+<a name="L1436"></a><tt class="py-lineno">1436</tt>  <tt class="py-line"> </tt>
+<a name="L1437"></a><tt class="py-lineno">1437</tt>  <tt class="py-line">    <tt class="py-keyword">for</tt> <tt class="py-name">request_id</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_order</tt><tt class="py-op">:</tt> </tt>
+<a name="L1438"></a><tt class="py-lineno">1438</tt>  <tt class="py-line">      <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_responses</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
+<a name="L1439"></a><tt class="py-lineno">1439</tt>  <tt class="py-line"> </tt>
+<a name="L1440"></a><tt class="py-lineno">1440</tt>  <tt class="py-line">      <tt id="link-273" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-273', 'request', 'link-34');">request</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_requests</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
-<a name="L1437"></a><tt class="py-lineno">1437</tt>  <tt class="py-line">      <tt class="py-name">callback</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callbacks</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
-<a name="L1438"></a><tt class="py-lineno">1438</tt>  <tt class="py-line"> </tt>
-<a name="L1439"></a><tt class="py-lineno">1439</tt>  <tt class="py-line">      <tt id="link-274" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1441"></a><tt class="py-lineno">1441</tt>  <tt class="py-line">      <tt class="py-name">callback</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callbacks</tt><tt class="py-op">[</tt><tt class="py-name">request_id</tt><tt class="py-op">]</tt> </tt>
+<a name="L1442"></a><tt class="py-lineno">1442</tt>  <tt class="py-line"> </tt>
+<a name="L1443"></a><tt class="py-lineno">1443</tt>  <tt class="py-line">      <tt id="link-274" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-274', 'response', 'link-248');">response</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1440"></a><tt class="py-lineno">1440</tt>  <tt class="py-line">      <tt class="py-name">exception</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1441"></a><tt class="py-lineno">1441</tt>  <tt class="py-line">      <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
-<a name="L1442"></a><tt class="py-lineno">1442</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">&gt;=</tt> <tt class="py-number">300</tt><tt class="py-op">:</tt> </tt>
-<a name="L1443"></a><tt class="py-lineno">1443</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-275" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-275', 'HttpError', 'link-9');">HttpError</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt id="link-276" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1444"></a><tt class="py-lineno">1444</tt>  <tt class="py-line">      <tt class="py-name">exception</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L1445"></a><tt class="py-lineno">1445</tt>  <tt class="py-line">      <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L1446"></a><tt class="py-lineno">1446</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">status</tt> <tt class="py-op">&gt;=</tt> <tt class="py-number">300</tt><tt class="py-op">:</tt> </tt>
+<a name="L1447"></a><tt class="py-lineno">1447</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-275" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-275', 'HttpError', 'link-9');">HttpError</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">uri</tt><tt class="py-op">=</tt><tt id="link-276" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-276', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">uri</tt><tt class="py-op">)</tt> </tt>
-<a name="L1444"></a><tt class="py-lineno">1444</tt>  <tt class="py-line">        <tt id="link-277" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1448"></a><tt class="py-lineno">1448</tt>  <tt class="py-line">        <tt id="link-277" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-277', 'response', 'link-248');">response</a></tt> <tt class="py-op">=</tt> <tt id="link-278" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-278', 'request', 'link-34');">request</a></tt><tt class="py-op">.</tt><tt class="py-name">postproc</tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
-<a name="L1445"></a><tt class="py-lineno">1445</tt>  <tt class="py-line">      <tt class="py-keyword">except</tt> <tt id="link-279" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-279', 'HttpError', 'link-9');">HttpError</a></tt> <tt class="py-keyword">as</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
-<a name="L1446"></a><tt class="py-lineno">1446</tt>  <tt class="py-line">        <tt class="py-name">exception</tt> <tt class="py-op">=</tt> <tt class="py-name">e</tt> </tt>
-<a name="L1447"></a><tt class="py-lineno">1447</tt>  <tt class="py-line"> </tt>
-<a name="L1448"></a><tt class="py-lineno">1448</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">callback</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1449"></a><tt class="py-lineno">1449</tt>  <tt class="py-line">        <tt class="py-name">callback</tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">,</tt> <tt id="link-280" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1449"></a><tt class="py-lineno">1449</tt>  <tt class="py-line">      <tt class="py-keyword">except</tt> <tt id="link-279" class="py-name"><a title="googleapiclient.errors.HttpError" class="py-name" href="#" onclick="return doclink('link-279', 'HttpError', 'link-9');">HttpError</a></tt> <tt class="py-keyword">as</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
+<a name="L1450"></a><tt class="py-lineno">1450</tt>  <tt class="py-line">        <tt class="py-name">exception</tt> <tt class="py-op">=</tt> <tt class="py-name">e</tt> </tt>
+<a name="L1451"></a><tt class="py-lineno">1451</tt>  <tt class="py-line"> </tt>
+<a name="L1452"></a><tt class="py-lineno">1452</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">callback</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1453"></a><tt class="py-lineno">1453</tt>  <tt class="py-line">        <tt class="py-name">callback</tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">,</tt> <tt id="link-280" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-280', 'response', 'link-248');">response</a></tt><tt class="py-op">,</tt> <tt class="py-name">exception</tt><tt class="py-op">)</tt> </tt>
-<a name="L1450"></a><tt class="py-lineno">1450</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callback</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1451"></a><tt class="py-lineno">1451</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callback</tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">,</tt> <tt id="link-281" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1454"></a><tt class="py-lineno">1454</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callback</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1455"></a><tt class="py-lineno">1455</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_callback</tt><tt class="py-op">(</tt><tt class="py-name">request_id</tt><tt class="py-op">,</tt> <tt id="link-281" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-281', 'response', 'link-248');">response</a></tt><tt class="py-op">,</tt> <tt class="py-name">exception</tt><tt class="py-op">)</tt> </tt>
-</div></div><a name="L1452"></a><tt class="py-lineno">1452</tt>  <tt class="py-line"> </tt>
-<a name="HttpRequestMock"></a><div id="HttpRequestMock-def"><a name="L1453"></a><tt class="py-lineno">1453</tt>  <tt class="py-line"> </tt>
-<a name="L1454"></a><tt class="py-lineno">1454</tt> <a class="py-toggle" href="#" id="HttpRequestMock-toggle" onclick="return toggle('HttpRequestMock');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequestMock-class.html">HttpRequestMock</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpRequestMock-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="HttpRequestMock-expanded"><a name="L1455"></a><tt class="py-lineno">1455</tt>  <tt class="py-line">  <tt class="py-docstring">"""Mock of HttpRequest.</tt> </tt>
-<a name="L1456"></a><tt class="py-lineno">1456</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1457"></a><tt class="py-lineno">1457</tt>  <tt class="py-line"><tt class="py-docstring">  Do not construct directly, instead use RequestMockBuilder.</tt> </tt>
-<a name="L1458"></a><tt class="py-lineno">1458</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L1459"></a><tt class="py-lineno">1459</tt>  <tt class="py-line"> </tt>
-<a name="HttpRequestMock.__init__"></a><div id="HttpRequestMock.__init__-def"><a name="L1460"></a><tt class="py-lineno">1460</tt> <a class="py-toggle" href="#" id="HttpRequestMock.__init__-toggle" onclick="return toggle('HttpRequestMock.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequestMock-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">resp</tt><tt class="py-op">,</tt> <tt class="py-param">content</tt><tt class="py-op">,</tt> <tt class="py-param">postproc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpRequestMock.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpRequestMock.__init__-expanded"><a name="L1461"></a><tt class="py-lineno">1461</tt>  <tt class="py-line">    <tt class="py-docstring">"""Constructor for HttpRequestMock</tt> </tt>
-<a name="L1462"></a><tt class="py-lineno">1462</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1463"></a><tt class="py-lineno">1463</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1464"></a><tt class="py-lineno">1464</tt>  <tt class="py-line"><tt class="py-docstring">      resp: httplib2.Response, the response to emulate coming from the request</tt> </tt>
-<a name="L1465"></a><tt class="py-lineno">1465</tt>  <tt class="py-line"><tt class="py-docstring">      content: string, the response body</tt> </tt>
-<a name="L1466"></a><tt class="py-lineno">1466</tt>  <tt class="py-line"><tt class="py-docstring">      postproc: callable, the post processing function usually supplied by</tt> </tt>
-<a name="L1467"></a><tt class="py-lineno">1467</tt>  <tt class="py-line"><tt class="py-docstring">                the model class. See model.JsonModel.response() as an example.</tt> </tt>
-<a name="L1468"></a><tt class="py-lineno">1468</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1469"></a><tt class="py-lineno">1469</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt> <tt class="py-op">=</tt> <tt class="py-name">resp</tt> </tt>
-<a name="L1470"></a><tt class="py-lineno">1470</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt> </tt>
-<a name="L1471"></a><tt class="py-lineno">1471</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">postproc</tt> <tt class="py-op">=</tt> <tt class="py-name">postproc</tt> </tt>
-<a name="L1472"></a><tt class="py-lineno">1472</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1473"></a><tt class="py-lineno">1473</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt> <tt class="py-op">=</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Response</tt><tt class="py-op">(</tt><tt class="py-op">{</tt><tt class="py-string">'status'</tt><tt class="py-op">:</tt> <tt class="py-number">200</tt><tt class="py-op">,</tt> <tt class="py-string">'reason'</tt><tt class="py-op">:</tt> <tt class="py-string">'OK'</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
-<a name="L1474"></a><tt class="py-lineno">1474</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'reason'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">:</tt> </tt>
-<a name="L1475"></a><tt class="py-lineno">1475</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">reason</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'reason'</tt><tt class="py-op">]</tt> </tt>
-</div><a name="L1476"></a><tt class="py-lineno">1476</tt>  <tt class="py-line"> </tt>
-<a name="HttpRequestMock.execute"></a><div id="HttpRequestMock.execute-def"><a name="L1477"></a><tt class="py-lineno">1477</tt> <a class="py-toggle" href="#" id="HttpRequestMock.execute-toggle" onclick="return toggle('HttpRequestMock.execute');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequestMock-class.html#execute">execute</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpRequestMock.execute-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpRequestMock.execute-expanded"><a name="L1478"></a><tt class="py-lineno">1478</tt>  <tt class="py-line">    <tt class="py-docstring">"""Execute the request.</tt> </tt>
-<a name="L1479"></a><tt class="py-lineno">1479</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1480"></a><tt class="py-lineno">1480</tt>  <tt class="py-line"><tt class="py-docstring">    Same behavior as HttpRequest.execute(), but the response is</tt> </tt>
-<a name="L1481"></a><tt class="py-lineno">1481</tt>  <tt class="py-line"><tt class="py-docstring">    mocked and not really from an HTTP request/response.</tt> </tt>
-<a name="L1482"></a><tt class="py-lineno">1482</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1483"></a><tt class="py-lineno">1483</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">postproc</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
-</div></div><a name="L1484"></a><tt class="py-lineno">1484</tt>  <tt class="py-line"> </tt>
-<a name="RequestMockBuilder"></a><div id="RequestMockBuilder-def"><a name="L1485"></a><tt class="py-lineno">1485</tt>  <tt class="py-line"> </tt>
-<a name="L1486"></a><tt class="py-lineno">1486</tt> <a class="py-toggle" href="#" id="RequestMockBuilder-toggle" onclick="return toggle('RequestMockBuilder');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.RequestMockBuilder-class.html">RequestMockBuilder</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="RequestMockBuilder-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="RequestMockBuilder-expanded"><a name="L1487"></a><tt class="py-lineno">1487</tt>  <tt class="py-line">  <tt class="py-docstring">"""A simple mock of HttpRequest</tt> </tt>
-<a name="L1488"></a><tt class="py-lineno">1488</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1489"></a><tt class="py-lineno">1489</tt>  <tt class="py-line"><tt class="py-docstring">    Pass in a dictionary to the constructor that maps request methodIds to</tt> </tt>
-<a name="L1490"></a><tt class="py-lineno">1490</tt>  <tt class="py-line"><tt class="py-docstring">    tuples of (httplib2.Response, content, opt_expected_body) that should be</tt> </tt>
-<a name="L1491"></a><tt class="py-lineno">1491</tt>  <tt class="py-line"><tt class="py-docstring">    returned when that method is called. None may also be passed in for the</tt> </tt>
-<a name="L1492"></a><tt class="py-lineno">1492</tt>  <tt class="py-line"><tt class="py-docstring">    httplib2.Response, in which case a 200 OK response will be generated.</tt> </tt>
-<a name="L1493"></a><tt class="py-lineno">1493</tt>  <tt class="py-line"><tt class="py-docstring">    If an opt_expected_body (str or dict) is provided, it will be compared to</tt> </tt>
-<a name="L1494"></a><tt class="py-lineno">1494</tt>  <tt class="py-line"><tt class="py-docstring">    the body and UnexpectedBodyError will be raised on inequality.</tt> </tt>
-<a name="L1495"></a><tt class="py-lineno">1495</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1496"></a><tt class="py-lineno">1496</tt>  <tt class="py-line"><tt class="py-docstring">    Example:</tt> </tt>
-<a name="L1497"></a><tt class="py-lineno">1497</tt>  <tt class="py-line"><tt class="py-docstring">      response = '{"data": {"id": "tag:google.c...'</tt> </tt>
-<a name="L1498"></a><tt class="py-lineno">1498</tt>  <tt class="py-line"><tt class="py-docstring">      requestBuilder = RequestMockBuilder(</tt> </tt>
-<a name="L1499"></a><tt class="py-lineno">1499</tt>  <tt class="py-line"><tt class="py-docstring">        {</tt> </tt>
-<a name="L1500"></a><tt class="py-lineno">1500</tt>  <tt class="py-line"><tt class="py-docstring">          'plus.activities.get': (None, response),</tt> </tt>
-<a name="L1501"></a><tt class="py-lineno">1501</tt>  <tt class="py-line"><tt class="py-docstring">        }</tt> </tt>
-<a name="L1502"></a><tt class="py-lineno">1502</tt>  <tt class="py-line"><tt class="py-docstring">      )</tt> </tt>
-<a name="L1503"></a><tt class="py-lineno">1503</tt>  <tt class="py-line"><tt class="py-docstring">      googleapiclient.discovery.build("plus", "v1", requestBuilder=requestBuilder)</tt> </tt>
-<a name="L1504"></a><tt class="py-lineno">1504</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1505"></a><tt class="py-lineno">1505</tt>  <tt class="py-line"><tt class="py-docstring">    Methods that you do not supply a response for will return a</tt> </tt>
-<a name="L1506"></a><tt class="py-lineno">1506</tt>  <tt class="py-line"><tt class="py-docstring">    200 OK with an empty string as the response content or raise an excpetion</tt> </tt>
-<a name="L1507"></a><tt class="py-lineno">1507</tt>  <tt class="py-line"><tt class="py-docstring">    if check_unexpected is set to True. The methodId is taken from the rpcName</tt> </tt>
-<a name="L1508"></a><tt class="py-lineno">1508</tt>  <tt class="py-line"><tt class="py-docstring">    in the discovery document.</tt> </tt>
-<a name="L1509"></a><tt class="py-lineno">1509</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1510"></a><tt class="py-lineno">1510</tt>  <tt class="py-line"><tt class="py-docstring">    For more details see the project wiki.</tt> </tt>
-<a name="L1511"></a><tt class="py-lineno">1511</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L1512"></a><tt class="py-lineno">1512</tt>  <tt class="py-line"> </tt>
-<a name="RequestMockBuilder.__init__"></a><div id="RequestMockBuilder.__init__-def"><a name="L1513"></a><tt class="py-lineno">1513</tt> <a class="py-toggle" href="#" id="RequestMockBuilder.__init__-toggle" onclick="return toggle('RequestMockBuilder.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.RequestMockBuilder-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">responses</tt><tt class="py-op">,</tt> <tt class="py-param">check_unexpected</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="RequestMockBuilder.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="RequestMockBuilder.__init__-expanded"><a name="L1514"></a><tt class="py-lineno">1514</tt>  <tt class="py-line">    <tt class="py-docstring">"""Constructor for RequestMockBuilder</tt> </tt>
-<a name="L1515"></a><tt class="py-lineno">1515</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1516"></a><tt class="py-lineno">1516</tt>  <tt class="py-line"><tt class="py-docstring">    The constructed object should be a callable object</tt> </tt>
-<a name="L1517"></a><tt class="py-lineno">1517</tt>  <tt class="py-line"><tt class="py-docstring">    that can replace the class HttpResponse.</tt> </tt>
-<a name="L1518"></a><tt class="py-lineno">1518</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1519"></a><tt class="py-lineno">1519</tt>  <tt class="py-line"><tt class="py-docstring">    responses - A dictionary that maps methodIds into tuples</tt> </tt>
-<a name="L1520"></a><tt class="py-lineno">1520</tt>  <tt class="py-line"><tt class="py-docstring">                of (httplib2.Response, content). The methodId</tt> </tt>
-<a name="L1521"></a><tt class="py-lineno">1521</tt>  <tt class="py-line"><tt class="py-docstring">                comes from the 'rpcName' field in the discovery</tt> </tt>
-<a name="L1522"></a><tt class="py-lineno">1522</tt>  <tt class="py-line"><tt class="py-docstring">                document.</tt> </tt>
-<a name="L1523"></a><tt class="py-lineno">1523</tt>  <tt class="py-line"><tt class="py-docstring">    check_unexpected - A boolean setting whether or not UnexpectedMethodError</tt> </tt>
-<a name="L1524"></a><tt class="py-lineno">1524</tt>  <tt class="py-line"><tt class="py-docstring">                       should be raised on unsupplied method.</tt> </tt>
-<a name="L1525"></a><tt class="py-lineno">1525</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1526"></a><tt class="py-lineno">1526</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">responses</tt> <tt class="py-op">=</tt> <tt class="py-name">responses</tt> </tt>
-<a name="L1527"></a><tt class="py-lineno">1527</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">check_unexpected</tt> <tt class="py-op">=</tt> <tt class="py-name">check_unexpected</tt> </tt>
-</div><a name="L1528"></a><tt class="py-lineno">1528</tt>  <tt class="py-line"> </tt>
-<a name="RequestMockBuilder.__call__"></a><div id="RequestMockBuilder.__call__-def"><a name="L1529"></a><tt class="py-lineno">1529</tt> <a class="py-toggle" href="#" id="RequestMockBuilder.__call__-toggle" onclick="return toggle('RequestMockBuilder.__call__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.RequestMockBuilder-class.html#__call__">__call__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">postproc</tt><tt class="py-op">,</tt> <tt class="py-param">uri</tt><tt class="py-op">,</tt> <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L1530"></a><tt class="py-lineno">1530</tt>  <tt class="py-line">               <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">methodId</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">resumable</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="RequestMockBuilder.__call__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="RequestMockBuilder.__call__-expanded"><a name="L1531"></a><tt class="py-lineno">1531</tt>  <tt class="py-line">    <tt class="py-docstring">"""Implements the callable interface that discovery.build() expects</tt> </tt>
-<a name="L1532"></a><tt class="py-lineno">1532</tt>  <tt class="py-line"><tt class="py-docstring">    of requestBuilder, which is to build an object compatible with</tt> </tt>
-<a name="L1533"></a><tt class="py-lineno">1533</tt>  <tt class="py-line"><tt class="py-docstring">    HttpRequest.execute(). See that method for the description of the</tt> </tt>
-<a name="L1534"></a><tt class="py-lineno">1534</tt>  <tt class="py-line"><tt class="py-docstring">    parameters and the expected response.</tt> </tt>
-<a name="L1535"></a><tt class="py-lineno">1535</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1536"></a><tt class="py-lineno">1536</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">methodId</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">responses</tt><tt class="py-op">:</tt> </tt>
-<a name="L1537"></a><tt class="py-lineno">1537</tt>  <tt class="py-line">      <tt id="link-282" class="py-name"><a title="googleapiclient.model.BaseModel.response
+</div></div><a name="L1456"></a><tt class="py-lineno">1456</tt>  <tt class="py-line"> </tt>
+<a name="HttpRequestMock"></a><div id="HttpRequestMock-def"><a name="L1457"></a><tt class="py-lineno">1457</tt>  <tt class="py-line"> </tt>
+<a name="L1458"></a><tt class="py-lineno">1458</tt> <a class="py-toggle" href="#" id="HttpRequestMock-toggle" onclick="return toggle('HttpRequestMock');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequestMock-class.html">HttpRequestMock</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpRequestMock-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="HttpRequestMock-expanded"><a name="L1459"></a><tt class="py-lineno">1459</tt>  <tt class="py-line">  <tt class="py-docstring">"""Mock of HttpRequest.</tt> </tt>
+<a name="L1460"></a><tt class="py-lineno">1460</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1461"></a><tt class="py-lineno">1461</tt>  <tt class="py-line"><tt class="py-docstring">  Do not construct directly, instead use RequestMockBuilder.</tt> </tt>
+<a name="L1462"></a><tt class="py-lineno">1462</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L1463"></a><tt class="py-lineno">1463</tt>  <tt class="py-line"> </tt>
+<a name="HttpRequestMock.__init__"></a><div id="HttpRequestMock.__init__-def"><a name="L1464"></a><tt class="py-lineno">1464</tt> <a class="py-toggle" href="#" id="HttpRequestMock.__init__-toggle" onclick="return toggle('HttpRequestMock.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequestMock-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">resp</tt><tt class="py-op">,</tt> <tt class="py-param">content</tt><tt class="py-op">,</tt> <tt class="py-param">postproc</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpRequestMock.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpRequestMock.__init__-expanded"><a name="L1465"></a><tt class="py-lineno">1465</tt>  <tt class="py-line">    <tt class="py-docstring">"""Constructor for HttpRequestMock</tt> </tt>
+<a name="L1466"></a><tt class="py-lineno">1466</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1467"></a><tt class="py-lineno">1467</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1468"></a><tt class="py-lineno">1468</tt>  <tt class="py-line"><tt class="py-docstring">      resp: httplib2.Response, the response to emulate coming from the request</tt> </tt>
+<a name="L1469"></a><tt class="py-lineno">1469</tt>  <tt class="py-line"><tt class="py-docstring">      content: string, the response body</tt> </tt>
+<a name="L1470"></a><tt class="py-lineno">1470</tt>  <tt class="py-line"><tt class="py-docstring">      postproc: callable, the post processing function usually supplied by</tt> </tt>
+<a name="L1471"></a><tt class="py-lineno">1471</tt>  <tt class="py-line"><tt class="py-docstring">                the model class. See model.JsonModel.response() as an example.</tt> </tt>
+<a name="L1472"></a><tt class="py-lineno">1472</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1473"></a><tt class="py-lineno">1473</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt> <tt class="py-op">=</tt> <tt class="py-name">resp</tt> </tt>
+<a name="L1474"></a><tt class="py-lineno">1474</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt> </tt>
+<a name="L1475"></a><tt class="py-lineno">1475</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">postproc</tt> <tt class="py-op">=</tt> <tt class="py-name">postproc</tt> </tt>
+<a name="L1476"></a><tt class="py-lineno">1476</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">resp</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1477"></a><tt class="py-lineno">1477</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt> <tt class="py-op">=</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Response</tt><tt class="py-op">(</tt><tt class="py-op">{</tt><tt class="py-string">'status'</tt><tt class="py-op">:</tt> <tt class="py-number">200</tt><tt class="py-op">,</tt> <tt class="py-string">'reason'</tt><tt class="py-op">:</tt> <tt class="py-string">'OK'</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
+<a name="L1478"></a><tt class="py-lineno">1478</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'reason'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">:</tt> </tt>
+<a name="L1479"></a><tt class="py-lineno">1479</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">.</tt><tt class="py-name">reason</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">[</tt><tt class="py-string">'reason'</tt><tt class="py-op">]</tt> </tt>
+</div><a name="L1480"></a><tt class="py-lineno">1480</tt>  <tt class="py-line"> </tt>
+<a name="HttpRequestMock.execute"></a><div id="HttpRequestMock.execute-def"><a name="L1481"></a><tt class="py-lineno">1481</tt> <a class="py-toggle" href="#" id="HttpRequestMock.execute-toggle" onclick="return toggle('HttpRequestMock.execute');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpRequestMock-class.html#execute">execute</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpRequestMock.execute-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpRequestMock.execute-expanded"><a name="L1482"></a><tt class="py-lineno">1482</tt>  <tt class="py-line">    <tt class="py-docstring">"""Execute the request.</tt> </tt>
+<a name="L1483"></a><tt class="py-lineno">1483</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1484"></a><tt class="py-lineno">1484</tt>  <tt class="py-line"><tt class="py-docstring">    Same behavior as HttpRequest.execute(), but the response is</tt> </tt>
+<a name="L1485"></a><tt class="py-lineno">1485</tt>  <tt class="py-line"><tt class="py-docstring">    mocked and not really from an HTTP request/response.</tt> </tt>
+<a name="L1486"></a><tt class="py-lineno">1486</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1487"></a><tt class="py-lineno">1487</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">postproc</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">content</tt><tt class="py-op">)</tt> </tt>
+</div></div><a name="L1488"></a><tt class="py-lineno">1488</tt>  <tt class="py-line"> </tt>
+<a name="RequestMockBuilder"></a><div id="RequestMockBuilder-def"><a name="L1489"></a><tt class="py-lineno">1489</tt>  <tt class="py-line"> </tt>
+<a name="L1490"></a><tt class="py-lineno">1490</tt> <a class="py-toggle" href="#" id="RequestMockBuilder-toggle" onclick="return toggle('RequestMockBuilder');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.RequestMockBuilder-class.html">RequestMockBuilder</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="RequestMockBuilder-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="RequestMockBuilder-expanded"><a name="L1491"></a><tt class="py-lineno">1491</tt>  <tt class="py-line">  <tt class="py-docstring">"""A simple mock of HttpRequest</tt> </tt>
+<a name="L1492"></a><tt class="py-lineno">1492</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1493"></a><tt class="py-lineno">1493</tt>  <tt class="py-line"><tt class="py-docstring">    Pass in a dictionary to the constructor that maps request methodIds to</tt> </tt>
+<a name="L1494"></a><tt class="py-lineno">1494</tt>  <tt class="py-line"><tt class="py-docstring">    tuples of (httplib2.Response, content, opt_expected_body) that should be</tt> </tt>
+<a name="L1495"></a><tt class="py-lineno">1495</tt>  <tt class="py-line"><tt class="py-docstring">    returned when that method is called. None may also be passed in for the</tt> </tt>
+<a name="L1496"></a><tt class="py-lineno">1496</tt>  <tt class="py-line"><tt class="py-docstring">    httplib2.Response, in which case a 200 OK response will be generated.</tt> </tt>
+<a name="L1497"></a><tt class="py-lineno">1497</tt>  <tt class="py-line"><tt class="py-docstring">    If an opt_expected_body (str or dict) is provided, it will be compared to</tt> </tt>
+<a name="L1498"></a><tt class="py-lineno">1498</tt>  <tt class="py-line"><tt class="py-docstring">    the body and UnexpectedBodyError will be raised on inequality.</tt> </tt>
+<a name="L1499"></a><tt class="py-lineno">1499</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1500"></a><tt class="py-lineno">1500</tt>  <tt class="py-line"><tt class="py-docstring">    Example:</tt> </tt>
+<a name="L1501"></a><tt class="py-lineno">1501</tt>  <tt class="py-line"><tt class="py-docstring">      response = '{"data": {"id": "tag:google.c...'</tt> </tt>
+<a name="L1502"></a><tt class="py-lineno">1502</tt>  <tt class="py-line"><tt class="py-docstring">      requestBuilder = RequestMockBuilder(</tt> </tt>
+<a name="L1503"></a><tt class="py-lineno">1503</tt>  <tt class="py-line"><tt class="py-docstring">        {</tt> </tt>
+<a name="L1504"></a><tt class="py-lineno">1504</tt>  <tt class="py-line"><tt class="py-docstring">          'plus.activities.get': (None, response),</tt> </tt>
+<a name="L1505"></a><tt class="py-lineno">1505</tt>  <tt class="py-line"><tt class="py-docstring">        }</tt> </tt>
+<a name="L1506"></a><tt class="py-lineno">1506</tt>  <tt class="py-line"><tt class="py-docstring">      )</tt> </tt>
+<a name="L1507"></a><tt class="py-lineno">1507</tt>  <tt class="py-line"><tt class="py-docstring">      googleapiclient.discovery.build("plus", "v1", requestBuilder=requestBuilder)</tt> </tt>
+<a name="L1508"></a><tt class="py-lineno">1508</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1509"></a><tt class="py-lineno">1509</tt>  <tt class="py-line"><tt class="py-docstring">    Methods that you do not supply a response for will return a</tt> </tt>
+<a name="L1510"></a><tt class="py-lineno">1510</tt>  <tt class="py-line"><tt class="py-docstring">    200 OK with an empty string as the response content or raise an excpetion</tt> </tt>
+<a name="L1511"></a><tt class="py-lineno">1511</tt>  <tt class="py-line"><tt class="py-docstring">    if check_unexpected is set to True. The methodId is taken from the rpcName</tt> </tt>
+<a name="L1512"></a><tt class="py-lineno">1512</tt>  <tt class="py-line"><tt class="py-docstring">    in the discovery document.</tt> </tt>
+<a name="L1513"></a><tt class="py-lineno">1513</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1514"></a><tt class="py-lineno">1514</tt>  <tt class="py-line"><tt class="py-docstring">    For more details see the project wiki.</tt> </tt>
+<a name="L1515"></a><tt class="py-lineno">1515</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L1516"></a><tt class="py-lineno">1516</tt>  <tt class="py-line"> </tt>
+<a name="RequestMockBuilder.__init__"></a><div id="RequestMockBuilder.__init__-def"><a name="L1517"></a><tt class="py-lineno">1517</tt> <a class="py-toggle" href="#" id="RequestMockBuilder.__init__-toggle" onclick="return toggle('RequestMockBuilder.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.RequestMockBuilder-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">responses</tt><tt class="py-op">,</tt> <tt class="py-param">check_unexpected</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="RequestMockBuilder.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="RequestMockBuilder.__init__-expanded"><a name="L1518"></a><tt class="py-lineno">1518</tt>  <tt class="py-line">    <tt class="py-docstring">"""Constructor for RequestMockBuilder</tt> </tt>
+<a name="L1519"></a><tt class="py-lineno">1519</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1520"></a><tt class="py-lineno">1520</tt>  <tt class="py-line"><tt class="py-docstring">    The constructed object should be a callable object</tt> </tt>
+<a name="L1521"></a><tt class="py-lineno">1521</tt>  <tt class="py-line"><tt class="py-docstring">    that can replace the class HttpResponse.</tt> </tt>
+<a name="L1522"></a><tt class="py-lineno">1522</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1523"></a><tt class="py-lineno">1523</tt>  <tt class="py-line"><tt class="py-docstring">    responses - A dictionary that maps methodIds into tuples</tt> </tt>
+<a name="L1524"></a><tt class="py-lineno">1524</tt>  <tt class="py-line"><tt class="py-docstring">                of (httplib2.Response, content). The methodId</tt> </tt>
+<a name="L1525"></a><tt class="py-lineno">1525</tt>  <tt class="py-line"><tt class="py-docstring">                comes from the 'rpcName' field in the discovery</tt> </tt>
+<a name="L1526"></a><tt class="py-lineno">1526</tt>  <tt class="py-line"><tt class="py-docstring">                document.</tt> </tt>
+<a name="L1527"></a><tt class="py-lineno">1527</tt>  <tt class="py-line"><tt class="py-docstring">    check_unexpected - A boolean setting whether or not UnexpectedMethodError</tt> </tt>
+<a name="L1528"></a><tt class="py-lineno">1528</tt>  <tt class="py-line"><tt class="py-docstring">                       should be raised on unsupplied method.</tt> </tt>
+<a name="L1529"></a><tt class="py-lineno">1529</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1530"></a><tt class="py-lineno">1530</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">responses</tt> <tt class="py-op">=</tt> <tt class="py-name">responses</tt> </tt>
+<a name="L1531"></a><tt class="py-lineno">1531</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">check_unexpected</tt> <tt class="py-op">=</tt> <tt class="py-name">check_unexpected</tt> </tt>
+</div><a name="L1532"></a><tt class="py-lineno">1532</tt>  <tt class="py-line"> </tt>
+<a name="RequestMockBuilder.__call__"></a><div id="RequestMockBuilder.__call__-def"><a name="L1533"></a><tt class="py-lineno">1533</tt> <a class="py-toggle" href="#" id="RequestMockBuilder.__call__-toggle" onclick="return toggle('RequestMockBuilder.__call__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.RequestMockBuilder-class.html#__call__">__call__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">postproc</tt><tt class="py-op">,</tt> <tt class="py-param">uri</tt><tt class="py-op">,</tt> <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L1534"></a><tt class="py-lineno">1534</tt>  <tt class="py-line">               <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">methodId</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">resumable</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="RequestMockBuilder.__call__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="RequestMockBuilder.__call__-expanded"><a name="L1535"></a><tt class="py-lineno">1535</tt>  <tt class="py-line">    <tt class="py-docstring">"""Implements the callable interface that discovery.build() expects</tt> </tt>
+<a name="L1536"></a><tt class="py-lineno">1536</tt>  <tt class="py-line"><tt class="py-docstring">    of requestBuilder, which is to build an object compatible with</tt> </tt>
+<a name="L1537"></a><tt class="py-lineno">1537</tt>  <tt class="py-line"><tt class="py-docstring">    HttpRequest.execute(). See that method for the description of the</tt> </tt>
+<a name="L1538"></a><tt class="py-lineno">1538</tt>  <tt class="py-line"><tt class="py-docstring">    parameters and the expected response.</tt> </tt>
+<a name="L1539"></a><tt class="py-lineno">1539</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1540"></a><tt class="py-lineno">1540</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">methodId</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">responses</tt><tt class="py-op">:</tt> </tt>
+<a name="L1541"></a><tt class="py-lineno">1541</tt>  <tt class="py-line">      <tt id="link-282" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-282', 'response', 'link-248');">response</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">responses</tt><tt class="py-op">[</tt><tt class="py-name">methodId</tt><tt class="py-op">]</tt> </tt>
-<a name="L1538"></a><tt class="py-lineno">1538</tt>  <tt class="py-line">      <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-283" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1542"></a><tt class="py-lineno">1542</tt>  <tt class="py-line">      <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-283" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-283', 'response', 'link-248');">response</a></tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt> </tt>
-<a name="L1539"></a><tt class="py-lineno">1539</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt id="link-284" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1543"></a><tt class="py-lineno">1543</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt id="link-284" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-284', 'response', 'link-248');">response</a></tt><tt class="py-op">)</tt> <tt class="py-op">&gt;</tt> <tt class="py-number">2</tt><tt class="py-op">:</tt> </tt>
-<a name="L1540"></a><tt class="py-lineno">1540</tt>  <tt class="py-line">        <tt class="py-comment"># Test the body against the supplied expected_body.</tt> </tt>
-<a name="L1541"></a><tt class="py-lineno">1541</tt>  <tt class="py-line">        <tt class="py-name">expected_body</tt> <tt class="py-op">=</tt> <tt id="link-285" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1544"></a><tt class="py-lineno">1544</tt>  <tt class="py-line">        <tt class="py-comment"># Test the body against the supplied expected_body.</tt> </tt>
+<a name="L1545"></a><tt class="py-lineno">1545</tt>  <tt class="py-line">        <tt class="py-name">expected_body</tt> <tt class="py-op">=</tt> <tt id="link-285" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-285', 'response', 'link-248');">response</a></tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">]</tt> </tt>
-<a name="L1542"></a><tt class="py-lineno">1542</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">bool</tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">bool</tt><tt class="py-op">(</tt><tt id="link-286" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-286', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1543"></a><tt class="py-lineno">1543</tt>  <tt class="py-line">          <tt class="py-comment"># Not expecting a body and provided one</tt> </tt>
-<a name="L1544"></a><tt class="py-lineno">1544</tt>  <tt class="py-line">          <tt class="py-comment"># or expecting a body and not provided one.</tt> </tt>
-<a name="L1545"></a><tt class="py-lineno">1545</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-287" class="py-name"><a title="googleapiclient.errors.UnexpectedBodyError" class="py-name" href="#" onclick="return doclink('link-287', 'UnexpectedBodyError', 'link-18');">UnexpectedBodyError</a></tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">,</tt> <tt id="link-288" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-288', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1546"></a><tt class="py-lineno">1546</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1547"></a><tt class="py-lineno">1547</tt>  <tt class="py-line">          <tt class="py-name">expected_body</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">)</tt> </tt>
-<a name="L1548"></a><tt class="py-lineno">1548</tt>  <tt class="py-line">        <tt id="link-289" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-289', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt id="link-290" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-290', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1549"></a><tt class="py-lineno">1549</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt id="link-291" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-291', 'body', 'link-69');">body</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">expected_body</tt><tt class="py-op">:</tt> </tt>
-<a name="L1550"></a><tt class="py-lineno">1550</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-292" class="py-name"><a title="googleapiclient.errors.UnexpectedBodyError" class="py-name" href="#" onclick="return doclink('link-292', 'UnexpectedBodyError', 'link-18');">UnexpectedBodyError</a></tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">,</tt> <tt id="link-293" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-293', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
-<a name="L1551"></a><tt class="py-lineno">1551</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt id="link-294" class="py-name" targets="Class googleapiclient.http.HttpRequestMock=googleapiclient.http.HttpRequestMock-class.html"><a title="googleapiclient.http.HttpRequestMock" class="py-name" href="#" onclick="return doclink('link-294', 'HttpRequestMock', 'link-294');">HttpRequestMock</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">postproc</tt><tt class="py-op">)</tt> </tt>
-<a name="L1552"></a><tt class="py-lineno">1552</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">check_unexpected</tt><tt class="py-op">:</tt> </tt>
-<a name="L1553"></a><tt class="py-lineno">1553</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-295" class="py-name"><a title="googleapiclient.errors.UnexpectedMethodError" class="py-name" href="#" onclick="return doclink('link-295', 'UnexpectedMethodError', 'link-21');">UnexpectedMethodError</a></tt><tt class="py-op">(</tt><tt class="py-name">methodId</tt><tt class="py-op">=</tt><tt class="py-name">methodId</tt><tt class="py-op">)</tt> </tt>
-<a name="L1554"></a><tt class="py-lineno">1554</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L1555"></a><tt class="py-lineno">1555</tt>  <tt class="py-line">      <tt id="link-296" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-296', 'model', 'link-23');">model</a></tt> <tt class="py-op">=</tt> <tt id="link-297" class="py-name"><a title="googleapiclient.model.JsonModel" class="py-name" href="#" onclick="return doclink('link-297', 'JsonModel', 'link-24');">JsonModel</a></tt><tt class="py-op">(</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
-<a name="L1556"></a><tt class="py-lineno">1556</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt id="link-298" class="py-name"><a title="googleapiclient.http.HttpRequestMock" class="py-name" href="#" onclick="return doclink('link-298', 'HttpRequestMock', 'link-294');">HttpRequestMock</a></tt><tt class="py-op">(</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-string">'{}'</tt><tt class="py-op">,</tt> <tt id="link-299" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-299', 'model', 'link-23');">model</a></tt><tt class="py-op">.</tt><tt id="link-300" class="py-name"><a title="googleapiclient.model.BaseModel.response
+<a name="L1546"></a><tt class="py-lineno">1546</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">bool</tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">bool</tt><tt class="py-op">(</tt><tt id="link-286" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-286', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1547"></a><tt class="py-lineno">1547</tt>  <tt class="py-line">          <tt class="py-comment"># Not expecting a body and provided one</tt> </tt>
+<a name="L1548"></a><tt class="py-lineno">1548</tt>  <tt class="py-line">          <tt class="py-comment"># or expecting a body and not provided one.</tt> </tt>
+<a name="L1549"></a><tt class="py-lineno">1549</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-287" class="py-name"><a title="googleapiclient.errors.UnexpectedBodyError" class="py-name" href="#" onclick="return doclink('link-287', 'UnexpectedBodyError', 'link-18');">UnexpectedBodyError</a></tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">,</tt> <tt id="link-288" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-288', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L1550"></a><tt class="py-lineno">1550</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1551"></a><tt class="py-lineno">1551</tt>  <tt class="py-line">          <tt class="py-name">expected_body</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">)</tt> </tt>
+<a name="L1552"></a><tt class="py-lineno">1552</tt>  <tt class="py-line">        <tt id="link-289" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-289', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">loads</tt><tt class="py-op">(</tt><tt id="link-290" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-290', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L1553"></a><tt class="py-lineno">1553</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt id="link-291" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-291', 'body', 'link-69');">body</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">expected_body</tt><tt class="py-op">:</tt> </tt>
+<a name="L1554"></a><tt class="py-lineno">1554</tt>  <tt class="py-line">          <tt class="py-keyword">raise</tt> <tt id="link-292" class="py-name"><a title="googleapiclient.errors.UnexpectedBodyError" class="py-name" href="#" onclick="return doclink('link-292', 'UnexpectedBodyError', 'link-18');">UnexpectedBodyError</a></tt><tt class="py-op">(</tt><tt class="py-name">expected_body</tt><tt class="py-op">,</tt> <tt id="link-293" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-293', 'body', 'link-69');">body</a></tt><tt class="py-op">)</tt> </tt>
+<a name="L1555"></a><tt class="py-lineno">1555</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt id="link-294" class="py-name" targets="Class googleapiclient.http.HttpRequestMock=googleapiclient.http.HttpRequestMock-class.html"><a title="googleapiclient.http.HttpRequestMock" class="py-name" href="#" onclick="return doclink('link-294', 'HttpRequestMock', 'link-294');">HttpRequestMock</a></tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">postproc</tt><tt class="py-op">)</tt> </tt>
+<a name="L1556"></a><tt class="py-lineno">1556</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">check_unexpected</tt><tt class="py-op">:</tt> </tt>
+<a name="L1557"></a><tt class="py-lineno">1557</tt>  <tt class="py-line">      <tt class="py-keyword">raise</tt> <tt id="link-295" class="py-name"><a title="googleapiclient.errors.UnexpectedMethodError" class="py-name" href="#" onclick="return doclink('link-295', 'UnexpectedMethodError', 'link-21');">UnexpectedMethodError</a></tt><tt class="py-op">(</tt><tt class="py-name">methodId</tt><tt class="py-op">=</tt><tt class="py-name">methodId</tt><tt class="py-op">)</tt> </tt>
+<a name="L1558"></a><tt class="py-lineno">1558</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L1559"></a><tt class="py-lineno">1559</tt>  <tt class="py-line">      <tt id="link-296" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-296', 'model', 'link-23');">model</a></tt> <tt class="py-op">=</tt> <tt id="link-297" class="py-name"><a title="googleapiclient.model.JsonModel" class="py-name" href="#" onclick="return doclink('link-297', 'JsonModel', 'link-24');">JsonModel</a></tt><tt class="py-op">(</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
+<a name="L1560"></a><tt class="py-lineno">1560</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt id="link-298" class="py-name"><a title="googleapiclient.http.HttpRequestMock" class="py-name" href="#" onclick="return doclink('link-298', 'HttpRequestMock', 'link-294');">HttpRequestMock</a></tt><tt class="py-op">(</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-string">'{}'</tt><tt class="py-op">,</tt> <tt id="link-299" class="py-name"><a title="googleapiclient.model" class="py-name" href="#" onclick="return doclink('link-299', 'model', 'link-23');">model</a></tt><tt class="py-op">.</tt><tt id="link-300" class="py-name"><a title="googleapiclient.model.BaseModel.response
 googleapiclient.model.Model.response" class="py-name" href="#" onclick="return doclink('link-300', 'response', 'link-248');">response</a></tt><tt class="py-op">)</tt> </tt>
-</div></div><a name="L1557"></a><tt class="py-lineno">1557</tt>  <tt class="py-line"> </tt>
-<a name="HttpMock"></a><div id="HttpMock-def"><a name="L1558"></a><tt class="py-lineno">1558</tt>  <tt class="py-line"> </tt>
-<a name="L1559"></a><tt class="py-lineno">1559</tt> <a class="py-toggle" href="#" id="HttpMock-toggle" onclick="return toggle('HttpMock');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.HttpMock-class.html">HttpMock</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpMock-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="HttpMock-expanded"><a name="L1560"></a><tt class="py-lineno">1560</tt>  <tt class="py-line">  <tt class="py-docstring">"""Mock of httplib2.Http"""</tt> </tt>
-<a name="L1561"></a><tt class="py-lineno">1561</tt>  <tt class="py-line"> </tt>
-<a name="HttpMock.__init__"></a><div id="HttpMock.__init__-def"><a name="L1562"></a><tt class="py-lineno">1562</tt> <a class="py-toggle" href="#" id="HttpMock.__init__-toggle" onclick="return toggle('HttpMock.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpMock-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">filename</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpMock.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpMock.__init__-expanded"><a name="L1563"></a><tt class="py-lineno">1563</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
-<a name="L1564"></a><tt class="py-lineno">1564</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1565"></a><tt class="py-lineno">1565</tt>  <tt class="py-line"><tt class="py-docstring">      filename: string, absolute filename to read response from</tt> </tt>
-<a name="L1566"></a><tt class="py-lineno">1566</tt>  <tt class="py-line"><tt class="py-docstring">      headers: dict, header to return with response</tt> </tt>
-<a name="L1567"></a><tt class="py-lineno">1567</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1568"></a><tt class="py-lineno">1568</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">headers</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1569"></a><tt class="py-lineno">1569</tt>  <tt class="py-line">      <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-string">'status'</tt><tt class="py-op">:</tt> <tt class="py-string">'200'</tt><tt class="py-op">}</tt> </tt>
-<a name="L1570"></a><tt class="py-lineno">1570</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">filename</tt><tt class="py-op">:</tt> </tt>
-<a name="L1571"></a><tt class="py-lineno">1571</tt>  <tt class="py-line">      <tt class="py-name">f</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt class="py-string">'rb'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1572"></a><tt class="py-lineno">1572</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">f</tt><tt class="py-op">.</tt><tt id="link-301" class="py-name"><a title="googleapiclient.http._StreamSlice.read" class="py-name" href="#" onclick="return doclink('link-301', 'read', 'link-50');">read</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1573"></a><tt class="py-lineno">1573</tt>  <tt class="py-line">      <tt class="py-name">f</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1574"></a><tt class="py-lineno">1574</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L1575"></a><tt class="py-lineno">1575</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1576"></a><tt class="py-lineno">1576</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">response_headers</tt> <tt class="py-op">=</tt> <tt class="py-name">headers</tt> </tt>
-<a name="L1577"></a><tt class="py-lineno">1577</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1578"></a><tt class="py-lineno">1578</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uri</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1579"></a><tt class="py-lineno">1579</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-<a name="L1580"></a><tt class="py-lineno">1580</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-302" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-302', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+</div></div><a name="L1561"></a><tt class="py-lineno">1561</tt>  <tt class="py-line"> </tt>
+<a name="HttpMock"></a><div id="HttpMock-def"><a name="L1562"></a><tt class="py-lineno">1562</tt>  <tt class="py-line"> </tt>
+<a name="L1563"></a><tt class="py-lineno">1563</tt> <a class="py-toggle" href="#" id="HttpMock-toggle" onclick="return toggle('HttpMock');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.HttpMock-class.html">HttpMock</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpMock-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="HttpMock-expanded"><a name="L1564"></a><tt class="py-lineno">1564</tt>  <tt class="py-line">  <tt class="py-docstring">"""Mock of httplib2.Http"""</tt> </tt>
+<a name="L1565"></a><tt class="py-lineno">1565</tt>  <tt class="py-line"> </tt>
+<a name="HttpMock.__init__"></a><div id="HttpMock.__init__-def"><a name="L1566"></a><tt class="py-lineno">1566</tt> <a class="py-toggle" href="#" id="HttpMock.__init__-toggle" onclick="return toggle('HttpMock.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpMock-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">filename</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpMock.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpMock.__init__-expanded"><a name="L1567"></a><tt class="py-lineno">1567</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
+<a name="L1568"></a><tt class="py-lineno">1568</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1569"></a><tt class="py-lineno">1569</tt>  <tt class="py-line"><tt class="py-docstring">      filename: string, absolute filename to read response from</tt> </tt>
+<a name="L1570"></a><tt class="py-lineno">1570</tt>  <tt class="py-line"><tt class="py-docstring">      headers: dict, header to return with response</tt> </tt>
+<a name="L1571"></a><tt class="py-lineno">1571</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1572"></a><tt class="py-lineno">1572</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">headers</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1573"></a><tt class="py-lineno">1573</tt>  <tt class="py-line">      <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-string">'status'</tt><tt class="py-op">:</tt> <tt class="py-string">'200'</tt><tt class="py-op">}</tt> </tt>
+<a name="L1574"></a><tt class="py-lineno">1574</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">filename</tt><tt class="py-op">:</tt> </tt>
+<a name="L1575"></a><tt class="py-lineno">1575</tt>  <tt class="py-line">      <tt class="py-name">f</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt class="py-string">'rb'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1576"></a><tt class="py-lineno">1576</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">f</tt><tt class="py-op">.</tt><tt id="link-301" class="py-name"><a title="googleapiclient.http._StreamSlice.read" class="py-name" href="#" onclick="return doclink('link-301', 'read', 'link-50');">read</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1577"></a><tt class="py-lineno">1577</tt>  <tt class="py-line">      <tt class="py-name">f</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1578"></a><tt class="py-lineno">1578</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L1579"></a><tt class="py-lineno">1579</tt>  <tt class="py-line">      <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L1580"></a><tt class="py-lineno">1580</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">response_headers</tt> <tt class="py-op">=</tt> <tt class="py-name">headers</tt> </tt>
 <a name="L1581"></a><tt class="py-lineno">1581</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
-</div><a name="L1582"></a><tt class="py-lineno">1582</tt>  <tt class="py-line"> </tt>
-<a name="L1583"></a><tt class="py-lineno">1583</tt>  <tt class="py-line"> </tt>
-<a name="HttpMock.request"></a><div id="HttpMock.request-def"><a name="L1584"></a><tt class="py-lineno">1584</tt> <a class="py-toggle" href="#" id="HttpMock.request-toggle" onclick="return toggle('HttpMock.request');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpMock-class.html#request">request</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">uri</tt><tt class="py-op">,</tt> </tt>
-<a name="L1585"></a><tt class="py-lineno">1585</tt>  <tt class="py-line">              <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> </tt>
-<a name="L1586"></a><tt class="py-lineno">1586</tt>  <tt class="py-line">              <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L1587"></a><tt class="py-lineno">1587</tt>  <tt class="py-line">              <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L1588"></a><tt class="py-lineno">1588</tt>  <tt class="py-line">              <tt class="py-param">redirections</tt><tt class="py-op">=</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> </tt>
-<a name="L1589"></a><tt class="py-lineno">1589</tt>  <tt class="py-line">              <tt class="py-param">connection_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpMock.request-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpMock.request-expanded"><a name="L1590"></a><tt class="py-lineno">1590</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uri</tt> <tt class="py-op">=</tt> <tt class="py-name">uri</tt> </tt>
-<a name="L1591"></a><tt class="py-lineno">1591</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt class="py-name">method</tt> </tt>
-<a name="L1592"></a><tt class="py-lineno">1592</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-303" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-303', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt id="link-304" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-304', 'body', 'link-69');">body</a></tt> </tt>
-<a name="L1593"></a><tt class="py-lineno">1593</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-name">headers</tt> </tt>
-<a name="L1594"></a><tt class="py-lineno">1594</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Response</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">response_headers</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">data</tt> </tt>
-</div></div><a name="L1595"></a><tt class="py-lineno">1595</tt>  <tt class="py-line"> </tt>
-<a name="HttpMockSequence"></a><div id="HttpMockSequence-def"><a name="L1596"></a><tt class="py-lineno">1596</tt>  <tt class="py-line"> </tt>
-<a name="L1597"></a><tt class="py-lineno">1597</tt> <a class="py-toggle" href="#" id="HttpMockSequence-toggle" onclick="return toggle('HttpMockSequence');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.HttpMockSequence-class.html">HttpMockSequence</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpMockSequence-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="HttpMockSequence-expanded"><a name="L1598"></a><tt class="py-lineno">1598</tt>  <tt class="py-line">  <tt class="py-docstring">"""Mock of httplib2.Http</tt> </tt>
-<a name="L1599"></a><tt class="py-lineno">1599</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1600"></a><tt class="py-lineno">1600</tt>  <tt class="py-line"><tt class="py-docstring">  Mocks a sequence of calls to request returning different responses for each</tt> </tt>
-<a name="L1601"></a><tt class="py-lineno">1601</tt>  <tt class="py-line"><tt class="py-docstring">  call. Create an instance initialized with the desired response headers</tt> </tt>
-<a name="L1602"></a><tt class="py-lineno">1602</tt>  <tt class="py-line"><tt class="py-docstring">  and content and then use as if an httplib2.Http instance.</tt> </tt>
+<a name="L1582"></a><tt class="py-lineno">1582</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uri</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L1583"></a><tt class="py-lineno">1583</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L1584"></a><tt class="py-lineno">1584</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-302" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-302', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L1585"></a><tt class="py-lineno">1585</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+</div><a name="L1586"></a><tt class="py-lineno">1586</tt>  <tt class="py-line"> </tt>
+<a name="L1587"></a><tt class="py-lineno">1587</tt>  <tt class="py-line"> </tt>
+<a name="HttpMock.request"></a><div id="HttpMock.request-def"><a name="L1588"></a><tt class="py-lineno">1588</tt> <a class="py-toggle" href="#" id="HttpMock.request-toggle" onclick="return toggle('HttpMock.request');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpMock-class.html#request">request</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">uri</tt><tt class="py-op">,</tt> </tt>
+<a name="L1589"></a><tt class="py-lineno">1589</tt>  <tt class="py-line">              <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> </tt>
+<a name="L1590"></a><tt class="py-lineno">1590</tt>  <tt class="py-line">              <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L1591"></a><tt class="py-lineno">1591</tt>  <tt class="py-line">              <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L1592"></a><tt class="py-lineno">1592</tt>  <tt class="py-line">              <tt class="py-param">redirections</tt><tt class="py-op">=</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> </tt>
+<a name="L1593"></a><tt class="py-lineno">1593</tt>  <tt class="py-line">              <tt class="py-param">connection_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpMock.request-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpMock.request-expanded"><a name="L1594"></a><tt class="py-lineno">1594</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uri</tt> <tt class="py-op">=</tt> <tt class="py-name">uri</tt> </tt>
+<a name="L1595"></a><tt class="py-lineno">1595</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt class="py-name">method</tt> </tt>
+<a name="L1596"></a><tt class="py-lineno">1596</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-303" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-303', 'body', 'link-69');">body</a></tt> <tt class="py-op">=</tt> <tt id="link-304" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-304', 'body', 'link-69');">body</a></tt> </tt>
+<a name="L1597"></a><tt class="py-lineno">1597</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-name">headers</tt> </tt>
+<a name="L1598"></a><tt class="py-lineno">1598</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Response</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">response_headers</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">data</tt> </tt>
+</div></div><a name="L1599"></a><tt class="py-lineno">1599</tt>  <tt class="py-line"> </tt>
+<a name="HttpMockSequence"></a><div id="HttpMockSequence-def"><a name="L1600"></a><tt class="py-lineno">1600</tt>  <tt class="py-line"> </tt>
+<a name="L1601"></a><tt class="py-lineno">1601</tt> <a class="py-toggle" href="#" id="HttpMockSequence-toggle" onclick="return toggle('HttpMockSequence');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="googleapiclient.http.HttpMockSequence-class.html">HttpMockSequence</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpMockSequence-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="HttpMockSequence-expanded"><a name="L1602"></a><tt class="py-lineno">1602</tt>  <tt class="py-line">  <tt class="py-docstring">"""Mock of httplib2.Http</tt> </tt>
 <a name="L1603"></a><tt class="py-lineno">1603</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1604"></a><tt class="py-lineno">1604</tt>  <tt class="py-line"><tt class="py-docstring">    http = HttpMockSequence([</tt> </tt>
-<a name="L1605"></a><tt class="py-lineno">1605</tt>  <tt class="py-line"><tt class="py-docstring">      ({'status': '401'}, ''),</tt> </tt>
-<a name="L1606"></a><tt class="py-lineno">1606</tt>  <tt class="py-line"><tt class="py-docstring">      ({'status': '200'}, '{"access_token":"1/3w","expires_in":3600}'),</tt> </tt>
-<a name="L1607"></a><tt class="py-lineno">1607</tt>  <tt class="py-line"><tt class="py-docstring">      ({'status': '200'}, 'echo_request_headers'),</tt> </tt>
-<a name="L1608"></a><tt class="py-lineno">1608</tt>  <tt class="py-line"><tt class="py-docstring">      ])</tt> </tt>
-<a name="L1609"></a><tt class="py-lineno">1609</tt>  <tt class="py-line"><tt class="py-docstring">    resp, content = http.request("http://examples.com")</tt> </tt>
-<a name="L1610"></a><tt class="py-lineno">1610</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1611"></a><tt class="py-lineno">1611</tt>  <tt class="py-line"><tt class="py-docstring">  There are special values you can pass in for content to trigger</tt> </tt>
-<a name="L1612"></a><tt class="py-lineno">1612</tt>  <tt class="py-line"><tt class="py-docstring">  behavours that are helpful in testing.</tt> </tt>
-<a name="L1613"></a><tt class="py-lineno">1613</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1614"></a><tt class="py-lineno">1614</tt>  <tt class="py-line"><tt class="py-docstring">  'echo_request_headers' means return the request headers in the response body</tt> </tt>
-<a name="L1615"></a><tt class="py-lineno">1615</tt>  <tt class="py-line"><tt class="py-docstring">  'echo_request_headers_as_json' means return the request headers in</tt> </tt>
-<a name="L1616"></a><tt class="py-lineno">1616</tt>  <tt class="py-line"><tt class="py-docstring">     the response body</tt> </tt>
-<a name="L1617"></a><tt class="py-lineno">1617</tt>  <tt class="py-line"><tt class="py-docstring">  'echo_request_body' means return the request body in the response body</tt> </tt>
-<a name="L1618"></a><tt class="py-lineno">1618</tt>  <tt class="py-line"><tt class="py-docstring">  'echo_request_uri' means return the request uri in the response body</tt> </tt>
-<a name="L1619"></a><tt class="py-lineno">1619</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L1620"></a><tt class="py-lineno">1620</tt>  <tt class="py-line"> </tt>
-<a name="HttpMockSequence.__init__"></a><div id="HttpMockSequence.__init__-def"><a name="L1621"></a><tt class="py-lineno">1621</tt> <a class="py-toggle" href="#" id="HttpMockSequence.__init__-toggle" onclick="return toggle('HttpMockSequence.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpMockSequence-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">iterable</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpMockSequence.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpMockSequence.__init__-expanded"><a name="L1622"></a><tt class="py-lineno">1622</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
-<a name="L1623"></a><tt class="py-lineno">1623</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
-<a name="L1624"></a><tt class="py-lineno">1624</tt>  <tt class="py-line"><tt class="py-docstring">      iterable: iterable, a sequence of pairs of (headers, body)</tt> </tt>
-<a name="L1625"></a><tt class="py-lineno">1625</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
-<a name="L1626"></a><tt class="py-lineno">1626</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_iterable</tt> <tt class="py-op">=</tt> <tt class="py-name">iterable</tt> </tt>
-<a name="L1627"></a><tt class="py-lineno">1627</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">follow_redirects</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
-</div><a name="L1628"></a><tt class="py-lineno">1628</tt>  <tt class="py-line"> </tt>
-<a name="HttpMockSequence.request"></a><div id="HttpMockSequence.request-def"><a name="L1629"></a><tt class="py-lineno">1629</tt> <a class="py-toggle" href="#" id="HttpMockSequence.request-toggle" onclick="return toggle('HttpMockSequence.request');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpMockSequence-class.html#request">request</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">uri</tt><tt class="py-op">,</tt> </tt>
-<a name="L1630"></a><tt class="py-lineno">1630</tt>  <tt class="py-line">              <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> </tt>
-<a name="L1631"></a><tt class="py-lineno">1631</tt>  <tt class="py-line">              <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L1632"></a><tt class="py-lineno">1632</tt>  <tt class="py-line">              <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L1633"></a><tt class="py-lineno">1633</tt>  <tt class="py-line">              <tt class="py-param">redirections</tt><tt class="py-op">=</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> </tt>
-<a name="L1634"></a><tt class="py-lineno">1634</tt>  <tt class="py-line">              <tt class="py-param">connection_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="HttpMockSequence.request-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpMockSequence.request-expanded"><a name="L1635"></a><tt class="py-lineno">1635</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_iterable</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">)</tt> </tt>
-<a name="L1636"></a><tt class="py-lineno">1636</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">content</tt> <tt class="py-op">==</tt> <tt class="py-string">'echo_request_headers'</tt><tt class="py-op">:</tt> </tt>
-<a name="L1637"></a><tt class="py-lineno">1637</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">headers</tt> </tt>
-<a name="L1638"></a><tt class="py-lineno">1638</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">content</tt> <tt class="py-op">==</tt> <tt class="py-string">'echo_request_headers_as_json'</tt><tt class="py-op">:</tt> </tt>
-<a name="L1639"></a><tt class="py-lineno">1639</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">dumps</tt><tt class="py-op">(</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt> </tt>
-<a name="L1640"></a><tt class="py-lineno">1640</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">content</tt> <tt class="py-op">==</tt> <tt class="py-string">'echo_request_body'</tt><tt class="py-op">:</tt> </tt>
-<a name="L1641"></a><tt class="py-lineno">1641</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt id="link-305" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-305', 'body', 'link-69');">body</a></tt><tt class="py-op">,</tt> <tt class="py-string">'read'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1642"></a><tt class="py-lineno">1642</tt>  <tt class="py-line">        <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-306" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-306', 'body', 'link-69');">body</a></tt><tt class="py-op">.</tt><tt id="link-307" class="py-name"><a title="googleapiclient.http._StreamSlice.read" class="py-name" href="#" onclick="return doclink('link-307', 'read', 'link-50');">read</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
-<a name="L1643"></a><tt class="py-lineno">1643</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L1644"></a><tt class="py-lineno">1644</tt>  <tt class="py-line">        <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-308" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-308', 'body', 'link-69');">body</a></tt> </tt>
-<a name="L1645"></a><tt class="py-lineno">1645</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">content</tt> <tt class="py-op">==</tt> <tt class="py-string">'echo_request_uri'</tt><tt class="py-op">:</tt> </tt>
-<a name="L1646"></a><tt class="py-lineno">1646</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">uri</tt> </tt>
-<a name="L1647"></a><tt class="py-lineno">1647</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">text_type</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1648"></a><tt class="py-lineno">1648</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt><tt class="py-op">.</tt><tt class="py-name">encode</tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1649"></a><tt class="py-lineno">1649</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Response</tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> </tt>
-</div></div><a name="L1650"></a><tt class="py-lineno">1650</tt>  <tt class="py-line"> </tt>
-<a name="set_user_agent"></a><div id="set_user_agent-def"><a name="L1651"></a><tt class="py-lineno">1651</tt>  <tt class="py-line"> </tt>
-<a name="L1652"></a><tt class="py-lineno">1652</tt> <a class="py-toggle" href="#" id="set_user_agent-toggle" onclick="return toggle('set_user_agent');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http-module.html#set_user_agent">set_user_agent</a><tt class="py-op">(</tt><tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">user_agent</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="set_user_agent-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="set_user_agent-expanded"><a name="L1653"></a><tt class="py-lineno">1653</tt>  <tt class="py-line">  <tt class="py-docstring">"""Set the user-agent on every request.</tt> </tt>
-<a name="L1654"></a><tt class="py-lineno">1654</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1655"></a><tt class="py-lineno">1655</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L1656"></a><tt class="py-lineno">1656</tt>  <tt class="py-line"><tt class="py-docstring">     http - An instance of httplib2.Http</tt> </tt>
-<a name="L1657"></a><tt class="py-lineno">1657</tt>  <tt class="py-line"><tt class="py-docstring">         or something that acts like it.</tt> </tt>
-<a name="L1658"></a><tt class="py-lineno">1658</tt>  <tt class="py-line"><tt class="py-docstring">     user_agent: string, the value for the user-agent header.</tt> </tt>
-<a name="L1659"></a><tt class="py-lineno">1659</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1660"></a><tt class="py-lineno">1660</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L1661"></a><tt class="py-lineno">1661</tt>  <tt class="py-line"><tt class="py-docstring">     A modified instance of http that was passed in.</tt> </tt>
-<a name="L1662"></a><tt class="py-lineno">1662</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1663"></a><tt class="py-lineno">1663</tt>  <tt class="py-line"><tt class="py-docstring">  Example:</tt> </tt>
-<a name="L1664"></a><tt class="py-lineno">1664</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1665"></a><tt class="py-lineno">1665</tt>  <tt class="py-line"><tt class="py-docstring">    h = httplib2.Http()</tt> </tt>
-<a name="L1666"></a><tt class="py-lineno">1666</tt>  <tt class="py-line"><tt class="py-docstring">    h = set_user_agent(h, "my-app-name/6.0")</tt> </tt>
-<a name="L1667"></a><tt class="py-lineno">1667</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1668"></a><tt class="py-lineno">1668</tt>  <tt class="py-line"><tt class="py-docstring">  Most of the time the user-agent will be set doing auth, this is for the rare</tt> </tt>
-<a name="L1669"></a><tt class="py-lineno">1669</tt>  <tt class="py-line"><tt class="py-docstring">  cases where you are accessing an unauthenticated endpoint.</tt> </tt>
-<a name="L1670"></a><tt class="py-lineno">1670</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L1671"></a><tt class="py-lineno">1671</tt>  <tt class="py-line">  <tt class="py-name">request_orig</tt> <tt class="py-op">=</tt> <tt id="link-309" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-309', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-310" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1604"></a><tt class="py-lineno">1604</tt>  <tt class="py-line"><tt class="py-docstring">  Mocks a sequence of calls to request returning different responses for each</tt> </tt>
+<a name="L1605"></a><tt class="py-lineno">1605</tt>  <tt class="py-line"><tt class="py-docstring">  call. Create an instance initialized with the desired response headers</tt> </tt>
+<a name="L1606"></a><tt class="py-lineno">1606</tt>  <tt class="py-line"><tt class="py-docstring">  and content and then use as if an httplib2.Http instance.</tt> </tt>
+<a name="L1607"></a><tt class="py-lineno">1607</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1608"></a><tt class="py-lineno">1608</tt>  <tt class="py-line"><tt class="py-docstring">    http = HttpMockSequence([</tt> </tt>
+<a name="L1609"></a><tt class="py-lineno">1609</tt>  <tt class="py-line"><tt class="py-docstring">      ({'status': '401'}, ''),</tt> </tt>
+<a name="L1610"></a><tt class="py-lineno">1610</tt>  <tt class="py-line"><tt class="py-docstring">      ({'status': '200'}, '{"access_token":"1/3w","expires_in":3600}'),</tt> </tt>
+<a name="L1611"></a><tt class="py-lineno">1611</tt>  <tt class="py-line"><tt class="py-docstring">      ({'status': '200'}, 'echo_request_headers'),</tt> </tt>
+<a name="L1612"></a><tt class="py-lineno">1612</tt>  <tt class="py-line"><tt class="py-docstring">      ])</tt> </tt>
+<a name="L1613"></a><tt class="py-lineno">1613</tt>  <tt class="py-line"><tt class="py-docstring">    resp, content = http.request("http://examples.com")</tt> </tt>
+<a name="L1614"></a><tt class="py-lineno">1614</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1615"></a><tt class="py-lineno">1615</tt>  <tt class="py-line"><tt class="py-docstring">  There are special values you can pass in for content to trigger</tt> </tt>
+<a name="L1616"></a><tt class="py-lineno">1616</tt>  <tt class="py-line"><tt class="py-docstring">  behavours that are helpful in testing.</tt> </tt>
+<a name="L1617"></a><tt class="py-lineno">1617</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1618"></a><tt class="py-lineno">1618</tt>  <tt class="py-line"><tt class="py-docstring">  'echo_request_headers' means return the request headers in the response body</tt> </tt>
+<a name="L1619"></a><tt class="py-lineno">1619</tt>  <tt class="py-line"><tt class="py-docstring">  'echo_request_headers_as_json' means return the request headers in</tt> </tt>
+<a name="L1620"></a><tt class="py-lineno">1620</tt>  <tt class="py-line"><tt class="py-docstring">     the response body</tt> </tt>
+<a name="L1621"></a><tt class="py-lineno">1621</tt>  <tt class="py-line"><tt class="py-docstring">  'echo_request_body' means return the request body in the response body</tt> </tt>
+<a name="L1622"></a><tt class="py-lineno">1622</tt>  <tt class="py-line"><tt class="py-docstring">  'echo_request_uri' means return the request uri in the response body</tt> </tt>
+<a name="L1623"></a><tt class="py-lineno">1623</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L1624"></a><tt class="py-lineno">1624</tt>  <tt class="py-line"> </tt>
+<a name="HttpMockSequence.__init__"></a><div id="HttpMockSequence.__init__-def"><a name="L1625"></a><tt class="py-lineno">1625</tt> <a class="py-toggle" href="#" id="HttpMockSequence.__init__-toggle" onclick="return toggle('HttpMockSequence.__init__');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpMockSequence-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">iterable</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpMockSequence.__init__-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpMockSequence.__init__-expanded"><a name="L1626"></a><tt class="py-lineno">1626</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
+<a name="L1627"></a><tt class="py-lineno">1627</tt>  <tt class="py-line"><tt class="py-docstring">    Args:</tt> </tt>
+<a name="L1628"></a><tt class="py-lineno">1628</tt>  <tt class="py-line"><tt class="py-docstring">      iterable: iterable, a sequence of pairs of (headers, body)</tt> </tt>
+<a name="L1629"></a><tt class="py-lineno">1629</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
+<a name="L1630"></a><tt class="py-lineno">1630</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_iterable</tt> <tt class="py-op">=</tt> <tt class="py-name">iterable</tt> </tt>
+<a name="L1631"></a><tt class="py-lineno">1631</tt>  <tt class="py-line">    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">follow_redirects</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
+</div><a name="L1632"></a><tt class="py-lineno">1632</tt>  <tt class="py-line"> </tt>
+<a name="HttpMockSequence.request"></a><div id="HttpMockSequence.request-def"><a name="L1633"></a><tt class="py-lineno">1633</tt> <a class="py-toggle" href="#" id="HttpMockSequence.request-toggle" onclick="return toggle('HttpMockSequence.request');">-</a><tt class="py-line">  <tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http.HttpMockSequence-class.html#request">request</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">uri</tt><tt class="py-op">,</tt> </tt>
+<a name="L1634"></a><tt class="py-lineno">1634</tt>  <tt class="py-line">              <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> </tt>
+<a name="L1635"></a><tt class="py-lineno">1635</tt>  <tt class="py-line">              <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L1636"></a><tt class="py-lineno">1636</tt>  <tt class="py-line">              <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L1637"></a><tt class="py-lineno">1637</tt>  <tt class="py-line">              <tt class="py-param">redirections</tt><tt class="py-op">=</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> </tt>
+<a name="L1638"></a><tt class="py-lineno">1638</tt>  <tt class="py-line">              <tt class="py-param">connection_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="HttpMockSequence.request-collapsed" style="display:none;" pad="++++" indent="++++++"></div><div id="HttpMockSequence.request-expanded"><a name="L1639"></a><tt class="py-lineno">1639</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_iterable</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">)</tt> </tt>
+<a name="L1640"></a><tt class="py-lineno">1640</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">content</tt> <tt class="py-op">==</tt> <tt class="py-string">'echo_request_headers'</tt><tt class="py-op">:</tt> </tt>
+<a name="L1641"></a><tt class="py-lineno">1641</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">headers</tt> </tt>
+<a name="L1642"></a><tt class="py-lineno">1642</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">content</tt> <tt class="py-op">==</tt> <tt class="py-string">'echo_request_headers_as_json'</tt><tt class="py-op">:</tt> </tt>
+<a name="L1643"></a><tt class="py-lineno">1643</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">dumps</tt><tt class="py-op">(</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt> </tt>
+<a name="L1644"></a><tt class="py-lineno">1644</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">content</tt> <tt class="py-op">==</tt> <tt class="py-string">'echo_request_body'</tt><tt class="py-op">:</tt> </tt>
+<a name="L1645"></a><tt class="py-lineno">1645</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt id="link-305" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-305', 'body', 'link-69');">body</a></tt><tt class="py-op">,</tt> <tt class="py-string">'read'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1646"></a><tt class="py-lineno">1646</tt>  <tt class="py-line">        <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-306" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-306', 'body', 'link-69');">body</a></tt><tt class="py-op">.</tt><tt id="link-307" class="py-name"><a title="googleapiclient.http._StreamSlice.read" class="py-name" href="#" onclick="return doclink('link-307', 'read', 'link-50');">read</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L1647"></a><tt class="py-lineno">1647</tt>  <tt class="py-line">      <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L1648"></a><tt class="py-lineno">1648</tt>  <tt class="py-line">        <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt id="link-308" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-308', 'body', 'link-69');">body</a></tt> </tt>
+<a name="L1649"></a><tt class="py-lineno">1649</tt>  <tt class="py-line">    <tt class="py-keyword">elif</tt> <tt class="py-name">content</tt> <tt class="py-op">==</tt> <tt class="py-string">'echo_request_uri'</tt><tt class="py-op">:</tt> </tt>
+<a name="L1650"></a><tt class="py-lineno">1650</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">uri</tt> </tt>
+<a name="L1651"></a><tt class="py-lineno">1651</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">content</tt><tt class="py-op">,</tt> <tt class="py-name">six</tt><tt class="py-op">.</tt><tt class="py-name">text_type</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1652"></a><tt class="py-lineno">1652</tt>  <tt class="py-line">      <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">content</tt><tt class="py-op">.</tt><tt class="py-name">encode</tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1653"></a><tt class="py-lineno">1653</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">Response</tt><tt class="py-op">(</tt><tt class="py-name">resp</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> </tt>
+</div></div><a name="L1654"></a><tt class="py-lineno">1654</tt>  <tt class="py-line"> </tt>
+<a name="set_user_agent"></a><div id="set_user_agent-def"><a name="L1655"></a><tt class="py-lineno">1655</tt>  <tt class="py-line"> </tt>
+<a name="L1656"></a><tt class="py-lineno">1656</tt> <a class="py-toggle" href="#" id="set_user_agent-toggle" onclick="return toggle('set_user_agent');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http-module.html#set_user_agent">set_user_agent</a><tt class="py-op">(</tt><tt class="py-param">http</tt><tt class="py-op">,</tt> <tt class="py-param">user_agent</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="set_user_agent-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="set_user_agent-expanded"><a name="L1657"></a><tt class="py-lineno">1657</tt>  <tt class="py-line">  <tt class="py-docstring">"""Set the user-agent on every request.</tt> </tt>
+<a name="L1658"></a><tt class="py-lineno">1658</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1659"></a><tt class="py-lineno">1659</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L1660"></a><tt class="py-lineno">1660</tt>  <tt class="py-line"><tt class="py-docstring">     http - An instance of httplib2.Http</tt> </tt>
+<a name="L1661"></a><tt class="py-lineno">1661</tt>  <tt class="py-line"><tt class="py-docstring">         or something that acts like it.</tt> </tt>
+<a name="L1662"></a><tt class="py-lineno">1662</tt>  <tt class="py-line"><tt class="py-docstring">     user_agent: string, the value for the user-agent header.</tt> </tt>
+<a name="L1663"></a><tt class="py-lineno">1663</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1664"></a><tt class="py-lineno">1664</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L1665"></a><tt class="py-lineno">1665</tt>  <tt class="py-line"><tt class="py-docstring">     A modified instance of http that was passed in.</tt> </tt>
+<a name="L1666"></a><tt class="py-lineno">1666</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1667"></a><tt class="py-lineno">1667</tt>  <tt class="py-line"><tt class="py-docstring">  Example:</tt> </tt>
+<a name="L1668"></a><tt class="py-lineno">1668</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1669"></a><tt class="py-lineno">1669</tt>  <tt class="py-line"><tt class="py-docstring">    h = httplib2.Http()</tt> </tt>
+<a name="L1670"></a><tt class="py-lineno">1670</tt>  <tt class="py-line"><tt class="py-docstring">    h = set_user_agent(h, "my-app-name/6.0")</tt> </tt>
+<a name="L1671"></a><tt class="py-lineno">1671</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1672"></a><tt class="py-lineno">1672</tt>  <tt class="py-line"><tt class="py-docstring">  Most of the time the user-agent will be set doing auth, this is for the rare</tt> </tt>
+<a name="L1673"></a><tt class="py-lineno">1673</tt>  <tt class="py-line"><tt class="py-docstring">  cases where you are accessing an unauthenticated endpoint.</tt> </tt>
+<a name="L1674"></a><tt class="py-lineno">1674</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L1675"></a><tt class="py-lineno">1675</tt>  <tt class="py-line">  <tt class="py-name">request_orig</tt> <tt class="py-op">=</tt> <tt id="link-309" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-309', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-310" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-310', 'request', 'link-34');">request</a></tt> </tt>
-<a name="L1672"></a><tt class="py-lineno">1672</tt>  <tt class="py-line"> </tt>
-<a name="L1673"></a><tt class="py-lineno">1673</tt>  <tt class="py-line">  <tt class="py-comment"># The closure that will replace 'httplib2.Http.request'.</tt> </tt>
-<a name="L1674"></a><tt class="py-lineno">1674</tt>  <tt class="py-line">  <tt class="py-keyword">def</tt> <tt class="py-def-name">new_request</tt><tt class="py-op">(</tt><tt class="py-param">uri</tt><tt class="py-op">,</tt> <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L1675"></a><tt class="py-lineno">1675</tt>  <tt class="py-line">                  <tt class="py-param">redirections</tt><tt class="py-op">=</tt><tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">DEFAULT_MAX_REDIRECTS</tt><tt class="py-op">,</tt> </tt>
-<a name="L1676"></a><tt class="py-lineno">1676</tt>  <tt class="py-line">                  <tt class="py-param">connection_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1677"></a><tt class="py-lineno">1677</tt>  <tt class="py-line">    <tt class="py-docstring">"""Modify the request headers to add the user-agent."""</tt> </tt>
-<a name="L1678"></a><tt class="py-lineno">1678</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">headers</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1679"></a><tt class="py-lineno">1679</tt>  <tt class="py-line">      <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L1680"></a><tt class="py-lineno">1680</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'user-agent'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">headers</tt><tt class="py-op">:</tt> </tt>
-<a name="L1681"></a><tt class="py-lineno">1681</tt>  <tt class="py-line">      <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'user-agent'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">user_agent</tt> <tt class="py-op">+</tt> <tt class="py-string">' '</tt> <tt class="py-op">+</tt> <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'user-agent'</tt><tt class="py-op">]</tt> </tt>
-<a name="L1682"></a><tt class="py-lineno">1682</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
-<a name="L1683"></a><tt class="py-lineno">1683</tt>  <tt class="py-line">      <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'user-agent'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">user_agent</tt> </tt>
-<a name="L1684"></a><tt class="py-lineno">1684</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">request_orig</tt><tt class="py-op">(</tt><tt class="py-name">uri</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt><tt class="py-op">,</tt> <tt id="link-311" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-311', 'body', 'link-69');">body</a></tt><tt class="py-op">,</tt> <tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
-<a name="L1685"></a><tt class="py-lineno">1685</tt>  <tt class="py-line">                        <tt class="py-name">redirections</tt><tt class="py-op">,</tt> <tt class="py-name">connection_type</tt><tt class="py-op">)</tt> </tt>
-<a name="L1686"></a><tt class="py-lineno">1686</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> </tt>
-</div><a name="L1687"></a><tt class="py-lineno">1687</tt>  <tt class="py-line"> </tt>
-<a name="L1688"></a><tt class="py-lineno">1688</tt>  <tt class="py-line">  <tt id="link-312" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-312', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-313" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1676"></a><tt class="py-lineno">1676</tt>  <tt class="py-line"> </tt>
+<a name="L1677"></a><tt class="py-lineno">1677</tt>  <tt class="py-line">  <tt class="py-comment"># The closure that will replace 'httplib2.Http.request'.</tt> </tt>
+<a name="L1678"></a><tt class="py-lineno">1678</tt>  <tt class="py-line">  <tt class="py-keyword">def</tt> <tt class="py-def-name">new_request</tt><tt class="py-op">(</tt><tt class="py-param">uri</tt><tt class="py-op">,</tt> <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L1679"></a><tt class="py-lineno">1679</tt>  <tt class="py-line">                  <tt class="py-param">redirections</tt><tt class="py-op">=</tt><tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">DEFAULT_MAX_REDIRECTS</tt><tt class="py-op">,</tt> </tt>
+<a name="L1680"></a><tt class="py-lineno">1680</tt>  <tt class="py-line">                  <tt class="py-param">connection_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1681"></a><tt class="py-lineno">1681</tt>  <tt class="py-line">    <tt class="py-docstring">"""Modify the request headers to add the user-agent."""</tt> </tt>
+<a name="L1682"></a><tt class="py-lineno">1682</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">headers</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1683"></a><tt class="py-lineno">1683</tt>  <tt class="py-line">      <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L1684"></a><tt class="py-lineno">1684</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-string">'user-agent'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">headers</tt><tt class="py-op">:</tt> </tt>
+<a name="L1685"></a><tt class="py-lineno">1685</tt>  <tt class="py-line">      <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'user-agent'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">user_agent</tt> <tt class="py-op">+</tt> <tt class="py-string">' '</tt> <tt class="py-op">+</tt> <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'user-agent'</tt><tt class="py-op">]</tt> </tt>
+<a name="L1686"></a><tt class="py-lineno">1686</tt>  <tt class="py-line">    <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L1687"></a><tt class="py-lineno">1687</tt>  <tt class="py-line">      <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'user-agent'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">user_agent</tt> </tt>
+<a name="L1688"></a><tt class="py-lineno">1688</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">request_orig</tt><tt class="py-op">(</tt><tt class="py-name">uri</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt><tt class="py-op">,</tt> <tt id="link-311" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-311', 'body', 'link-69');">body</a></tt><tt class="py-op">,</tt> <tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
+<a name="L1689"></a><tt class="py-lineno">1689</tt>  <tt class="py-line">                        <tt class="py-name">redirections</tt><tt class="py-op">,</tt> <tt class="py-name">connection_type</tt><tt class="py-op">)</tt> </tt>
+<a name="L1690"></a><tt class="py-lineno">1690</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> </tt>
+</div><a name="L1691"></a><tt class="py-lineno">1691</tt>  <tt class="py-line"> </tt>
+<a name="L1692"></a><tt class="py-lineno">1692</tt>  <tt class="py-line">  <tt id="link-312" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-312', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-313" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-313', 'request', 'link-34');">request</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_request</tt> </tt>
-<a name="L1689"></a><tt class="py-lineno">1689</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt id="link-314" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-314', 'http', 'link-33');">http</a></tt> </tt>
-</div><a name="L1690"></a><tt class="py-lineno">1690</tt>  <tt class="py-line"> </tt>
-<a name="tunnel_patch"></a><div id="tunnel_patch-def"><a name="L1691"></a><tt class="py-lineno">1691</tt>  <tt class="py-line"> </tt>
-<a name="L1692"></a><tt class="py-lineno">1692</tt> <a class="py-toggle" href="#" id="tunnel_patch-toggle" onclick="return toggle('tunnel_patch');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http-module.html#tunnel_patch">tunnel_patch</a><tt class="py-op">(</tt><tt class="py-param">http</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-</div><div id="tunnel_patch-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="tunnel_patch-expanded"><a name="L1693"></a><tt class="py-lineno">1693</tt>  <tt class="py-line">  <tt class="py-docstring">"""Tunnel PATCH requests over POST.</tt> </tt>
-<a name="L1694"></a><tt class="py-lineno">1694</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
-<a name="L1695"></a><tt class="py-lineno">1695</tt>  <tt class="py-line"><tt class="py-docstring">     http - An instance of httplib2.Http</tt> </tt>
-<a name="L1696"></a><tt class="py-lineno">1696</tt>  <tt class="py-line"><tt class="py-docstring">         or something that acts like it.</tt> </tt>
-<a name="L1697"></a><tt class="py-lineno">1697</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1698"></a><tt class="py-lineno">1698</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
-<a name="L1699"></a><tt class="py-lineno">1699</tt>  <tt class="py-line"><tt class="py-docstring">     A modified instance of http that was passed in.</tt> </tt>
-<a name="L1700"></a><tt class="py-lineno">1700</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1701"></a><tt class="py-lineno">1701</tt>  <tt class="py-line"><tt class="py-docstring">  Example:</tt> </tt>
-<a name="L1702"></a><tt class="py-lineno">1702</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1703"></a><tt class="py-lineno">1703</tt>  <tt class="py-line"><tt class="py-docstring">    h = httplib2.Http()</tt> </tt>
-<a name="L1704"></a><tt class="py-lineno">1704</tt>  <tt class="py-line"><tt class="py-docstring">    h = tunnel_patch(h, "my-app-name/6.0")</tt> </tt>
-<a name="L1705"></a><tt class="py-lineno">1705</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
-<a name="L1706"></a><tt class="py-lineno">1706</tt>  <tt class="py-line"><tt class="py-docstring">  Useful if you are running on a platform that doesn't support PATCH.</tt> </tt>
-<a name="L1707"></a><tt class="py-lineno">1707</tt>  <tt class="py-line"><tt class="py-docstring">  Apply this last if you are using OAuth 1.0, as changing the method</tt> </tt>
-<a name="L1708"></a><tt class="py-lineno">1708</tt>  <tt class="py-line"><tt class="py-docstring">  will result in a different signature.</tt> </tt>
-<a name="L1709"></a><tt class="py-lineno">1709</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
-<a name="L1710"></a><tt class="py-lineno">1710</tt>  <tt class="py-line">  <tt class="py-name">request_orig</tt> <tt class="py-op">=</tt> <tt id="link-315" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-315', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-316" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1693"></a><tt class="py-lineno">1693</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt id="link-314" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-314', 'http', 'link-33');">http</a></tt> </tt>
+</div><a name="L1694"></a><tt class="py-lineno">1694</tt>  <tt class="py-line"> </tt>
+<a name="tunnel_patch"></a><div id="tunnel_patch-def"><a name="L1695"></a><tt class="py-lineno">1695</tt>  <tt class="py-line"> </tt>
+<a name="L1696"></a><tt class="py-lineno">1696</tt> <a class="py-toggle" href="#" id="tunnel_patch-toggle" onclick="return toggle('tunnel_patch');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="googleapiclient.http-module.html#tunnel_patch">tunnel_patch</a><tt class="py-op">(</tt><tt class="py-param">http</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="tunnel_patch-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="tunnel_patch-expanded"><a name="L1697"></a><tt class="py-lineno">1697</tt>  <tt class="py-line">  <tt class="py-docstring">"""Tunnel PATCH requests over POST.</tt> </tt>
+<a name="L1698"></a><tt class="py-lineno">1698</tt>  <tt class="py-line"><tt class="py-docstring">  Args:</tt> </tt>
+<a name="L1699"></a><tt class="py-lineno">1699</tt>  <tt class="py-line"><tt class="py-docstring">     http - An instance of httplib2.Http</tt> </tt>
+<a name="L1700"></a><tt class="py-lineno">1700</tt>  <tt class="py-line"><tt class="py-docstring">         or something that acts like it.</tt> </tt>
+<a name="L1701"></a><tt class="py-lineno">1701</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1702"></a><tt class="py-lineno">1702</tt>  <tt class="py-line"><tt class="py-docstring">  Returns:</tt> </tt>
+<a name="L1703"></a><tt class="py-lineno">1703</tt>  <tt class="py-line"><tt class="py-docstring">     A modified instance of http that was passed in.</tt> </tt>
+<a name="L1704"></a><tt class="py-lineno">1704</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1705"></a><tt class="py-lineno">1705</tt>  <tt class="py-line"><tt class="py-docstring">  Example:</tt> </tt>
+<a name="L1706"></a><tt class="py-lineno">1706</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1707"></a><tt class="py-lineno">1707</tt>  <tt class="py-line"><tt class="py-docstring">    h = httplib2.Http()</tt> </tt>
+<a name="L1708"></a><tt class="py-lineno">1708</tt>  <tt class="py-line"><tt class="py-docstring">    h = tunnel_patch(h, "my-app-name/6.0")</tt> </tt>
+<a name="L1709"></a><tt class="py-lineno">1709</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
+<a name="L1710"></a><tt class="py-lineno">1710</tt>  <tt class="py-line"><tt class="py-docstring">  Useful if you are running on a platform that doesn't support PATCH.</tt> </tt>
+<a name="L1711"></a><tt class="py-lineno">1711</tt>  <tt class="py-line"><tt class="py-docstring">  Apply this last if you are using OAuth 1.0, as changing the method</tt> </tt>
+<a name="L1712"></a><tt class="py-lineno">1712</tt>  <tt class="py-line"><tt class="py-docstring">  will result in a different signature.</tt> </tt>
+<a name="L1713"></a><tt class="py-lineno">1713</tt>  <tt class="py-line"><tt class="py-docstring">  """</tt> </tt>
+<a name="L1714"></a><tt class="py-lineno">1714</tt>  <tt class="py-line">  <tt class="py-name">request_orig</tt> <tt class="py-op">=</tt> <tt id="link-315" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-315', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-316" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-316', 'request', 'link-34');">request</a></tt> </tt>
-<a name="L1711"></a><tt class="py-lineno">1711</tt>  <tt class="py-line"> </tt>
-<a name="L1712"></a><tt class="py-lineno">1712</tt>  <tt class="py-line">  <tt class="py-comment"># The closure that will replace 'httplib2.Http.request'.</tt> </tt>
-<a name="L1713"></a><tt class="py-lineno">1713</tt>  <tt class="py-line">  <tt class="py-keyword">def</tt> <tt class="py-def-name">new_request</tt><tt class="py-op">(</tt><tt class="py-param">uri</tt><tt class="py-op">,</tt> <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
-<a name="L1714"></a><tt class="py-lineno">1714</tt>  <tt class="py-line">                  <tt class="py-param">redirections</tt><tt class="py-op">=</tt><tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">DEFAULT_MAX_REDIRECTS</tt><tt class="py-op">,</tt> </tt>
-<a name="L1715"></a><tt class="py-lineno">1715</tt>  <tt class="py-line">                  <tt class="py-param">connection_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1716"></a><tt class="py-lineno">1716</tt>  <tt class="py-line">    <tt class="py-docstring">"""Modify the request headers to add the user-agent."""</tt> </tt>
-<a name="L1717"></a><tt class="py-lineno">1717</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">headers</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
-<a name="L1718"></a><tt class="py-lineno">1718</tt>  <tt class="py-line">      <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
-<a name="L1719"></a><tt class="py-lineno">1719</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">method</tt> <tt class="py-op">==</tt> <tt class="py-string">'PATCH'</tt><tt class="py-op">:</tt> </tt>
-<a name="L1720"></a><tt class="py-lineno">1720</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-string">'oauth_token'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">headers</tt><tt class="py-op">.</tt><tt id="link-317" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
+<a name="L1715"></a><tt class="py-lineno">1715</tt>  <tt class="py-line"> </tt>
+<a name="L1716"></a><tt class="py-lineno">1716</tt>  <tt class="py-line">  <tt class="py-comment"># The closure that will replace 'httplib2.Http.request'.</tt> </tt>
+<a name="L1717"></a><tt class="py-lineno">1717</tt>  <tt class="py-line">  <tt class="py-keyword">def</tt> <tt class="py-def-name">new_request</tt><tt class="py-op">(</tt><tt class="py-param">uri</tt><tt class="py-op">,</tt> <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> <tt class="py-param">body</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
+<a name="L1718"></a><tt class="py-lineno">1718</tt>  <tt class="py-line">                  <tt class="py-param">redirections</tt><tt class="py-op">=</tt><tt class="py-name">httplib2</tt><tt class="py-op">.</tt><tt class="py-name">DEFAULT_MAX_REDIRECTS</tt><tt class="py-op">,</tt> </tt>
+<a name="L1719"></a><tt class="py-lineno">1719</tt>  <tt class="py-line">                  <tt class="py-param">connection_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L1720"></a><tt class="py-lineno">1720</tt>  <tt class="py-line">    <tt class="py-docstring">"""Modify the request headers to add the user-agent."""</tt> </tt>
+<a name="L1721"></a><tt class="py-lineno">1721</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">headers</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
+<a name="L1722"></a><tt class="py-lineno">1722</tt>  <tt class="py-line">      <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L1723"></a><tt class="py-lineno">1723</tt>  <tt class="py-line">    <tt class="py-keyword">if</tt> <tt class="py-name">method</tt> <tt class="py-op">==</tt> <tt class="py-string">'PATCH'</tt><tt class="py-op">:</tt> </tt>
+<a name="L1724"></a><tt class="py-lineno">1724</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-string">'oauth_token'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">headers</tt><tt class="py-op">.</tt><tt id="link-317" class="py-name"><a title="googleapiclient.discovery_cache.appengine_memcache.Cache.get
 googleapiclient.discovery_cache.base.Cache.get
 googleapiclient.discovery_cache.file_cache.Cache.get
 googleapiclient.schema.Schemas.get" class="py-name" href="#" onclick="return doclink('link-317', 'get', 'link-36');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'authorization'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
-<a name="L1721"></a><tt class="py-lineno">1721</tt>  <tt class="py-line">        <tt id="link-318" class="py-name"><a title="googleapiclient.discovery_cache.LOGGER
+<a name="L1725"></a><tt class="py-lineno">1725</tt>  <tt class="py-line">        <tt id="link-318" class="py-name"><a title="googleapiclient.discovery_cache.LOGGER
 googleapiclient.discovery_cache.appengine_memcache.LOGGER
 googleapiclient.discovery_cache.file_cache.LOGGER
 googleapiclient.http.LOGGER
 googleapiclient.model.LOGGER" class="py-name" href="#" onclick="return doclink('link-318', 'LOGGER', 'link-25');">LOGGER</a></tt><tt class="py-op">.</tt><tt class="py-name">warning</tt><tt class="py-op">(</tt> </tt>
-<a name="L1722"></a><tt class="py-lineno">1722</tt>  <tt class="py-line">            <tt class="py-string">'OAuth 1.0 request made with Credentials after tunnel_patch.'</tt><tt class="py-op">)</tt> </tt>
-<a name="L1723"></a><tt class="py-lineno">1723</tt>  <tt class="py-line">      <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'x-http-method-override'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">"PATCH"</tt> </tt>
-<a name="L1724"></a><tt class="py-lineno">1724</tt>  <tt class="py-line">      <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt class="py-string">'POST'</tt> </tt>
-<a name="L1725"></a><tt class="py-lineno">1725</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">request_orig</tt><tt class="py-op">(</tt><tt class="py-name">uri</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt><tt class="py-op">,</tt> <tt id="link-319" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-319', 'body', 'link-69');">body</a></tt><tt class="py-op">,</tt> <tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
-<a name="L1726"></a><tt class="py-lineno">1726</tt>  <tt class="py-line">                        <tt class="py-name">redirections</tt><tt class="py-op">,</tt> <tt class="py-name">connection_type</tt><tt class="py-op">)</tt> </tt>
-<a name="L1727"></a><tt class="py-lineno">1727</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> </tt>
-</div><a name="L1728"></a><tt class="py-lineno">1728</tt>  <tt class="py-line"> </tt>
-<a name="L1729"></a><tt class="py-lineno">1729</tt>  <tt class="py-line">  <tt id="link-320" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-320', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-321" class="py-name"><a title="googleapiclient.http.HttpMock.request
+<a name="L1726"></a><tt class="py-lineno">1726</tt>  <tt class="py-line">            <tt class="py-string">'OAuth 1.0 request made with Credentials after tunnel_patch.'</tt><tt class="py-op">)</tt> </tt>
+<a name="L1727"></a><tt class="py-lineno">1727</tt>  <tt class="py-line">      <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'x-http-method-override'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">"PATCH"</tt> </tt>
+<a name="L1728"></a><tt class="py-lineno">1728</tt>  <tt class="py-line">      <tt class="py-name">method</tt> <tt class="py-op">=</tt> <tt class="py-string">'POST'</tt> </tt>
+<a name="L1729"></a><tt class="py-lineno">1729</tt>  <tt class="py-line">    <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> <tt class="py-op">=</tt> <tt class="py-name">request_orig</tt><tt class="py-op">(</tt><tt class="py-name">uri</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt><tt class="py-op">,</tt> <tt id="link-319" class="py-name"><a title="googleapiclient.channel.Channel.body" class="py-name" href="#" onclick="return doclink('link-319', 'body', 'link-69');">body</a></tt><tt class="py-op">,</tt> <tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
+<a name="L1730"></a><tt class="py-lineno">1730</tt>  <tt class="py-line">                        <tt class="py-name">redirections</tt><tt class="py-op">,</tt> <tt class="py-name">connection_type</tt><tt class="py-op">)</tt> </tt>
+<a name="L1731"></a><tt class="py-lineno">1731</tt>  <tt class="py-line">    <tt class="py-keyword">return</tt> <tt class="py-name">resp</tt><tt class="py-op">,</tt> <tt class="py-name">content</tt> </tt>
+</div><a name="L1732"></a><tt class="py-lineno">1732</tt>  <tt class="py-line"> </tt>
+<a name="L1733"></a><tt class="py-lineno">1733</tt>  <tt class="py-line">  <tt id="link-320" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-320', 'http', 'link-33');">http</a></tt><tt class="py-op">.</tt><tt id="link-321" class="py-name"><a title="googleapiclient.http.HttpMock.request
 googleapiclient.http.HttpMockSequence.request
 googleapiclient.model.BaseModel.request
 googleapiclient.model.Model.request" class="py-name" href="#" onclick="return doclink('link-321', 'request', 'link-34');">request</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_request</tt> </tt>
-<a name="L1730"></a><tt class="py-lineno">1730</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt id="link-322" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-322', 'http', 'link-33');">http</a></tt> </tt>
-</div><a name="L1731"></a><tt class="py-lineno">1731</tt>  <tt class="py-line"> </tt><script type="text/javascript">
+<a name="L1734"></a><tt class="py-lineno">1734</tt>  <tt class="py-line">  <tt class="py-keyword">return</tt> <tt id="link-322" class="py-name"><a title="googleapiclient.http" class="py-name" href="#" onclick="return doclink('link-322', 'http', 'link-33');">http</a></tt> </tt>
+</div><a name="L1735"></a><tt class="py-lineno">1735</tt>  <tt class="py-line"> </tt><script type="text/javascript">
 <!--
 expandto(location.href);
 // -->
@@ -2164,7 +2168,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.http-module.html">Mo
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:51 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.BatchHttpRequest-class.html b/docs/epy/googleapiclient.http.BatchHttpRequest-class.html
index 530bcb9eeb7..a9915f98797 100644
--- a/docs/epy/googleapiclient.http.BatchHttpRequest-class.html
+++ b/docs/epy/googleapiclient.http.BatchHttpRequest-class.html
@@ -59,10 +59,10 @@
 <h1 class="epydoc">Class BatchHttpRequest</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#BatchHttpRequest">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_24" name="uml_class_diagram_for_googleap_24">
-<area shape="rect" id="node1_3" href="googleapiclient.http.BatchHttpRequest-class.html#__init__" title="Constructor for a BatchHttpRequest." alt="" coords="17,40,328,60"/>
-<area shape="rect" id="node1_4" href="googleapiclient.http.BatchHttpRequest-class.html#add" title="Add a new request." alt="" coords="17,60,328,80"/>
-<area shape="rect" id="node1_5" href="googleapiclient.http.BatchHttpRequest-class.html#execute" title="Execute all the requests as a single batched HTTP request." alt="" coords="17,80,328,100"/>
-<area shape="rect" id="node1" href="googleapiclient.http.BatchHttpRequest-class.html" title="Batches multiple HttpRequest objects into a single HTTP request." alt="" coords="5,6,339,106"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http.BatchHttpRequest-class.html#__init__" title="Constructor for a BatchHttpRequest." alt="" coords="18,36,331,55"/>
+<area shape="rect" id="node1_4" href="googleapiclient.http.BatchHttpRequest-class.html#add" title="Add a new request." alt="" coords="18,55,331,73"/>
+<area shape="rect" id="node1_5" href="googleapiclient.http.BatchHttpRequest-class.html#execute" title="Execute all the requests as a single batched HTTP request." alt="" coords="18,73,331,92"/>
+<area shape="rect" id="node1" href="googleapiclient.http.BatchHttpRequest-class.html" title="Batches multiple HttpRequest objects into a single HTTP request." alt="" coords="5,5,343,99"/>
 </map>
   <img src="uml_class_diagram_for_googleap_24.gif" alt='' usemap="#uml_class_diagram_for_googleap_24" ismap="ismap" class="graph-without-title" />
 </center>
@@ -740,7 +740,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">execute</span>(<span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.HttpMock-class.html b/docs/epy/googleapiclient.http.HttpMock-class.html
index 8f7576bd754..b3e8fd736d6 100644
--- a/docs/epy/googleapiclient.http.HttpMock-class.html
+++ b/docs/epy/googleapiclient.http.HttpMock-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class HttpMock</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#HttpMock">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_25" name="uml_class_diagram_for_googleap_25">
-<area shape="rect" id="node1_2" href="googleapiclient.http.HttpMock-class.html#__init__" title="Args:..." alt="" coords="17,39,611,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.http.HttpMock-class.html#request" title="googleapiclient.http.HttpMock.request" alt="" coords="17,59,611,79"/>
-<area shape="rect" id="node1" href="googleapiclient.http.HttpMock-class.html" title="Mock of httplib2.Http" alt="" coords="5,5,622,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.http.HttpMock-class.html#__init__" title="Args:..." alt="" coords="17,36,617,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http.HttpMock-class.html#request" title="googleapiclient.http.HttpMock.request" alt="" coords="17,55,617,73"/>
+<area shape="rect" id="node1" href="googleapiclient.http.HttpMock-class.html" title="Mock of httplib2.Http" alt="" coords="5,5,629,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_25.gif" alt='' usemap="#uml_class_diagram_for_googleap_25" ismap="ismap" class="graph-without-title" />
 </center>
@@ -250,7 +250,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.HttpMockSequence-class.html b/docs/epy/googleapiclient.http.HttpMockSequence-class.html
index 3426ce5ccd3..7a5ba177b31 100644
--- a/docs/epy/googleapiclient.http.HttpMockSequence-class.html
+++ b/docs/epy/googleapiclient.http.HttpMockSequence-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class HttpMockSequence</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#HttpMockSequence">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_26" name="uml_class_diagram_for_googleap_26">
-<area shape="rect" id="node1_2" href="googleapiclient.http.HttpMockSequence-class.html#__init__" title="Args:..." alt="" coords="17,39,611,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.http.HttpMockSequence-class.html#request" title="googleapiclient.http.HttpMockSequence.request" alt="" coords="17,59,611,79"/>
-<area shape="rect" id="node1" href="googleapiclient.http.HttpMockSequence-class.html" title="Mock of httplib2.Http" alt="" coords="5,5,622,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.http.HttpMockSequence-class.html#__init__" title="Args:..." alt="" coords="17,36,617,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http.HttpMockSequence-class.html#request" title="googleapiclient.http.HttpMockSequence.request" alt="" coords="17,55,617,73"/>
+<area shape="rect" id="node1" href="googleapiclient.http.HttpMockSequence-class.html" title="Mock of httplib2.Http" alt="" coords="5,5,629,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_26.gif" alt='' usemap="#uml_class_diagram_for_googleap_26" ismap="ismap" class="graph-without-title" />
 </center>
@@ -267,7 +267,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.HttpRequest-class.html b/docs/epy/googleapiclient.http.HttpRequest-class.html
index 7a16b74fa31..5b2d0a5f6f5 100644
--- a/docs/epy/googleapiclient.http.HttpRequest-class.html
+++ b/docs/epy/googleapiclient.http.HttpRequest-class.html
@@ -59,13 +59,13 @@
 <h1 class="epydoc">Class HttpRequest</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#HttpRequest">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_27" name="uml_class_diagram_for_googleap_27">
-<area shape="rect" id="node1_6" href="googleapiclient.http.HttpRequest-class.html#__init__" title="Constructor for an HttpRequest." alt="" coords="17,39,677,59"/>
-<area shape="rect" id="node1_7" href="googleapiclient.http.HttpRequest-class.html#execute" title="Execute the request." alt="" coords="17,59,677,79"/>
-<area shape="rect" id="node1_8" href="googleapiclient.http.HttpRequest-class.html#add_response_callback" title="add_response_headers_callback" alt="" coords="17,79,677,99"/>
-<area shape="rect" id="node1_9" href="googleapiclient.http.HttpRequest-class.html#next_chunk" title="Execute the next step of a resumable upload." alt="" coords="17,99,677,119"/>
-<area shape="rect" id="node1_10" href="googleapiclient.http.HttpRequest-class.html#to_json" title="Returns a JSON representation of the HttpRequest." alt="" coords="17,119,677,139"/>
-<area shape="rect" id="node1_11" href="googleapiclient.http.HttpRequest-class.html#from_json" title="Returns an HttpRequest populated with info from a JSON object." alt="" coords="17,139,677,159"/>
-<area shape="rect" id="node1" href="googleapiclient.http.HttpRequest-class.html" title="Encapsulates a single HTTP request." alt="" coords="5,5,689,165"/>
+<area shape="rect" id="node1_6" href="googleapiclient.http.HttpRequest-class.html#__init__" title="Constructor for an HttpRequest." alt="" coords="17,36,684,55"/>
+<area shape="rect" id="node1_7" href="googleapiclient.http.HttpRequest-class.html#execute" title="Execute the request." alt="" coords="17,55,684,73"/>
+<area shape="rect" id="node1_8" href="googleapiclient.http.HttpRequest-class.html#add_response_callback" title="add_response_headers_callback" alt="" coords="17,73,684,92"/>
+<area shape="rect" id="node1_9" href="googleapiclient.http.HttpRequest-class.html#next_chunk" title="Execute the next step of a resumable upload." alt="" coords="17,92,684,111"/>
+<area shape="rect" id="node1_10" href="googleapiclient.http.HttpRequest-class.html#to_json" title="Returns a JSON representation of the HttpRequest." alt="" coords="17,111,684,129"/>
+<area shape="rect" id="node1_11" href="googleapiclient.http.HttpRequest-class.html#from_json" title="Returns an HttpRequest populated with info from a JSON object." alt="" coords="17,129,684,148"/>
+<area shape="rect" id="node1" href="googleapiclient.http.HttpRequest-class.html" title="Encapsulates a single HTTP request." alt="" coords="5,5,696,155"/>
 </map>
   <img src="uml_class_diagram_for_googleap_27.gif" alt='' usemap="#uml_class_diagram_for_googleap_27" ismap="ismap" class="graph-without-title" />
 </center>
@@ -561,7 +561,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">_process_response</s
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.HttpRequestMock-class.html b/docs/epy/googleapiclient.http.HttpRequestMock-class.html
index 902b193ad48..a0d32571ff3 100644
--- a/docs/epy/googleapiclient.http.HttpRequestMock-class.html
+++ b/docs/epy/googleapiclient.http.HttpRequestMock-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class HttpRequestMock</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#HttpRequestMock">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_28" name="uml_class_diagram_for_googleap_28">
-<area shape="rect" id="node1_2" href="googleapiclient.http.HttpRequestMock-class.html#__init__" title="Constructor for HttpRequestMock" alt="" coords="16,39,240,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.http.HttpRequestMock-class.html#execute" title="Execute the request." alt="" coords="16,59,240,79"/>
-<area shape="rect" id="node1" href="googleapiclient.http.HttpRequestMock-class.html" title="Mock of HttpRequest." alt="" coords="4,5,252,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.http.HttpRequestMock-class.html#__init__" title="Constructor for HttpRequestMock" alt="" coords="17,36,241,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http.HttpRequestMock-class.html#execute" title="Execute the request." alt="" coords="17,55,241,73"/>
+<area shape="rect" id="node1" href="googleapiclient.http.HttpRequestMock-class.html" title="Mock of HttpRequest." alt="" coords="5,5,253,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_28.gif" alt='' usemap="#uml_class_diagram_for_googleap_28" ismap="ismap" class="graph-without-title" />
 </center>
@@ -279,7 +279,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">execute</span>(<span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.MediaDownloadProgress-class.html b/docs/epy/googleapiclient.http.MediaDownloadProgress-class.html
index 97380f63186..45362fa3f81 100644
--- a/docs/epy/googleapiclient.http.MediaDownloadProgress-class.html
+++ b/docs/epy/googleapiclient.http.MediaDownloadProgress-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class MediaDownloadProgress</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#MediaDownloadProgress">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_29" name="uml_class_diagram_for_googleap_29">
-<area shape="rect" id="node1_2" href="googleapiclient.http.MediaDownloadProgress-class.html#__init__" title="Constructor." alt="" coords="17,39,288,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.http.MediaDownloadProgress-class.html#progress" title="Percent of download completed, as a float." alt="" coords="17,59,288,79"/>
-<area shape="rect" id="node1" href="googleapiclient.http.MediaDownloadProgress-class.html" title="Status of a resumable download." alt="" coords="5,5,299,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.http.MediaDownloadProgress-class.html#__init__" title="Constructor." alt="" coords="18,36,291,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http.MediaDownloadProgress-class.html#progress" title="Percent of download completed, as a float." alt="" coords="18,55,291,73"/>
+<area shape="rect" id="node1" href="googleapiclient.http.MediaDownloadProgress-class.html" title="Status of a resumable download." alt="" coords="5,5,303,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_29.gif" alt='' usemap="#uml_class_diagram_for_googleap_29" ismap="ismap" class="graph-without-title" />
 </center>
@@ -272,7 +272,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">progress</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.MediaFileUpload-class.html b/docs/epy/googleapiclient.http.MediaFileUpload-class.html
index 2b812dd1ef1..aaf5e4d6784 100644
--- a/docs/epy/googleapiclient.http.MediaFileUpload-class.html
+++ b/docs/epy/googleapiclient.http.MediaFileUpload-class.html
@@ -59,20 +59,20 @@
 <h1 class="epydoc">Class MediaFileUpload</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#MediaFileUpload">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_30" name="uml_class_diagram_for_googleap_30">
-<area shape="rect" id="node1_11" href="googleapiclient.http.MediaFileUpload-class.html#__init__" title="Constructor." alt="" coords="17,320,597,340"/>
-<area shape="rect" id="node1_12" href="googleapiclient.http.MediaFileUpload-class.html#to_json" title="Creating a JSON representation of an instance of MediaFileUpload." alt="" coords="17,340,597,360"/>
-<area shape="rect" id="node1_13" href="googleapiclient.http.MediaFileUpload-class.html#from_json" title="googleapiclient.http.MediaFileUpload.from_json" alt="" coords="17,360,597,380"/>
-<area shape="rect" id="node1" href="googleapiclient.http.MediaFileUpload-class.html" title="A MediaUpload for a file." alt="" coords="5,286,609,386"/>
-<area shape="rect" id="node2_14" href="googleapiclient.http.MediaIoBaseUpload-class.html#chunksize" title="Chunk size for resumable uploads." alt="" coords="224,120,392,140"/>
-<area shape="rect" id="node2_15" href="googleapiclient.http.MediaIoBaseUpload-class.html#mimetype" title="Mime type of the body." alt="" coords="224,140,392,160"/>
-<area shape="rect" id="node2_16" href="googleapiclient.http.MediaIoBaseUpload-class.html#size" title="Size of upload." alt="" coords="224,160,392,180"/>
-<area shape="rect" id="node2_17" href="googleapiclient.http.MediaIoBaseUpload-class.html#resumable" title="Whether this upload is resumable." alt="" coords="224,180,392,200"/>
-<area shape="rect" id="node2_18" href="googleapiclient.http.MediaIoBaseUpload-class.html#getbytes" title="Get bytes from the media." alt="" coords="224,200,392,220"/>
-<area shape="rect" id="node2_19" href="googleapiclient.http.MediaIoBaseUpload-class.html#has_stream" title="Does the underlying upload support a streaming interface." alt="" coords="224,220,392,240"/>
-<area shape="rect" id="node2_20" href="googleapiclient.http.MediaIoBaseUpload-class.html#stream" title="A stream interface to the data being uploaded." alt="" coords="224,240,392,260"/>
-<area shape="rect" id="node2" href="googleapiclient.http.MediaIoBaseUpload-class.html" title="A MediaUpload for a io.Base objects." alt="" coords="212,86,404,266"/>
-<area shape="rect" id="node3_21" href="googleapiclient.http.MediaUpload-class.html#new_from_json" title="Utility class method to instantiate a MediaUpload subclass from a JSON representation produced by to_json()." alt="" coords="240,40,376,60"/>
-<area shape="rect" id="node3" href="googleapiclient.http.MediaUpload-class.html" title="Describes a media object to upload." alt="" coords="228,6,388,66"/>
+<area shape="rect" id="node1_11" href="googleapiclient.http.MediaFileUpload-class.html#__init__" title="Constructor." alt="" coords="17,297,596,316"/>
+<area shape="rect" id="node1_12" href="googleapiclient.http.MediaFileUpload-class.html#to_json" title="Creating a JSON representation of an instance of MediaFileUpload." alt="" coords="17,316,596,335"/>
+<area shape="rect" id="node1_13" href="googleapiclient.http.MediaFileUpload-class.html#from_json" title="googleapiclient.http.MediaFileUpload.from_json" alt="" coords="17,335,596,353"/>
+<area shape="rect" id="node1" href="googleapiclient.http.MediaFileUpload-class.html" title="A MediaUpload for a file." alt="" coords="5,267,608,360"/>
+<area shape="rect" id="node2_14" href="googleapiclient.http.MediaIoBaseUpload-class.html#chunksize" title="Chunk size for resumable uploads." alt="" coords="223,111,391,129"/>
+<area shape="rect" id="node2_15" href="googleapiclient.http.MediaIoBaseUpload-class.html#mimetype" title="Mime type of the body." alt="" coords="223,129,391,148"/>
+<area shape="rect" id="node2_16" href="googleapiclient.http.MediaIoBaseUpload-class.html#size" title="Size of upload." alt="" coords="223,148,391,167"/>
+<area shape="rect" id="node2_17" href="googleapiclient.http.MediaIoBaseUpload-class.html#resumable" title="Whether this upload is resumable." alt="" coords="223,167,391,185"/>
+<area shape="rect" id="node2_18" href="googleapiclient.http.MediaIoBaseUpload-class.html#getbytes" title="Get bytes from the media." alt="" coords="223,185,391,204"/>
+<area shape="rect" id="node2_19" href="googleapiclient.http.MediaIoBaseUpload-class.html#has_stream" title="Does the underlying upload support a streaming interface." alt="" coords="223,204,391,223"/>
+<area shape="rect" id="node2_20" href="googleapiclient.http.MediaIoBaseUpload-class.html#stream" title="A stream interface to the data being uploaded." alt="" coords="223,223,391,241"/>
+<area shape="rect" id="node2" href="googleapiclient.http.MediaIoBaseUpload-class.html" title="A MediaUpload for a io.Base objects." alt="" coords="211,80,403,248"/>
+<area shape="rect" id="node3_21" href="googleapiclient.http.MediaUpload-class.html#new_from_json" title="Utility class method to instantiate a MediaUpload subclass from a JSON representation produced by to_json()." alt="" coords="239,36,373,55"/>
+<area shape="rect" id="node3" href="googleapiclient.http.MediaUpload-class.html" title="Describes a media object to upload." alt="" coords="226,5,385,61"/>
 </map>
   <img src="uml_class_diagram_for_googleap_30.gif" alt='' usemap="#uml_class_diagram_for_googleap_30" ismap="ismap" class="graph-without-title" />
 </center>
@@ -392,7 +392,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">to_json</span>(<span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.MediaInMemoryUpload-class.html b/docs/epy/googleapiclient.http.MediaInMemoryUpload-class.html
index 2a2c89721db..193854fd5a5 100644
--- a/docs/epy/googleapiclient.http.MediaInMemoryUpload-class.html
+++ b/docs/epy/googleapiclient.http.MediaInMemoryUpload-class.html
@@ -59,19 +59,19 @@
 <h1 class="epydoc">Class MediaInMemoryUpload</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#MediaInMemoryUpload">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_31" name="uml_class_diagram_for_googleap_31">
-<area shape="rect" id="node1_10" href="googleapiclient.http.MediaInMemoryUpload-class.html#__init__" title="Create a new MediaInMemoryUpload." alt="" coords="17,339,689,359"/>
-<area shape="rect" id="node1" href="googleapiclient.http.MediaInMemoryUpload-class.html" title="MediaUpload for a chunk of bytes." alt="" coords="5,305,701,365"/>
-<area shape="rect" id="node2_11" href="googleapiclient.http.MediaIoBaseUpload-class.html#chunksize" title="Chunk size for resumable uploads." alt="" coords="269,119,437,139"/>
-<area shape="rect" id="node2_12" href="googleapiclient.http.MediaIoBaseUpload-class.html#mimetype" title="Mime type of the body." alt="" coords="269,139,437,159"/>
-<area shape="rect" id="node2_13" href="googleapiclient.http.MediaIoBaseUpload-class.html#size" title="Size of upload." alt="" coords="269,159,437,179"/>
-<area shape="rect" id="node2_14" href="googleapiclient.http.MediaIoBaseUpload-class.html#resumable" title="Whether this upload is resumable." alt="" coords="269,179,437,199"/>
-<area shape="rect" id="node2_15" href="googleapiclient.http.MediaIoBaseUpload-class.html#getbytes" title="Get bytes from the media." alt="" coords="269,199,437,219"/>
-<area shape="rect" id="node2_16" href="googleapiclient.http.MediaIoBaseUpload-class.html#has_stream" title="Does the underlying upload support a streaming interface." alt="" coords="269,219,437,239"/>
-<area shape="rect" id="node2_17" href="googleapiclient.http.MediaIoBaseUpload-class.html#stream" title="A stream interface to the data being uploaded." alt="" coords="269,239,437,259"/>
-<area shape="rect" id="node2_18" href="googleapiclient.http.MediaIoBaseUpload-class.html#to_json" title="This upload type is not serializable." alt="" coords="269,259,437,279"/>
-<area shape="rect" id="node2" href="googleapiclient.http.MediaIoBaseUpload-class.html" title="A MediaUpload for a io.Base objects." alt="" coords="257,85,449,285"/>
-<area shape="rect" id="node3_19" href="googleapiclient.http.MediaUpload-class.html#new_from_json" title="Utility class method to instantiate a MediaUpload subclass from a JSON representation produced by to_json()." alt="" coords="285,40,421,60"/>
-<area shape="rect" id="node3" href="googleapiclient.http.MediaUpload-class.html" title="Describes a media object to upload." alt="" coords="273,6,433,66"/>
+<area shape="rect" id="node1_10" href="googleapiclient.http.MediaInMemoryUpload-class.html#__init__" title="Create a new MediaInMemoryUpload." alt="" coords="17,316,689,335"/>
+<area shape="rect" id="node1" href="googleapiclient.http.MediaInMemoryUpload-class.html" title="MediaUpload for a chunk of bytes." alt="" coords="5,285,701,341"/>
+<area shape="rect" id="node2_11" href="googleapiclient.http.MediaIoBaseUpload-class.html#chunksize" title="Chunk size for resumable uploads." alt="" coords="269,111,437,129"/>
+<area shape="rect" id="node2_12" href="googleapiclient.http.MediaIoBaseUpload-class.html#mimetype" title="Mime type of the body." alt="" coords="269,129,437,148"/>
+<area shape="rect" id="node2_13" href="googleapiclient.http.MediaIoBaseUpload-class.html#size" title="Size of upload." alt="" coords="269,148,437,167"/>
+<area shape="rect" id="node2_14" href="googleapiclient.http.MediaIoBaseUpload-class.html#resumable" title="Whether this upload is resumable." alt="" coords="269,167,437,185"/>
+<area shape="rect" id="node2_15" href="googleapiclient.http.MediaIoBaseUpload-class.html#getbytes" title="Get bytes from the media." alt="" coords="269,185,437,204"/>
+<area shape="rect" id="node2_16" href="googleapiclient.http.MediaIoBaseUpload-class.html#has_stream" title="Does the underlying upload support a streaming interface." alt="" coords="269,204,437,223"/>
+<area shape="rect" id="node2_17" href="googleapiclient.http.MediaIoBaseUpload-class.html#stream" title="A stream interface to the data being uploaded." alt="" coords="269,223,437,241"/>
+<area shape="rect" id="node2_18" href="googleapiclient.http.MediaIoBaseUpload-class.html#to_json" title="This upload type is not serializable." alt="" coords="269,241,437,260"/>
+<area shape="rect" id="node2" href="googleapiclient.http.MediaIoBaseUpload-class.html" title="A MediaUpload for a io.Base objects." alt="" coords="257,80,449,267"/>
+<area shape="rect" id="node3_19" href="googleapiclient.http.MediaUpload-class.html#new_from_json" title="Utility class method to instantiate a MediaUpload subclass from a JSON representation produced by to_json()." alt="" coords="285,36,420,55"/>
+<area shape="rect" id="node3" href="googleapiclient.http.MediaUpload-class.html" title="Describes a media object to upload." alt="" coords="273,5,431,61"/>
 </map>
   <img src="uml_class_diagram_for_googleap_31.gif" alt='' usemap="#uml_class_diagram_for_googleap_31" ismap="ismap" class="graph-without-title" />
 </center>
@@ -297,7 +297,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.MediaIoBaseDownload-class.html b/docs/epy/googleapiclient.http.MediaIoBaseDownload-class.html
index 2bab3587376..548be0b1f28 100644
--- a/docs/epy/googleapiclient.http.MediaIoBaseDownload-class.html
+++ b/docs/epy/googleapiclient.http.MediaIoBaseDownload-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class MediaIoBaseDownload</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#MediaIoBaseDownload">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_32" name="uml_class_diagram_for_googleap_32">
-<area shape="rect" id="node1_2" href="googleapiclient.http.MediaIoBaseDownload-class.html#__init__" title="Constructor." alt="" coords="17,39,397,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.http.MediaIoBaseDownload-class.html#next_chunk" title="Get the next chunk of the download." alt="" coords="17,59,397,79"/>
-<area shape="rect" id="node1" href="googleapiclient.http.MediaIoBaseDownload-class.html" title="&quot;Download media resources." alt="" coords="5,5,409,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.http.MediaIoBaseDownload-class.html#__init__" title="Constructor." alt="" coords="18,36,395,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http.MediaIoBaseDownload-class.html#next_chunk" title="Get the next chunk of the download." alt="" coords="18,55,395,73"/>
+<area shape="rect" id="node1" href="googleapiclient.http.MediaIoBaseDownload-class.html" title="&quot;Download media resources." alt="" coords="5,5,407,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_32.gif" alt='' usemap="#uml_class_diagram_for_googleap_32" ismap="ismap" class="graph-without-title" />
 </center>
@@ -314,7 +314,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">next_chunk</span>(<s
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.MediaIoBaseUpload-class.html b/docs/epy/googleapiclient.http.MediaIoBaseUpload-class.html
index 419f3900b73..3c938a5fb07 100644
--- a/docs/epy/googleapiclient.http.MediaIoBaseUpload-class.html
+++ b/docs/epy/googleapiclient.http.MediaIoBaseUpload-class.html
@@ -59,18 +59,18 @@
 <h1 class="epydoc">Class MediaIoBaseUpload</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#MediaIoBaseUpload">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_33" name="uml_class_diagram_for_googleap_33">
-<area shape="rect" id="node1_10" href="googleapiclient.http.MediaIoBaseUpload-class.html#__init__" title="Constructor." alt="" coords="17,120,520,140"/>
-<area shape="rect" id="node1_11" href="googleapiclient.http.MediaIoBaseUpload-class.html#chunksize" title="Chunk size for resumable uploads." alt="" coords="17,140,520,160"/>
-<area shape="rect" id="node1_12" href="googleapiclient.http.MediaIoBaseUpload-class.html#mimetype" title="Mime type of the body." alt="" coords="17,160,520,180"/>
-<area shape="rect" id="node1_13" href="googleapiclient.http.MediaIoBaseUpload-class.html#size" title="Size of upload." alt="" coords="17,180,520,200"/>
-<area shape="rect" id="node1_14" href="googleapiclient.http.MediaIoBaseUpload-class.html#resumable" title="Whether this upload is resumable." alt="" coords="17,200,520,220"/>
-<area shape="rect" id="node1_15" href="googleapiclient.http.MediaIoBaseUpload-class.html#getbytes" title="Get bytes from the media." alt="" coords="17,220,520,240"/>
-<area shape="rect" id="node1_16" href="googleapiclient.http.MediaIoBaseUpload-class.html#has_stream" title="Does the underlying upload support a streaming interface." alt="" coords="17,240,520,260"/>
-<area shape="rect" id="node1_17" href="googleapiclient.http.MediaIoBaseUpload-class.html#stream" title="A stream interface to the data being uploaded." alt="" coords="17,260,520,280"/>
-<area shape="rect" id="node1_18" href="googleapiclient.http.MediaIoBaseUpload-class.html#to_json" title="This upload type is not serializable." alt="" coords="17,280,520,300"/>
-<area shape="rect" id="node1" href="googleapiclient.http.MediaIoBaseUpload-class.html" title="A MediaUpload for a io.Base objects." alt="" coords="5,86,531,306"/>
-<area shape="rect" id="node2_19" href="googleapiclient.http.MediaUpload-class.html#new_from_json" title="Utility class method to instantiate a MediaUpload subclass from a JSON representation produced by to_json()." alt="" coords="201,40,337,60"/>
-<area shape="rect" id="node2" href="googleapiclient.http.MediaUpload-class.html" title="Describes a media object to upload." alt="" coords="189,6,349,66"/>
+<area shape="rect" id="node1_10" href="googleapiclient.http.MediaIoBaseUpload-class.html#__init__" title="Constructor." alt="" coords="18,111,518,129"/>
+<area shape="rect" id="node1_11" href="googleapiclient.http.MediaIoBaseUpload-class.html#chunksize" title="Chunk size for resumable uploads." alt="" coords="18,129,518,148"/>
+<area shape="rect" id="node1_12" href="googleapiclient.http.MediaIoBaseUpload-class.html#mimetype" title="Mime type of the body." alt="" coords="18,148,518,167"/>
+<area shape="rect" id="node1_13" href="googleapiclient.http.MediaIoBaseUpload-class.html#size" title="Size of upload." alt="" coords="18,167,518,185"/>
+<area shape="rect" id="node1_14" href="googleapiclient.http.MediaIoBaseUpload-class.html#resumable" title="Whether this upload is resumable." alt="" coords="18,185,518,204"/>
+<area shape="rect" id="node1_15" href="googleapiclient.http.MediaIoBaseUpload-class.html#getbytes" title="Get bytes from the media." alt="" coords="18,204,518,223"/>
+<area shape="rect" id="node1_16" href="googleapiclient.http.MediaIoBaseUpload-class.html#has_stream" title="Does the underlying upload support a streaming interface." alt="" coords="18,223,518,241"/>
+<area shape="rect" id="node1_17" href="googleapiclient.http.MediaIoBaseUpload-class.html#stream" title="A stream interface to the data being uploaded." alt="" coords="18,241,518,260"/>
+<area shape="rect" id="node1_18" href="googleapiclient.http.MediaIoBaseUpload-class.html#to_json" title="This upload type is not serializable." alt="" coords="18,260,518,279"/>
+<area shape="rect" id="node1" href="googleapiclient.http.MediaIoBaseUpload-class.html" title="A MediaUpload for a io.Base objects." alt="" coords="5,80,529,285"/>
+<area shape="rect" id="node2_19" href="googleapiclient.http.MediaUpload-class.html#new_from_json" title="Utility class method to instantiate a MediaUpload subclass from a JSON representation produced by to_json()." alt="" coords="201,36,335,55"/>
+<area shape="rect" id="node2" href="googleapiclient.http.MediaUpload-class.html" title="Describes a media object to upload." alt="" coords="188,5,347,61"/>
 </map>
   <img src="uml_class_diagram_for_googleap_33.gif" alt='' usemap="#uml_class_diagram_for_googleap_33" ismap="ismap" class="graph-without-title" />
 </center>
@@ -674,7 +674,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">to_json</span>(<span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.MediaUpload-class.html b/docs/epy/googleapiclient.http.MediaUpload-class.html
index e90d6db4333..1386a80dc97 100644
--- a/docs/epy/googleapiclient.http.MediaUpload-class.html
+++ b/docs/epy/googleapiclient.http.MediaUpload-class.html
@@ -59,16 +59,16 @@
 <h1 class="epydoc">Class MediaUpload</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#MediaUpload">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_34" name="uml_class_diagram_for_googleap_34">
-<area shape="rect" id="node1_9" href="googleapiclient.http.MediaUpload-class.html#chunksize" title="Chunk size for resumable uploads." alt="" coords="17,40,172,60"/>
-<area shape="rect" id="node1_10" href="googleapiclient.http.MediaUpload-class.html#mimetype" title="Mime type of the body." alt="" coords="17,60,172,80"/>
-<area shape="rect" id="node1_11" href="googleapiclient.http.MediaUpload-class.html#size" title="Size of upload." alt="" coords="17,80,172,100"/>
-<area shape="rect" id="node1_12" href="googleapiclient.http.MediaUpload-class.html#resumable" title="Whether this upload is resumable." alt="" coords="17,100,172,120"/>
-<area shape="rect" id="node1_13" href="googleapiclient.http.MediaUpload-class.html#getbytes" title="Get bytes from the media." alt="" coords="17,120,172,140"/>
-<area shape="rect" id="node1_14" href="googleapiclient.http.MediaUpload-class.html#has_stream" title="Does the underlying upload support a streaming interface." alt="" coords="17,140,172,160"/>
-<area shape="rect" id="node1_15" href="googleapiclient.http.MediaUpload-class.html#stream" title="A stream interface to the data being uploaded." alt="" coords="17,160,172,180"/>
-<area shape="rect" id="node1_16" href="googleapiclient.http.MediaUpload-class.html#to_json" title="Create a JSON representation of an instance of MediaUpload." alt="" coords="17,180,172,200"/>
-<area shape="rect" id="node1_17" href="googleapiclient.http.MediaUpload-class.html#new_from_json" title="Utility class method to instantiate a MediaUpload subclass from a JSON representation produced by to_json()." alt="" coords="17,200,172,220"/>
-<area shape="rect" id="node1" href="googleapiclient.http.MediaUpload-class.html" title="Describes a media object to upload." alt="" coords="5,6,184,226"/>
+<area shape="rect" id="node1_9" href="googleapiclient.http.MediaUpload-class.html#chunksize" title="Chunk size for resumable uploads." alt="" coords="17,36,172,55"/>
+<area shape="rect" id="node1_10" href="googleapiclient.http.MediaUpload-class.html#mimetype" title="Mime type of the body." alt="" coords="17,55,172,73"/>
+<area shape="rect" id="node1_11" href="googleapiclient.http.MediaUpload-class.html#size" title="Size of upload." alt="" coords="17,73,172,92"/>
+<area shape="rect" id="node1_12" href="googleapiclient.http.MediaUpload-class.html#resumable" title="Whether this upload is resumable." alt="" coords="17,92,172,111"/>
+<area shape="rect" id="node1_13" href="googleapiclient.http.MediaUpload-class.html#getbytes" title="Get bytes from the media." alt="" coords="17,111,172,129"/>
+<area shape="rect" id="node1_14" href="googleapiclient.http.MediaUpload-class.html#has_stream" title="Does the underlying upload support a streaming interface." alt="" coords="17,129,172,148"/>
+<area shape="rect" id="node1_15" href="googleapiclient.http.MediaUpload-class.html#stream" title="A stream interface to the data being uploaded." alt="" coords="17,148,172,167"/>
+<area shape="rect" id="node1_16" href="googleapiclient.http.MediaUpload-class.html#to_json" title="Create a JSON representation of an instance of MediaUpload." alt="" coords="17,167,172,185"/>
+<area shape="rect" id="node1_17" href="googleapiclient.http.MediaUpload-class.html#new_from_json" title="Utility class method to instantiate a MediaUpload subclass from a JSON representation produced by to_json()." alt="" coords="17,185,172,204"/>
+<area shape="rect" id="node1" href="googleapiclient.http.MediaUpload-class.html" title="Describes a media object to upload." alt="" coords="5,5,184,211"/>
 </map>
   <img src="uml_class_diagram_for_googleap_34.gif" alt='' usemap="#uml_class_diagram_for_googleap_34" ismap="ismap" class="graph-without-title" />
 </center>
@@ -681,7 +681,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">new_from_json</span>
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:04 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.MediaUploadProgress-class.html b/docs/epy/googleapiclient.http.MediaUploadProgress-class.html
index 302b2e4de94..939e7471998 100644
--- a/docs/epy/googleapiclient.http.MediaUploadProgress-class.html
+++ b/docs/epy/googleapiclient.http.MediaUploadProgress-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class MediaUploadProgress</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#MediaUploadProgress">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_35" name="uml_class_diagram_for_googleap_35">
-<area shape="rect" id="node1_2" href="googleapiclient.http.MediaUploadProgress-class.html#__init__" title="Constructor." alt="" coords="17,39,288,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.http.MediaUploadProgress-class.html#progress" title="Percent of upload completed, as a float." alt="" coords="17,59,288,79"/>
-<area shape="rect" id="node1" href="googleapiclient.http.MediaUploadProgress-class.html" title="Status of a resumable upload." alt="" coords="5,5,299,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.http.MediaUploadProgress-class.html#__init__" title="Constructor." alt="" coords="18,36,291,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http.MediaUploadProgress-class.html#progress" title="Percent of upload completed, as a float." alt="" coords="18,55,291,73"/>
+<area shape="rect" id="node1" href="googleapiclient.http.MediaUploadProgress-class.html" title="Status of a resumable upload." alt="" coords="5,5,303,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_35.gif" alt='' usemap="#uml_class_diagram_for_googleap_35" ismap="ismap" class="graph-without-title" />
 </center>
@@ -273,7 +273,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">progress</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http.RequestMockBuilder-class.html b/docs/epy/googleapiclient.http.RequestMockBuilder-class.html
index ae2fc97c609..2901f476cc5 100644
--- a/docs/epy/googleapiclient.http.RequestMockBuilder-class.html
+++ b/docs/epy/googleapiclient.http.RequestMockBuilder-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class RequestMockBuilder</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#RequestMockBuilder">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_36" name="uml_class_diagram_for_googleap_36">
-<area shape="rect" id="node1_2" href="googleapiclient.http.RequestMockBuilder-class.html#__init__" title="Constructor for RequestMockBuilder" alt="" coords="17,39,680,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.http.RequestMockBuilder-class.html#__call__" title="Implements the callable interface that discovery.build() expects of requestBuilder, which is to build an object compatible with HttpRequest.execute()." alt="" coords="17,59,680,79"/>
-<area shape="rect" id="node1" href="googleapiclient.http.RequestMockBuilder-class.html" title="A simple mock of HttpRequest" alt="" coords="5,5,691,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.http.RequestMockBuilder-class.html#__init__" title="Constructor for RequestMockBuilder" alt="" coords="17,36,687,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http.RequestMockBuilder-class.html#__call__" title="Implements the callable interface that discovery.build() expects of requestBuilder, which is to build an object compatible with HttpRequest.execute()." alt="" coords="17,55,687,73"/>
+<area shape="rect" id="node1" href="googleapiclient.http.RequestMockBuilder-class.html" title="A simple mock of HttpRequest" alt="" coords="5,5,699,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_36.gif" alt='' usemap="#uml_class_diagram_for_googleap_36" ismap="ismap" class="graph-without-title" />
 </center>
@@ -319,7 +319,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">__call__</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.http._StreamSlice-class.html b/docs/epy/googleapiclient.http._StreamSlice-class.html
index 6a5ba8807c5..32dc7f27549 100644
--- a/docs/epy/googleapiclient.http._StreamSlice-class.html
+++ b/docs/epy/googleapiclient.http._StreamSlice-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class _StreamSlice</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.http-pysrc.html#_StreamSlice">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_37" name="uml_class_diagram_for_googleap_37">
-<area shape="rect" id="node1_2" href="googleapiclient.http._StreamSlice-class.html#__init__" title="Constructor." alt="" coords="17,39,253,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.http._StreamSlice-class.html#read" title="Read n bytes." alt="" coords="17,59,253,79"/>
-<area shape="rect" id="node1" href="googleapiclient.http._StreamSlice-class.html" title="Truncated stream." alt="" coords="5,5,265,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.http._StreamSlice-class.html#__init__" title="Constructor." alt="" coords="18,36,254,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.http._StreamSlice-class.html#read" title="Read n bytes." alt="" coords="18,55,254,73"/>
+<area shape="rect" id="node1" href="googleapiclient.http._StreamSlice-class.html" title="Truncated stream." alt="" coords="5,5,265,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_37.gif" alt='' usemap="#uml_class_diagram_for_googleap_37" ismap="ismap" class="graph-without-title" />
 </center>
@@ -285,7 +285,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">read</span>(<span cl
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.mimeparse-module.html b/docs/epy/googleapiclient.mimeparse-module.html
index 456b534d790..c2d92e03b3e 100644
--- a/docs/epy/googleapiclient.mimeparse-module.html
+++ b/docs/epy/googleapiclient.mimeparse-module.html
@@ -490,7 +490,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">best_match</span>(<s
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.mimeparse-pysrc.html b/docs/epy/googleapiclient.mimeparse-pysrc.html
index 30b03e781c1..b55b8d5685f 100644
--- a/docs/epy/googleapiclient.mimeparse-pysrc.html
+++ b/docs/epy/googleapiclient.mimeparse-pysrc.html
@@ -264,7 +264,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.mimeparse-module.htm
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:51 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.model-module.html b/docs/epy/googleapiclient.model-module.html
index b2fe8f82270..9029b087958 100644
--- a/docs/epy/googleapiclient.model-module.html
+++ b/docs/epy/googleapiclient.model-module.html
@@ -306,7 +306,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">makepatch</span>(<sp
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.model-pysrc.html b/docs/epy/googleapiclient.model-pysrc.html
index ae0f007ca82..552c5c6dc4b 100644
--- a/docs/epy/googleapiclient.model-pysrc.html
+++ b/docs/epy/googleapiclient.model-pysrc.html
@@ -635,7 +635,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.model-module.html">M
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:51 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.model.BaseModel-class.html b/docs/epy/googleapiclient.model.BaseModel-class.html
index a6fbe3e5ccc..5a01c9582cf 100644
--- a/docs/epy/googleapiclient.model.BaseModel-class.html
+++ b/docs/epy/googleapiclient.model.BaseModel-class.html
@@ -59,16 +59,16 @@
 <h1 class="epydoc">Class BaseModel</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.model-pysrc.html#BaseModel">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_38" name="uml_class_diagram_for_googleap_38">
-<area shape="rect" id="node1_8" href="googleapiclient.model.BaseModel-class.html#accept" title="googleapiclient.model.BaseModel.accept" alt="" coords="17,95,397,115"/>
-<area shape="rect" id="node1_9" href="googleapiclient.model.BaseModel-class.html#content_type" title="googleapiclient.model.BaseModel.content_type" alt="" coords="17,115,397,135"/>
-<area shape="rect" id="node1_10" href="googleapiclient.model.BaseModel-class.html#no_content_response" title="googleapiclient.model.BaseModel.no_content_response" alt="" coords="17,135,397,155"/>
-<area shape="rect" id="node1_11" href="googleapiclient.model.BaseModel-class.html#alt_param" title="googleapiclient.model.BaseModel.alt_param" alt="" coords="17,155,397,175"/>
-<area shape="rect" id="node1_12" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="17,177,397,197"/>
-<area shape="rect" id="node1_13" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="17,197,397,217"/>
-<area shape="rect" id="node1_14" href="googleapiclient.model.BaseModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="17,217,397,237"/>
-<area shape="rect" id="node1_15" href="googleapiclient.model.BaseModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="17,237,397,257"/>
-<area shape="rect" id="node1" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,69,409,264"/>
-<area shape="rect" id="node2" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="177,5,239,51"/>
+<area shape="rect" id="node1_8" href="googleapiclient.model.BaseModel-class.html#accept" title="googleapiclient.model.BaseModel.accept" alt="" coords="18,89,406,108"/>
+<area shape="rect" id="node1_9" href="googleapiclient.model.BaseModel-class.html#content_type" title="googleapiclient.model.BaseModel.content_type" alt="" coords="18,108,406,127"/>
+<area shape="rect" id="node1_10" href="googleapiclient.model.BaseModel-class.html#no_content_response" title="googleapiclient.model.BaseModel.no_content_response" alt="" coords="18,127,406,145"/>
+<area shape="rect" id="node1_11" href="googleapiclient.model.BaseModel-class.html#alt_param" title="googleapiclient.model.BaseModel.alt_param" alt="" coords="18,145,406,164"/>
+<area shape="rect" id="node1_12" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="18,167,406,185"/>
+<area shape="rect" id="node1_13" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="18,185,406,204"/>
+<area shape="rect" id="node1_14" href="googleapiclient.model.BaseModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="18,204,406,223"/>
+<area shape="rect" id="node1_15" href="googleapiclient.model.BaseModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="18,223,406,241"/>
+<area shape="rect" id="node1" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,67,417,248"/>
+<area shape="rect" id="node2" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="181,5,241,48"/>
 </map>
   <img src="uml_class_diagram_for_googleap_38.gif" alt='' usemap="#uml_class_diagram_for_googleap_38" ismap="ismap" class="graph-without-title" />
 </center>
@@ -545,7 +545,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">deserialize</span>(<
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.model.JsonModel-class.html b/docs/epy/googleapiclient.model.JsonModel-class.html
index 88b26f40724..f58cfc6a614 100644
--- a/docs/epy/googleapiclient.model.JsonModel-class.html
+++ b/docs/epy/googleapiclient.model.JsonModel-class.html
@@ -59,18 +59,18 @@
 <h1 class="epydoc">Class JsonModel</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.model-pysrc.html#JsonModel">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_39" name="uml_class_diagram_for_googleap_39">
-<area shape="rect" id="node1_9" href="googleapiclient.model.JsonModel-class.html#accept" title="googleapiclient.model.JsonModel.accept" alt="" coords="104,195,312,215"/>
-<area shape="rect" id="node1_10" href="googleapiclient.model.JsonModel-class.html#content_type" title="googleapiclient.model.JsonModel.content_type" alt="" coords="104,215,312,235"/>
-<area shape="rect" id="node1_11" href="googleapiclient.model.JsonModel-class.html#alt_param" title="googleapiclient.model.JsonModel.alt_param" alt="" coords="104,235,312,255"/>
-<area shape="rect" id="node1_12" href="googleapiclient.model.JsonModel-class.html#__init__" title="Construct a JsonModel." alt="" coords="104,257,312,277"/>
-<area shape="rect" id="node1_13" href="googleapiclient.model.JsonModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="104,277,312,297"/>
-<area shape="rect" id="node1_14" href="googleapiclient.model.JsonModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="104,297,312,317"/>
-<area shape="rect" id="node1_15" href="googleapiclient.model.JsonModel-class.html#no_content_response" title="googleapiclient.model.JsonModel.no_content_response" alt="" coords="104,317,312,337"/>
-<area shape="rect" id="node1" href="googleapiclient.model.JsonModel-class.html" title="Model class for JSON." alt="" coords="92,169,324,343"/>
-<area shape="rect" id="node2_16" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="17,103,397,123"/>
-<area shape="rect" id="node2_17" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="17,123,397,143"/>
-<area shape="rect" id="node2" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,69,409,149"/>
-<area shape="rect" id="node3" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="177,5,239,51"/>
+<area shape="rect" id="node1_9" href="googleapiclient.model.JsonModel-class.html#accept" title="googleapiclient.model.JsonModel.accept" alt="" coords="107,183,318,201"/>
+<area shape="rect" id="node1_10" href="googleapiclient.model.JsonModel-class.html#content_type" title="googleapiclient.model.JsonModel.content_type" alt="" coords="107,201,318,220"/>
+<area shape="rect" id="node1_11" href="googleapiclient.model.JsonModel-class.html#alt_param" title="googleapiclient.model.JsonModel.alt_param" alt="" coords="107,220,318,239"/>
+<area shape="rect" id="node1_12" href="googleapiclient.model.JsonModel-class.html#__init__" title="Construct a JsonModel." alt="" coords="107,241,318,260"/>
+<area shape="rect" id="node1_13" href="googleapiclient.model.JsonModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="107,260,318,279"/>
+<area shape="rect" id="node1_14" href="googleapiclient.model.JsonModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="107,279,318,297"/>
+<area shape="rect" id="node1_15" href="googleapiclient.model.JsonModel-class.html#no_content_response" title="googleapiclient.model.JsonModel.no_content_response" alt="" coords="107,297,318,316"/>
+<area shape="rect" id="node1" href="googleapiclient.model.JsonModel-class.html" title="Model class for JSON." alt="" coords="95,160,330,323"/>
+<area shape="rect" id="node2_16" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="18,97,406,116"/>
+<area shape="rect" id="node2_17" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="18,116,406,135"/>
+<area shape="rect" id="node2" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,67,417,141"/>
+<area shape="rect" id="node3" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="181,5,241,48"/>
 </map>
   <img src="uml_class_diagram_for_googleap_39.gif" alt='' usemap="#uml_class_diagram_for_googleap_39" ismap="ismap" class="graph-without-title" />
 </center>
@@ -432,7 +432,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">no_content_response<
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.model.MediaModel-class.html b/docs/epy/googleapiclient.model.MediaModel-class.html
index 61dccffa488..5d1c41e26d9 100644
--- a/docs/epy/googleapiclient.model.MediaModel-class.html
+++ b/docs/epy/googleapiclient.model.MediaModel-class.html
@@ -59,19 +59,19 @@
 <h1 class="epydoc">Class MediaModel</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.model-pysrc.html#MediaModel">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_40" name="uml_class_diagram_for_googleap_40">
-<area shape="rect" id="node1_9" href="googleapiclient.model.MediaModel-class.html#accept" title="googleapiclient.model.MediaModel.accept" alt="" coords="128,293,288,313"/>
-<area shape="rect" id="node1_10" href="googleapiclient.model.MediaModel-class.html#content_type" title="googleapiclient.model.MediaModel.content_type" alt="" coords="128,313,288,333"/>
-<area shape="rect" id="node1_11" href="googleapiclient.model.MediaModel-class.html#alt_param" title="googleapiclient.model.MediaModel.alt_param" alt="" coords="128,333,288,353"/>
-<area shape="rect" id="node1_12" href="googleapiclient.model.MediaModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="128,356,288,376"/>
-<area shape="rect" id="node1_13" href="googleapiclient.model.MediaModel-class.html#no_content_response" title="googleapiclient.model.MediaModel.no_content_response" alt="" coords="128,376,288,396"/>
-<area shape="rect" id="node1" href="googleapiclient.model.MediaModel-class.html" title="Model class for requests that return Media." alt="" coords="116,267,300,402"/>
-<area shape="rect" id="node2_14" href="googleapiclient.model.JsonModel-class.html#__init__" title="Construct a JsonModel." alt="" coords="104,201,312,221"/>
-<area shape="rect" id="node2_15" href="googleapiclient.model.JsonModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="104,221,312,241"/>
-<area shape="rect" id="node2" href="googleapiclient.model.JsonModel-class.html" title="Model class for JSON." alt="" coords="92,168,324,248"/>
-<area shape="rect" id="node3_16" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="17,103,397,123"/>
-<area shape="rect" id="node3_17" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="17,123,397,143"/>
-<area shape="rect" id="node3" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,69,409,149"/>
-<area shape="rect" id="node4" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="177,5,239,51"/>
+<area shape="rect" id="node1_9" href="googleapiclient.model.MediaModel-class.html#accept" title="googleapiclient.model.MediaModel.accept" alt="" coords="131,276,294,295"/>
+<area shape="rect" id="node1_10" href="googleapiclient.model.MediaModel-class.html#content_type" title="googleapiclient.model.MediaModel.content_type" alt="" coords="131,295,294,313"/>
+<area shape="rect" id="node1_11" href="googleapiclient.model.MediaModel-class.html#alt_param" title="googleapiclient.model.MediaModel.alt_param" alt="" coords="131,313,294,332"/>
+<area shape="rect" id="node1_12" href="googleapiclient.model.MediaModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="131,335,294,353"/>
+<area shape="rect" id="node1_13" href="googleapiclient.model.MediaModel-class.html#no_content_response" title="googleapiclient.model.MediaModel.no_content_response" alt="" coords="131,353,294,372"/>
+<area shape="rect" id="node1" href="googleapiclient.model.MediaModel-class.html" title="Model class for requests that return Media." alt="" coords="119,253,306,379"/>
+<area shape="rect" id="node2_14" href="googleapiclient.model.JsonModel-class.html#__init__" title="Construct a JsonModel." alt="" coords="107,191,318,209"/>
+<area shape="rect" id="node2_15" href="googleapiclient.model.JsonModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="107,209,318,228"/>
+<area shape="rect" id="node2" href="googleapiclient.model.JsonModel-class.html" title="Model class for JSON." alt="" coords="95,160,330,235"/>
+<area shape="rect" id="node3_16" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="18,97,406,116"/>
+<area shape="rect" id="node3_17" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="18,116,406,135"/>
+<area shape="rect" id="node3" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,67,417,141"/>
+<area shape="rect" id="node4" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="181,5,241,48"/>
 </map>
   <img src="uml_class_diagram_for_googleap_40.gif" alt='' usemap="#uml_class_diagram_for_googleap_40" ismap="ismap" class="graph-without-title" />
 </center>
@@ -339,7 +339,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">no_content_response<
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.model.Model-class.html b/docs/epy/googleapiclient.model.Model-class.html
index 87c0d709cdb..9175a3a711d 100644
--- a/docs/epy/googleapiclient.model.Model-class.html
+++ b/docs/epy/googleapiclient.model.Model-class.html
@@ -59,9 +59,9 @@
 <h1 class="epydoc">Class Model</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.model-pysrc.html#Model">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_41" name="uml_class_diagram_for_googleap_41">
-<area shape="rect" id="node1_2" href="googleapiclient.model.Model-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="17,39,397,59"/>
-<area shape="rect" id="node1_3" href="googleapiclient.model.Model-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="17,59,397,79"/>
-<area shape="rect" id="node1" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="5,5,409,85"/>
+<area shape="rect" id="node1_2" href="googleapiclient.model.Model-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="18,36,406,55"/>
+<area shape="rect" id="node1_3" href="googleapiclient.model.Model-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="18,55,406,73"/>
+<area shape="rect" id="node1" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="5,5,417,80"/>
 </map>
   <img src="uml_class_diagram_for_googleap_41.gif" alt='' usemap="#uml_class_diagram_for_googleap_41" ismap="ismap" class="graph-without-title" />
 </center>
@@ -297,7 +297,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">response</span>(<spa
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.model.ProtocolBufferModel-class.html b/docs/epy/googleapiclient.model.ProtocolBufferModel-class.html
index 2149befab5b..9a44531cc03 100644
--- a/docs/epy/googleapiclient.model.ProtocolBufferModel-class.html
+++ b/docs/epy/googleapiclient.model.ProtocolBufferModel-class.html
@@ -59,18 +59,18 @@
 <h1 class="epydoc">Class ProtocolBufferModel</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.model-pysrc.html#ProtocolBufferModel">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_42" name="uml_class_diagram_for_googleap_42">
-<area shape="rect" id="node1_9" href="googleapiclient.model.ProtocolBufferModel-class.html#accept" title="googleapiclient.model.ProtocolBufferModel.accept" alt="" coords="120,195,296,215"/>
-<area shape="rect" id="node1_10" href="googleapiclient.model.ProtocolBufferModel-class.html#content_type" title="googleapiclient.model.ProtocolBufferModel.content_type" alt="" coords="120,215,296,235"/>
-<area shape="rect" id="node1_11" href="googleapiclient.model.ProtocolBufferModel-class.html#alt_param" title="googleapiclient.model.ProtocolBufferModel.alt_param" alt="" coords="120,235,296,255"/>
-<area shape="rect" id="node1_12" href="googleapiclient.model.ProtocolBufferModel-class.html#__init__" title="Constructs a ProtocolBufferModel." alt="" coords="120,257,296,277"/>
-<area shape="rect" id="node1_13" href="googleapiclient.model.ProtocolBufferModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="120,277,296,297"/>
-<area shape="rect" id="node1_14" href="googleapiclient.model.ProtocolBufferModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="120,297,296,317"/>
-<area shape="rect" id="node1_15" href="googleapiclient.model.ProtocolBufferModel-class.html#no_content_response" title="googleapiclient.model.ProtocolBufferModel.no_content_response" alt="" coords="120,317,296,337"/>
-<area shape="rect" id="node1" href="googleapiclient.model.ProtocolBufferModel-class.html" title="Model class for protocol buffers." alt="" coords="108,169,308,343"/>
-<area shape="rect" id="node2_16" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="17,103,397,123"/>
-<area shape="rect" id="node2_17" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="17,123,397,143"/>
-<area shape="rect" id="node2" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,69,409,149"/>
-<area shape="rect" id="node3" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="177,5,239,51"/>
+<area shape="rect" id="node1_9" href="googleapiclient.model.ProtocolBufferModel-class.html#accept" title="googleapiclient.model.ProtocolBufferModel.accept" alt="" coords="123,183,301,201"/>
+<area shape="rect" id="node1_10" href="googleapiclient.model.ProtocolBufferModel-class.html#content_type" title="googleapiclient.model.ProtocolBufferModel.content_type" alt="" coords="123,201,301,220"/>
+<area shape="rect" id="node1_11" href="googleapiclient.model.ProtocolBufferModel-class.html#alt_param" title="googleapiclient.model.ProtocolBufferModel.alt_param" alt="" coords="123,220,301,239"/>
+<area shape="rect" id="node1_12" href="googleapiclient.model.ProtocolBufferModel-class.html#__init__" title="Constructs a ProtocolBufferModel." alt="" coords="123,241,301,260"/>
+<area shape="rect" id="node1_13" href="googleapiclient.model.ProtocolBufferModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="123,260,301,279"/>
+<area shape="rect" id="node1_14" href="googleapiclient.model.ProtocolBufferModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="123,279,301,297"/>
+<area shape="rect" id="node1_15" href="googleapiclient.model.ProtocolBufferModel-class.html#no_content_response" title="googleapiclient.model.ProtocolBufferModel.no_content_response" alt="" coords="123,297,301,316"/>
+<area shape="rect" id="node1" href="googleapiclient.model.ProtocolBufferModel-class.html" title="Model class for protocol buffers." alt="" coords="111,160,312,323"/>
+<area shape="rect" id="node2_16" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="18,97,406,116"/>
+<area shape="rect" id="node2_17" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="18,116,406,135"/>
+<area shape="rect" id="node2" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,67,417,141"/>
+<area shape="rect" id="node3" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="181,5,241,48"/>
 </map>
   <img src="uml_class_diagram_for_googleap_42.gif" alt='' usemap="#uml_class_diagram_for_googleap_42" ismap="ismap" class="graph-without-title" />
 </center>
@@ -436,7 +436,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">no_content_response<
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.model.RawModel-class.html b/docs/epy/googleapiclient.model.RawModel-class.html
index 8d35f27091b..87a77241d72 100644
--- a/docs/epy/googleapiclient.model.RawModel-class.html
+++ b/docs/epy/googleapiclient.model.RawModel-class.html
@@ -59,19 +59,19 @@
 <h1 class="epydoc">Class RawModel</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.model-pysrc.html#RawModel">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_43" name="uml_class_diagram_for_googleap_43">
-<area shape="rect" id="node1_9" href="googleapiclient.model.RawModel-class.html#accept" title="googleapiclient.model.RawModel.accept" alt="" coords="128,293,288,313"/>
-<area shape="rect" id="node1_10" href="googleapiclient.model.RawModel-class.html#content_type" title="googleapiclient.model.RawModel.content_type" alt="" coords="128,313,288,333"/>
-<area shape="rect" id="node1_11" href="googleapiclient.model.RawModel-class.html#alt_param" title="googleapiclient.model.RawModel.alt_param" alt="" coords="128,333,288,353"/>
-<area shape="rect" id="node1_12" href="googleapiclient.model.RawModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="128,356,288,376"/>
-<area shape="rect" id="node1_13" href="googleapiclient.model.RawModel-class.html#no_content_response" title="googleapiclient.model.RawModel.no_content_response" alt="" coords="128,376,288,396"/>
-<area shape="rect" id="node1" href="googleapiclient.model.RawModel-class.html" title="Model class for requests that don&#39;t return JSON." alt="" coords="116,267,300,402"/>
-<area shape="rect" id="node2_14" href="googleapiclient.model.JsonModel-class.html#__init__" title="Construct a JsonModel." alt="" coords="104,201,312,221"/>
-<area shape="rect" id="node2_15" href="googleapiclient.model.JsonModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="104,221,312,241"/>
-<area shape="rect" id="node2" href="googleapiclient.model.JsonModel-class.html" title="Model class for JSON." alt="" coords="92,168,324,248"/>
-<area shape="rect" id="node3_16" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="17,103,397,123"/>
-<area shape="rect" id="node3_17" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="17,123,397,143"/>
-<area shape="rect" id="node3" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,69,409,149"/>
-<area shape="rect" id="node4" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="177,5,239,51"/>
+<area shape="rect" id="node1_9" href="googleapiclient.model.RawModel-class.html#accept" title="googleapiclient.model.RawModel.accept" alt="" coords="131,276,294,295"/>
+<area shape="rect" id="node1_10" href="googleapiclient.model.RawModel-class.html#content_type" title="googleapiclient.model.RawModel.content_type" alt="" coords="131,295,294,313"/>
+<area shape="rect" id="node1_11" href="googleapiclient.model.RawModel-class.html#alt_param" title="googleapiclient.model.RawModel.alt_param" alt="" coords="131,313,294,332"/>
+<area shape="rect" id="node1_12" href="googleapiclient.model.RawModel-class.html#deserialize" title="Perform the actual deserialization from response string to Python object." alt="" coords="131,335,294,353"/>
+<area shape="rect" id="node1_13" href="googleapiclient.model.RawModel-class.html#no_content_response" title="googleapiclient.model.RawModel.no_content_response" alt="" coords="131,353,294,372"/>
+<area shape="rect" id="node1" href="googleapiclient.model.RawModel-class.html" title="Model class for requests that don&#39;t return JSON." alt="" coords="119,253,306,379"/>
+<area shape="rect" id="node2_14" href="googleapiclient.model.JsonModel-class.html#__init__" title="Construct a JsonModel." alt="" coords="107,191,318,209"/>
+<area shape="rect" id="node2_15" href="googleapiclient.model.JsonModel-class.html#serialize" title="Perform the actual Python object serialization." alt="" coords="107,209,318,228"/>
+<area shape="rect" id="node2" href="googleapiclient.model.JsonModel-class.html" title="Model class for JSON." alt="" coords="95,160,330,235"/>
+<area shape="rect" id="node3_16" href="googleapiclient.model.BaseModel-class.html#request" title="Updates outgoing requests with a serialized body." alt="" coords="18,97,406,116"/>
+<area shape="rect" id="node3_17" href="googleapiclient.model.BaseModel-class.html#response" title="Convert the response wire format into a Python object." alt="" coords="18,116,406,135"/>
+<area shape="rect" id="node3" href="googleapiclient.model.BaseModel-class.html" title="Base model class." alt="" coords="5,67,417,141"/>
+<area shape="rect" id="node4" href="googleapiclient.model.Model-class.html" title="Model base class." alt="" coords="181,5,241,48"/>
 </map>
   <img src="uml_class_diagram_for_googleap_43.gif" alt='' usemap="#uml_class_diagram_for_googleap_43" ismap="ismap" class="graph-without-title" />
 </center>
@@ -339,7 +339,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">no_content_response<
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.sample_tools-module.html b/docs/epy/googleapiclient.sample_tools-module.html
index 84f10f248df..9aad11c1ef9 100644
--- a/docs/epy/googleapiclient.sample_tools-module.html
+++ b/docs/epy/googleapiclient.sample_tools-module.html
@@ -204,7 +204,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">init</span>(<span cl
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.sample_tools-pysrc.html b/docs/epy/googleapiclient.sample_tools-pysrc.html
index c7228adc82c..22c00067480 100644
--- a/docs/epy/googleapiclient.sample_tools-pysrc.html
+++ b/docs/epy/googleapiclient.sample_tools-pysrc.html
@@ -195,7 +195,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.sample_tools-module.
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:51 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.schema-module.html b/docs/epy/googleapiclient.schema-module.html
index 527428db725..f821a5acaba 100644
--- a/docs/epy/googleapiclient.schema-module.html
+++ b/docs/epy/googleapiclient.schema-module.html
@@ -167,7 +167,7 @@ <h1 class="epydoc">Module schema</h1><p class="nomargin-top"><span class="codeli
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.schema-pysrc.html b/docs/epy/googleapiclient.schema-pysrc.html
index c0955a577e6..caca21840ba 100644
--- a/docs/epy/googleapiclient.schema-pysrc.html
+++ b/docs/epy/googleapiclient.schema-pysrc.html
@@ -459,7 +459,7 @@ <h1 class="epydoc">Source Code for <a href="googleapiclient.schema-module.html">
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:06 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.schema.Schemas-class.html b/docs/epy/googleapiclient.schema.Schemas-class.html
index 3708da505db..025f7f23d93 100644
--- a/docs/epy/googleapiclient.schema.Schemas-class.html
+++ b/docs/epy/googleapiclient.schema.Schemas-class.html
@@ -59,11 +59,11 @@
 <h1 class="epydoc">Class Schemas</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.schema-pysrc.html#Schemas">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_44" name="uml_class_diagram_for_googleap_44">
-<area shape="rect" id="node1_4" href="googleapiclient.schema.Schemas-class.html#__init__" title="Constructor." alt="" coords="17,39,216,59"/>
-<area shape="rect" id="node1_5" href="googleapiclient.schema.Schemas-class.html#prettyPrintByName" title="Get pretty printed object prototype from the schema name." alt="" coords="17,59,216,79"/>
-<area shape="rect" id="node1_6" href="googleapiclient.schema.Schemas-class.html#prettyPrintSchema" title="Get pretty printed object prototype of schema." alt="" coords="17,79,216,99"/>
-<area shape="rect" id="node1_7" href="googleapiclient.schema.Schemas-class.html#get" title="Get deserialized JSON schema from the schema name." alt="" coords="17,99,216,119"/>
-<area shape="rect" id="node1" href="googleapiclient.schema.Schemas-class.html" title="Schemas for an API." alt="" coords="5,5,227,125"/>
+<area shape="rect" id="node1_4" href="googleapiclient.schema.Schemas-class.html#__init__" title="Constructor." alt="" coords="18,36,217,55"/>
+<area shape="rect" id="node1_5" href="googleapiclient.schema.Schemas-class.html#prettyPrintByName" title="Get pretty printed object prototype from the schema name." alt="" coords="18,55,217,73"/>
+<area shape="rect" id="node1_6" href="googleapiclient.schema.Schemas-class.html#prettyPrintSchema" title="Get pretty printed object prototype of schema." alt="" coords="18,73,217,92"/>
+<area shape="rect" id="node1_7" href="googleapiclient.schema.Schemas-class.html#get" title="Get deserialized JSON schema from the schema name." alt="" coords="18,92,217,111"/>
+<area shape="rect" id="node1" href="googleapiclient.schema.Schemas-class.html" title="Schemas for an API." alt="" coords="5,5,228,117"/>
 </map>
   <img src="uml_class_diagram_for_googleap_44.gif" alt='' usemap="#uml_class_diagram_for_googleap_44" ismap="ismap" class="graph-without-title" />
 </center>
@@ -485,7 +485,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">get</span>(<span cla
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/googleapiclient.schema._SchemaToStruct-class.html b/docs/epy/googleapiclient.schema._SchemaToStruct-class.html
index 7f0176ad8c4..4dd17dcf00d 100644
--- a/docs/epy/googleapiclient.schema._SchemaToStruct-class.html
+++ b/docs/epy/googleapiclient.schema._SchemaToStruct-class.html
@@ -59,14 +59,14 @@
 <h1 class="epydoc">Class _SchemaToStruct</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.schema-pysrc.html#_SchemaToStruct">source&nbsp;code</a></span></p>
 <center>
 <center>  <map id="uml_class_diagram_for_googleap_45" name="uml_class_diagram_for_googleap_45">
-<area shape="rect" id="node1_7" href="googleapiclient.schema._SchemaToStruct-class.html#__init__" title="Constructor." alt="" coords="17,40,237,60"/>
-<area shape="rect" id="node1_8" href="googleapiclient.schema._SchemaToStruct-class.html#emit" title="Add text as a line to the output." alt="" coords="17,60,237,80"/>
-<area shape="rect" id="node1_9" href="googleapiclient.schema._SchemaToStruct-class.html#emitBegin" title="Add text to the output, but with no line terminator." alt="" coords="17,80,237,100"/>
-<area shape="rect" id="node1_10" href="googleapiclient.schema._SchemaToStruct-class.html#emitEnd" title="Add text and comment to the output with line terminator." alt="" coords="17,100,237,120"/>
-<area shape="rect" id="node1_11" href="googleapiclient.schema._SchemaToStruct-class.html#indent" title="Increase indentation level." alt="" coords="17,120,237,140"/>
-<area shape="rect" id="node1_12" href="googleapiclient.schema._SchemaToStruct-class.html#undent" title="Decrease indentation level." alt="" coords="17,140,237,160"/>
-<area shape="rect" id="node1_13" href="googleapiclient.schema._SchemaToStruct-class.html#to_str" title="Prototype object based on the schema, in Python code with comments." alt="" coords="17,160,237,180"/>
-<area shape="rect" id="node1" href="googleapiclient.schema._SchemaToStruct-class.html" title="Convert schema to a prototype object." alt="" coords="5,6,249,186"/>
+<area shape="rect" id="node1_7" href="googleapiclient.schema._SchemaToStruct-class.html#__init__" title="Constructor." alt="" coords="18,36,238,55"/>
+<area shape="rect" id="node1_8" href="googleapiclient.schema._SchemaToStruct-class.html#emit" title="Add text as a line to the output." alt="" coords="18,55,238,73"/>
+<area shape="rect" id="node1_9" href="googleapiclient.schema._SchemaToStruct-class.html#emitBegin" title="Add text to the output, but with no line terminator." alt="" coords="18,73,238,92"/>
+<area shape="rect" id="node1_10" href="googleapiclient.schema._SchemaToStruct-class.html#emitEnd" title="Add text and comment to the output with line terminator." alt="" coords="18,92,238,111"/>
+<area shape="rect" id="node1_11" href="googleapiclient.schema._SchemaToStruct-class.html#indent" title="Increase indentation level." alt="" coords="18,111,238,129"/>
+<area shape="rect" id="node1_12" href="googleapiclient.schema._SchemaToStruct-class.html#undent" title="Decrease indentation level." alt="" coords="18,129,238,148"/>
+<area shape="rect" id="node1_13" href="googleapiclient.schema._SchemaToStruct-class.html#to_str" title="Prototype object based on the schema, in Python code with comments." alt="" coords="18,148,238,167"/>
+<area shape="rect" id="node1" href="googleapiclient.schema._SchemaToStruct-class.html" title="Convert schema to a prototype object." alt="" coords="5,5,249,173"/>
 </map>
   <img src="uml_class_diagram_for_googleap_45.gif" alt='' usemap="#uml_class_diagram_for_googleap_45" ismap="ismap" class="graph-without-title" />
 </center>
@@ -509,7 +509,7 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">to_str</span>(<span
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:50 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:05 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/help.html b/docs/epy/help.html
index 3432247d7ea..1240626794d 100644
--- a/docs/epy/help.html
+++ b/docs/epy/help.html
@@ -246,7 +246,7 @@ <h2> The Navigation Bar </h2>
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/identifier-index.html b/docs/epy/identifier-index.html
index 92a80b8f345..09cdb2c0ca1 100644
--- a/docs/epy/identifier-index.html
+++ b/docs/epy/identifier-index.html
@@ -76,7 +76,7 @@ <h1 class="epydoc">Identifier Index</h1>
  <a href="#T">T</a>
  <a href="#U">U</a>
  <a href="#V">V</a>
-  W
+ <a href="#W">W</a>
  <a href="#X">X</a>
   Y
   Z
@@ -116,15 +116,16 @@ <h1 class="epydoc">Identifier Index</h1>
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.ProtocolBufferModel-class.html">ProtocolBufferModel</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.JsonModel-class.html#alt_param">alt_param</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.JsonModel-class.html">JsonModel</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache-module.html#autodetect">autodetect()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache-module.html">googleapiclient.discovery_cache</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient._auth-module.html#authorized_http">authorized_http()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient._auth-module.html">googleapiclient._auth</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.model.RawModel-class.html#accept">accept</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.RawModel-class.html">RawModel</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.MediaModel-class.html#alt_param">alt_param</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.MediaModel-class.html">MediaModel</a>)</span></td>
-<td width="33%" class="link-index">&nbsp;</td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache-module.html#autodetect">autodetect()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache-module.html">googleapiclient.discovery_cache</a>)</span></td>
 </tr>
 </table>
 </td></tr>
@@ -217,32 +218,38 @@ <h1 class="epydoc">Identifier Index</h1>
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.MediaModel-class.html#deserialize">deserialize()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.MediaModel-class.html">MediaModel</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache-module.html">discovery_cache</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient-module.html">googleapiclient</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache-module.html#DISCOVERY_DOC_MAX_AGE">DISCOVERY_DOC_MAX_AGE</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache-module.html">googleapiclient.discovery_cache</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#DEFAULT_METHOD_DOC">DEFAULT_METHOD_DOC</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient._auth-module.html#default_credentials">default_credentials()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient._auth-module.html">googleapiclient._auth</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.ProtocolBufferModel-class.html#deserialize">deserialize()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.ProtocolBufferModel-class.html">ProtocolBufferModel</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache-module.html#DISCOVERY_DOC_MAX_AGE">DISCOVERY_DOC_MAX_AGE</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache-module.html">googleapiclient.discovery_cache</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#DISCOVERY_URI">DISCOVERY_URI</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.model.BaseModel-class.html#deserialize">deserialize()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.model.BaseModel-class.html">BaseModel</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#DEFAULT_METHOD_DOC">DEFAULT_METHOD_DOC</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.RawModel-class.html#deserialize">deserialize()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.RawModel-class.html">RawModel</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#DISCOVERY_URI">DISCOVERY_URI</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.model-module.html#dump_request_response">dump_request_response</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.model-module.html">googleapiclient.model</a>)</span></td>
+</tr>
+<tr>
+<td width="33%" class="link-index"><a href="googleapiclient.model.BaseModel-class.html#deserialize">deserialize()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.model.BaseModel-class.html">BaseModel</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html">discovery</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient-module.html">googleapiclient</a>)</span></td>
+<td width="33%" class="link-index">&nbsp;</td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.model.JsonModel-class.html#deserialize">deserialize()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.JsonModel-class.html">JsonModel</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html">discovery</a><br />
+<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache-module.html">discovery_cache</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient-module.html">googleapiclient</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.model-module.html#dump_request_response">dump_request_response</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.model-module.html">googleapiclient.model</a>)</span></td>
+<td width="33%" class="link-index">&nbsp;</td>
 </tr>
 </table>
 </td></tr>
@@ -333,28 +340,35 @@ <h1 class="epydoc">Identifier Index</h1>
 <td valign="top">
 <table class="link-index" width="100%" border="1">
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.http.MediaIoBaseUpload-class.html#has_stream">has_stream()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaIoBaseUpload-class.html">MediaIoBaseUpload</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient._auth-module.html#HAS_GOOGLE_AUTH">HAS_GOOGLE_AUTH</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient._auth-module.html">googleapiclient._auth</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.http-module.html">http</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient-module.html">googleapiclient</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.http.HttpMockSequence-class.html">HttpMockSequence</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
+</tr>
+<tr>
+<td width="33%" class="link-index"><a href="googleapiclient._auth-module.html#HAS_OAUTH2CLIENT">HAS_OAUTH2CLIENT</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient._auth-module.html">googleapiclient._auth</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#HTTP_PAYLOAD_METHODS">HTTP_PAYLOAD_METHODS</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http.HttpMockSequence-class.html">HttpMockSequence</a><br />
+<td width="33%" class="link-index"><a href="googleapiclient.http.HttpRequest-class.html">HttpRequest</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.http.MediaUpload-class.html#has_stream">has_stream()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaUpload-class.html">MediaUpload</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.http.MediaIoBaseUpload-class.html#has_stream">has_stream()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaIoBaseUpload-class.html">MediaIoBaseUpload</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.errors.HttpError-class.html">HttpError</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.errors-module.html">googleapiclient.errors</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http.HttpRequest-class.html">HttpRequest</a><br />
+<td width="33%" class="link-index"><a href="googleapiclient.http.HttpRequestMock-class.html">HttpRequestMock</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.http-module.html">http</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient-module.html">googleapiclient</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.http.MediaUpload-class.html#has_stream">has_stream()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaUpload-class.html">MediaUpload</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http.HttpMock-class.html">HttpMock</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http.HttpRequestMock-class.html">HttpRequestMock</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
+<td width="33%" class="link-index">&nbsp;</td>
 </tr>
 </table>
 </td></tr>
@@ -720,6 +734,18 @@ <h1 class="epydoc">Identifier Index</h1>
 <tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
 </table>
 </td></tr>
+<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="W">W</a></h2></td>
+<td valign="top">
+<table class="link-index" width="100%" border="1">
+<tr>
+<td width="33%" class="link-index"><a href="googleapiclient._auth-module.html#with_scopes">with_scopes()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient._auth-module.html">googleapiclient._auth</a>)</span></td>
+<td width="33%" class="link-index">&nbsp;</td>
+<td width="33%" class="link-index">&nbsp;</td>
+</tr>
+<tr><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td><td class="link-index">&nbsp;</td></tr>
+</table>
+</td></tr>
 <tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="X">X</a></h2></td>
 <td valign="top">
 <table class="link-index" width="100%" border="1">
@@ -746,21 +772,13 @@ <h1 class="epydoc">Identifier Index</h1>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.RequestMockBuilder-class.html#__call__">__call__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.RequestMockBuilder-class.html">RequestMockBuilder</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http._StreamSlice-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.http._StreamSlice-class.html" onclick="show_private();">_StreamSlice</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.model.BaseModel-class.html#_log_response">_log_response()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.model.BaseModel-class.html">BaseModel</a>)</span></td>
-</tr>
-<tr>
-<td width="33%" class="link-index"><a href="googleapiclient.mimeparse-module.html#__credits__">__credits__</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.mimeparse-module.html">googleapiclient.mimeparse</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.JsonModel-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.JsonModel-class.html">JsonModel</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_media_path_url_from_info">_media_path_url_from_info()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.mimeparse-module.html#__email__">__email__</a><br />
+<td width="33%" class="link-index"><a href="googleapiclient.mimeparse-module.html#__credits__">__credits__</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.mimeparse-module.html">googleapiclient.mimeparse</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.ProtocolBufferModel-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.ProtocolBufferModel-class.html">ProtocolBufferModel</a>)</span></td>
@@ -768,99 +786,107 @@ <h1 class="epydoc">Identifier Index</h1>
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#__getstate__">__getstate__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.mimeparse-module.html#__email__">__email__</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.mimeparse-module.html">googleapiclient.mimeparse</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.schema.Schemas-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.schema.Schemas-class.html">Schemas</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_media_size_to_long">_media_size_to_long()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.channel.Channel-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.channel.Channel-class.html">Channel</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#__getstate__">__getstate__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.schema._SchemaToStruct-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.schema._SchemaToStruct-class.html" onclick="show_private();">_SchemaToStruct</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#_new_id">_new_id()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.channel.Notification-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.channel.Notification-class.html">Notification</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.channel.Channel-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.channel.Channel-class.html">Channel</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery_cache.base.Cache-class.html#__metaclass__">__metaclass__</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache.base.Cache-class.html">Cache</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.schema.Schemas-class.html#_prettyPrintByName">_prettyPrintByName()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.schema.Schemas-class.html">Schemas</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.channel.Notification-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.channel.Notification-class.html">Notification</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.errors.BatchError-class.html#__repr__">__repr__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.errors.BatchError-class.html">BatchError</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.schema.Schemas-class.html#_prettyPrintSchema">_prettyPrintSchema()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.schema.Schemas-class.html">Schemas</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery.ResourceMethodParameters-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.ResourceMethodParameters-class.html" onclick="show_private();">ResourceMethodParameters</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.errors.HttpError-class.html#__repr__">__repr__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.errors.HttpError-class.html">HttpError</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http.HttpRequest-class.html#_process_response">_process_response()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.HttpRequest-class.html">HttpRequest</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html">Cache</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery.ResourceMethodParameters-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.ResourceMethodParameters-class.html" onclick="show_private();">ResourceMethodParameters</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#__setstate__">__setstate__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery_cache.file_cache-module.html#_read_or_initialize_cache">_read_or_initialize_cache()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache.file_cache-module.html">googleapiclient.discovery_cache.file_cache</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache.file_cache.Cache-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache.file_cache.Cache-class.html">Cache</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache.appengine_memcache.Cache-class.html">Cache</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model-module.html#_abstract">_abstract()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model-module.html">googleapiclient.model</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#_refresh_and_apply_credentials">_refresh_and_apply_credentials()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.errors.BatchError-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.errors.BatchError-class.html">BatchError</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache.file_cache.Cache-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache.file_cache.Cache-class.html">Cache</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#_add_basic_methods">_add_basic_methods()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_retrieve_discovery_doc">_retrieve_discovery_doc()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.errors.HttpError-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.errors.HttpError-class.html">HttpError</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.errors.BatchError-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.errors.BatchError-class.html">BatchError</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#_add_nested_resources">_add_nested_resources()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http-module.html#_retry_request">_retry_request()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
 </tr>
 <tr>
-<td width="33%" class="link-index"><a href="googleapiclient.errors.UnexpectedBodyError-class.html#__init__">__init__()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.errors.UnexpectedBodyError-class.html">UnexpectedBodyError</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.errors.HttpError-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.errors.HttpError-class.html">HttpError</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#_add_next_methods">_add_next_methods()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.schema._SchemaToStruct-class.html">_SchemaToStruct</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.schema-module.html">googleapiclient.schema</a>)</span></td>
 </tr>
 <tr>
+<td width="33%" class="link-index"><a href="googleapiclient.errors.UnexpectedBodyError-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.errors.UnexpectedBodyError-class.html">UnexpectedBodyError</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient._auth-module.html">_auth</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient-module.html">googleapiclient</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#_serialize_request">_serialize_request()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
+</tr>
+<tr>
 <td width="33%" class="link-index"><a href="googleapiclient.errors.UnexpectedMethodError-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.errors.UnexpectedMethodError-class.html">UnexpectedMethodError</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.BaseModel-class.html#_build_query">_build_query()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.BaseModel-class.html">BaseModel</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#_serialize_request">_serialize_request()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#_set_dynamic_attr">_set_dynamic_attr()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery._BytesGenerator-class.html">_BytesGenerator</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#_set_dynamic_attr">_set_dynamic_attr()</a><br />
+<td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#_set_service_methods">_set_service_methods()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
 </tr>
 <tr>
@@ -868,15 +894,15 @@ <h1 class="epydoc">Identifier Index</h1>
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.HttpMock-class.html">HttpMock</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_cast">_cast()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery.Resource-class.html#_set_service_methods">_set_service_methods()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery.Resource-class.html" onclick="show_private();">Resource</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.http-module.html#_should_retry_response">_should_retry_response()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.HttpMockSequence-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.HttpMockSequence-class.html">HttpMockSequence</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#_deserialize_response">_deserialize_response()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http-module.html#_should_retry_response">_should_retry_response()</a><br />
+<td width="33%" class="link-index"><a href="googleapiclient.http-module.html#_ssl_SSLError">_ssl_SSLError</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
 </tr>
 <tr>
@@ -884,7 +910,7 @@ <h1 class="epydoc">Identifier Index</h1>
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.HttpRequest-class.html">HttpRequest</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#_execute">_execute()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http-module.html#_ssl_SSLError">_ssl_SSLError</a><br />
+<td width="33%" class="link-index"><a href="googleapiclient.http._StreamSlice-class.html">_StreamSlice</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
 </tr>
 <tr>
@@ -892,64 +918,70 @@ <h1 class="epydoc">Identifier Index</h1>
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.HttpRequestMock-class.html">HttpRequestMock</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.mimeparse-module.html#_filter_blank">_filter_blank()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.mimeparse-module.html">googleapiclient.mimeparse</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http._StreamSlice-class.html">_StreamSlice</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.http.MediaUpload-class.html#_to_json">_to_json()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaUpload-class.html">MediaUpload</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.MediaDownloadProgress-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaDownloadProgress-class.html">MediaDownloadProgress</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_fix_up_media_upload">_fix_up_media_upload()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http.MediaUpload-class.html#_to_json">_to_json()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaUpload-class.html">MediaUpload</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.schema._SchemaToStruct-class.html#_to_str_impl">_to_str_impl()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.schema._SchemaToStruct-class.html" onclick="show_private();">_SchemaToStruct</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.MediaFileUpload-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaFileUpload-class.html">MediaFileUpload</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_fix_up_method_description">_fix_up_method_description()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.schema._SchemaToStruct-class.html#_to_str_impl">_to_str_impl()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.schema._SchemaToStruct-class.html" onclick="show_private();">_SchemaToStruct</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache.file_cache-module.html#_to_timestamp">_to_timestamp()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache.file_cache-module.html">googleapiclient.discovery_cache.file_cache</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.MediaInMemoryUpload-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaInMemoryUpload-class.html">MediaInMemoryUpload</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_fix_up_parameters">_fix_up_parameters()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery_cache.file_cache-module.html#_to_timestamp">_to_timestamp()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery_cache.file_cache-module.html">googleapiclient.discovery_cache.file_cache</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.http-module.html#_TOO_MANY_REQUESTS">_TOO_MANY_REQUESTS</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.MediaIoBaseDownload-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaIoBaseDownload-class.html">MediaIoBaseDownload</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.errors.HttpError-class.html#_get_reason">_get_reason()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.errors.HttpError-class.html">HttpError</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.http-module.html#_TOO_MANY_REQUESTS">_TOO_MANY_REQUESTS</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.http-module.html">googleapiclient.http</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.channel-module.html#_upper_header_keys">_upper_header_keys()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.channel-module.html">googleapiclient.channel</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.MediaIoBaseUpload-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaIoBaseUpload-class.html">MediaIoBaseUpload</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#_header_to_id">_header_to_id()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.channel-module.html#_upper_header_keys">_upper_header_keys()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.channel-module.html">googleapiclient.channel</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_urljoin">_urljoin()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.MediaUploadProgress-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.MediaUploadProgress-class.html">MediaUploadProgress</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.http.BatchHttpRequest-class.html#_id_to_header">_id_to_header()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.BatchHttpRequest-class.html">BatchHttpRequest</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery-module.html#_urljoin">_urljoin()</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.discovery._BytesGenerator-class.html#_write_lines">_write_lines</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery._BytesGenerator-class.html" onclick="show_private();">_BytesGenerator</a>)</span></td>
 </tr>
 <tr>
 <td width="33%" class="link-index"><a href="googleapiclient.http.RequestMockBuilder-class.html#__init__">__init__()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.http.RequestMockBuilder-class.html">RequestMockBuilder</a>)</span></td>
 <td width="33%" class="link-index"><a href="googleapiclient.model.BaseModel-class.html#_log_request">_log_request()</a><br />
 <span class="index-where">(in&nbsp;<a href="googleapiclient.model.BaseModel-class.html">BaseModel</a>)</span></td>
-<td width="33%" class="link-index"><a href="googleapiclient.discovery._BytesGenerator-class.html#_write_lines">_write_lines</a><br />
-<span class="index-where">(in&nbsp;<a href="googleapiclient.discovery._BytesGenerator-class.html" onclick="show_private();">_BytesGenerator</a>)</span></td>
+<td width="33%" class="link-index">&nbsp;</td>
+</tr>
+<tr>
+<td width="33%" class="link-index"><a href="googleapiclient.http._StreamSlice-class.html#__init__">__init__()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.http._StreamSlice-class.html" onclick="show_private();">_StreamSlice</a>)</span></td>
+<td width="33%" class="link-index"><a href="googleapiclient.model.BaseModel-class.html#_log_response">_log_response()</a><br />
+<span class="index-where">(in&nbsp;<a href="googleapiclient.model.BaseModel-class.html">BaseModel</a>)</span></td>
+<td width="33%" class="link-index">&nbsp;</td>
 </tr>
 </table>
 </td></tr>
@@ -980,7 +1012,7 @@ <h1 class="epydoc">Identifier Index</h1>
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/module-tree.html b/docs/epy/module-tree.html
index bdb9f44af0c..fbaa6d16142 100644
--- a/docs/epy/module-tree.html
+++ b/docs/epy/module-tree.html
@@ -57,6 +57,7 @@ <h1 class="epydoc">Module Hierarchy</h1>
 <ul class="nomargin-top">
     <li> <strong class="uidlink"><a href="googleapiclient-module.html">googleapiclient</a></strong>
     <ul>
+    <li class="private"> <strong class="uidlink"><a href="googleapiclient._auth-module.html">googleapiclient._auth</a></strong>: <em class="summary">Helpers for authentication using oauth2client or google-auth.</em>    </li>
     <li> <strong class="uidlink"><a href="googleapiclient.channel-module.html">googleapiclient.channel</a></strong>: <em class="summary">Channel notifications support.</em>    </li>
     <li> <strong class="uidlink"><a href="googleapiclient.discovery-module.html">googleapiclient.discovery</a></strong>: <em class="summary">Client for discovery based APIs.</em>    </li>
     <li> <strong class="uidlink"><a href="googleapiclient.discovery_cache-module.html">googleapiclient.discovery_cache</a></strong>: <em class="summary">Caching utility for the discovery document.</em>
@@ -101,7 +102,7 @@ <h1 class="epydoc">Module Hierarchy</h1>
 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
   <tr>
     <td align="left" class="footer">
-    Generated by Epydoc 3.0.1 on Tue Nov  1 17:02:49 2016
+    Generated by Epydoc 3.0.1 on Thu Jan  5 12:55:02 2017
     </td>
     <td align="right" class="footer">
       <a target="mainFrame" href="http://epydoc.sourceforge.net"
diff --git a/docs/epy/redirect.html b/docs/epy/redirect.html
index bc03ec61917..09be7b4b584 100644
--- a/docs/epy/redirect.html
+++ b/docs/epy/redirect.html
@@ -7,7 +7,7 @@
 <body>
 <script type="text/javascript">
 <!--
-var pages = ["googleapiclient.discovery_cache.appengine_memcache.Cache-c", "googleapiclient.discovery_cache.appengine_memcache-m", "googleapiclient.discovery.ResourceMethodParameters-c", "googleapiclient.discovery_cache.file_cache.Cache-c", "googleapiclient.errors.UnacceptableMimeTypeError-c", "googleapiclient.errors.InvalidNotificationError-c", "googleapiclient.errors.UnknownApiNameOrVersion-c", "googleapiclient.errors.InvalidChunkSizeError-c", "googleapiclient.errors.UnexpectedMethodError-c", "googleapiclient.errors.MediaUploadSizeError-c", "googleapiclient.errors.ResumableUploadError-c", "googleapiclient.discovery_cache.file_cache-m", "googleapiclient.discovery_cache.base.Cache-c", "googleapiclient.errors.UnexpectedBodyError-c", "googleapiclient.http.MediaDownloadProgress-c", "googleapiclient.discovery._BytesGenerator-c", "googleapiclient.model.ProtocolBufferModel-c", "googleapiclient.http.MediaInMemoryUpload-c", "googleapiclient.http.MediaIoBaseDownload-c", "googleapiclient.http.MediaUploadProgress-c", "googleapiclient.errors.InvalidJsonError-c", "googleapiclient.http.RequestMockBuilder-c", "googleapiclient.errors.UnknownFileType-c", "googleapiclient.errors.UnknownLinkType-c", "googleapiclient.http.MediaIoBaseUpload-c", "googleapiclient.schema._SchemaToStruct-c", "googleapiclient.http.BatchHttpRequest-c", "googleapiclient.http.HttpMockSequence-c", "googleapiclient.discovery_cache.base-m", "googleapiclient.channel.Notification-c", "googleapiclient.http.HttpRequestMock-c", "googleapiclient.http.MediaFileUpload-c", "googleapiclient.discovery.Resource-c", "googleapiclient.errors.BatchError-c", "googleapiclient.http._StreamSlice-c", "googleapiclient.errors.HttpError-c", "googleapiclient.http.HttpRequest-c", "googleapiclient.http.MediaUpload-c", "googleapiclient.model.MediaModel-c", "googleapiclient.discovery_cache-m", "googleapiclient.channel.Channel-c", "googleapiclient.model.BaseModel-c", "googleapiclient.model.JsonModel-c", "googleapiclient.model.RawModel-c", "googleapiclient.schema.Schemas-c", "googleapiclient.http.HttpMock-c", "googleapiclient.sample_tools-m", "googleapiclient.errors.Error-c", "googleapiclient.NullHandler-c", "googleapiclient.model.Model-c", "googleapiclient.discovery-m", "googleapiclient.mimeparse-m", "googleapiclient.channel-m", "googleapiclient.errors-m", "googleapiclient.schema-m", "googleapiclient.model-m", "googleapiclient.http-m", "googleapiclient-m"];
+var pages = ["googleapiclient.discovery_cache.appengine_memcache.Cache-c", "googleapiclient.discovery_cache.appengine_memcache-m", "googleapiclient.discovery.ResourceMethodParameters-c", "googleapiclient.discovery_cache.file_cache.Cache-c", "googleapiclient.errors.UnacceptableMimeTypeError-c", "googleapiclient.errors.InvalidNotificationError-c", "googleapiclient.errors.UnknownApiNameOrVersion-c", "googleapiclient.errors.InvalidChunkSizeError-c", "googleapiclient.errors.UnexpectedMethodError-c", "googleapiclient.errors.MediaUploadSizeError-c", "googleapiclient.errors.ResumableUploadError-c", "googleapiclient.discovery_cache.file_cache-m", "googleapiclient.discovery_cache.base.Cache-c", "googleapiclient.errors.UnexpectedBodyError-c", "googleapiclient.http.MediaDownloadProgress-c", "googleapiclient.discovery._BytesGenerator-c", "googleapiclient.model.ProtocolBufferModel-c", "googleapiclient.http.MediaInMemoryUpload-c", "googleapiclient.http.MediaIoBaseDownload-c", "googleapiclient.http.MediaUploadProgress-c", "googleapiclient.errors.InvalidJsonError-c", "googleapiclient.http.RequestMockBuilder-c", "googleapiclient.errors.UnknownFileType-c", "googleapiclient.errors.UnknownLinkType-c", "googleapiclient.http.MediaIoBaseUpload-c", "googleapiclient.schema._SchemaToStruct-c", "googleapiclient.http.BatchHttpRequest-c", "googleapiclient.http.HttpMockSequence-c", "googleapiclient.discovery_cache.base-m", "googleapiclient.channel.Notification-c", "googleapiclient.http.HttpRequestMock-c", "googleapiclient.http.MediaFileUpload-c", "googleapiclient.discovery.Resource-c", "googleapiclient.errors.BatchError-c", "googleapiclient.http._StreamSlice-c", "googleapiclient.errors.HttpError-c", "googleapiclient.http.HttpRequest-c", "googleapiclient.http.MediaUpload-c", "googleapiclient.model.MediaModel-c", "googleapiclient.discovery_cache-m", "googleapiclient.channel.Channel-c", "googleapiclient.model.BaseModel-c", "googleapiclient.model.JsonModel-c", "googleapiclient.model.RawModel-c", "googleapiclient.schema.Schemas-c", "googleapiclient.http.HttpMock-c", "googleapiclient.sample_tools-m", "googleapiclient.errors.Error-c", "googleapiclient.NullHandler-c", "googleapiclient.model.Model-c", "googleapiclient.discovery-m", "googleapiclient.mimeparse-m", "googleapiclient.channel-m", "googleapiclient.errors-m", "googleapiclient.schema-m", "googleapiclient._auth-m", "googleapiclient.model-m", "googleapiclient.http-m", "googleapiclient-m"];
 var dottedName = get_anchor();
 if (dottedName) {
     var target = redirect_url(dottedName);
diff --git a/docs/epy/toc-everything.html b/docs/epy/toc-everything.html
index f47bd32593c..83fb7d3c528 100644
--- a/docs/epy/toc-everything.html
+++ b/docs/epy/toc-everything.html
@@ -69,6 +69,15 @@ <h2 class="toc">All Classes</h2>
     <a target="mainFrame" href="googleapiclient.schema._SchemaToStruct-class.html"
      >googleapiclient.schema._SchemaToStruct</a><br />  </div>
   <h2 class="toc">All Functions</h2>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#authorized_http"
+     >googleapiclient._auth.authorized_http</a><br />  </div>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#default_credentials"
+     >googleapiclient._auth.default_credentials</a><br />  </div>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#with_scopes"
+     >googleapiclient._auth.with_scopes</a><br />  </div>
   <div class="private">
     <a target="mainFrame" href="googleapiclient.channel-module.html#_upper_header_keys"
      >googleapiclient.channel._upper_header_keys</a><br />  </div>
@@ -138,6 +147,12 @@ <h2 class="toc">All Functions</h2>
     <a target="mainFrame" href="googleapiclient.model-module.html#makepatch"
      >googleapiclient.model.makepatch</a><br />    <a target="mainFrame" href="googleapiclient.sample_tools-module.html#init"
      >googleapiclient.sample_tools.init</a><br />  <h2 class="toc">All Variables</h2>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#HAS_GOOGLE_AUTH"
+     >googleapiclient._auth.HAS_GOOGLE_AUTH</a><br />  </div>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#HAS_OAUTH2CLIENT"
+     >googleapiclient._auth.HAS_OAUTH2CLIENT</a><br />  </div>
     <a target="mainFrame" href="googleapiclient.channel-module.html#CHANNEL_PARAMS"
      >googleapiclient.channel.CHANNEL_PARAMS</a><br />    <a target="mainFrame" href="googleapiclient.channel-module.html#EPOCH"
      >googleapiclient.channel.EPOCH</a><br />    <a target="mainFrame" href="googleapiclient.channel-module.html#X_GOOG_CHANNEL_ID"
diff --git a/docs/epy/toc-googleapiclient._auth-module.html b/docs/epy/toc-googleapiclient._auth-module.html
new file mode 100644
index 00000000000..a2896cb5f27
--- /dev/null
+++ b/docs/epy/toc-googleapiclient._auth-module.html
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="ascii"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+          "DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>_auth</title>
+  <link rel="stylesheet" href="epydoc.css" type="text/css" />
+  <script type="text/javascript" src="epydoc.js"></script>
+</head>
+
+<body bgcolor="white" text="black" link="blue" vlink="#204080"
+      alink="#204080">
+<h1 class="toc">Module _auth</h1>
+<hr />
+  <h2 class="toc">Functions</h2>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#authorized_http"
+     >authorized_http</a><br />  </div>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#default_credentials"
+     >default_credentials</a><br />  </div>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#with_scopes"
+     >with_scopes</a><br />  </div>
+  <h2 class="toc">Variables</h2>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#HAS_GOOGLE_AUTH"
+     >HAS_GOOGLE_AUTH</a><br />  </div>
+  <div class="private">
+    <a target="mainFrame" href="googleapiclient._auth-module.html#HAS_OAUTH2CLIENT"
+     >HAS_OAUTH2CLIENT</a><br />  </div>
+<hr />
+<span class="options">[<a href="javascript:void(0);" class="privatelink"
+    onclick="toggle_private();">hide&nbsp;private</a>]</span>
+
+<script type="text/javascript">
+  <!--
+  // Private objects are initially displayed (because if
+  // javascript is turned off then we want them to be
+  // visible); but by default, we want to hide them.  So hide
+  // them unless we have a cookie that says to show them.
+  checkCookie();
+  // -->
+</script>
+</body>
+</html>
diff --git a/docs/epy/toc.html b/docs/epy/toc.html
index d6678898498..019e619e508 100644
--- a/docs/epy/toc.html
+++ b/docs/epy/toc.html
@@ -16,7 +16,10 @@ <h1 class="toc">Table&nbsp;of&nbsp;Contents</h1>
   <br />
   <h2 class="toc">Modules</h2>
     <a target="moduleFrame" href="toc-googleapiclient-module.html"
-     onclick="setFrame('toc-googleapiclient-module.html','googleapiclient-module.html');"     >googleapiclient</a><br />    <a target="moduleFrame" href="toc-googleapiclient.channel-module.html"
+     onclick="setFrame('toc-googleapiclient-module.html','googleapiclient-module.html');"     >googleapiclient</a><br />  <div class="private">
+    <a target="moduleFrame" href="toc-googleapiclient._auth-module.html"
+     onclick="setFrame('toc-googleapiclient._auth-module.html','googleapiclient._auth-module.html');"     >googleapiclient._auth</a><br />  </div>
+    <a target="moduleFrame" href="toc-googleapiclient.channel-module.html"
      onclick="setFrame('toc-googleapiclient.channel-module.html','googleapiclient.channel-module.html');"     >googleapiclient.channel</a><br />    <a target="moduleFrame" href="toc-googleapiclient.discovery-module.html"
      onclick="setFrame('toc-googleapiclient.discovery-module.html','googleapiclient.discovery-module.html');"     >googleapiclient.discovery</a><br />    <a target="moduleFrame" href="toc-googleapiclient.discovery_cache-module.html"
      onclick="setFrame('toc-googleapiclient.discovery_cache-module.html','googleapiclient.discovery_cache-module.html');"     >googleapiclient.discovery_cache</a><br />    <a target="moduleFrame" href="toc-googleapiclient.discovery_cache.appengine_memcache-module.html"
diff --git a/docs/epy/uml_class_diagram_for_googleap.gif b/docs/epy/uml_class_diagram_for_googleap.gif
index 86f45632901a6296eb6550fe297313bcc2c12a72..01d4f006266c289dc682a9ae868e97cee58c8fe5 100644
GIT binary patch
literal 14673
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
SY_T?MUHt0D023G#(E2|t$wmDD

literal 12528
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_10.gif b/docs/epy/uml_class_diagram_for_googleap_10.gif
index b289d22c029613c6f9fd99bd2bf7a12d19891064..e77cf93935631a9cc0f96efbc67f953296421c1d 100644
GIT binary patch
literal 14292
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
bmwSo2uvC9x9VNe0FMo)-=-`O~0ImN65B$O@

delta 12187
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_11.gif b/docs/epy/uml_class_diagram_for_googleap_11.gif
index 5fa8d293efb881c5edb073cbc39b4b82e27604a4..d6affed36f4aa211e3e97138e174a3677b919aae 100644
GIT binary patch
literal 10246
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

delta 8365
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
D#5<4U

diff --git a/docs/epy/uml_class_diagram_for_googleap_12.gif b/docs/epy/uml_class_diagram_for_googleap_12.gif
index 3c93ccf919b8b3957f75d5818dfd1afcc8b9a43a..264975895f2f515b811252b88237b0f4310f527a 100644
GIT binary patch
literal 13072
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

delta 10632
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_13.gif b/docs/epy/uml_class_diagram_for_googleap_13.gif
index 9f5ec1933c626ac38b7667bf84b8a7d062085bcc..5c95b9326d56505d7c7a4656bf01d3e99f614434 100644
GIT binary patch
literal 11800
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
Bf@}Z)

literal 9904
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_14.gif b/docs/epy/uml_class_diagram_for_googleap_14.gif
index 4c1f0a595f5899a3f5e64896ff194eba0f8d345b..202891d514139688586296d5681a68d476008535 100644
GIT binary patch
literal 11434
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
C)4NIl

delta 9518
zcmV+}CDGcdS*lBaM@dFFIbpy600Q>_00aUAoPvZzMnvSo#FR=*d;$cls;nd;B!p&M
z#Dau$UR1PZWMoQ2)TWd)0tEEp<Ww>=JTfedc67Xwgv^qZ+_JP35)8DCd{kCc?9$X!
zLOg74Y=jaNgl=p+Iy^KcBz$IElp-XYc5J+woLovo3<?B)tcHB_#>AvXM5KOnY*tLv
zs+`Q8jNH1sd|p)i^7I@U6r46R#G<4uDlBADOe7i<w3d`yMm&Tb9F%foOgc2IR#eoQ
zjC2kREFv6?YGgz*EUb=<{L<8%essi|jNGc6?7qCrs;m?O1f+s=<jTy1YHYM_Y?O9v
z#FmU45)|Bj-rQ71JdAE+lqxI~4h*!4eEiPLymoZVnw;diynJG0{QCUNqLeHi9IRek
z3<d;DN=)p+#Dr>G#EOh`Vq|1aMAV|B^y=)qmW1T8q_mQRbar%%5)?!_G(0XWoO*0r
zPD~6A46KTb{L0MKs;qosR2&{0oIX5kQcNTs9E=)&985kmgbEBSCL}~QEX1CigkoH*
zQdCqvJnY)syncLKT3mE;baYx&w33v(a&)v}WK2Rt)SjHAf`pWMe2j8*%%Y@(0t7q)
z1hi^w^vcYfIy|geT)cXG1O^1;#>6BhB*cb<%$AhgwzTZl)HEt2lqMv+o}8?TeB8dg
z{Py&J#GZ`YuACee6pV6YlrAjHo}A>qy!`(B^zQ7878KO3tc)HUgboa(hJ?(fq;y_f
z)TW#~GBgwt6ts?nR6<02W@KDSObiMP%$}4S8XRO&R3sW4Tt-Bca%?OjB%FSHly-Df
zMnr^aWMocEyq1haIy{_ubbMl5Og=nBHZ=bN|NfI90+19T`2+y~0M7s{00000zyJUO
z00{n*Ap=E!C(AVef(ji<w5ZXeNRujE%CxD|r%;Wq@rdC=ldD*>YTe4UtJkk!!-^eC
zwyasLA23kWk*2NNw{YXiolCc_-Me`6>fOs1t`4;wF|h4RxUCZah2;+ArGrc2wniV@
zJ<Rv-TFH2cP-)8r4`#OjMD^-*;lm!up+~F!{8lr6XU}^r2Oi9NF6G*wowzl@3$<?C
zaBmZq%~5b$Q#7bhp<(LHtp;g?)mULl#VINppr=8uocZB5z^MK(C_)8*g*3MtXrS^0
zS&=jVa^#8QqV2LSm`<UJ3*dJeQ8lzRgb!a>pn!e&>33Xm%b5b7e{MMkopjV$hn;rZ
zHTYeBc;l6KUV7`b_g;MS)z=nr8yS~|3p$iCfe)T(paB;aRFOs<c}y_D2Q;+BqKhyd
z7C|yq)Nsgcw+Z3~5fkKb2z)v;@B;u1tbmCay+{GT3UC3S#tOA0<HnP<U=jrjIRL<g
zl~`)Y<&Q6V=H&`>(%F`bG}?%xjy(F<Vw^&M5@{roh^3(<lTJb@C6y-vR@`8D^wL%m
zKBUpW6Fxkd1~6~5g+`}oL^`PthfUB{6EzUJ9RQ}L@kW6D0GP0<6Ab{sOarD+*X3fm
znSus&CiGY9t+_fVY8sTnS5#Y<X4)2~o`QNTrKO&lYN3>w!fIQu!Y8Y?zoDp+ikK{a
z*480vwuMQnZ<Q+)FNeLC#srwCS_%O2(hFZQkm+WE4kdh&0)M})pui~(zVV3<8uXXO
zzX1=NhPy%a=CEAoIyN!8Zcz*Xy!f_7ue~A9i^;zIHhNhaPyE&Z8flb5MFfJhb;=NJ
z;i75F%%V|k8cm#{s<y4Z0mFm+7V)irmfGd!78hz3fyo=D6w#m3+cC|u%P?OIm&`QV
zjB^?~x5cxiK5q-O(AXkIG`B}ze6hG0saS>%OnyLu{wZTNV8JqJ9O8qHpWM*a-FcI6
zm>W(Msls7g-qy^LO{#$OgHkua#W9$?_k(t+^+E(P2-ljz3U~m3OXiz*o(AH7JCXpO
zXsSud_aS}*E;!+azm9k8i#J}w<6ELv=;Vl6E_b+&rZ`wF8pJ_GFe@P7L&DD$LBlP)
zG@~8#(o=t!6xWSs$|t>nNX0E>jQE?wO~8Oj9-zuSln*wh!3-6rh|$bu@tYs0z&AZE
zMaFvAYk>B+=e@QNP<#L&pLmLYaK7{vN<Hgq-{t1kym8TnHNpXo2uJvq5MqXI7*SDe
zOi02OuCP$7LE%MI$QmvL!-Y7+jSX=lLyOQbhyFkeq7dKG!;1WHh)7JL2#ZJ&Fq}e0
zP>iA!r%1&rTJefl%%T>z$i*&taf+t^gGV$Gl`@*~jA%@w8ksVKl_~Lmjc`0+2kZ91
zINI@!cwyp1j)=!T`cY-G`J*5OsYi+Magc~iVj&}P$V564h>L_sBOggg5=QbNG#pTY
z4s@6#oWcZR$OA9jFa*ThCqMhCq$=rhNr$MgOlL|H7Y+l2BrxL%Dd0j9YOtj%WvO_p
z3?>ohm_pk43RwNARvv_Z;TB;~$yT`1l`yB-%7)NTVGK(q037rMcBug|5EIxm$5~B=
zs8DKDvzilbv&?4VYiW!cXE4jT5EYsZb*lcm4FaB!1YH6HUzpGw=j0_%Rnk)-G~8eR
z{&yQwFarj>h`<{FC_nlYbe_bVVIAo*1U0y&36;92JP(?XNxnsY0eQg13Ph0y1c-E`
z8TH{t=Te<h%&!g(dMPzyYQ&l9^rvwlDMCyN)Sn9VAVe+dOOI-hq$>5IOf860p9)hq
zQuV1(CCF5-D$J}7WUE|VrB?+4*05G`tgI-jSs#g38b&Y=R8RmaPQeSyZHGb3Ny8}>
zq}K$cQj-SSPAErzS<1V1C#P$z3{NTI)@IZ~OFF2<G13Jm7_sS>bn>N}V2LI*{Q#G`
z<mHO~1f#_ErL7-S-Kuagt58V_Sw0y4Ry0i^+hQHl6v1*rJKN$+*N)1xinZ$UQs%MV
zgi~V2<<`O)=7es#<(m^T7jX50+P4fBX=i&G)=a^)?RIy6YE|pcZli;k?80oid8w|`
zHmDoe>5X**g>UEXnL1qTv!6-$r|%Mn-t;bZkEwm1fYb0mE(Oq{K&vRI6zV@JI2581
z-AsY|o5%ke(x)!$=to0J;ot@mi6~VmOI_Mw4?il2HN7cfOYC2(ve=*&W+aARj7as;
z7{)HXu_Muc>H$nB=f^+}vXF;N<RTmS$Vg7Il9$ZnCJPx89`J|<zHo{vTlvaZ&a#%b
z%;he7`O9DqvzW(BW-Nap${*G-{v~a!<{igak~3~I9@#ACLDHEoEHqvYi2#JV+(1@3
zz4Ko3oaZ#S#?YHdOauUDmnN;apn}#5p<x)Dwk1Y?4ZwKxTqGLkH)Ar+aWRDpYQT$6
zq{*-vDimN3<e@aQx|5&G3m%Y>7X*O%te$q|t>3c0H}ql%w?Ir~@jw~Q%2HLvt0kB4
zGK^#7B?)oR^iFeZ7hp)iEn4y|Y_s(%+-lP>ZR6No;sEHo5FwsW&9yam?UpZiG-rq@
z?rpGt$y{U~M%r}21Z(lK0sxd^sp>W-yW5h7Yq#ap=A{fe!@EvP>v=Cv5J6tPiEoTj
zyDlK0g0E9>3dFcqafqRBKK_dbxrgh;83#(k=i0Jzm20O7UFh`1>0*jH)Sv_(r~+aN
zd>aP;uY%h_pULxbjMK0;Wob|WY(yIAO0K|v0vfA}DV{(CnWuT2F0gA|q#!%1pBOSt
z!J$*OL*lJBjp+fe=fLZX#HO>|j&6TD9OEu`CDOg_ZBIKw*N%4_-o5WZ{QD3oQ|J-$
z+0W(9`^+D6Xt^A^@lW$i;oSmxMKiiCj<&nrOUie=6du`fnLM~LgXxODh0}`M{7~0_
zZi>N@(rtJ(MXS@WYFC@b_8$U(C$oK+99)M4D^S(!Gn7|Z(;6?f*8Jk-^4VPOQrM&=
zcA<=|CVK;*me5_Cprrmkdf^OPFU@{-v{S$QxQw^A(;`)&Zkt={n~Lyi3!18glYYIB
zJ1^%xd*D@%)U`XeEzl)zFhp<P_Hg%qrf2aYGWAj@$$%KbQCxbVZ+X#g|E73XhZpBp
zUR-k<3#U%j*M0E^3<nr2CTCuH5pff@P2_ihcX40-<Z-{FHzg->xKMI7XlX(sJPH6c
zQqTZx;DEsNaVM8@Emwpu7jrB4b$an&5j9Z+7Ci+7bo#?T4F+^TH-7*SG*p0p3=VP#
zyZ{4l;5I_{gyFMncu{mncU?-Sd@N`e8g?oiCQ?rqbu>qHY^a2J5n?OVQb3h;cfoaU
zWMfWY9V+%nV`mEfWk(l17>NAWRGkNSBP4i`=t7b>iI&ueQuT<ISR0kNiNMi`p2&%q
zs8yO6ijo0}gGOmMba;vJXNiP=igs~moq=dMv}li!d3H96UsZ~9VM3xudYL8}s7FY;
zNLH-pdWA)NvUhuwF?_KHA5s8Uaz$5KhZnQvD$fxe(=ite5Cv_q0$;#d$(M`e2N%s3
zTF?h1+=qZL^nC!}Sdb-I>5>=Wmj-xJBXnT`4weS;;ULgvdW=|(Z;^q2+D0un2t)O!
zTH3-|;9`G()-0MrQx=c}X#fN%mw)8ghIR3OX%K+Ca*!QkF4yHXcOil2GLLjY0wll%
zm{5Tfn2~sh{(;QITN>CiSm+ieIFb-z7bqArGgC8lVFI^+0B-PHDoBh1=@u@SUoe<B
zH)uS|CWJaUgxk?Kf5UQr`nMfaU;zdPG)Rb)8cA~x)r1lTh17F}V%QsGSU^X2IcInp
z2!xH$L6UAk0$)%IZn1_i={$V#hCmaCb~J}`fo^Z10?ptSQ&)9+=|Oy<ha>h!ekd28
z5En&21Qt+kfLLS2m{zngh&Gi6IF&<(n22^^0&!4{i>R4NX^K35w3%wfny2WRya=18
zC7ZN4M6h_9wYi$Q`53v`o782SNCba|*JpV#dHvyvarB#WQF$eV7_%rswwM>uITvEk
z0Js>CVgC6TpQnnrQF_t|D%u&7chP#H^m?eq9J9Aq`$3#Fbs-CKSbA}d5~7V}SZQ_P
zFylC$e7P6r_<W;(rH;38S#Cm{d$J=v5}<Jce$Hl(GlGw{;hol{8~-?W!l@SonSSX3
zO~pc-(2@q9LU6B@EO~K%mVzk}8F~`xG#JUBjJX#a>5=au9LYtT>k=0bm=`7)I4G&2
z`KcQ(>7sPR7X+Dbh2mXQLYy~~GdsgICn#|~88*GRqA5dvaTdy(OQ~NUS90=I1jM;J
z6HqvZ6N6oc7bsVixO0^*ho5WOCAtA~%Xy)B!GsaEmS;JJ2i7UXxj^0XJ!W~Ic7cX*
zS)cxNc^h<zG<qqd#nhMY_LqVrn2M2=ppljRk(hDHn~uqcf)tr?F`0DXsc(S`06+wp
zd8KLQnS}^{M5Fl`6F>zwz+IAxn{o=Am&lv6x|`d1t8!$kx*D9k+N%}ztH5d(%sH$<
zHLJMsi=V-Yb)lS)hO93HMAM0Rc>s`X1+5@NrL_T`cQK6QgsoHRNhY9-qDE?_)*qJk
zp4kzf4Kkm{*MhTYs^mEt*Ovq<Fl@c{Yr&=}2ihlp3R+t9*r0b&p;eWuaq%<hXKmPq
zuA}#%AzF}tSr;a1ZiLxY;2NPhRb1}o7NU9^4Y)BlDqVQ7qjnLb-^!c9VO|C27HKm6
zf{3xCWYeTQ^Q0+gt*>~oK02m}lW`l@aXjdQhykWzx?izFm2GN-r}C92Yp`r;r_^C{
zIHz-ef%Ao7m<D{>Ku)U{XxNq)lc-BOufhbWQfG(HDy)9Qsft*p1*?Q(r>bFxh<_NX
zVuiEDimPB-w}nxxcne5(ySFCRpMD#gW*fMC3%G=vw{)vS%=#A2+FyDL9Mk$1*@<3{
zyRE?}7v4Hul?ZF&8haZuL7Z!Ra%rDwu%DEFo4C)ZY{M2PMRFwd3aE5ZkN22A1bezD
zt2P=Mf7c>zc449rNqH4(TAO>60+=rgXtN!&Z#)`xCabxq>lP`yf$_&Se9@C&{sWX9
zd6c%xw9n}lTM7V-<2cIt7H4`pxs$XVHoR`Za}iWNUaGBfA*k0gx?bzNgWI%;A+~RS
zVW|{Wx#MdWXp3!XyS;21c66~rgZZ|k*%qnUzt4NPa#6W;E5XJ}!NY37z>2}Ws=>O-
z!Fy($&6;>+%e{QzoRpVnCaf2cI~S9?wuT$65juK>!L4?YxnKLjc)_0Rs-Cw;djt|#
zt@diV7i-q|u6AL%F8rc;L7>I6y3=QWCY?1)4o6G&8nEJryf@36wWTY$dmP=?ep9SA
zB`U&n(V`>Vw{wwP(KVw3xLgHDC|Eo(%3HGjhIYJ(q|jlcZP9^m>~J)T7yee7Zg(6|
zt@9q=%Ox~;gOLNjadD<cs~s%|r*=%jAEjUp^ruqja}FkSXvr5_JC#YdbZ3lz!@;D#
zG)1<8Ov!^3z;aQlsa(KJA({#tw_Zoe5Zq#_e9La(!L-WD!0F4q3Cy}F%(qF*L$tVa
z(YV)ozmAt^&0NOL{1_`N7cHE{x$JpV+MU2?vo@@nxvazKxs2!0SEz)00`kMG*2Bu^
zuC*4gIaG;E{3g*ipqjNMw?Tb>QtTGrXT^9?yKbh%9LmKbs(#E8(5BE(UtE9?>yY>t
zyo))ce4)kyxElZ?PQpQe4HuH{5`lAE7tL$UXiS;#l*iJ$$0N;w;N|{-Fl2&x(UW%(
z$jhwCT}revSUg=ig8*<k^;L2-J-~J0$Vl6!lDuXQd@7dgv{IO-L8q2~nk<DAMs!98
z%JmD<w)|42EEoJs)Xa=XtQ;4v9MiD86mhhwcG19Eea*UT%&@7}tjX4<=+>bK*PbZX
zn@HD&2EvR>#w^C1DV!J6JTKL%X3Y7&aY4gy(aq^w)a0xnLM*PLTb~qCy6#-dN<4w}
z9DHq~Z2UaClQMocR*74Ge9+;x7ru+4z$>=|T-Etl(E|g=d$FS#;}#!XVwH%;px4q+
zdc8&&$6;05ggj7BxfkVYm5esjG}ehq-N}0)zX=q|g00xVan;-Yfy&1X-N4b+U;Sc&
zXux+t)^K6g)xFhwYuA%V-jHbCfQR0Fr`~wS-gRfegx$T2hu6t}tk?gH)^<^yc*e*z
ze0g+H&G#MB!^z)tVc2wm*xoGQ@@=T{K_7aiuG)b?B2uoUc53S^y2v-#?_AW#1^`hq
zB@I9s{hFYM(j<qFufUd$3(C&}>)E(=yD}UrvqBjT+bM73Dm9?642&4{H^vQ(+JB_J
zY4EWq^B|OQqi=D4FUGsE@V3Sk!_gC1$2g|SE}MoK4YOr)<3_Wx2UnA5^T#i(y=Sf9
zPZL2vYvq(7w7r8omBX{Wz;R7kw0Qy4kX+~JJGZv#g<x1H{>!6q+ta7avL5V1K~S4>
zJNKtr8`T4LIa3|rsx42_4HsGc;`r@IUH#oY4c36$wn^lF-HHh0U`gh>JWS$^x9%->
zr!E;hzynl;R)w%eupaA3Pyhvh1hIbWX;cUv0R;xo>%RW$z#i<vKJ3I^?8biV1P}?4
zKmf<y?9Tq|&_3)?;1e#f1+Jj%uCN8vzU@2F0?MxJEx_&KeiMrD?UA4e<DTv^u?1`p
z2_XOrk-!Fj+OF>O&JwSn?3Zu}%Ki%V-tQ?92+HmWo}lbI;O_=c5--39k&p@kkqVK(
z2QP5&68{mZpzLEH5SyUvW-##_zY!>)><=Ii51{NQ(EjlzZxLsp>~}yAm7wfraPlx8
z5fq^8oIntqpzIV7^E%%UccARCzy?6i2C<;>J74sF38C=jp7eZR^h{q6Sbzdh@9+x`
z^(cS^O@H+TK?llC2Uy?rS-<sOANH)E^^w5!V&C;-Z}w+@^=ZHMSl{+;-}G=F_eMYW
zbiea<fA=w;_j-TweBbvS|M!4D@q$123$XzLkobzf_>AB9j{o?OANh|D0X@(I5Fq)O
zpZS`9kNF1B69Di5IuQDzKl-F!`lf&SsGs_(zxu4-`mS&KPq3LEk%bv7`yN628*KX>
zf%`!e-}$*LBt+O~HTzAlXNjiYs6jicfg7?Y%6I-T{I_5HIOO|yaj3~k;K%Cu(yxq=
zJsl9f!=eoy6C}ie&K~Xo9}R9I;5?ym(ft*Favkd$&Y#;M%y>Z|a{eUZ;AsH;yD$CU
z$Jqc;C(nclA84dW<3dNN2|n;R0T3Zsl^Ta2BD|PJkQ*Ws@*GM7Ku3cg02-{oB&L@X
z04or_1fXWc%$W!^Xy9U@N*aL#4I)&?&>=*L6fFY4h*Tp-k03>oG?_*R23A$AUd5V!
zRqIx+U9$pcf-p}ngh_m)Y4F4c$TYy-AVl*v&DgR&AWlHoq(;VzrU2kg^QJ~f6KVW9
zX#jv(15+zZy+jB=@?@oH*CKQaS1#Q&X7A?y-K(_kUxb1Q8wTJ+DpjwoUBB)M79l3e
zybvA&z-2aI$h0T(f>;FM1WbI9mI5GuJPq-X$s(&Zp`*m76p)`=e~DXn8ce)j`j!kl
z`S9YRkB?uDsrmJ(u-(6REj!H<)o9VADMclMAcUueAjE|&`VeXWjnC3(;uPah1MCeL
zLaHydA__Bwr3S1^4Lkhw<1Y>W02Hvk0uM}ZLBAS&FhdAegReywuad6}9Xk4dfCN+A
zIHUm!mPz9f9|-#7283j!kpzg`aDpNgAaW_AW|+!Dg%u$z0+S}VI0h5pez-6sQF;Lr
zOv7;0kw+ha6fzAW3o;S_B$Z?`4JV<L{!+yZ+j}w3_vEWZgE*)NW(5R%c<hZ^8YqH>
zTX<=v%Rc`M6e1~3p@M-TO!>rrwu~CkfQnnn5YA53nt%b5Jmj*IGRe{yw9rEnU9?ez
z9tCs-Nh!4yQ%x)D^wUryR1Hr(hiy$h4Ua|krHqngwpnMNwQgBxkrkF$Yqc_V+GM5G
zwp(wJ<@Q^Is=c<{s<IUqGA@Eix7~Etb@wH5&Ak@gc<;qG-)ZNimsop$^#wTKfcfoL
zPgM^_IAMhsX1HO8ABH$$%4R6oTmbwiBV&y>=D1^zKL$Bukw+%EWRpFv0gQ^v{a0X@
zUly0(m0N5XW}9zjR_2-a3=3zUfBvSHwVe&_8EB)8)_LgHYCgK@frVDuMW&sm`rf3Y
z_6h*4x8}NQufGO6Y_Z3GCcA92&la0vtfj{IWVhdjJ8rp6PI+yqi>^9veXq6~TfFrK
z++Du=#%k)o4|jHO!mTnqTBWcH7g{2KX!eG}5Z6%g#aU@wT|AEE;&URX=r#f#nf2%~
z%&pUW@y@4>JXtk>QJvWc<XT-`s5j60?`AUsAcs8Sa6wL_r~tr!f@$$U=2--E$Q`oQ
z34cAQ$VMuufs0~Cc9>(HO(KrkbDzHN>Wz<#!qm2Z{Mk4zZ<dItqGyr!_<Uy;c;_Hw
zUt3IYdDaR5Pzw6h&wjnr7V!Rn)xT*yK?KiI0|3Uiy7JlWd<uLH`&<GoXD9$6T>4;_
zK!~6&6wrVN<jMtql_ILXWNKQ+*u!<Eq#_l3u7DL>+xY~x0t;*>S*Cab5lo0ftm#l-
zE|3zlq(A}_o)Cq8gNfOubvDBwpjlGr(hYa_#KPgPiCW}h3cdKn=n*k$MkJ%t%&0Up
zrtxTN99kRQ2sAkEOpbH(SsiC~M?Bt4k1OM&%O)p`uK`ehLn}bWDKJq36(~nTj~Rwx
zDhI#BZ841J8e`r}R|GJL0svu};7c^%23&B#1U_Kmv4-G=Qvg8<%}O1#{#da<25fe<
z<K9bnu@i)t;1tOc#uJ$S@vPg)(vp|dVep1mJj2j{3RIwhDLydF#5B(oy!g+vm<O3$
z_6H~0<U$#LLaCwW8S|1*)Yen7mym@t1P_PsLtuDu7F=LrgU<3EH`{ltBs>8V5vYR@
z@fE&tX6~3_Os4u&!x^*Sf)}Phh6+ql2g*U~efo5kDXMUYJODr#_>x~1b9PWJCUbuo
z0uKNlY5`I7p$dI?0}!kTt^Z*(St}5R>P(@6C*VtefCQ}MIlq$0V~J`$BD#+T@bFMP
zkboBgeU<}liYx&dG7TnB-n}ANQ0&aIV95lQnr6f%1o0vQo#90uwAI0>reTDT(Eu=p
zKm<{IpbQ~o)(G|5{-q|A@L68%7g(=Dt3aUz03bn$4WR|YwyFp+rtr}hPJsvIIJT%^
zol*^d%_&qE5!Got^dWZU=d96s3y4r{7GUXB%YY#fS)Z5|Y}2*GeUbEu#sWZYb-P>M
zwu`sF-E9>ChsD}*wzGW%qj52bT>7cjVxDEL8f}Y0)<$=4(>)*nf^iJ)cGtV#1#fu8
zJ6`gJ7Z4oa03gb{UiP-Pyu-k*{p<i-`qtNfzW2rNZzU0lNJt{T{{?V>cWVgc7C0+Y
z;O`U+ykG{iA_M&8Zw4AXVa{Fx!jZTHg*6<;5JVytv4}(nHauecWrDv8Py~N7L1Gs7
zZ4&$)#VGj8g#H%SSZP~uMI`i46+J}46<e@zkSo>+{wAU-OyF+|guG;Pd4a!5sEQJQ
z`0E8GS9w^Z05K@80tye4!pdK65gqtTh^r8SzjOd|nqjj8{@!5+Z{EQj_`3r&*V!u|
zzHpvnVP`&T#S(eWGnM;1=&Xo25@;rLq6>XyMK{_ihDNlb6%A=gH=5FwPV}WQJ!nmD
zn$Ml~be%yR>NJm<)L%CBsjHl7RWF%;)vXTlt6|OAj{X-34sZYx{=0@*-?j`*0Cup2
zJ#1nZJJ=tHZ?EkL-EKKo+3t}KaMR`NXD_X10Qgdv$P%+;SNp5iu1~zE?QH~3NuNnL
z1xwIv0#5!>;R(nn0z}sBL~<AL+A^U@lK=pOBt($kE7(X!J_3<{)4Semy!LN@jfa=d
zoTxOR;mx=Yj!w%a<uMR>404o19E|I3;uZuq<jjK*hX)1*(vtYckLx9ElVw2&d6K}F
z)V`Ffe7PY}_{-7KD^Q`l+cqcK(}0d}p$~o8MK?MinXRpw+q}9SPdXq!aTBUn-Rf7z
zdeu*%vZ&KizyVfU*8{us;);EL>_|5|%gDajw5uKMZTHvO|N3*dm;1VPuh-PGzIVP;
zed~C)*4M!f__)8F@HCTqP!FG{r;m&7i(mQOA%8c+Pu|*<w|ud-%U%TF00#(QFMKl(
zpZWg&*8%)>z<&um`hvxPzm;J9<_2-$LByVL3ApekY~Qz3c$g27NX71d*Y@B@c)`h$
zkg)KTb_M=+g2)(FzS3af<1OGg60nH=&IZ8WNmS*<kyvr|EB5^XRAu{-=)U;-WqlD_
zrNci~KfRuRg{v?>5}k;@xl$Yn6fD613qS$>QiS{~7d8O23u6NUyp{kwK>k7j1-zD4
zkU&P@FGi5SR)9cyk+lqee31?0z%XO94>T7K6hZeO!4iCp6GXw*P{9@KiWYRit$@K8
zT(m=@K|Ptl8+^17)Ikum!OW{Q!4tyYy0u&z!Xw<R15h*opanT_!Y72nD3rn}q{1q+
z{=zH7!YqtJS^$70lmj6E!!Q)XF(kt>G{ZAQ!!%UGH5@}Z=)y#Q1As3S0syE0HZ;Qu
z001GtLo(dMFziD+Btzf=#5R0GLW@H%q{BfR!#xZGGT_5J^g~Eg#4rQ^8CZo&yu?Wa
zLpSt7M65$i)I&*pL^1qBO-w{k6hlsgLpeM}0FZ@Ypn^vbf<>SOFq{J_Km;K`gb$Fc
z4hY3xw1P*-172`{16dHoK175*zyx5B1uzT)IG}=4pan{p!&i(&Pkh7?@Pz;X0B!t(
zXN<;a#6xdXMMGr8PXqvC2m@jOfH05)U$6pQJOwK_0ZjOXEHFkR*uy=PfLjQHRsOJn
zQ#i&vtVd#41#Ub6A=m|H=ma|GgC&?lb!5jdm_s@^fs4F<$WUyC5ugJA*vJ!D$cB7K
zJp9OV9JE86Lv#!UA+Q2Eqy%1=1%=cCA((?#H~}m813KKtJj{be2*XAgNFfLVOn8Ja
zphqic$yWfwAjpF`T*;QKLqWttItWFoOv<IqgQ?uaLOjWH#Kx3VNHRD9Uid^ru!Rpm
z2A#~qJ^TWHsszI$002jz$X^r!888N3umu|sf-C?4Y7_!G_yVv5%Tpvp0EkCCj7Pro
zOTa|Tt?Wd>Y{fc6gglT1TL42!zyw6F0!mQJUmOOX1VdxQgd+e$8Q=vWpoIQEph=)K
zN&rwwAz(_#jLJ_eOfc-jtAx$0lth#4Gn9->Y`n#Po^(b4umMUS0{}RJofLv%xCKN2
z$c}P`T<C-fP=;JU%`XUob^HQq49Qm*23?TNIkZGfTm`!P!|wdfKjck5^G$SgPcZxi
zUPwqVlmII51xMJ0TTsqm97Z>Q1OUi_T=<h+FoI3Y156l(Tog)Zltya&O{s*$KLp1H
zRZp&e>`ggD#SGQZ4P8$=L&*&V(GUg14z05f710w#Q8FY^H8ar^b<q=D(KKt(7o|}R
zjZrWI09)9F9p%v;_0b;%(jXPmAtllxHBuk71q)?QBxKSiby6kuPz<f9(J4j68~w5w
zrP3_5Lo2m1EY;F4MMEyFGA{+wG9|>vG}APHEkiM7GBQ=uGG)^x%h4mH(>k@&JFU|s
zUBV~j(>?_-G=0-RjZ-0W(?HeIK@GA(HB>4^R2x&&MXk|Bt+7Xi)EAZ17NgWkP0>qb
zF#z}lVgS`p71dEC)lxOpQ$^KORn=7;)n9<pIx9UtmDO3*Ej#GJTgBB})zw|))n4@p
M)n5fx1`7xPI~OyN4gdfE

diff --git a/docs/epy/uml_class_diagram_for_googleap_15.gif b/docs/epy/uml_class_diagram_for_googleap_15.gif
index 9f0d471d921af89d8ab51c7f56f85c47088e05e8..4e3fd1aaa5e84ab400d1a55c039e70fa733fbbc7 100644
GIT binary patch
literal 11780
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
a)EmCP_d{y2-D@OQCg4=sDH#L;RR14ZR&HDX

literal 9814
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_16.gif b/docs/epy/uml_class_diagram_for_googleap_16.gif
index 36f16122796b02f259675c7d44b61bcaa01df4a9..bc507dc50c6be2ae6577b9e1b2d6f7f2ccf00ed6 100644
GIT binary patch
literal 11858
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
C{;<LT

literal 9925
zcmcgt^;;8;^B=GQ!a#bYgmez1go!XZ#L=B1-HhH_28<Dok`Mvu4kZSRlCjZD1*Abi
z1qDGxrA7Ss{U^Tn+;czN^W5F*b<c&Nv4Q$c4<Z0SeF6Xgseu?QM$bTRWNakg#0*6Z
z97)26iinO>)gWE1G2YI2Z!a$sJ(!a0dIw&a8hH3&%UVf!;1LEFg{-Nop*+g3NkVe4
zfwxE__$-vQt@V6eeqeB*m#sBS1GYamZw-fG*f^BMMKQsFC~xQWzJYuZ(ShR9(x^aZ
z6Fo2ku*N{I<^hsYhQnu|4#!63n@Ulx))zkyYcg>Byc}j4%B8BxveL3%mS&>79QeX~
zq@%U70St4EKR?{7<zKmC9FiF<E5c7{YQgz?=_$#M6yjR4aLV$s`!5DcA0XG8N;#;3
zl&XA;e;__MaI2$cpfEo_DzF8M;%DR7nxX{SnqB<EX#m3odu{!LCoMZtjN@Pi4@4m;
z#ibXoC@4>_i}MRJEoIqj{4K7|U|Qfv1`g@zh4FXxGS@r&vOiFWsY$}@|Ledb%>2K;
zMIrSxl=oNHasP-*i<ZU(I-8q;nZXxRl=-F>l&5t|28#b0f2kHM(9&%E-8#n8xiksW
zVrgxy1;a3a2OglzOw3xETAUr7k>N=Eqx^w?*3%2e%RgUMN~x;Z>c;2Cp#mM9apB03
zvQi8+5cW^yWm__Ec>ln|DN3mZO!OaAM`u}aQ9V`JfjAWKA7(5@R9tku8&4_B-x?d)
zUz}fmF_14VdU1TX{;ZUrivt(#we`;<FFR6(qm-3iTwWZ0+poc5a9kYo&ss3dVB9r+
zO5MMyaE2)<bFgvXvoP~@rPgpgl((0&i5ZvyOexFf=jAukfO%P3i}La#9i5#G^zy?4
zWkp0wAE5H1kb$<=)&_cJ|7iMqd6}CH6yo$WV9L_6rEy4<r?Z}_^54Igfd5|+J_Aw#
z0ILAm|0_%Uw-W&ROMuT6extUE;beMtY3GTyN^&a8b(2z~_Nvi`+&BE!C)%sWvxRgs
z_>DViCi5h%nw%#)YNsDV?@g5&ch<cuQIGhtKG`WTtqw?H5HP_v%vKxaNxMwp8{gC;
zGRJ;2=wR}j?K}P7PIWaeJ$EN(2$*)aIJAl=BU-6yTi1F*KTbV0?RoaLKjzn$x6_bd
zrY-@Mwy&myR#rgDHnV_jweg2;1HrXhl#}m{lQF$WzqPHa-aUX*mg|K&BixgfhRv53
zwl{oU$IH=Oqr}N?uU2Fdo+^R6g4aVs*b84;ggV)(_aTRer_7%-AquzA!&4^B@<J85
zI?qbaJTxczE}`~wAR<VzM-9CLzrV^R2|yu9?A2dYl&TziGZ;73IJ9o!YcVX|&N=A+
zPIsf7!>8M+%M*fc(mh4aJET61T30!BiTPL%?Hae&b>fQpwXnn$#>Yda4^|lwNn|NY
z1i;xL1i<LEr$$1F^y>K0s)x{PivSh*tu}H{4{OpD2ph742Bi|H4FvEJg-m!yyr=-+
zP^tr3@DL(-GH)m?NuN;*FoP+u_n+L(R*3r~21d@U6ylUu)2g#z=gXd@a5g{DM`=2h
zqIu?UDX{_xYTI@9rz~#@L2&JMDo!};3P>pmKWb2q(9>vSNj07+<haSwCjh8}dl;fG
z0cPz@tb73UOWGF1(za(`JBc>Z>d<blwO2z@nj@cNXYKUZdzGucEGbU5wzjO;zcRm_
z<nQ#HB+=YGRN0W5Q6;;$$n4)OX3`u|ATtk59i&SERyFW40)Eah3aaGns_HXI&ks{4
z3=QXK%P_B6q_PMd(v1#LT?MD~>l}S*bKcQVRqPM800Rb2yY-(B3cr?_dhtg!j)%kg
zqMM2jF*2u5gTXIkumzn}`At(gEaW&W@l{RTt*biZ<UjI1S_@aVKiRVT%L``+w8+ku
z&#fuG?3jkSfge+p*KjvDG<rrmYqdfc@iWUJ2Fg8#Zm4zwPh*1tlUYU%^`*?c;Lu?e
z#J&(FEAn7w@oj8<D7Ux)hu^4&^E<AWkM1}o9wu9w&SI3S1`IJ#jjZHRW%{KlYH$Kz
z)AUnGG&AUfW*wm1x5;?wg!uuDy!w0WP*(K*L$xyUN2e;govk!S`Dj8`o%*tZ(B^E4
z5>!%1kMvqDQCESiS1oWjXO&>jwUjw-A~2Y^tgqmYJ1rqw&Ip-ER7~B<XHkVG-hs5%
zu)g&EQ6kttRJ$dwKNh#VhCU{I9_(g8pa4SUF@>Qo4mnM3?FDRXe_9*}o5iY-sIuq{
zPYYQ*vBBIH7C~l4B(7&|h!&mq`qmT0;*#VP^^r`bu<N=HXP~K<+TbddjX840MQECl
zSrz?5qg-7)+yH^A;;1(om3I7*VNa>z>X{goj|<CaRmT__u@)#5|G@d0Rr5XxPcD%9
zkr@i}pxZkhR$u**731+iFDq?a>)hgg=UKH7sL?R}AS@@%%v1P!_=KJYTiQd6(RD#%
zV>W}I!pi)JL}ny6Bi@t2Z)XGwtptv&OWgk5SR=g~Zk*cCX69pJ#m;O6WOPqvko8Rh
zg}2qp+;5C&28*+PE`qO~GT8rVw3R4)Uw9ueX-k+ZfYz@}VP_B?U{i4bzZY%PAeABu
z`?B)5!yRk`!r!{Hm^HYQ;{74O569~Ro$h7fEM|^uy6n%SZg8h^5utIbn&JPvC3e?l
z&PrH$-R<vXG@q?|GA-E`EdY?bea?w28!7b=*sa2-5%d`f`Wj$Yi*t-$h*3Q~0D(_u
zu7J{zH9SY}4L(~wwWWkyWsZ|lx#vIf<jY}wn6MPwjA6c<;YdhN?u%)*e@>0`QI(lo
znpHW2m73*IqlMUn^>b-T3$s_VvrDZVh<dTjHoT=%ve`i}-Imv&jorlvE#s&No(@XY
zp(K)|IBS-GwU&9btLBo14paS667>PC;JZ>E7JV<^rYff?%5xwI?)Kfs$e*<(?&;zx
ztW=Ntwze}afz>0&wXK5IZ<|nx%?M)#2RQeot+Ipgnx{Y>=dco7bM1rKQq~kcqwC90
z%TMj^Fjk)9+lwS#Z%lCCb_x3pNa#`0Y7ZFV=M&GfXg`eq8Wrttv-di<I=N_{6xbKr
z`0R~p1K;v)W+Y8Y$mefQG~D((%ehYLzq6&jJCu*gZv3wtU3s7_51OgcZkBA|_%bA~
z&QZno)-3UN$@pL1xqA8i9YbA{_nWkA>5?{5rY@@<S8q$Fs|-qcn(n(bcPv+Md5dD*
za7IUS++*@D+ON-kp|X(tJg&{$k&|k+CBk<$VPxL%=rLtWoY8^f+Cdr}WhO(~>1@jW
zRYzeDWm`V}Y}%c<vuNDRTed`aN^nu}QY@(DlfbzBqZ`3DuC2&^)|q>vAgk=k+>5~U
zA86ZZ4E}QcS?VK67@H|EHlqRfJQi;yR3t4jR(f!kc8h&tnus}c7UkVhyQlOj%tId>
z4#jEIOt$e#bGTpK5|+gG<&{&W1?zGlAoO`lS=4sxM#pVU7Tqg@+Gh9vYV*9Bva}g%
z7JGa^0{d-^Qpe03nnwgeyu60x9Dm9Mb{@&B`@ew(eOz`q0POUK3YQ^XcBw>v<+>50
z?2{(-EvRkM*-Ox170C(;_(4qr81ZcUqAJn9HkTgIvpxT*7OX+;H#gmjRj}69aea{<
zg0t+G7u`vE?l8kJLa+-<s|?Y)d`Q=ux+lg*mqhx!+7Vt5V94OLb2z$7%DA<q4H5~Z
z@?=2q(f)m&w5C%&`Aa18O`F<%L>qOW9`CLRX_K0_nNg;J2zpW<TdLR=;L;(a*<8-8
zbZ5BIs$2I%t6JtR)$`B9J={oL=i98{1Wo>r^3h^*gWrPgYQmSYqWRwqe%HD9%_3#B
z!}@dO_4cdZ6u}7JUjDuxcYm3^e@h*!f1^)6tGoZ5=~VOp$F-I4CoqCy@@~dZ%A1V!
z3&hf^jNwOfK{5CBn=9M=?MlXv1*y>zo&RwQI!l0{h=u(d`F0L(con)AFFtJlTyg$p
zxm+U_Rf%gAkEf|9oN+0wsJXly_a5w|@bW<v-fHNAfa~dbBVtn-T;jA>l5ybASlook
zdoY-zsqk4Ve$ys<zDu)5ZbmEwsu!|x9C}jc^Fu`G$Wn41%}ug!j;joboelY07h{(S
z`E2Lv9Kpv}Z@#$n-;Y!<9k;Bwk82!j7<<p1t?0z)Ft^LCu%T)-F^TXOh;UV3Ke!0&
z3P8o7jVgQ-O*{;fcpNTghf#n;$ec#T{cvYhu>f-20s)cd<l9WNNNu$Q0E@B<l!>{6
zhOA8!wW$g}!MyJbjIlr(MZ1{Pqhx&{yiwBp;+A(Ik;;aVfen~gR!^A)OYMTl=;6o^
zuY2Ym0@BAu_r@76?;ApHai?7@SwE$Vxh@)$vjcymo?bYgW_grWXwO$bNGHywmrbM>
zHP{q$XFQ_HNH*|ON5-W8@JYvHM1}c2P4vBq_s!0YjZ)2Uv&leuz^e@7o`~}_7#j5%
z*|vO+OVLMlM91eVqT1;M9RPOW`gV?~kj_uiuUQ4&C_=z!P!JW3H_>tO@xyI8$V-Uh
z44vqDDjItDA7IlyN6caO5#&7`D8}+SQW3;V3;Ow9XvRAZXP*_4o49Hqr%tbXRPVS-
za@_PxKrhM`!>u6hR0sr6>T$x>GB)x@0)hoS5S}A&Pkw1zC0aP~vr;xPms)BDScORB
zD9VjVyG*2vIPosuu;1YlSAWFf36bQ!al`6Hq#|gr0#J0|ENz6N-sO@na)TDBtNFsF
z#W5N;F>AAG3FPqe9s!q7Dq1>aqqKZp<A|#Z7&h9J`G^$HWj-%^ZNuoBJ~6!Xn9LcS
zN5Q$&-Up1q?O5n84D|!6&7K;ioEniB9O40*-Q=>ei;UmZK~<(+KQ??I35jHZm=Zw{
zL@?U^-e{36UNKE|;fi{JZfa3llp-hwk@>LUiLqY>4FAM`w77n!c!0j7UaSOvQ?D(i
zq^q~M?~J>5rDXnoi4iaXyW|tA82jgaM%ZCVghi|vhPzV|-dzNly$SJaqatwUcwC-w
zm)B<yEaK*_NU!qbMbE}n9mX|`@ptyv{njZ}i4<lGw~q_UWUI>bw)cyC5B;cKhU$fU
zK1Eg6X7z+Q1j9??JFeeis|cfh@X9;;MpAb7`=^Vwe1FxWNsSQTlLxz0cShl*Gt{7R
zc<A#2+1Rjz!XznHo;bEI%G{IXxLyeVZtiyx{z?7PJvInS5k#CvU9z$2tdUP)w+cD(
zFGFa`2N!F2saoC*O|puFWSAC@>L8&?N;iyas>HO>P0%j<XBTj!SCb8)p30u=k_wTu
zD<DJ^$fuSEtcvwfMNG$5#tvgxy9<48V(Av8MtZg1{<`HITOO5&4Ra{JM8@(V)0N|-
zYDVWDe?NYlBwCb_TTqc(@F%w@Y^o${GBt_gNtogj<om{u_l$slS1z{J@6(eMdcEp1
z9<~_}jOg+xqa>W6^zlRqzOQ60wmICZxsSJWV6~a^xS8k=q1<fIQE4XpcvwE15m{N9
zgKbd&>b*&ieG1441hoq3)pk*pMJwXAFs)W!jIAngRR;cbi-Lv6Wh<=ZOiJbBOG%x6
zO<Om4mVBt7(7?gtfZ;l6x>X4VN5{kEifD^Un}X)BA2)V=f|jw*s!u9~9dpnQ5OM!t
z%!<t>Z{<xJ=Wn05s^a*V2#V^`E-~%ZQLHr^Qzax1SI}oJKc&m0wDuaWH#N6@)kyia
zK96bF(x^+%3*%b~gY6`zQPp|&xwY#S1o>m?e-=mtv<3Rt&wE6u*GDA&O7Wlvp;ooc
zn<2i-g^;`kQ_bfjV56l^>TBti2P2Ic_I03U%)R<1kJPjT?q<)F&asSUcc-2di<THh
zqv-w~@x}57d?ns|1Qa6yQ__QM)}x$ry;^mPW8{Bx&b5;6n%&<zED3q1;Zi^!@R2v3
zPf4dV02S_6j%X{-FCn~c3?y?&>W7OSF*G18vQLU`1LON7n^k#v6P84RqdclujAJ<i
z982Q!sf!dCeLDp@Ltwm-;?2Dcdt6fei9g0wQL}mOmo)hTvH9K8_}9B!P7DCtNA;<5
zE}uBf-aNd3>Ok;t1go`{Yg22uaKqA#KG(g0<TZS{aCeADBZqD8#{h`$!yy0u!9cz!
zWV>$iS$E9}SL4di>v%%AMQ^0c@R-Rk*?*XrF+A8b+&48G?_K(`IOhKJAnJW-{$pS9
z7D%opB(J|4%h$@P5tlOD8kO7Y_L~$lT(;j-)?*kCWV3HQ_V0rPES^4#^5~PlsEX66
z813wP<0Jl5#gy65^q9BpL+XIqbV*mOOm95@+r<Y~EvjPDB;;(>_4S^JT<2MpY8rww
z$Vk#2ra0x)afyu@NUxdks0o@)4A~D=eh9g=Ee?+6N3{OBwlOWH9Fv?&GZYq9XV@$t
zM^_(ZMiQ)bXFjaA+=*ZoNBT}eoHPrJdyqaj@^H<NvVM1x*<>;YG2Ei5(V1u_T+G1V
z<7zm?vhLZ0nht(HjGvk&?oJP0q4Y^ndW<Q$ctXT1VJU7X>#^@k=do88+%mEdxzf?z
z{aEYOr$paQ)t2Jk7V>T{?(?i&116sOC%I*jJhk(zi|hGK>vXdV@maNs;x4fso&PNN
zxi)-8V=VfE>qhyfMz1$Lps>xf%plyH(JXs8r;ve%H)~LpW7Gsbz;$zy4w?z_=sR0t
zgfrx2z)N4VCkOfCbN%DjUnXvDUnWAml457`qFE=VTc%u0@JjYD7mZ{<sK${^xbiJx
z<ogMuwYo<G-d9o5h5LBRqI#YB!eZGJb_1jV-P94|T=#`#oh;<Sbe@7UYT<`G<A2jO
zz!8RTikc-l{`aykkkZz;*fP0Tx3gGDzf>l<RARJ*r6u7^$7IJ!rAi@hU<wOO-juVU
zFdcH}?8{xJ`K=Zqxa_kkr*aO<zHiRcCa}aKepFC(;03HdPw9c0ZMqX`=6yHh#ltG1
zOb^g`;mm%PhGsmzy_)AEm!OMhLE3o5(i|dg(12&$!)6TwL)`6!YzGwJROgi!(@ow^
z#tRQ!;h0KlT_%PttX(EfjWfL^&Mvt9@l5h1M(ZqwdMqvsF2n~c<r%%p@qLF*efMAe
zyO{BJkv_wiw}ZIUrOB41zqrLHi>EPT6Dp`!q{Yh<fjRQz2GV00nYjE;cJpUY!%rQ-
zxVmSni8>;d&uXLm_hkDf)K<Pb&ri?-ER@9fw0Zs%SESB~YUVsA7G^O{y{6e)Aw=~n
z@ym3=d6?IvLOx30tY`z{xR2Dvm@-!rYF;1?+9iJp<%d;=gei>mw;yzmagt}*?Z?&Y
zrsPYoJWQSUBR(2*cF@`7`TiPLXdU!v-Mq`LqaCoFFN_~dh82)IM~Go}9PqJJ^Eu9+
zcQkvtzofX^OI}V_hpxS;r*vG~*VRFkL};GWJMt~iMBTI!*ld!!JI4fZ`19fPtC7o}
zw^~e#=(TR+t+yHUTkgi6`e0@sGJC$sMc2#oXaj)ODYoft25r~&%n$$&5!n7<&o7_;
z8Wnxo%-)O3J>s=}lGgr+>;Bk-eW3f5LT$kKyZu*}`!ibm=uLKcVcPDB{ca)J`4?X`
zEvToS?TZn=et5v1dGNJxhW=yOHzi?Or27@|9L7Rzy47dj4qvhLRP0x>FibsQJbL$C
zN|Amli=m-n|Mup0+PiE@2>L<*BQ+IcA%b2h^nmRzYe&Vtj}S|B#eOLC2mcVOOvOHn
z5DQDizRb+!5AhJzfQtPG+AO6N`vIXpp@OWO75jDCEOiz8oGiaIHdr21>=U%<wC~ap
zDt>CZ9bTzC_*8b7;(lo6#^TmSjre}Rc=br;0CXqe2vkWo^^DGb<H%v?$W`#Tv*M_b
zc;vZp<P~!4lW^oWbZozI9K3NDDtKaW`vf`kD=OhcvHT=1;U{Y2MBwiU`u2~c+oz1f
zRMa`A8AGSIjnk~Zr#XUW*@9F$EI?MFv!e2|;_S1u8FqjWwF=95)$Q{dxAVG$^M>;C
zrlIqejq_(A=hkgc1anh(WPe}N`OO#jTOjeb4#&n>udJxvvaiZ-%Qm0%x{U@M&E`bD
z4#}zLOT~*Gw+r>H-!WkglO~(vU(V*9<8p2Zu)H8wF<oO99Z7t3?HiRKQ?SS;tTJr&
z4`;Z*9`CF2HDOAOj&S&;=!Z=N;7`B8pN;VqKzn^2@QO&Nb|PD~f$SCdB{$U!y7(c#
zrjW=0eF}@XJe$T>G<C%otq4Gs$Wnl{=K?@kUH}hh$0$$eb<n=y!yt}CAd`so#Eh_B
zI)@xJG0pnAVYZO|Bjqc#SgeChtLtd7&7SQumrm-Oq&9X%3>QXwMO&ZVNOEFd$m<u^
z)N%)0$V6LG%y8^s3t%(FQ^IgU3UR@^0sySh+CuFI_2{*Kde!<Zi69y6<Xt4azkj-X
z+l>G2hDo}@N9(R9ZS%a<W#}6NSEb|>ndKW`#!J<G0xxkjnE<Q=TA*^rsD=0$e&o!H
zG?!WG>I-n?lshG)JE?J447i;af?;O|AF8sm-Q=6jjvCwE4n@oHF>o&Uu4tz()KUp!
zTJwbtQ{>KBR?(TSD{`thKO$%-%)Ia>g)T9MdnvU{Ev8JG7l$9OGW-Q_w7sCdY8I+9
z#EXLJ(%U6J*M~fRbT^Y%gH0G@3tjO@W_*_DNheI-luU>5s!;@`K^2okWQ4+{s(p*T
zjAU>MJHt7oigOG&-lq|uqFQNG>}KT9`CLQ6L=H9v5k@68fM|gi8-qk;{-xz8cr9M>
z^~u(65D?afprr+2VklXzs`k{WuGsXtX|2Ctjw)Hl-K0b@`$lp%P8Cr3&~={WmH9$V
zg-*WtR!5%FWCb^VMwi_MZ-Kc6;-EE_>f*4vBeQq-265e*>F%x6pgUSj+4{$|xJUQ9
z9em2Wf*pKwIScIrx|E_;y=oV_okDWAkDV}0gWc;*9h{I3@qFW+x5%Z)6S44@gIsT8
zzK^PH_<gQ@Y#)CFQr|?MeYLx5bJalIBL(73@JJQJs(VfaOD;PDv@NdR%T)VBxR-sK
z_NG^^p?I%X-mO>fb26s?*ttJ;<9fVV;1tN?T@vDL`{~IEn9-*^;j*r<>nYPW9^dNB
z#n_!Cf33dV#1z|A{ko@h=kIE&k4-#Vdp`9AJQt|r4ro-=>J99CZJ-&HXT|08rK%b0
zw9&jacKns_Jt{i5uf3QzWa#Nad`R<omaWu2DW&kCNbz=M+mH&_`M`nR?j-wONn7bd
z`Mw~uq4%x0{jfa|Na;^M*1N|{UT~jos$RXv5dX=}?*0`V;GmKn=9$CZC=VdGuimbU
zwN2!8PsJS$-nlE?k!!NLDKejX-=Nq>j+h*|Tu@(f_U?K$RArYbf$Qpc$+n2}mP6^S
z7pqSO-`=DjU$W(JD@&n5+b{YI{kPgRDA2Z}CMR97=@0@yA7AQ?4|c~YpkMQpn^qKL
z0);T9T>En%Rz2Fwqt^+}VHK8o3y;n2nDX8uyvn!s0!{zOPW1d$MsyEN{3`m8(|Qw5
z=a$yR%^*u_>1oSlIiqv+L0d31b{Q|^%?(nPVRQ+v+{aDyoUkfpSOGmaThj&v3|dp2
zkdBaoV}0ngJ2>6z_jnSc#-7$%WNO{}NLfD}D;W*DAAx-Gp)j%Sw;w(28{ZVkaCgwQ
z?~Wn`3jX+tPF>3LhqEKb>2o1KTniv%#(=s)4}Jeo+)RgF7gopyoy`#Os&uGGE)<Z#
zj-wm1BHzSMLZgy$r0^mR(-qXJW!rt$s&l!DBTv7@T>5bHBP$uz-Bak1Pq;s{dvgDc
zT|5w?nZDc<Exv=G5m)gVaMk#kwi?H9$kvgAz3`x`pr=4zePFaOnsHbt5kJeiPbHmJ
zMHN3G{GzS?&cqqpLn64`U;Q4J8#tNsO<R)jahtmD6NR!@o+*q`GgknzG;X`ep06%$
z>bp-V=x$P>brguHcL|&9QIc@>%KJm9;*7M@^a3(1+91?+NCNKglbukkti?-1y%VZo
zLGXDh2l#sVYiW1W+=3x3xCg^<KZN=$UBHG5Ttu{dgImT_cqmugAn#zhB^#_IeOZ)*
zw6SaiA{}c3RWfDH-ML>B#H`ia^r!Djq%Y^CBpv_|mGl$Fn;Y43>R>swlyqe-D@sW}
zIhw6JJ=7u?s-J2EVO2)5&P!_@Lf#%UyzG-1wC8CP6lrFDqY>1HAw19IowYYLTVivl
zv?Sch?aHf_6?mSuX80xQzsfHA`~UHcEj|dvlM9@}{?GyL8<BforvxKwHC?{gF7>@(
z(xZp7r0qp5^=}Ny-^gEkp@n)mz}k-ylMPG%)&1BbV>1ZV*#SBV)_HL<`dwD5!u9BZ
z(9qwffs&^I=?K6w(Ox-GEHshPv}lufHF!g6z8`JSaKgbd27Rks`OdlqK6rN`G_63K
z*2$j4Y7>SL3lyeh?IC#9A{4GS{RCeAd(ES2s&+i{PAN^+I)nF#VL7Q?47AN3q?-^2
z(wKoQu3eo$EFnX9zL`$kjz{%2;<@01wr#;vox$5};YEX_O{&K{5Kn_nTbRWsC7PQr
zLtbU%$?4ozU%L6qsym{rRm4YQZ{-#0IHHV7U`OL>@l1&7VdZS8uYT&2+017@tAz)>
zjPGhp6m%bEDn8xi3Mqb*SGz+lIzZDw-+P3e;sX|hK(;-r3(v8UElzStKkE82Nng1_
zgT7un6Owi5dv`P!M~hZSNtab@j%;hy*gqd(T%Nkz$p7G%XxoNawc50XG(a=Ow6|9E
zF{)Qn<=BgruK@Jh0MxTg$(fhPt?MifY6SAFF%Q9(=$JD~x(Pe)J6Qa?jle+5Yc#pz
zLWVa-gk$zE-)egczJk%uM!Wk8$t5VjdR&!M9k?(#620-pTg`;gcs{oH5PrEqYR=I-
zx$vr6ncIg^XVW195l=Q)msS~iC$gIliZ|Ms)u`fTQnZj&bc3AIduP&b<J;QA1fHu6
zwZ17gk7(=!e|gl}x6oJ?nc(vFnat-nd>-F%+@FCRA4AQVZ1bo9xu?5<-_IA{o8Nf;
z5&124^^8D#aPlzw>G$Bg-y10cF~gAN-gh?ISK}%G-!pm+4y3-5uT{LGgMnXUD-<!!
zPhX*!1~b!?>3%-(MpI>9!Vi(jDM^eTSL{n&1Alkv@gM`Q{Oxn~b47$mxtqDK$;d&Z
zxoFbmav#3?4yO6Cpl72Rn9c|p@|+&mw#f=f-_jg%BSp8_unl<by$LvRB`|!Gv&i^X
z(o8C}AEurkLUT6sux=|r1eRg$8pOYjU(1K$?A-qb%#!|QBc2-`+;-f&9rpuIjmo9b
zBZ`wdLCO#iQu_o=q(^05sUa@55gGS0!1Kh`O(OF^=S>=&TW3Vp^-fx49a@gz#}8?G
zB6Ki3U6%2~JV1a2Hy~sVU^amf*c!feI4lSx32~5wMM)ycr0aU{>p*}WQOB2%B!MAG
z=98pqNYeOAlFSH6cAg}+1($OsiKF0v9UwFfeh&bkn}E})>jK(HH*j#Z8o0{-zZf!P
z8RP{`HmAqlAyD7kf@7ZON?pJW=KvA|)RWxQlE`EaG+D-4S4}%vRZmwkP*3WRtesEx
zo1k?uN-{ac7!#<C_Td0+v>jC63Ou6b1&1r^0ialSG)XlLYtlk8Z6TS|=u6^9<@3q%
zXrN>Z#?xrj*=!W*tS>7)0_DIcqDa0hKs8{p%T9{xG6)KwG1<X*5HXJSWC>>=t5FLp
zJ=vIlTnmWS-@&*RVPFTkYJ_BY-xQZkatL@_hA<YmZlEfQ)eNOE^&-n$vZSE%aT2&O
zzm_pwQ9~CXnq3m><27LtY8aDmsDhf%g^fv>7+?ZZ^iYW&p)_hWK;IeaTWwfq5!zKf
z$!;dmc4rL2l5%f`I@pXFgVI&DCi{m1jCOz$2f7{;Sj(B@yP?#NF~(0|lljiZs<<TW
zCR&p;j09dEipKiHkaGAZAHno)#U!?_n?&HS>@zfg(<#V-aRrBo3cu+?pe_c5g%Xk+
z8)%EYuy!#dc9ukQ-(>s!F&H5Q0!TIq)pf=j17?yXC>Zk`T_^zU6hpec1AK94N<;z%
z=1r3@K#5ZzpaB$tBY6`suozNriz%!6NV4KM$(npgvNjtVpdL57V=`cLeQM%H3q}!$
z^{z0!Q2~ZQlSwF&@XnZwJ<ydU(U0CN+?q1HMV6VNxsjtQ2S9HJn!gt{|A<7t!@xID
zi9ABO@nEd&CPiXC*>i?ka{lEck*4_2P{~?X31hyCGzaXMcX^G50h3)DFdjw5YJn-n
z$YdvX>;MWLoKL>PlA;etz7tCJoS~8&0096mmj;r^W|YxDia8Vkv_a6(BP6%RAON%;
z3J%;!IY1@eZNNzGzm~YTdsIVCI3zC&Ae{L1yaM%=QMBF@*zi)IZyNBHc9L-@*3}+Z
zP$PNs!bo5ls7yaALytAL$5^UgQU$2fHUQCqp#YZ|a@mD3fC($=GRGn?C$d15(U+u&
zp0m^jm>FRY255Y8NZ0<%3f&s9gz5Jkl1*hz6>4XfFDh2_bcy+xa8#lnwC>(ACVt+)
zi2l`;og~j3poipa01ORV*OdvvdLqW}_>M>847HHfMg`XTqd<c$Ly9tumo|;oA(<CE
zfgVVL-?G*Mj==tmBM#@&2W-yqvz~`G2^S0QoQoERR(~faJnoFT=q=uNS>zox()C)D
zH%nqpTlCkr^(naH+qD?9y%;>Ycza<nm~$zNb1~$oTvw9T1F;l&e<><*DLQ2-reG<y
zb}6oFDZbSXPyq-T6#?-cE+y0s1ME%1#g>zv>P7^W-&0vmxo<D6x4dGpj4iOo{%1d#
zzMMX4AKq#|+`EiBS`K=<Jh;1@Ew<t<w|J~$hq75IxW7^ux$=0y?g41|Nv*>#w&io#
zmD0?`oZ6Dyg_Uw9y|N&_a?onk5h*WaIaFn}_SS0R{nh$WcqJ!aRmy5pfn&=oAix*f
zy1n}BX!SX0t&MZ7U2LsGWvx@+sdI3(!2(kpxz>|X#Ai0#Tf5fRwbnnnHn6ZZxV<)b
Ig&v^!Kj6PT+W-In

diff --git a/docs/epy/uml_class_diagram_for_googleap_17.gif b/docs/epy/uml_class_diagram_for_googleap_17.gif
index 1af681ac67a341a39a8e1dd3155fdcfb02982d2c..419b9cafeff683a3882c428322fc3b0302542eec 100644
GIT binary patch
literal 12836
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

literal 11911
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_18.gif b/docs/epy/uml_class_diagram_for_googleap_18.gif
index e28ee2e8ba78f8e655d525fd177025beaada3a04..87ad7ed0bb798fdfdfeebdc0e89c2d5c7fca687c 100644
GIT binary patch
literal 12338
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
BTweeH

literal 10254
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_19.gif b/docs/epy/uml_class_diagram_for_googleap_19.gif
index f5beaac93b1922eeee8999113e1f7fb57c5ba60d..b8009bda49152c518abf629537f1ccd7195cbf1d 100644
GIT binary patch
literal 13296
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
CeD1^m

literal 10868
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
E4=jYV8vp<R

diff --git a/docs/epy/uml_class_diagram_for_googleap_2.gif b/docs/epy/uml_class_diagram_for_googleap_2.gif
index 040ca7565fe2a2e142a39ff4155d8118460d78c0..57b1f6f3be13806d647c5afddbc82ae0756dee73 100644
GIT binary patch
literal 5407
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

literal 4675
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
Az5oCK

diff --git a/docs/epy/uml_class_diagram_for_googleap_20.gif b/docs/epy/uml_class_diagram_for_googleap_20.gif
index d3b22122f71e9e0673afd25268db698328d70de4..bbb2092923ef5d33fe4e3193f95dc24235ed6792 100644
GIT binary patch
literal 13092
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
NoOFrd0-=D@{|A5}Il2G<

literal 10654
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
D4ccDu

diff --git a/docs/epy/uml_class_diagram_for_googleap_21.gif b/docs/epy/uml_class_diagram_for_googleap_21.gif
index ef77139db560a9ca1c4938723f924848097ea073..8097ecad27af31e83879918563a5abd77b42bd03 100644
GIT binary patch
literal 12351
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
BCqDoH

literal 10681
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
KqbyKB{r>>kV5kBB

diff --git a/docs/epy/uml_class_diagram_for_googleap_22.gif b/docs/epy/uml_class_diagram_for_googleap_22.gif
index 35fa369158f2d823227d0d014c588a87dbb704db..202ad11aac0b97060c13ac8c057e72a2eeadf415 100644
GIT binary patch
literal 11503
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
Qmk(nn9{st^00UJ24~Yl;TmS$7

literal 9705
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_23.gif b/docs/epy/uml_class_diagram_for_googleap_23.gif
index f48a690aa90e36103adea1c1a1774accd372ff86..0991530c3ada85438dd848456202b5851412b9f5 100644
GIT binary patch
literal 11514
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%0ANvc5~m6<2fbfA?PUWIhu=
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
F{|6(_>aqX;

delta 9604
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_24.gif b/docs/epy/uml_class_diagram_for_googleap_24.gif
index 794fdf89083ad4bedf91ee655dd8ab921d3494ac..195370bbb09f398382713bd490d3735911fc378e 100644
GIT binary patch
literal 5488
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
BLuCK}

literal 4352
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
Bei#4%

diff --git a/docs/epy/uml_class_diagram_for_googleap_25.gif b/docs/epy/uml_class_diagram_for_googleap_25.gif
index a48db3a25a79777d907d84f1469cf20145f50945..6949e28cb5033cb8f2e2304c7e661c40b9808343 100644
GIT binary patch
literal 5976
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
R0c-OaYkPt<!;b-a{|7iM8Pos(

delta 4640
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
WoXy(2&D`A0-u%tr?9B%d2mm|5zi<5j

diff --git a/docs/epy/uml_class_diagram_for_googleap_26.gif b/docs/epy/uml_class_diagram_for_googleap_26.gif
index d2e72dd55243906dc0f34e18f02d5d7a05d6c7d5..40eb954d1eb16ae7177ed470588ccc485f3379c4 100644
GIT binary patch
literal 5660
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
T`||Po`0{<FC;RItB+&m4n@))p

delta 4570
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
EJ0b2Gw*UYD

diff --git a/docs/epy/uml_class_diagram_for_googleap_27.gif b/docs/epy/uml_class_diagram_for_googleap_27.gif
index 9c2bffb45cc1233749755e2e4a5cd25c35db5490..f3d3781ff66f65b1e9b059f92f2eaaf120aad656 100644
GIT binary patch
literal 10398
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
SRA<fkUo}k6%D8`@eE$djNp>#)

literal 7942
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
Bbb0^)

diff --git a/docs/epy/uml_class_diagram_for_googleap_28.gif b/docs/epy/uml_class_diagram_for_googleap_28.gif
index ae44c0f958ba4119749d96283c2395c948a04906..32b5628d7c23c5edffb78cfb0c33fb6cc1178934 100644
GIT binary patch
delta 3548
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

delta 2879
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_29.gif b/docs/epy/uml_class_diagram_for_googleap_29.gif
index cae3b904ebb80cdd69b86ab0cf1c8014d63c916f..0bcf20937a8c3e81afa6e8d68ae200dc3be4c85e 100644
GIT binary patch
literal 3740
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

literal 3280
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
K*0R$9!0x{=|DyZ=

diff --git a/docs/epy/uml_class_diagram_for_googleap_3.gif b/docs/epy/uml_class_diagram_for_googleap_3.gif
index 3ab1c485034c8429a09a0b91305ab2f78ce32b4c..0bd1afd25c2a1e999260c612f3b16e1b47424822 100644
GIT binary patch
literal 3258
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

literal 2937
zcmc(c`6JVf1Asp}*vuTQWn^+R5ks+Zv@%S{l9(f{Qtv9Xa<r6QuXkh47IK%la!U+L
zuGp3`SLCQvA}Pudk)t%<@At3xK7YXT{O~w99k#GMTL^Llz5oCe4CTad$cM@8&)Zuv
z(wOJyI33(jRVCep!VF;&O$lfex~Qb6D3UWdG1-2<h~h#a?8428+c^P@$)=XdL@pA6
zWcbjyA<T^zJycsV*@}qWjvcC~OuHH0lFJJZVBih#ll20+C$%Vn+fz|VFvf3m^&n-T
z;pgah9o+kRLC^gnnhRyQtA~4qG27ZA$VfvgBGW>dv?COX6%n@`3zdcPA~}>Jl$LwE
z_q77L8<o7DfK@?PR#X<na5khHR8K0w0KfdaopXgT`Cmgy8d4F-JWb<<GB*Z>sE5hC
zi17AY9>bGbnZP9)<HIk|@w;$6B}J4&MBEPS=B5<*KcT%21p$B;fd60re@_6Ilw}hc
z#fgrIjf+pX#l4-Flzb;8H7z|OGwbfXY#!G-C%@o+VNr2OX<2y%C+|U3HNU2|PVgwV
zzM-+Hx#daS!&Z^_Y5Oy=@OfufcTaDI<i*Q@!J&@f*KbDNmi52;FgE@%Zgk@Fm#LSN
z(=)SkP2Xaz!Ar|OS60{7fBoM0Bi#fb2&^MNUlax3YCx0h(S*Vh$JJ01QSr}ishS16
zm(&z?Bx%_tV4Z4<I#c!CD`=gy#od|eAV>O7M|i5P#no@`JL^jO@<>q#jU$4xmxYe0
z2B*3N<%6ZJg)3=lHD8XFd)Ebwc0GFVy4v@taq(NfUE0~_1}l!rvz%gh(gOheb~6s5
zAn!b_Gu&KXeWr~bXleWVG5=!?;3!OgcQqQxLm}`5085-AvDdK62ydvHDq~~rYLM6J
zz7AS|xXEXsdSf}&OQwgmt3R51XKiP=-KdN(KXwT;8|U`<;b}P|`kLc}tt?BXHq#>3
z#XJhFDDUGa48wsDn)XH3NfDOoAsA->IIazWEUb#cmJ}z{TmPvNU(XlX<Q`7ira{@u
zKF!>skC8QC2C?Lv@HXuVL{|U`>`{$N{TD!F?bwPUfP|r|(GBTW;(NUE;`FU_-=oaD
zNjBF2EX!TS)7!5Av~8S8O4P%W$g(bz9jaVYW1GKjY7R*solBrp=;wJHJ#6_(@!D=a
z=u}$4V=_$tjYSbnA6-7U1wm%9lB+t?bzNvB4#nAS&%@C1pGdo>a%_znBW0W<={8)m
zS8KXq%oD*-7hTSjSiyll4!-yD&xy%9&c^Xm#qI|!-*{w&-b*ds0SHxNU}akNG&1?3
zHryQ>!~zp(vLvK28X(D)t*o9YcN2bnP?|fSmXsq54e*y$-xI?N={cVdoR(3%X^T3f
zWdn&jA`!A-1pGK&&~>kaSDm5qcR4>MOH$rATR$^@c3S2BeDm_FOVwVB1A?zlHdbZ=
z-PRRNzqdg#jG%yf`$Hx~NOQ&&VPp>`vJ5TtVk|yWy;!;U9D99su|q2s|3iYyWc=vV
zFRlF1g%8A%JQ62;?NNl+jHO<Ssmi4n#MRlQJ`&7mxu1-=y!_Hp@8R+Q#XQFhKng1t
zniRb*@5@z&?OhnAUGJs8I{CNJ%9}R!QT&Ks>FC{&-xYH!?-reUCE}phm(Bg;%uIv3
z!&m24$5=4qwQ&w6@kjUhgF1DCT=V(0Pst9(>yv3-iG-mL6Wi5M-t|KlKiqSlTc0k1
zJzE(nF0Hy*a@Vl7@z|r{#vw%yWslKQo6qMP=i7!=FiI|K%wO;C!=g_d%kmGUD#R*A
zpFiK&w=4a}?Srr87q!o|d6x$+62hmYCl=@3VV+FuOxi?qcB@-Ub=$Amkju%1tNG2R
ziLN)xJ97VK9=%8fDfo!DlmtQ40g#@WqZq7`%t0;(5*tNqgo-Ov>x~fnq~aD>Z7l<&
zvcLl4@<ENCG!}-QK@9jLrNr@4h5fEKX8e^3R3U(zTYsc#nu2mApQV?t$ChXK(wIW_
z_|NvJoy&QEv+53A@SP|=1lW?Z(2mjB!s)h3%8XlM&(L9H4?><xy#$1HRNC)`Kc{N9
zW+RE~mZ8t;gbJcan1tZH*F>ysc;#q0BN61;@7zCrc6N$kj^LM8UCQ^y^VJC=_yx)~
z*(?%U5veT`4@CfeQW8{YZ$YZ2j~Hhd)(Jakno`2S0dWiY@S||qqYEGqE+1lujZ4X(
zuosZ)+VaJ*sku;H9Z-Li249G1!k#z&<R+t0l%QA6EjsP9TN|-xe>anR&McnQizZ)9
zcNV&`WC{8gzWIXXd|ZL%k*y~C>L3@fJAwL<-oTP0JaEXA<zS~4kDsc?JT3+s_;OU&
zNXAylB8@@!HgZc<4uLX|7n<C8U!vuNY5>XNlG&O@HZl)SL@MgI9{-q5a?;D0cCfP=
z;9e0Fss-(K_;;vKQ^p_W4tzvyz}<LU>J3yhRqA%rQ1>_*&=AU@8GN_A6m+@uo!yk5
zZc=wGn~HLs+az>q!f-|avqUYKn%|N}#eVgRIM{1IK99*Ps#mHwb(=-~7w5TCF5#i;
zz8O>~CsiOt=ZDnTLP7?BebFI$k<95o5h-ov1)cv`HHw@v7l2*fB+y==9Ks-mlj8EM
zCjXT9!tNMomyb%FMfvP`Gee<ij*~TQ6qRLRNbLVr>sBwr%6LogIetwAkROf@INpsh
zz5BJ|i44hK`|Xp-jL?R=rv@{cs4n9Po)pXAc^{ASqmTDz*7xUduZ)mSwY2I|h%b$O
z?bY9*B+>AGJBHns#r~fuGi8&z6O=+GBgb>{`R^7**|;E}@1}_$2(^c<*gq!K-B`6#
zh~Pt2hRYo0NHSKsY#KUTZT1`Vad22S%rDMYJ9ryH)*Bovhi`>LyiL%dLmpnUXNeP>
z=f+akQ~u})U2YaJ#+G`6N*v$beYkyEor=C1`PU}+Mn|NrX>xXEnK~xyp@AyiWdq)~
zwZHmWf-XHE#4!6J${u3k9VzeX%2q4@4q|*G;a0wp@>GG`1t~SY96e?EI;{8d6>&Cb
z?gGZq*Yi<RI*jh*43QM~F<VKOJHq|2$~F+(j-{+mA-V?M+Qj54voi}VTW#gHCyo;d
z4;j&hLB`rcDZ3sKuYxbRw^{O<O+AWDa_BsMmj_=gS9!<F?zFT|S+BN!@xf=T|H;Bw
zYLoH)lFp?WuV(=x5gE%jFY;MC(L))|EHT<Uv!Q-laZUEhU>$b=x?O)5VeV?P6vqP8
zBrI6ji@-+0KWAXWzduZ~!7ZQv%-=9KIr;9Jr)-+93~rB-)pEUgtDZusjzs8sw>6NK
z(M2+Gz>bHHTyKCylm&i-etiGqRns4%;N{tD6V1E^p~C#(3k4k$s(O8bifcx^cA7I$
zWGSEY$8cnQW6V@9thcWYTCn<7G*qh+7t#6(IejMypL`2#vGdHH!Rs~t+G4P;Fzsp8
zXL!v+mS^x^D_hv`OM!s{a^ZY%h`j8z91%%2{XVM=J$4pB4H7}9<Lt5JQN!3a>O|oX
zOAj8{8mq4$;hL@^(TD6`eFP9x7JK}{>_6hCS!sv9Z*{i*FmnfXVA|_@eS1XCPyQ5d
z#$EIG+ozXTwjO^ncm4aG_ZVCFEk@)*?6Hjr_02WOvDP1%eH&j6Y_9hwwJw()`}6JO
z=C3z>tt*cM!^gJjfMVp^);f+!e`IfNOltz)Mn%$<<~H<FSlh<bvCWXzo6@zu%`3}&
zo6;$3sT9Kkmni@iEZG~ZURM^pfrV5>BHpl+RoQ|C7RsBgB2mC(vA286TPwqX1OEZ&
CZ!u2*

diff --git a/docs/epy/uml_class_diagram_for_googleap_30.gif b/docs/epy/uml_class_diagram_for_googleap_30.gif
index f2f052c943caa24b93722ad8abd776dfdf6e24fa..9f807450fe7f5320a5afa142a3b4c45db3b599d3 100644
GIT binary patch
literal 15670
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

delta 12781
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_31.gif b/docs/epy/uml_class_diagram_for_googleap_31.gif
index be0878605d87f36f6ddb0c75a816c33b1560bf06..cb1f1e3241cba52fd2bdd1e0267b6b168f08fdf9 100644
GIT binary patch
literal 16007
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
XZM!>Nc5T}BJze&XwQbp<z{&pu0qrqa

literal 13867
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
ZSK2GZZJq~zzMA%(<u!B@0f7L8{{y*VtfK$`

diff --git a/docs/epy/uml_class_diagram_for_googleap_32.gif b/docs/epy/uml_class_diagram_for_googleap_32.gif
index 1d7323b202cc61ae97ab5c6c7d7f417159be286d..ed8f8b50dec81dae456cb53c70c2667521ae21da 100644
GIT binary patch
literal 4782
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
SPMCI2m@iEHmV&he!0f;31pkTv

literal 4235
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_33.gif b/docs/epy/uml_class_diagram_for_googleap_33.gif
index 0aec8e8c4fd6633b624318d13dd077e0dd767689..98e7ed26d635b5e8a305292aebfc929bdd91ab22 100644
GIT binary patch
literal 12543
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

delta 10305
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
R?4rtcgOg&g|K7M%{|8LbWwrnS

diff --git a/docs/epy/uml_class_diagram_for_googleap_34.gif b/docs/epy/uml_class_diagram_for_googleap_34.gif
index 7f3564e661d050af6d58c8225e8d355ebc2e471d..07ba985ce4a5770a29852e776afa935b3d2d8f90 100644
GIT binary patch
literal 6315
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
LfoH;hwf_GBsGQ#i

literal 5138
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
Jm&pL2_kZbu2dw}A

diff --git a/docs/epy/uml_class_diagram_for_googleap_35.gif b/docs/epy/uml_class_diagram_for_googleap_35.gif
index c263227ff666bea94bfe3394823bb2d342a84a5e..597b75abd3638ab4050926ed93e57cc233998d4a 100644
GIT binary patch
literal 3710
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
E1N8+d5&!@I

literal 3196
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
Wa*oVM*i8^B7{cCU;Y}k1u>HRW5^Q4t

diff --git a/docs/epy/uml_class_diagram_for_googleap_36.gif b/docs/epy/uml_class_diagram_for_googleap_36.gif
index ed62595332d35e167f7783848dff49f57340f9e9..5940a4322e74e597e8727100d74ec6d218cad8e9 100644
GIT binary patch
delta 6695
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
E09Vmx*8l(j

literal 5249
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
BTLu6C

diff --git a/docs/epy/uml_class_diagram_for_googleap_37.gif b/docs/epy/uml_class_diagram_for_googleap_37.gif
index dbf307c8136ec3ee789dfb3cd7b855511e312650..be15041dbb8cdcfd88e8279f02f7b2acf3629f6b 100644
GIT binary patch
literal 3081
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
M=T21%TmabpU+%9yh5!Hn

literal 2836
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
A*8l(j

diff --git a/docs/epy/uml_class_diagram_for_googleap_38.gif b/docs/epy/uml_class_diagram_for_googleap_38.gif
index 22b7ac0cbedeed2d9b42f839841bb659bc75b4df..69aca278013949d8e6bc8229338fee21623d9758 100644
GIT binary patch
literal 9445
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
IBmiLl2f}931^@s6

literal 8184
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
A$^ZZW

diff --git a/docs/epy/uml_class_diagram_for_googleap_39.gif b/docs/epy/uml_class_diagram_for_googleap_39.gif
index 5c17b4751cda51649b06bf57aa915baeb3a9782b..8de959bab6c50c7f31bc320a08f326002971b6b3 100644
GIT binary patch
literal 12553
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

delta 10237
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
D1n<Mu

diff --git a/docs/epy/uml_class_diagram_for_googleap_4.gif b/docs/epy/uml_class_diagram_for_googleap_4.gif
index 23819fca703f58a2828d7e547d5acb9727ff05f7..c56352655a9b1807233c1b35a2422cf68d4db038 100644
GIT binary patch
delta 5485
zcmY+Fc|4T+`~TnfeUF*3b`L{iDPwEwXGWGG)z~S@(jp~9(n$_NS!e7^r4b=iV<}lG
zq)nEw6N<8i&RAMR8CzPM=G*7@-|zb4`s4cRdc9tc*W;O`_CSkiV`oh_@(O|dz!3P~
z;IUY75fOrfgfxL5FD<=QR#rtpK}$u2Mxp3yY8vb6?xfMo4Gpc0jrZ={xu3x}WM$=Q
zW8=Peuh;(lK2A=j4;~CSawO>3vGZPDkv={NXU?Pq1Y8ad&Ik+3x^N*cI{GGy6(1j8
zoS0ael2V?Q#;m$><xytlv+V4Kyu6m1H#-UoOG-+5Zr^@&_ilN4`QW{K<25zB$B$?0
z>gF07TUuJawzRBtbO`$U1p>kUd-(rbN<T2d0GI&n|6Ttl3Sb4?f<Rksxhq{I!QK8Q
zxBBmf?78RmV6-x<=SxHrZ%fq$d)@q3pK2re0-pcNe;T##!T93$`j}UXzXYt<%wk9v
zVPiq&Af$u^2FC$OE%O&7FS_<^{ris};I9!idZrRA&m?XCd!nnlxbuqQj~|F#O-XmA
zx{LB`V4)for5$)tVE6D&Uq0R{4B~GpeI>ZXh&Q+7f_Nt^d;stMqPEQCy2&$s)SgG>
zL+N-rUY}~l5s%xBf8qIE+H*Aa<b!heo?)*+9hdPJH?)i@7&!N!D3r`&h_K|v@ah~Q
zE(tI(_>Fjo%tJQOO)Yb&z$O)n-vK7Z*Z-P)#VKnXk~FHFdqXE2V?o|l$$+^Z|NSTo
zE|ZV|9<K`EQV=f(d`dH&gY<0yt}L1g5LQqJZES~e!_V`h2h(3Vn>=4%lqZPkQUL>*
zM7K@2UIE)!5~qUHyHGwic^WXU%zSbLp2-MwjcO4wKiR+a0)Ct8K$vStDK8#X_SwwP
z0RWc3i#c+WgrZmiL|6o{xVzJY23gqeQ~e-V0)#*q<YbpuGGW+nh9P!*ig(#`8(oPZ
zevDJZ2JN1$VqODP5JU<<QHV^vBQGITg(tyKG}VF)$&N8+azsA(wWoV#hrhi-x0g8r
z(F##+h;Y;poGD92GyU~>fPv3$c;a!9{uHo;v!PE=et*O14@D!XM})3lvVI|xCj(Lt
zAwZ&nTXZU5!MI}=S`lT5eitnGqY*g-&zhCv(TLM`^7s6$<(}>g&E2biVPGNZ0%PJu
znMgOIl3_HP>Sz!DC+Gj5KW+HczMWQQzC0TBl|OLbWug4b6JC<meaneGW_`~--Kh|K
zty_3J|MfY)Lu;|VIVG?Uv3_5%*tqd+ez6JQwE0}jW`BM&o>Iwg5i?rgx1u)MOKrr%
z{!8s7gxg{}6SlC_NyZ%rAihiTU+z|C#vAJq)k+tZd#K(|mZfw${a5<vhYcP|8GKw=
zdBu2DdroR6?(FJ-t+&3u)T-f^)i;hdI%|Um4xcs9`Svy8ua0BqzpRaTChL3~^~pK=
zZOqT2lGbVW<jc2lqE3V5K;X#P^RI)o%+@EP)}zn8vs?JG&PzxZqf5q}?~gOnIHu0b
z5GU!E#3j>97-muM4TiC`EH%<em@PDGK8u7`ncL9(Jp08hu|v*#<uCZMr!#Ko3i|Ow
z`x16oRi42h(NH4G%<a}`egy6@PP%peugeCRAGQ>-cQBF_mFPkglD_$@mg{FnAr<{W
zvx|m+)BF%R%LiuojiLW65>6&SOavaX?uXO=DT#xyeE=*O(6+8^<3Qq;0OYISzXh_I
zVqIAw#Bj3J29A-I#Q>1q%hgYM07rTcL4K1CZx0)TV*rtHWPuur)LJ+O0+lxj7#p@o
zIf$2tg#>WT);P?WD7r1d?AZ58m;-P|mV3>olZ{yi9FH7l61p}%kL1Scqe{)?oE3ac
zlX~8Jrf~NO@$TtXPj?PHnCXroa@bl}%Q&cvXU_Z7mRKT4jDyCC7#vb(+ypP~Hv~j~
zxe`{VIH~l06&WPXc6unye6q|_D)VHgsf^_nYi+M8Ju;Xse2^S@46oRCwQ)^W5|>0Q
zmPCq}5Z?J8H|H^qISJh*<j(_u#Bw%4Arj_K?dZ47^gSWUE)Mwc<At~?u*c1wj-sIq
z-JKM+I29y-KuH*&Eb$G!T-jXUjA8GNBl6(arrha3PHdY3D^bH1Ks9zs7>p+<-!Aqa
zJV+8GdICz|48w%aLS#6Yn@l$)hD2uW&0bFk&_7BT&*WIdRg=X=0j$o7ml>71<tv;4
zQ32;q9%LiHa5as174?>vE9jo!Y7gVUm^2Z$&8lqA4(Ud09=I;b9r69{?8Jm?$-9LZ
zj&?Q!O>|BuZb;Ng5Z5WC+K~W^Sy(ZYg>XIZ-hgbajYODTBMP*=E)G(1kmOJ-X${lk
zf2RiCp4&pLwbY2PFV%lB(Bp%xlx}ZUfr?nshSJoyR7DA0U@xTlASAQw(!q~ob<cl$
z=R<fi5r9^b$mq3RB5QjP-`U5Ir={mu2$ada7hb-x%Wk&678udz(PDVNDB9OdCC$;Z
zrs@WUd4ZCsse;PNm<0;+T;Tejuh*VYQzZuGWA^Qdmv&EsXxACYZ(^IKjOCpu*i3r6
zuzQE^149oTfh~k`3-F#ASX_!7Ui&tS`IG^+KQ)71QsN!wGSg&EatT6i4&V|Gi%Ym9
z^!QgkPmJQQDaA}wg1h_kYAW`Eb{CB2Ga<Q8IZeOM0t`C={C<XB)BKMw{xeeP_%x?3
z&v*tHupvCktDx*V?RvF`D;m0jRpDYKw2#S)Aq+0|M-W@Z#%DZ%v-?`+g1@eP^9P@Q
zusD`IB*88f@hs~Oe;b(mS8hQ)!1U%oc#*(Q!zzjy@MwE%SP)BolHXy(Wj4nKrp&ni
zmm=HxGB!PgtL?f^r*^mJ{gr@-l~_38J?yV-8=UR^-ojV*l|;JTHlttK2wwQ**yR0-
z0<X%V`@O&cF8hbWA20Z5Nx|~g9Hh;3K7M(z$`$Ttj+;~PQ0P5eni#G&F4r=H@x$U&
z)aQP3#@TQcdv~Dpb>U$bW}!TAN<qdLC2Ok(m#6vgxY|N>U)i;En1Qt^Iv0%p#qw5)
z1ct6xux|QRF>bX~%s!72GscAE>Zx68OODRyMFg(KVPqQ>GpxZs;XAm@#3fehNb<BS
z)%2ZF?s`nY*^WmrizSx}poFZM8_Ogng{7CId@2x8QUJ}&t+p?aIFMcOk!OTwIcqxh
zW<N=e6L`H3JDt^a?$?I7DB1Zeh69;lXFt(VE<uayRK+cbc++V1Xs4*)77LhGtj|64
zz4}#gQ5gR@el3)l{&MZRI`{TerhZnu1S;;oK2NXObS=H>bSys9aqxq7ZRu>&>SOYU
zvVim0zFkb@?8Su&)`-ceEsOav>y$~FtI^S()5ny_ho1%g)!dfR^&zojaFWFMfcS88
zWu+O|k#Ap7jr*nT;p0|k9HjWY*G)mKCzgo*p|pA>p1dts@5aDS{i?Gb+cjE$V8z-k
z*npMGvQvYvVh{1$iTwT63a?*VEq;7Dd+rmY$>e_(wicYYmdCUp?%xRxHMw5tdHL{i
zDP7$DC1t~%R|1@%3?xQgIVQN)^$%y^6eT&ynBZ-yNEID3sw5z;GNC2;NQ&OpA(qgn
zH*k`_XaQk3+ESmCh%9Ric}E{?ea}e68&Xy_R~`yh);QsQcvYF!603hT4BN)q&YV`F
z(v|595R{BE5?Gt@<grra@`tAj)KDA)*6C96R$^A<#E3#jhYiSxj~}v(Y&1%gS4Jq-
z(ZlOe%|=o0ZiAUSlq$^Tnk=+kCZf30Uu-JGtVEv514PGN&DPr0=TXX`NLkn8)S7VY
zz#(aKM6L?dIVrUS`vM^*ta)C(aa$zY*Xbl7nr;w1RC>xj4pbQ=IKg199olGBvkF$7
zIc1e@kqQOLUkZ{@<i<$rAys%Z8;?YEB@5PatW7cJC}9`rfx%=B<ZAAkQJfaik%mjT
zbo|Msdoyb4Jpb;lOV;LQa%<K)&LF5W+K_eGBgl%Cum{Ir22HyfW2onZVr^p7O_H-z
z_r6x$@0{kMcl2=W<@{>3H{YdCp8{@5>9)%!R@Bpc2_~4Jgr9fM=$v2!NKJP1JjjT#
z4h{uo+Vv#Ms4mjnHCR&}oePD*Bet7fO5=L^=CM@ZmBi`Vm+lt;P5HO4C6y48@w8+`
zdV~%Nn41d0duv8$r;`|GYm!rRY>K6odbFIanxHCER~dLn`_O3cJTY_C8#!kPoiTt8
z5@U~q!ZZ|2WxDM%M-YapK!Xg}Q1s>^*sknq<F`NELqdZoFq?vNgp8<&2zPh#>uvwU
z*&LWlvr^7Z_1PPaI~twppVD$|JDSb(PR(U>?^8&GK$nzlFf7rpsM4RiG2$(~yeVJW
zn0Z~D#<JPYhuWm_)GYH-rnmLh9Pd1oS7m1=eRZdyCx~(etLG3Yu61ph`fQi)98R`b
zHXqM1DYG+`HO#7ug@(?<L9d-cPEahuaw1wNk7!}(D(VT&aME&KnjYXYX^0jFh;ZaP
zHEsmAsCMPLXUt?HLh4WK-0JLdhEpl_N6brQ5fyI839GDrjZ;5LAcaH_VTT9>n#60M
z$FHBK@NNha;hcm|1y;g2+QvC<!ssy#z1%n97X0vb+vLD-&^(Be97A>4Bs}Mjp~y51
z=)Q3O9t(B5?%B%>Crx=5Rki|oIOBj`n!gp4J8(v)>g1MSK)I%X4+N3`6{Ol99C4~4
z1Bkuf|1`;{JS!+X>8_=w>}x442FR^G2x2wzS|}F|0Q1kWjwU4F7^+pJgrLxdH=@*X
zXNUCdpok1@lj1XB&W|{nwAfODn#+!1=H{zWI4Tn=iNEtG&SoO#_?(o}<)3$JPxz6l
zTu$Yc<vmpdo<(O40s`ZXF#9<Bg+{9e>ac#WOb)#(DV13lcM>Xw$;ET;H8{$e0?)rS
zL9AwZi)MhFY?ZRs15MXjcFs~zW!-0w;;WkCsEnb>Em>kYTy^M`+#ON1?0hRxF~@)q
z8D{bJx*|+}k;i*DuO-oc=#Ks8lKak;#Ltma5f$6rl7hQcZ6bhOgfo?KOxYrH!YflI
zh=nB}nx&x*ZF0gHk-`}=9!lO>ZpQzlIu8;ptNmoO_}X|;8A2o~)`NDKqq?kJFU?U6
zYBf?_O%6xqJ8gHZMs~puyRM=smMBxdzd9MCEffSLg*@~ue290dF&KnTds!MeR-4bG
zcJi`Qk6l}csEFv*uUJ&+qIR(*YAaeRQeE4shw3v-6?fEv1CJ82P=V7$XT5PXIH<-m
zqZ)Cl#s)n;a-mwDw<n;BR!@W?DxOGJJ&E~Md-cPUD6OXv74kBy8gT;5Oc_D-4AEAE
zn5HFlMT?*_E<*$N^)l?XdLfgo<~c`IGJX*=e@Wq~d&rs?{aJ#M=M(h-=&YQcCY$wk
z864~;P&oj9guc7^F&(ZFSFWm)uW#9*TbhrQ?Wpg{ufOPA-&s-r@>e~frJgI=FnF}V
zK)GQ!zu|49%Bbj83X|HPZlzl00?Ro*9FJ_YdDGy!lmRX6!cH|NVl2dBZNzzi8VK)C
zYy5f9sIfwYH;%RyKP%DCxV^3&ma>OX4Ji-WUcy-8`lSST$LGIxG#eK;iqnvrMF*3v
z9m;K|gjkUpG4}J#0HFdg&p*tye`??+5d;#KniGRuiOej=yo@4ZRIBtvllO8HJODlq
z>;&e1*Gv4)W8LK$S(`W}{Z?nr4WlO3r=C^&jU3rx{Y@H2)_RuG>b9XLQ;+_hF_i;k
zN29hyf@1$Q4<mqV0xJE|;X}iy7R%!7dWg}-;0qz`Qe$aH>pRJB+C^d$PhrVwxv`3p
z%I0{cy9T30tP1#FGCT1-LOjDCA|&M8j>qPnuTe${UUU{L&|(VEo9)_L0eLRh4k=T$
zhuv}DsBECKUBcDaX;h7yxn#?>S7u9SYYBoTy6Y!sw+c|4ClnbDri63zzHM5tyRpTp
z$2rIL<I`T~XThy5w9wS&jWOlSiQe<tOf8ju`G$?Yf0ujkQ%><gQ1^vOleZeTrai(p
z+sl)q@H_~qDsJ|vc={8?1s>}AOn*?<7rOZ|PockF`6X`3nC$7hH($nm-pXd)(xs@M
z{u~t%d*qV;kaZDUQR|mGt2Ox?PWUxIV8NRLp{8JvGEdm*@N}En(|sq%m<p7sPJS-G
z^UWpmexV%@j`jS2(oU&rD9!Q><3BaSErXUi{TA+nwtYP|HwNt++V@TlI__-Vzh&q^
zLxYR^kgG$(;RYG@8}v^69x}I1p}J0R#C=$`dPq!(Ap|uEnVHK#yTk_=SzWCG?&#m{
zD3ROh+b|*?JN%cSH8k)Pv5#PG*Fs@?H$tIBVeK9;z}T6BMum*Fsf?zGKYG_XlG{Kw
z*-(!VNAFwh-?HXZuHv$i?2>vL)-Y{Ri)taYI79`zN|@Q-)Y;GJb0!aYKM3-<WHJ7B
z_U*##zA=lp^WNh>FooBnC#0%}%ELT<Jo3=`;Gt*T*5K7<Td@DSrJp!c$-U>Yhi1o#
zt)yUF^`sZAt>N35rqRiTjRRc`?=}@qq~UIh=LG3UPM%aiPt|YzJ1XTmCbX}^T!jB_
zF)2vy<EXDSD%knxdO~;}#e4I|K!NV-+J!As#?@nWugA=46T3D$eO$kos1TpvZk*QJ
z<sWJp-;0(Wj_OQyk&|Hl%XH@<g^3zBW4V;5w)KmPhXHW}dZ#^QdK^8v<!YvDDox3|
z)bvVu?+cJ?H#a(>jhUse+p}$XxT#s$(UdE$R(ja?y>XE4yP4ySLz{l?V~6MNJ8^w@
z;%2`>sLh}Uar42>IdqpW>Lrn#WS6ZYaa+>#<F99h!H2ATcYO#;XCf`1-zVt$55j~m
zc}-Dnp|RyJpXVL?D)wqwVb@$#rMg>a>hC+wZ$~%7@61dbm8b6~DP{ktd(dC))`cx~
zaT`f|H{*Bqrd<AGbv12icNuX9x86;Cwr=Anw#PQ0$D$^nMoM)4xKDLmmxZ6aA~kUA
z-piRS;;$1T59u!r$Z(jiLC{kot!@i6()as4@tuy$eHougV#Av+?{@irxcQa2^5ui%
z*U!JdPW66O%@qIXxcDt*@%zoipN)$f?-qamUIdE#WykuOKm#n3kH5tiY2u6h%Wv}(
zuR@n3cP|k=mSmVqq+3gJO-l;@E^QSokrkJfcQ31YEN^2jtKV8y(QI1Q{&!hduuN54
c(c8VE@3CUYT%q4uF=<*c{dc7t#eg0E2PUf^NB{r;

literal 4756
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_40.gif b/docs/epy/uml_class_diagram_for_googleap_40.gif
index 2abee821d92193eb13b33a91bf3444c68e0cd5cf..d1b147e4779cdc0cc0029095f3857b4d7dce6f23 100644
GIT binary patch
literal 14387
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
Ncj{|E84L;-{0|z2hA{vD

delta 11402
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
Y{KaSd#&`V3hy2Kw{K=>M9t#KnJKcH(H2?qr

diff --git a/docs/epy/uml_class_diagram_for_googleap_41.gif b/docs/epy/uml_class_diagram_for_googleap_41.gif
index e8905e6e0a5787ea66a8d6bf6ef31be84a715071..6f06b8e3f34d222257de9298960c2c5d1efa5da1 100644
GIT binary patch
literal 4403
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
PC16mx%nk~e0POi6DfVOD

literal 3683
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
D$WC(*

diff --git a/docs/epy/uml_class_diagram_for_googleap_42.gif b/docs/epy/uml_class_diagram_for_googleap_42.gif
index 53e255e0b47b031662e8b0a17d60e574ae83ec63..34def5dc706c14c1bb6a49c125d5f6bb6a6afa38 100644
GIT binary patch
literal 12749
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
Q*35_m1*st<0x<c10M{YruK)l5

delta 10261
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
b<y*$(T-N1X=H*`Y<zEKoU>0V~2nYZ>F9^1<

diff --git a/docs/epy/uml_class_diagram_for_googleap_43.gif b/docs/epy/uml_class_diagram_for_googleap_43.gif
index 81831dd9cd5254dc2502835aee1bb074597ab9e1..4da4b75d4c748b12167f0e770ee31ab1f4992636 100644
GIT binary patch
literal 14325
zcmeHt={wX9)c$Ao8SB``KE}Q_gd{Zfv1H%3#!ev=+0x7yjD2KRWG$qkY;77uQz0Z<
z5<;|EOH%WEpXdGWKlq&&=hb<2?(5vwec#uyw6f4U=6@4J2K@s5x8wjo2LN0EAQ1q_
z0DwZkIgp5C6pEXJBZHHZpNCtBk5`xvoyE^DD!?y|5tb4a%@Y-s5fcd!7nPF`SCW=c
zm63|V;nd}DSLEar6cjWS<+PRMOO%y$R8{pgRLhSXG1SyF(p1aQ!dGf(86VX!*VVGn
z)3esssWvb;Wq88j<Z*iffkYs<m>ATVn!1{sdzhc}v^24{w)U~M_Omv<VQU*`XAx*`
z8{%LU<mh<Y$>yw!t*fi+EmzkwZf*>BI}Z<!QV)+vPtWt-PItV$V|;uPPrD_N+%Nk3
zUkdO{4hp&-983-INe??+6n;AM42gF3Y))k0xpU{T&Yg>njxLA}xfUJGhzZGyjV*~g
zQy3rrC_cU<F|jf+sy8{gIwhv^(xuwe^VMW>BPFgsE$w;QMONCyhV=AX8HqRP^gCH8
zE!o-aIjKXrxgB|wwt|9gMp|c4(W9dDm&L`sCG-cSrF~`DPbw=1D|1J$U1L=h^jB9;
zS2JE-XAITWj?`XhuB)4^E1syYf7RGH(OB~KX8G%;rm3cimX?;u*4Fvfs>QaN`TO@5
zySi2$K3sV8Xrs4xk;&}u@BiN4zcV!Slf_ya9%he?eR=!#`~3XE!ov2)k3YYDWwY7;
zhw%Sz|IZD`{Dz_cpaxL;---Xd2>{6kPNF1;Z8d#qNC6ceR$J{rCR*0|8nL}@Fb8w=
z%si{T{&@k`G+V;zUc-wbCFd5O7xx-pmEi+lUbDJ?W8|vd`Oot&?%#ZUosh;MY2DE@
zUQaAi@qO9R{N|=Zy>*p!XUp4L9{10@f7$tE7zy-eOWJg`&ffQzP4Ioy^-U4b>ta>e
zbl-XZC?N)je${=~74Q~AN!j+aEe+7SzwW*2(R5};FZ1itAgJa3_$2I&VPgBo*ELyS
zw?p!#ARwY4;O2aQmj*HnGOJH{e_BVN=DDO|`ua&0Nf;sF(Sz>VzPo`(?u<M>KK$;;
z1*9&thIq!}IH2aSY2GHq1BlJA!@kK;D2QM&`Lb`1pZqE6er13*g3*d5?WGRGcL&MU
z7Ru#hgoIGBt_3*w0-S*TqW)_k4IO_$T$ZzK9Er4_pGG1kP`VU>T)CPIl6i4_KWA2h
zN1q_K#rkrN$onZ4mmc(9O$H}a0fRJb0+FNhSkpup%7C;2vFkv7yke^>7bwcD2QrZr
zb8~n`;xv;%02h!MX5rWwe7R(X((Fn_7>}H+ESDM{R?@uZK#|PL^(SC+37aMrBE?<L
zAQwve8Y{wuA2#IXt;b!<$jAkNLj8N~1TbpXK}_}tKz?_XCiYpGMsC(Emx>0IF|yGT
zmNU{(P5PMR>qG3%eob{#UaGD4*1W`Tcl}Jl+<6H9BkJ``*rv6OMTL`5dfH#U-XF72
z{nnwNSN^p#YU}ftE-EPJTena6tJ`-MsAs>sF6W;;``}ZTs_Vng*)Q)r+SP@fdt5f+
z{iB!oKIg~XscqG0ry=2pXeLBaP3-;~-LLpgq^jDM{l9<S<-G!-Db9n!PsQ4Yu<xG5
zJkKLZY`@URn{R)i)P3#BOX2%pw}<8W49cYquC?DD*8X)k-WSO20DuUYt2^T=j&-aF
z+hgB$C#Zs09btR-5p8*5Xr6$KlSp*h6iFn`bQ+ex|8w?aqDed`x#rtXyEr0u#w7l6
z<gZgI#BV4rr;F^^UmrB%aC_6q#J})GdiQR|Bn>GShsv_7c0$3F@MFAA=WxH*WW#ZL
zybyI<r|7k^f8+BoH4_FHmOwiAA|8&7lPj7uvRZ(Vz<<6A`QQ8bgS4rUV%E#Hix(MC
z{DGE>)3#3pjZBaCY)_t`C4%0Dvd8x3E<Q#7TF5+y-d`?bqkgYt7Nj1$zxz7%=l7@f
zmkzfT?JxiB|4_jGe(-~x#NMu_^1_Ksu-GOUX<GvpVKL$Qn-p|z4OEfX2Mz#0$fg?j
zF;*W>(q<Y~yGAH=h$2|NNmH_|<#1>93qRaU$LH2^g%StE<~B3*hHH5)vIe9MHZwJ#
zuV1q-nBBvPZPAIgb^K+lXA1gTSzF7qrV;Q#6|a~q=V&+H8>E&5O)#QTW|;qs%dKIb
z5R~x4I<aY_xw1YjJ0iDUA~KH3wOfPG@?aMK8>F`}{qd6^pvufu;#oA7<GgJHu6|!L
zhZ$4IDE^3gHmMFATH>?T17vxYTAbyVk2P&L$lizs8CR?54TPJ?i1*R$q_nQI<*p8j
zc@|o}+%7$JZH06r8d$>AL5e>!W4QdmZ~%Y~*n$8qJeAOPPycrKGh{aDB|ZY7(f`{n
zVMw-o`<kMmxQU#`^9tfI{Ve*5?M*TJXv&FR637la&dJk<6bOT(lu2e-LK~ZA@wf)k
zm)KW)(3HWU({FJBy>hm{rW&z(lmJn2s6sbjLwlX7Fr9VBMFU>tCKY>seO%9-^wHK3
zvy8rg??Z_d(hxM6qTKb5B2G}m%x)pKwwOFJA}F(z=LQ0c9H)yp)>&LrGSBjG)I0fd
zQa<W}jAUes3t#;!=U{AgFc5;!Z*#I(uK~T9Ff|d6Za_d0Km?gzmVky;&tYL{SthU)
zsGJO6bL-aQb(dcUcW<i5wWO?`b%h-Ti?1{z`#1WmH=^klWB$-&Fw?<N$hqU5l_q7e
zISw8OK}R&(<n2$SE6pOc)OFgLR!dI{fM+Ik_smijO@rjb>vq}eOCZ%t#=QK0s1_GU
zungvC+}IpaT#W=p2sMZUW0Ix@<ea4CqU(T=oJQ4D=Zx#f8NP|RuOYk8zz5{~YzCRb
zrN+RSJP@zKplHleh^QVySyYQP@Hp#cEewG2;~`7LY^TzI;2XN~m?ufUm{Q_6s)&!O
zsm}!Zx-C>fBT+@4Wn9#vNfW>J`>KmjhHF(2KCL^M@jZM0nUY-$zf}ZU;MV>iK7Z?B
zm=)i*;=Lig(f0g{!yl#o>^~>)++$?guHeLfvxs*0u9OY0C~zi%w5#cPRko`t-oIaZ
zjNU8l9$wW@6@AH3+Ft(LHYBCJ2dklRzjFHP`=bJK?2(B4`_~#jhv?LvA59qDq1UVN
z>3#YAn(P)-1zY|^5I-1mmDu$bUR<>}aWKxv?`TjwwSged$~xcaxN&S`!!G&YjZ1F_
z?R)OJ(^dV_Y>nM!_mMMkjg^zP^E+Fw?tk`tcQ9q$+KGEQR^?aQ&X-kARpNA}X?xis
z1pNZrWB!^w$mN_R9>(2$86E0-w;jA_U<Na3t#mi41+_&zgDp(9!`9cbBf>^{D!!RX
zFs9tsEb1ucgY-y&p*gaFE8Tnc)}k=nKFyzrA=1)5e9gokN)4+f1MbgS#TSP(xt?8?
zy_R5)7-(5;xXo`=Zp&lAjY1C(Xr^FzEK~Fd>}9<{!>rA;TNbOLLwen$?_2#nEo-#e
zPlM-2Bl~+E@m(GZ3UORO=6tkS-I20WOlG7d?;OWH{!HLg8S_3@XNf;ejzu`tRN%C)
z>8FH2DS(6WQt=Ylq1Q?I+dCwZtJ4e>#&o#NGis_Kqb3=>pU_cc@sKlwOK8Tf&odly
z?;ZA7z+GVW;+J>LKbp&*e@&E~0VooL<Ja@{gYn#jW5Hs};N)XU0V<?sOG+2wT?Jrz
z`e-_oOJa}H;gam;e~O;)JKw)nZhkejq7_2=;>*?t`i*|xJJt(Ui+)0S$spT{Wo(xs
zfHj@#fWMP6?8R#X{H@Cpa!uL>-s=E+7GY-_h!fD%!&6}W{I4z6LFI5jX^H##Rl(iT
z5-xIFx!oR_$@KfVRO~<q0RJ_UUyF&$TZE%XDpNzCO+h5$3buR?0klDL(Qp7OY2M~k
z5o(pm1PmF-?sTFk8WX)JorjISs-1Gb4Cr%(CW=smI$aFgz-8l#%~!yx@@eJrQQk~s
z3In*@0prHQDGcSPO^S>jReYPg-(Y`8!x#m4q-+B2PS70}`$|wO?iX;JMadio1jvd<
zqCvSNM2L>H06=?s3?5pZ;oO$d@e53e7E?eYsr<-<MQSdPMmMGi(<x#s%499VT8YX_
zCi1L9DWuC(_7+$-0ppCMxe;AF!|d~-FCHC}_aNGr6HhslkS~KMNAdFZJ@&9LOwv}G
z9RS2e%N#*Fvt6{z6KKF9+`Ek|U>@tt1VXyWVf)fCN)nlJWZGMMgC4A;o{Rj>1$3XP
z1i{L(5$D_n<-%hm@$@(TR-SDDx)f<h_K}DNH}X3x>qSS90IG2^5q+UwGtX*Ifm0+a
zGX~^7fpo`%EYfk4EaZh6``|XfbJ4yy2+=*0_W_eHZepdr=d`Aj^%CPHx|ph1;-os5
zz8qihJ3-WOS+dkcff;i#LeB-;jKEnXvyCMo)5t4>`QPc7DSF=A3?+%oP_AQ)v*~f1
zL>Vqvp+p8$Alyl*(WznvAmECHty~0Vk&ZPvr^f)bRVRFUs?98tmkdpc&Y?OwTY50M
zF*t}K<X0$WQWJLs52<*LkoheOVwFxz+HW?wC@a~GU_x%jxmzwn^~R$AX&33%Atqhi
zSmubA9YESmsxtt(dj(W5A(;>^mzYk}Nl07if;DcH6ZyR?V!_~9<f1O-0bjW#E`NE&
zl@ttq(IqA`t=?GZ`u4eNOGo7wH?8p?jCq0z03a@Jf>#@DBbrnm&0alelH3ag60n#n
zu3EXCpeHx7Q$!`r1}T@7D=kbaZ!RZ+tYX`LtK4pOZF>Ms7L;3HKX5W9fvLvU9^F9e
zuB(4~YFem^KEeGR5pi7^L;nSC?*SGsU{pySbdhU9i&rC2a*p(hZ_h!^Gvwut%T!~9
z)E-%}u<D{vEBnP9Dj%{>^E5&$TBQlozlC7)A<f%>v*unmbP9@JRMzV#WH>nA4J(0!
z%S&y*g*fCeNnW|D9t`>Ps4R#v3`Bp6%<imOcB|<0#Bk#od%;LUCg{40^HXKase^`r
z7p0Ri*VLNf*dzy8>sa0-89o(E1ff<q$$?$#u8V~nAFL-V*JqY^sKTmmf*Yd6sy<bS
z9oAMKKkx|j#3Ucb5U)6-$th)E>%ZSD0Ud|$#E1s6#{ho^kkjXefaj%yNMQ7ngX&yO
z%d!(HBi!tQ<7Iv&pJmz09X=Drw0I^`m1O0a2xAt4=p}%#(>boUmopEf{i8w8YyEQ3
zEpOk-E9qN*(#6~luc#pUQcVz^iV~**0MZN*+ANq|g5N%9agTL;IOyGSA=GHXK8z0S
zTutrKsqJ@cwY0`?kAZTdk!tutWh?~zQ}%@n=7-qbT*5U;dgGOnTaT>kE-yl>%vw<8
zl#cS2TP=vUEr_-xUsxw_`C0u!Qpr-1cg#aeffIMc6K-y7*ym0|o;1QQW<U^|1vhI;
z1xS#*JunM)d!nTzcN1v%70cxSDg|LT+1bj)Vz5iQ3fbfKy_K!6&HOo%R3N3mip44P
zCNNu`m>Zs6I*Ig*mIBZ@zg@BAH$@=70myUYav2CsChFOcv@u!S(FM=WG;CRud|rhq
z;~`v3L<Rt!YX_ri#2x<t&NjKr4St+VKVK?@@lXs-0w+8I_Z$1IrTgXLK^kFqBwkc(
zy_JvJ1O%9X-6o)nzl$P1D9w4WpVY`|hWl^=emTTI4zDyyhqbC?##qPXuJpyL-P6G(
z2`cGn-aVP#exHInVy$rxbNob4SSM7*1$6s;D^a4H!01JTOV?VdOK@%nIbp_?*hj#H
z<S2cTbxYwB#IXk@$q%C0ozZieVA(Ny|Fa!bW5g{_tN3sXR#%jbtXinG$|Bsp)ej%-
zK5tI2`sbl?YeJ>P5$-;w`s0L3OI>NJ8KT+qY4dE1z)$h8=1RfiqP%M<3Zbgp4)9Dy
z#6Km8gCLCLu(e1o=I>b*UB*+g;L|#qHLZ_XHV*oxm@X6QBxoS1WFRTzqsnjLpNsAr
z*eXCC^S`lN(5x)~k-uNsKvb6N0$>|$H{IKddn#Ata%Eao-(fID8#b(j!Tdg=3YGs8
zZXWM&pDr^vUx)B+1M*6;R9v9GDdt`gW*JPlz}VS{HWQDO3qsL-`)jJ^=mEK-@TF4U
zSadZp2s|KWb(t-3WTAU7(~;FAj}T>KySu=x=bGz>qADN1IPo#pS(|lD;^npZ=XE|W
z>%YD@2Yq?t@ymM_FIx{^-p+mb3Hqud;_Mv>8~wItS1FL$Nl42zuSvI8it(=sUEm}S
z)g2D7>}K2N;;8uv2+aLlqS|nZ`O7=Y=V+QS2S3l*aGjsKmS~y+8g7a~mOb6^0<|16
za-#=Uu8nlnjW8)Ogzcd(T>W<fAithpn0!o{T7%Ar#11}B2rY{*a!)KPJGH5JIoU(%
z=|u^MucUW#!q82>H=x8%irKFwZ9jv=m&<_ST#28nNthAaQJ2)hV{(lmx65kV;0!={
z(`pJD{CFPO#?}YT)xxVnfeieF*po5T*w`c#P;Dg7J$U_A?UjVNStZK@OQ*|)QU7UX
zxhBYC(K+Q;E_VEyh-w2MKGc9u(wQupGvi`yiG9<$J&>;K96LJViMcxtirTja1!spy
zrUwu+Lg*MQsV9YSpYyH5-$}&_1Y3~@m9e*{?kir}d-ZlO?s9PWWMsyqL*t|cs&gTs
zXqlL=IfyjcE)r#wd>SfIQpPCOh<^0Q&m|Qt(tY%zFLR@uwalH{`ljexVzT`2_~GJr
zBl9H_Z)Fyi@Ny!~EIK>s%ZoVN_pT}Mp}*4!M%G8VR8n4pEXx>GUQ<(#CVvBIp5?IV
z!BV#Jbx9&(e-5dNm83OG!ph#W(zCuKRt5-31ver(zKOLhd2C*i>+7p-+Ne;SwH$sd
z7Nv|iC*;o1zk1q1%ty~{%Wz@!{S3#i@wb;I<7Xe~B-M((v=--BFj8rHg%Ibu1Nlc^
zy5qhS!htR9xyjg@X?0QAiNx%*EElIQKPhSO@%fNZ=uqPd4{q}WN6oLqFTO*4Y}{Vr
z(ZF02Tbfdzz1%pNT-??shP&?t@*lh1DBrGl^&V?)$zjym>HCU1xVT`Z{mGtpUkRky
z_#J!Bs?uhyf3SV7^3IpJJD)08d%BP;G?JSMfA!YqwQGZiyI7!#L`2kD7PlPtznjMF
zoE0mhr6tivE;-Nw>Vs>S9s#5t6y^yp{z<w9hMQ-@O;sXaLxQ8HWax|Eru=E~OA^D!
zYn!fq=1%(T+uxn~rGk<3xjMYdJ4-xcL;hg!^y<OKvi_coO}}F5XS30i=*Hgc-u3Dv
zQ4IskW%5%WgMliVidu^3cz*wDjabvp0c5DZxv$T$!vT>sreJBGxGe_E)t@kCE_UM;
z+s%LVU+i@k=#K|qlg)=aw})(khS^#}l0|(PF@xDI=Qi_yNHzYb1HZ7Jgdk3v({pV~
zb2llCn}V0O5FuNb>t?xRcv{<*d+`~0sF~d9ZH3F*N*_!F9RMU_TZ6rgm)^m%<;<jH
z2r?IT^sevdKi%P^0Zt#m2GYAGCwI+05M)<Q!ue3XZ=l5M2B*e!c*b@IJ_11>kxoxf
z<m2_60-^4_C#LIBQVz%elijTX;OiuK?$Mvu26SN2dROs!XPzDpbOus)P(6XVF$H>O
zoB<U)I%YsOu|V(gX#}MGSDe89<@3Lwea9{o?8nRM4ZYFH{J0-gzgu`j$JYLL6a;>3
z>^DDNuj(AMvi|o)2%&*j_r~P|&!U5t%i66U4h(k=+D;z5ck++A^PjHET0PhQVDJBV
zd|k7b{fA%Ru>U&#+37>@`9szR{%a(iQTE}O^xuh-e<zRpH6?)M9RAKd{X5V8@OQF6
zXGs=ne)QkU>3?gN|E*vD_xbL><&TgQ)OL46Sm?)pn<wqIrFD0&`zGPv>|ZfYgQD}q
zO8Oiv7L94h?g*;{hrFT;K6$$akMV#(b-*ZcWoG=NB}2wMU(R!4#j04@^-j=(3Crvp
z&EU}nWe0AunGRnyFb1hb0p=QWV=^%)WR+FP(D2N}hI5l+qg~_N_Nr5>r~Jb3EPebs
zEq52sadv$%i<6f}4D4XsL}(A<yCR>&aGbWV?EF4B*YWu@lLF(-Pb&H0-{>PQl*p)|
zh~53ajI)ui8fwQ6tdo91^Py2tI}pf3N%lpt`muw40LT<D=WYbpB$8RpV<O*=ke0&D
zbBlfH&N{>Idd%;Xb8D(h)Q%S+NKY|iX$V5LS(LC(_^v0Mha!8eJXNYnC(go{`xMAw
z*F3ZR2;;M%-_zO;OTYJid}25ETmmHfU+ByIBhl1&viZZnimh)<YXnjbT5}N?6qHP0
z*=%Cr1EfVP=LO=A95a3j1TbCa95XsRIKO3%sXaJnzJSrZ#W&c+s!@L>Od?{@No{s_
zgt8BE3t^LVu<~|_ff7-I#7~4vt^+j`#Jv;(uTZ%5ok7fi;Q8T#klk&(q6S*2{;m{P
z109Bm`BDR`!#LI89zkBi#R>E}zU?)^rco&sJtYWRa)vsrs)yOwwtdEwJMU!u=cs_w
z?S6p3YwE_TDa32wIrH^6JL?NIxsWTP7Tbqh&tZ6|i;}aW>sxN1i`0<&Q*48jz8dSW
z<7oTqN{3TWk^I+*fU*Eu7nGlzTgU^j0P0C@(c0TkOu$>$O-wimicOy=eJ7m*kSU1m
zj(Td?ks8_V5ZS#`o+&$jb7qrDw9I%OJg%#Er0rr8l+z$la%g?Q5E>8p&+0diOR8NM
z`BeF-gur~Ehra?CrczlMsA&A}pkimY#Nblz_}{_hfu)Hdm1nzthg^#Rtb?kPzlT8p
zs&G<RU5@TSSVNIpQuvLl@dx2e^`%Ll*|nFtyjF5gOeLKqD)%0IvA(~S6mjqAAts_@
zp!8lu*E`)4kv(tYlcOGXZtF)q{w44zs`t-Ny>m?e`FH2~H+oM*KSRhK4;>P}co@Ty
zElXLe66p5Pt7)D}IX`;h*WvlG+TN7i5AY+0yZ3k%FU8%OviKX<>l%6~KG!$%@6WE_
zo0onS+CKmLD<tmIrG$bM5hO}ijsuEF51#;a=WzM=@);)W7uKbd&na=0oU<h!tSPE|
zJkWWq@b7RT^67dyUT(P_a!&;xc0<dKk;N+rk_7SOe9oqGcRs#@;7l+EajqNE7I`Ux
zg#zI8%-$u@Be+-LNXQUgz`}>*n5XxQ4gL{}hUwOUS8|ZPf|GPJs4X|D{1y0YESA#H
zCL?Hz-2J+2g0W~ojAqffVEiULN$4Ya>&86);Kp(pW>m>VJ9svp@`7N&i_&`rqw2yc
z7}nSfJmoBbR60Akrkm$L>f~>OW_7ITw1?AV^wGCRJ(_hxL>IvdW4&~<K8HMF9~2s(
zb$Ch!6c{Zlv9Vtb#Vp$6zV<=pwC-Aj4FSA(A{L=sC^@>Bhg#<nb$n)igj%TEMX46&
zN4FsqV&eH91Hx}i5E^r@^)th0uuv_S6ix;v3<imP5Rh)5wSjMi6O*#rs{MqPV3{Nu
zD&?LDWyaqoue=}H&$cuKFiLK`Ed<QwG({61S~0SV;sK)jjsPS-?s5Vavqj~^2XLX3
zAhKHg^m7^axjYv`Pl}GSaL^9q3ulF+RU1~O>sQKpX|GSj)i<RzIF;NAY*a05Q#kow
z^d?e_;_<^W<P5M}$_8kF7=#l<6_um5(Ddy7X4A1g=+Cqe@!!}|d0?>;HxHInAyJh#
z`+!{LhdPpq^PeTcu{;*jTpZww_`C!?qU4BELAwBI)`-R>6(qkVQ;?<uD?R?%mQQS=
zP%6w!UVl6f)5fwOUZ|_T6(;MY%sA3yUf)&x!uUyD8XRCkliK)8I~our)^gT}+6ltK
z428`zR-B%<KfuZF0Gj)%jnIvza+hvWmCJ!zu<}5l>^o$ElpM?`9I$)?K_rB4fb0OA
zLL!|p5xd>N5d<Z{Y-Utn{4~y61jJq)n|?60cc*n+6$pDVUEV-~fomb^8+fV+q1e%E
z<O5#wf#r>CB-k8l!z-uCkc!4CD$a$A;{U+(3>IN%l#J|<_d>&*J(hdl8FG&#AV^`t
z5$$O*<aKDt-<_`L2S@n6-DG~&U4A$_qT<7&FhQ^6eelUyL%1SY^pox~NUjyhZ}gTf
zvRm_5`mbx-Wbw>NJrJd5Lg=oUnf+%&W@^NkvUKobiO6mbZQN@V%)eQ4u*~-0)whTQ
zuay)!>j0^lq`sS_n`Gy$Y#u_23H9i45&5H@6lK5myX15+oy1^g(S<gZ6S>oC6BF0i
zd0EOZlNOi@7P6D%{&=m#L&|g;`#He9Iy-unBP@g?x10dxTFOA!l0kL}<b%;GYl2_-
z=$Us2bpm*p#09Jk=Vmm-juey#5(V=50wUvjNR;TgHy%3B>b>F6|D^U?{_3wW?{dvh
zFKHQ?<0P&nyiX4y;wHGg4-M<br;7&kWUO=SN?8bV`kT*r+tMuWUShzDm(VO>mh}8$
ze`Um@JX3AH2hzgr9%-2)Pcv%#XRvN5pH8&y<h*#Y_xD`d<T+(_e9w9maHn`uL2f>%
zsEGSxi+|D^jhW{gl!4B&vhG7O?Z9`TCM#kwk53)`mjsBjvJ_*l+`M)~`dH$e!=2dj
zBk8N^h<C37Q_oipUt4p(e|+>(6kpYk`A|c4;<zmTh1wmiRn|KWvzMFD$`t=bAy1QS
ze$8|N1v5lKO_pRzY<cEz1A??9Hc=#{Reb-o67d0*FF2OYQR9u1*ncA+Mp*tEg;zL(
z#Ga;`7ixNV1%{mbGZ?a4a!>GnqESPcxshI2;>kye12<0a!9LKRV^cK(QJnb)cLayn
zk}?Cr{@Yy^`~B`;Pv*u9*U4E~*>l8l*+zU+IMG}t&!p*^+-IN0SSh2CYAswM^taw5
zPBOHqyvLEH94a>fh)2M|ho&PzDza$9=tXPY1hS0AaRyW`*&kkhTC~Z7Xjf@|#GJwJ
zy+20(sCZgKe}8>LruyKqkmd2=m{Ef-iLX;$V%1cXV(ZFqSP@esjX=El^S6BFG8RZU
zc_RR+SCel_B1;iz@_&k6exYn6^>Q%MPO`Ku$UGZ0JVsg|1G0K2k#dks;f<j4VcIOp
zDFrxYn%Bv{0i1?COs;w6_&)m2z{!VR;$Thmz4Dfphb?vd^hYYHe>_jd_VvPgnmSFC
zO-T@l9&#qE81jM&tLeInE91%S%LoHLzANVTM6(r1(C{ps&V8!03BSQZUbr3uhDR!C
zGbQH*@qz<V<^5L~kCKcHaW19oF+M52S|~$(?xpmj{<?W;tCCqZM38RUMm|tgTdD*j
z^^p2Cc`$%Cu25a;P=NOu{W+Nv7|Z{Hx^k7l$+4Aftdgczh&<+!rrCskK5^UHhwJY{
zw4su@dWDIh$I;uG&rHoqm-ivZC;}E}JoqS{7$N@$cLZ^i5bIA9SOgx7X;_2_>hfXk
zmfzG&pq@zSLMWTM9`gC1pvK`e{X$5bel>6pBw9{k<<Lbom9F<#9BL89&p@T#KrR&L
z5HK3LdgNfv>ObBV9m@F*q9u9{?y=RJ6|wh*@P7tvB(Mg0G*ecVu<8A#y1|vgBD~&^
zDw<Q#%LsSCRG!g`PP=Yrob6>LbdgH_x}4V0hI+YpJ<A~tuBYWSX{zuhM?DNUL81xG
z2$lrB=w^X=lpbZ$Sa+3q&a?|hIO@2G-zNHSnK^4KM?mW|i;dps5R-s>6KYqJ_B|HW
z3QQIupj{3L+AeyptjVawhvz9}(*6)xo8I1Jvi4P^MFP3;icY&3hv`fq!l4X7v9YYQ
z*{uY%bi8E#F33Dy9($rY+u_)moUDtS<+vK-mjRIY^N`rHbgjkw3?i*j4Ko^44Eqc;
zRief&=#HAwzhb*N@K4x5t=7X54_~PY-@-l1Aqw`6rKx)WUN1Q>z0!Mzf&3NgU*dYO
ztX8VYd=y{|78pArrc8aif(d>+ikH!^x3NEc)V}PM-CoM;93}goDSXn4<n$i<!(scs
z^Y;I~+OrSs0d5CSI+z~`1{pd)PdUJR#}2h`{<alYK}w>k9Bzt|!B~J}#DQDA5}Dw@
zo6ZMQB7;3>yy}huk|-1OIJk!*5a}rLmnQBo4&J1R+#W~lK}FTchHZ{gPe%38j(D^q
zX5A5&P832r+LJ+i-)OkViT*E8zTj~~^!Tx8C)M{4j-ee*W{`a96xF{@3{?u)0m$D6
z@x6!QPdT$!CZK$OLHQm~J{^co)f+jE3BGT1^d6x9{>{!fz?Vm}LQY!gO@POsMuwBK
zeKZMQ7d*kmQc}{~*G2Rj)$;b_GYU<g<)W!hw!NLE-s$3SO5&(G*+Jd)m8h%pDOaYk
zt83)j4u4noJl9(kSI^sT8MUt7Bd(YFTz$W}1}(Xs=AP07x%sP4iO9GGo^tz3a0`xf
zTO_%K=1nolZsF?V$oCEr=9K^%0I}T8t&W}1F+hhwV%6Qx8@gXO<sRqj9v|s`@sfK&
zo_k`Id%PidiECPOi-KW6Q@^=i{_9TW_Mk|5P}M!s3_WP4JkotVsF7*OgVQ_n?ip1x
z?6lipT+fUw8e&;KV}hmXZcbZc!RmS*mLxEx6N>ABX8X=k;ymbYMJ@$<R={Ss&=lDo
zPd*~qh%}=e#(7yDa`yO)5gnkULxCn*#i=>l=-INtvU1nCiV?EP<}|Vi#4w!Erjubx
zwA8&~uFYvnz@tQR?$)Y%y}4IYu;-1)xuC?k4qwmaJ$J#jIa?AH9!BOUPqQU}iaKdf
z{H$#P*@&3NF+-7EoVEr4<^4HZJusx_UBL*H2vA&Q!F40hBlJ=Z7UYHDT(|FRXYjkW
z!kO1qGhA4zxd)Um28Jy9ST>RK<kL7<P<1rLmX!wGC);|^U@RJ2JAr(n$465SbY$O4
zvk4%wXnI6)ULHj#nr6}j)K#TH7kx5IX!q6MXL0+ER|$5%^-CWiTcnUZj)QDiG;5-t
z<ro;4@dbLI3T^H-i_}Yh-`j=(gc)y5r3Kr4Kz@CiW0Pt-=9yXou8X9IwLxK{fF{dt
z)79hqw}lk>_Xvxbp4Dj+0MKO2OAyIibjr^W8gd=Nw+=y<rwI`uA1;w?0WgjM1sKqO
zk!02gO@IU@AeU^B3$`pWjG=xcdXd9u23fjDmt3YjA*C9Ea82H5y$@V#?pP9aA@2i>
zK@;kIkJtnYGUxA(0LtsraCDkEKsH~TW~*Sm6u!G#5>LN24@grFkQJ8T$oNQcUACoz
zZr!FxE>4RfmyUaoHHLiOk1R7K1CNYC<yqvsMn5$T9~&}_7we^wK+bytfkZ=Px&kRB
zACJcu{#ach4+dhJ$TmteL=##44*60iba2%j0{HwHf#NoO{&muB>@KljG&o*Mp~vUN
zn3vYNPlwPdd2hvjt-wKdjb<2_Iv7xT32Fv-nCYFqoK7=o3kivu$vm~T=&=^b6B^_8
zF6!snMDxcOyU;ibk09MoORQ_>@<J1<Kh?y1!qieYdOR;Jgr<HEz5Fkf%o9eD3ZrU-
zr5T0Mgx7C$gzEc+W~PQkg@myW%tGmR*5jf=v;2g!yTbB$LUTvM`hZXQQsIvO!WeL_
zLWS@WsemG*jTYj@>tL#aUwBDWcv*FJu*O<y3AE%%2>I<s>e~?9dSInO_|@Kx{+h)T
zO=MUYd0>QQxlazuqU=OMWRuB-gFYjx^XrCGW;Vr!L9Owm)JbjBTYSE`zrefiK_miq
z3_-Wjq0Q+~h)0?v9I&kM`;xb01OQmZJO}b)t;X5=8lfF_XE_!;tXOGqBBVZU&14;-
zUhbP32_X_lur4V4``NH5@O#OK{<Zb{MiHg^3)*+c!eL)~|GDGBD3|yAvES36>(e^r
zzGFP!vZW#?+)(W95mM+KvbIuS=xCaO$9yXHvd-GH?)NX%MpS{C;JTqm`qa1gLzs!k
zG<Z`4;IPCs1F~Vz5Ws)Pko7#~W^b?9jIQ)b%}z_s%Fcvs2#0>Y6IHbD$H(+GN(G1n
z=<T>OsjF1g7v$|x8p)6BU;0gm4nS(&ogf1H`R78a&mAaaIYb5C5B_-h2`%r*TEv?B
zY^hIGFElb^^Frw+N(5EzH_NNI)o--LB*tX>(msW3<?F_X94SKFjFCimh(F!RCvQpe
zZcF{z$^*8s(_1o%v9c#)h3#XdPsb``Mk_vzQ7VYtsE!r68%rtKNFM=4g*=XQ$2Jab
z3!GkKul${E`@50)ByyMAqYA!2Nk30bU%MxC{<8cIitTqR>RD^N4{HQ!Ndz?LLVRt|
zb~tcPgT{p?!+?2S29={cx9U9~1QSwuJ8$^yJ4rvlripx7m&_5pHvFXZNcT>oP6Y0U
z<V54yN4=28Mhh#xewNWtpysnlSj74$)FuH?Xrui{PTXr`hr2W(>=)*fG(F3o7#1k?
zJ?Pe{V6_Fx-M3$yZ=TnDe*Pf--HY$;uYR5eeuBO1cQE+bKD#tn6BHIg)mS69D)^+9
z?2yxU2y4@@v3Kfg{}C<OlKB<3KyrTm^K<;WsekTb->1cI>{Z{P3`j<_m#W`e1K2`-
zbFb1bl1p}AJ&>W)i$R~<0f$}bDSptui!SzY@;Kj*YtvYGpyrf^q}#ra2t+t_EiZll
zW%Yhu!LK|7RT4jcv0z`~4s8W~p(a0;{2{Vi^2c^m+N|%2g&km3vzHq8`xpEI#9^t4
zC$O??|Ki=H?1Fit9`8HcKJPkdVq?C$3rn`Td(Mi9&HH}9IRG@h=i^5%NKZOxG!MV~
z!2$||yr#9DOM4YJPe*w4eR4PaGL4{9{MLX_jc6N@#4h{KTpu=5OG46wVp2P4CVJ<o
zk_Y-C6voMTo0^pS-=aHD|6y51#K38ouuIc7&*%<CMc&wdb8@ZF{!;!}EZgo5RcL1R
z4)>qAA1m*kUt+Vi78SqNDMr3OnK~|&I)6HK?RDfQ`%CKu|1$0V4ctln@^pQpAm!VK
zfBZjEyX<2$Sf@A7r7m}8OCTuRYuh_dQ@0d<U;F9)^YtFJGya*-yXvU(?cAS#A?UVX
z1V;p9QJ|m3A)*zrzA5vJ&addy8n%TS$`v~nYr8HB?>iwRtgVMb(=f^a(26Ctfs2rE
z6*YcVgK-+ic`aiwA*65g>hX*EV25A|NZytUz%FkqPc}K-bh>?JPsJrovOD(M=RMV#
zwgAOcx&2!1*U)sW+F`Sx%t?fhT<~0>Oi?{YzE)u~Q-DlAQMUd4TMk=<z-<-oVf_$7
z)|g^lQFI<^iBnq}t~_@BJ6HQx=94Si+Qb33T<;!7=>)!gB(vU{v3Ulx*<C=G?T8e4
z?~P)P+5&*9M$}=?YFc&K(R1GqkDHExZ<#fX)$MLf#{A%dIv}0$p`rmZ-#x9c30o_?
zr(Xu4n0`w=g>UZKv$b{)4}R^uR(gU4bb_5I;gL^-%EBuEFhSmyOtMk{{>Awz@R%t1
zJA$8xNCP{wzhvky_KxAQ<bNvqigOD>36v&D(8L*BkNW_kVzS1IdsS0uEYDy&<ZALJ
zYSN!>E+#6Js-W^ft|-8&EDL%3{XQTU`MwaywKqhYLO7$@4$d;M?QX_gYbe1GSl|%D
zpCOTyAa~7NVOFjxZq91FD8W%r+_;Q@d<(hg!T*5(4gpu#WZ=XU>+?diK2;T3CxuqK
z4n`~A(46OMs;^427HufX)>p|Yaq8;#y8fRdbE&;@pwc>0@lxe>r|_pUtq(ryPqlU(
z9H_eXeAicNml${G<9ng<NbUZJ{vWlDaqAQ6oo~I8)w{;;)cCZ&Pr5Y@SIs)1@nE$w
zS>xeG%Oj0P-yZ(ac>FE(#E~aK!6>!f-ywsMPyQbKvATP}5pk=HE!KLL2~ll5(}y@=
zd#0b$W<G3y*IQzvHN3|4x^T16Tg$VFHNvwJ;_ksHzHi6b{j?Xo3*+0aLZ=PR7u^T@
zJ6$>s{Z%Zi6m$hX>h5_3l<r!Q2<FI`LeNhaYA#L6o7pHF9dRx52v0sHu=|Nn8vTCH
z*_>A{{<T|HRhFO~_cKLf^Q)eqVSB3yDdU2%_df}j<Q6BU#rQ9f(v6=F-+i0@=68?;
zF97s&D0pf?08|aZU0ziwwLh`I(kM~E=b6I**r8H^-%79SHjKDZ=|+UZ)tJu+Lc@yY
zP?Q1wx(G_n!B|Ql8~s4o(QupcU6Y`Pusem?r3eZEZ3O8Yd<l7)VPhxqSrZR?WUXe7
zNeXfiH~M#e!Z&~{SgID{#Dn|lI)JLENnJ<vb+g&2hn*lt0Yp$xtee-Aldf_{13!Ge
z&qr+wQ1Dph6C#WxhkT^N2u&PV)-wtIu@h;;<;WPuOVk-=5tj>yA3lSUQ(>mtMw1mv
z&Sot@V^4|?+RNWq0t0i9o?nlfRhDI?(T1{B#|=nWQN4b70FAf{V)1(=FeUyKKa=;W
z%d(dsvNvOuCdxy|>U=~oeupA$wHkiEK<aCty?Y>x5~<!qna)sv^I9}2f>q3<JH|RV
z1`8m4e=1G~=$R{knfy*o<BT)l9$N!aP#Pyr&QeYi7Zi@L^ne0VHCCsLZ~~SN^Bhu?
z7pG$HMSx%6;#$)rk8nWI@O|tYTkFA#(gy#6v-<#`MK0x1BNzMC$hsT=4HSo1Y``Wb
zf`2jt8HCHIms^!Z&Qx`(Z9^`n1j*g6klw&AX}mhof6jnLw^ak1<PeN``j0bWDzBsm
z0Sq!y?&NhV0e)@<RWnBkZS}R08%}r~At#d#_gRLXc_V<oPPGE9%J4dEhA5C1?*|Ff
zDl}bg5{8sVWE`D!a_1{tQ=3K#<5y1t1RE)U#Lvgv;<sER=aJlNB?!%pN2(NsUoh%~
z;tH!(+n|WtPdbk=OznYz&~tbeWk--&<CDPj`%VHZ$N2dD^t|EmB$SoGe;#ViN*=d(
zGTSJ-A{|di_Bg{vmGxh!@ArI_1HEF_m0lbz_vCCybp!u{Nv2#rivSkhq*P+TilP`b
zKR|V+vg2ruV+*qwyJVi0%Ng(QB5?}l1o}=u0n!OITp%<BwqKCX>Exw=)||V7Y|s@V
zlFzUn4%_-HccwY11-$=UW$S~I%K@&_H&x~zFMM%mlD|38LUdno8{|vw&yGc1=`zVH
z!ZMW1KKPi>zMg51OxF{4$?l?mG#a!I6Y%lPyyd4TbTPoY$SYXFG5xf8q~nI~kyM*G
zzh68n!H133Qv8BOkJh@GB3Uz+1$?9n#d`XHcXz3>5z_DzJxpXNKI5jvBFA|>ee@`v
zu4uZ%!@l*aU&cuDimq({|5ePOh7^nLo;xl4G{IGVfJ1~Hh|-kkdkW2J&$Y7th&DW>
zCA#iQ&4l|kcbIeWhM7)2gRfxE-glbqeD~t3H|oz?M!D3;vnzu`&CNc`QJ2J9Y<hBo
z%dT;cco%&)<`vSVcBG^50o27CwyQ*I#pHJa$ZfG2gJ!f$tTdKK&aCDH`s*McYOx;-
z1hPsxXmNLnly|Nnp4bKf0DSX<bJBK^l2^g`l1KB2B%DAcpr3f=)$UI8`7;1%)UYul
z_bc=Yf(I#fo$t*1FLpS%I^NtO9r#}F@;DS?^E{*KRV~V~slO?KVqJzc$+Kh3{*)YI
zC!Eq5p$M`Fh`Jl;ISI9dA&E0gWJtzlku*`x@ubCQqsGN7UHco6Q5Rm@FZ?_&&7Jm4
z5y0U<4D>~av3DpR{Do<fpDy}p9&t&{qyXY?a#*tss&K<`8(Ik|{6>jWo&oU)T)n6|
z#X|UBd+Em7*M~7jSt`QYS&kCOvpx{<oOcZc>c4VE8k@{ayiD>SznL5@f9`8lkB4$T
ze;_N(v$du3C+D2{4MM)C(ASm7@~56=j_XtI-@e9`s<|i}6-AvdE8nQN`gKLobHXYv
z8S$lJ>|w+ksb3BctBN#4Sh$YobN9~Plea&;pwnoy*YA3%l2?*$R(}O_+LX#!&d#;B
zR_#*|uUH}2Ng+?Z_8Tvoj<Lj?Qa?VDWoMxfW?Yi+n1H+fYqCh7>ZbI~ldCE<$AQ(I
zKl87aPI3eWAL)JOIT0z-%MsFU(RlU8Q7af3sFmml+6gSUC7WHDRiEA4x{)uQ6z}q;
zbD;yS6%0Nljg_?-Q!-(C{__}@a=tp|ay!Cs*iWOK?6M*E$0FD-9uFEAdAlhjov9;b
z`GOaCJXN+e(xuHr4O^6}5uibYdhRzfdsDAxcz~d(uZdTF-WE?kbS25S`Rg$K-##n7
z@S?0^3fw=X{Ne-Z1}UI~WDw&P8AN~$1DF_6h~&b#znCr2#oS9XGb!$_#EJe{vaf4-
zS#pY{tD2`v?(`I4=@mD}RhcChGZABlrT;!vl7Rl{Xnz-?aW%ILA4dhBiTTf<?7NpZ
zut6L*qD5Srt`;hJ#!Qx>Z}_Kid*-2_E%@vLM+@=;+Va-Y!2XhS$czkbxld^sXYC=Y
zzx;F`Kz4u>Lh2NvaEkGDim5oIj5?)!oN{TMay3p#3MA$ffOa%~{1~S;RHrtIQy;Q{
zw&66^>NLLNj{K}U@(+iH*W-C)HHGUnrDU}f>a{dvkLuPRHImh~sMl67BLKjO{{c{c
BiYx#C

delta 11441
zcmWkzc{me}8{ceWW>|8}nXAYZxsPOQ&S9AQNbW175rtthVo5n;L?LJH`^bGKx017*
zp(vGav3~vDKR?g&zR&x4KkxHC@B6$zf-)V521fd7>NoR%*}z`_0GI(xrjYTvTK&EK
z>AL7hMsR-|L0nY4|9KI?1yA+!XmImbDyMlEqc=WoXkC?&VE_k6$xy=xv>aN;6EY!$
zz{vqGiX&|F_D6a-b^HUnIvP?U_orv^Hh3*Lnep<<rKScC8$4P=32Tfcb8`}9q-4@X
z#c5#y0t{ekh{tS6`sugh<H7#%d@Aj#5*!Auw82NZ;5$MH0(_heNs(kPr~R%DCw(oY
zOX41uSaCki@h9n(Ns$ei=}TQ5SPdmwG@<BUXc$~ZR3P0i0DV=aKZjbGLfv0nA~@iw
zd;(-S88`zNudmggL>(tSPhYBQIR3n!9v0A_NfqGWtfWM4jE>Ki(>9tK0&K8O#%Lue
z@$`S0Juf=_eR?`E9_i-MaW9hW7a$`ffYnwi(nXUQzyvoBYM@6$V1S1ix~Qb6Ba=)H
z3@C~tNBRXcJRzS>&r&%!Y4-w7N5{u=XfzEiI2%0D4KE->6d?OK1^nY7Bv2Ghkhvs|
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
GX#Nk$*8)QT

diff --git a/docs/epy/uml_class_diagram_for_googleap_44.gif b/docs/epy/uml_class_diagram_for_googleap_44.gif
index 902e0fce2881a5f2be86811bcd0311c49e1a8d43..c8cda05f56e83a56477e8a8adbbe51e1f9f43218 100644
GIT binary patch
literal 4699
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
E4@95qoB#j-

literal 4001
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
LtrI{B0muFWe4^D#

diff --git a/docs/epy/uml_class_diagram_for_googleap_45.gif b/docs/epy/uml_class_diagram_for_googleap_45.gif
index b2bf6daa84e819652d5ec2984fd605356d96d0c1..12044ed6de62439236477006fb30a9a3de650a61 100644
GIT binary patch
literal 6055
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
G_kREiXlSAU

literal 4946
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_5.gif b/docs/epy/uml_class_diagram_for_googleap_5.gif
index cbc84d5644d5ae61937c20a0c7f1569477bf27bb..5ff1dac0c9c463da62284ae0ee2e666fab6df52e 100644
GIT binary patch
literal 3891
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

literal 3195
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

diff --git a/docs/epy/uml_class_diagram_for_googleap_6.gif b/docs/epy/uml_class_diagram_for_googleap_6.gif
index 21dc1125fd380b231d8d74a854c64b22a212c408..9a0086edbd1363be11336e587e95f55b39a58009 100644
GIT binary patch
delta 1248
zcmV<61Rwj(3gQWWM@dFFH(`eWH2~EB000002nGfX3JMVp4i*s+8x|HE85tuS94sRv
zF()T9Dk?fJFFi3aLpC-=I5<i?JWoJCRYgTuM@L*sOJPn<WKmIRRaI_TS#exkcVS_A
zV`GGDY>97gj&yXAcXyV0dYXNGpMim-g@vk$im;E5wUd)Mx|f%}nwr9%p2wo1%cZ5y
zsHm!{s?)5j+_SUcx3}ZDx#_;X!otGt!ou^$#`np|{LRh((9r+?|C0d$6@MZ51PK5D
zIRGpG0001o05t#r2LC{ua7Zi~kI1BQ$!t2G(5Q4uty-_xtai)odcWYXcuX#v&*-#z
z&2GEj@VHUNs@w1QynfH``~QG`GG73NhKGoWii?bmj*pO#gd;bVmY0~Bnwy-Ro}Zwc
zBLI`3rl+W>syCyhnKl=(7k?WktDGei3>G3bw!WLKUI3J@023M-5da^X8W*S+0vR9`
z1QETzo+$^Q!Ck|eHUPDi5el0Z6_+#EmNYb$B>*j!CjcmxHZ!mLmp1U2`rV*W!x9Ps
z>tbY@;f)KpV&rZ-h(JR?iAp90XejjHh6)4$H1?YDpa6gd`x>abWPgI*jSm6@9H`|&
zfQJD97{H?;0e}Gi2MRqzm@r@<g8>5=%xDq7Ck+@3VlHrTLnzUPTOMK(cPs-00`wwK
zs8nIXjdTMGXrS@p0EinMuEl83;YI;w17GM>SVF)F8>3>l06<X%0TDNHxv(*z0bBqU
z=xvxl!^Q&*Hx5>6K!3r8ja-i-W7VS7pD|<;2s|q>!1I8MXhjT|@lJySxCKg7?gb!3
zB@QtGbc8_p9Rd)8UzF2O0|1G4Dge;vPyic@cP$=3$czvM02P&50Ej`o*XS&z^Nq7K
z7>11jCQcCOg?0mg0{9Dbw1L6o1LX&pb;$)CAuvFGcMVq14Sy40ARdARywJgIm7H)C
z0}E`Y843VkGylUp6IOB_7U@+YPDC`^bAtsHRDeMxXn{~&C4$}10z54^FxCVG_>(|K
z4Lnnc3o{IcO@klebAt^l*bw592W-$w1`%*)BLGz0V9yLsj(A0hOAZ4A3?(=)BMJl%
z0NxE4ROvzhynno)zy=Iz(2E9Ry?FsVDohYSM;;VFl?eg3U}Pl?-oOB5HDHhcTol$I
zfC)FW)sYGT)L_E_7QjP6M_rO43^7|BLcjxA-f#c{mY5(wl_CgWQfD`;kR}2OxOBn+
z01P0&1SRZ80RRRJ;M<`LzUTr10t}EVq?T+T00IcyB!5B;2M9oe3Iz;c00LBn>dGk$
z;8jTt0BsBZ!zJo&<w6VXSOS9z0C8eN3-E42Lzc8v($Bq%W#Xk3#zbK7!E|oo!UzP^
zo6W-zizw<h4`5*N#TaLd0Rsm_pz+5bhb;2QB$u4=0~0$G$;vFZ?DETpj2rRHG<TD7
zR;1Rf^MB5l3|s}6JO>T2&r|>{^wG8uJ%!OoH+_oIQZViG)Sf^cg>WWkt@YMicZ~tc
zgupEJ*krdXGu3F@e0JJw19LNJIkzo0CRRfs_1tLJ{lwjPPp!8TeD~e--%S93!3c;a
zuK41NH}3f3kVh{0<d0+Ub`}Pdt@-Ah8z9H$pdE)U`sk#WZu;q{r>^?ythes^>#)Zz
K`|M%_0RTG<#R!!E

literal 1358
zcmd6k{ZrC+0DwQ>7e)FW19I96HZ{spd?{a`a-A>Cx4w2<l6uWLHCL_3v`C%jN|BTl
zk(A6OnHssK=&VuGW`>IB6bp^DOt2tQE6vwaXl7gg#h%}vyXWo+iwLFfNW1{(U<?2V
z4e|1MNH9aGQnp={aFUWKn<?5R87qdxInA*n*-7i90o#40T;B4^vbs(>*{Ss1OflVW
zgK=<tB*Ht+X2-Aur#UjAVEK_+T`MK8BP(mArhD?`KDDnWRh*R#TSG`BqO6i+CnZx|
zD7t&{<b5n;cYv%=psklJ^r<J?+wAag@?J!c!sZ-`mzRqv>&TEbB;oQ{p^UaFiSCY^
zlg=UA+sW!>41Zr~K2QChs8ag6QBCb_FdmNIi||s|>;v(FbdJ1KygZ~0@T5x4WoI8r
zrf#Mr$FL|H$e%u~fd3!P76=8vUO@ev_W230S;@h3^LQ8X3-}iciv-2O649m7GV$f|
zD-}Oot(07=x?WvVdqaA&?&n*-)Hlc)n|^J+edo6_I{3Y%_5L4i5859pIyx0TRuXLZ
z*1mrAz@x{S!J#MGzlOlh9=|Z1e)PplgYlK=_1L)S+4EPe9)8q`3ECD99NKNx@<IQ$
z5<6l9sQ_(4k#b%la*b<E_r(og^AUQpS5;@`N8gW!Gj5FVos20!)58eNPYLF+#5B@D
z6|&wc-K47dlj!2wV!;mHzyOSHyMkE_R1q8Z9O-@8(P)c0MVN6UMrtRBARtoSLf{-5
zgk5aeYZ58Jd~%4;3}r!Fk^Rb!1Q~YM;&K1;*bWra(A87y_@z*AEN#2{v+^)ct*F{)
zWBZj)DX2jy3T(iPaAB%HYTMzS*b{-_Xb^1dE{@<cf<UieH7PT}ez>?3zuK*w6&Ix_
z(4R$}iJGWz?uoYZ5^Ba`&{!Ip=%j7|&Uqy;$?Z&kx6VSGh&_p5G`B7DSeMx!=&3(K
zme*?mGk{wYk##P^Z|q}e)kvZ9dP#CFW+<YXoaAgmlWhDDMIanK3+>-yYeermAA6Q%
z@Cf2_hKQlwgxporcg1>~?iPVtU`9FM^TV2RhKc?r(23VkGZ=WEpi~8JBiRsSb<;7I
ziy6&X(U3}X<_bf)<F?_asQyOpJmOjzGl@Bu7JXg#(9r!TFfbg1<U|v{2@yWmvqEg#
zvICVk=LGKq*e&(mK`6HcX2%yksUgbBG}5f8EU$Cx_-O(lbm1^SlNa9Zm{@6RBd&%j
zyb?)Iidv~PK{R_F^LuL;sV-aPLFXmmqSQ<-QNPgK1#Kc2x=0Q8ve1QV7RRj`n%>4S
zR;|wo%tha-fBy8_w1Eq86(9CXA&mQX4UN069h%#^)4f8JmpM{?;(d{&LmuU2gzJ>8
zGpdosO)pd@rXReKzI$`dy!dXq?J~a^g@GK{GaXo0*-R%)o1E!_t(t+WbrXDewtLM{
zS(+!RWn#L=j7B0JI9*{k^_Gd)bA9eL)Qf%89>Jyd(K+||fw2~{t(v|ha~LSc!m}EN
z!^wp~Xb&>0LTFRID#xNX^V&&p(DpIwADIs&?r8D+(-O|qU3J1Pm&Iq)EBfByW0f-h
zjo4+8QpfrG<dQyfym4tXdueKE^psbr;t9_og$`7jTC-6=dvAUv3iGs>#IY%s*A+*b
NEMt-kVWbn-^)DJeJca-O

diff --git a/docs/epy/uml_class_diagram_for_googleap_7.gif b/docs/epy/uml_class_diagram_for_googleap_7.gif
index b4ce9dc5d7922eda049481f8ce06b0866510cd3f..1d117891cc0d25bcbde9f73cdca0575f427649a1 100644
GIT binary patch
literal 5409
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

delta 4482
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
S)cU@6_ifJg9njJQ9RCkbSTJ}1

diff --git a/docs/epy/uml_class_diagram_for_googleap_8.gif b/docs/epy/uml_class_diagram_for_googleap_8.gif
index cbd6200d02a8ac3cbfc5654a7a93e8737fa5f5e3..4333f9e9406888cec62060273d65daff1f29cca3 100644
GIT binary patch
literal 2662
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
UkG<??Py5>2{`R<^Ll6J}JIB&^&Hw-a

literal 2590
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
Pn?<Yt)}@7j0?z*c2t;v~

diff --git a/docs/epy/uml_class_diagram_for_googleap_9.gif b/docs/epy/uml_class_diagram_for_googleap_9.gif
index b4ce9dc5d7922eda049481f8ce06b0866510cd3f..1d117891cc0d25bcbde9f73cdca0575f427649a1 100644
GIT binary patch
literal 5409
zcmeHI`9IY8<A1&9dXIZT?qigY?HC;lDpR?su;r>Ww!s*K5ynxNLuNwGj0lbUNE*sn
zYA6~<p)IMXQLTh+XRCE}`0V}@-=DtEf8hCiJdelI$;FXq71#`Jf+g@DGyt#!fCK;w
z04xS0kA;=w<<HB@t12t4U#Ft6Ze6;Xnzp*Cf!2C`ZS9NN+D1B>#`=0@hI+qjFihKE
zn7d)amW>-tOiV0HH|^eRvfJF;dfV2*ZQJ${w(PaAIIwfOz2#0Kk?24qy4vh6v$b{G
zyXOdr^y_}x3VZuw4i3H!`}~~jU0q#IxVfEjvp;><G4ROYU=J6Hr)Stv_hZM7(Y(DI
zeSE@wePfRQ8g=4C!YS`WvQJ!KVA5}XXHTDQIenTPbmBbq6puzurPDJbDD4puk&%%X
zA|o$F1~C|nY({WSR7hu3R919!K`bqo$t*}nC`yPZI~R5L+_~bUBw_NIt88{Phgo_4
ze8c&KT0Z{)pWk%hTtj+#OJ>Tgi)>MLc6$z2l9SV#pMN|5e5XKgPr&afOz$o#dQhC%
zTUItumOXeir@y@XQF-1_b@h{K!L!=Sb#-+kb#>!)MNh9?d(~Jf6$vMA-kff4f8W{p
zrn~#&-MgQ9d%yJezn4fBC6aHC9<7az%B0e@wYC2u`G5RhIbgJck^>+OZ26DyzfAz_
z8c>kaa~27ExL7sw6B1GReI9P3Yl(AnMPG*2PTHiTx$<E){$RSEOH0*2zS*x0Ck9%o
zhYAU&2TNRT);zjGjGmjk@Y(s|RT5WT-}P4ASfz8mxxNjr)*fg(JD0k)HaxrLdy_Ub
z*!s&e%<d9Llnj;q;wJU?hLb~W*I%_W-c@W`=e=;Sg>m&#!O-)CQX}IE|Bv6&`bzK8
zKfdg~{d{YtCjXDuP%hqSojUrA%mFE7yuX#MY4zaSqD7fy*~nd&aAxdFV&e$LTI^`a
zvT8VeyZ`>m<5FViUr(oX{l6Y~lC|F*06gFC7gbebR-lH$c@)_74%!HbA)V$;qidwI
zPVy16PwL-!Mwg2r)mY;1L_k8yh{ix&#?p<5dM9V}TtksEwGIV-lkV?PixWiwt@slj
z8d~T&BOYSc({e}T!5mY(zk=m5-azm2s1Rk#2=3Jl+9F07m{EoO`eqE=^Auq4b=seB
zg5iy{o%HP2k0j@cGqh7dT4Wp{m!uc_bUzn1aBUXk*y{|W>HtzlsYXeCpf^?u;T<lK
z0hl~aobesaqV)(342&eKhssL3aJ{+lmvZ04#J>lmvIMUS-pHKNSSRI>$)XQs?$j}D
z|L!6Oj$#lHfpR7OK=8?kxrqsu@pmozV!5|tK<&WWDBgP5cg-jjQPw^E(a)I366D4S
zY2yt=0#AL7g11qjdVo6pJntu4XYNX63z`cZ)PR7lmoekAIuIq2G@D!r=t8&2p0eOb
z6jY*v5d%Ff<;=oA+ooO{K?<>Vnn{{{0qH!9iC6=PwzB!QKw{LO4`P+bOK<gcj7Ndo
z7Bg|bGH@pR9q6t;3V@lOphgr=o@T`XF+=Nt>aTPQEv0`o++&s*^+2!(>2octdr9Q)
zTT$I#OxGKC)VyDM?4f2m;yUK$0k!TOI?d3@G_7N%!Hf~Rl$n2?lSf+r={d;@UwnaH
z`d;&(r0vheSB!^SmnLJL>&HPG>JH%m{ngr^OK(_kfYs~7je1*O@=afRU!fQ_Ex*g&
z`IG)4$LDA3`*N>{m6@c#Pc<_o*Zx3ulpnWQe4q8pYX@Xf&}iVt{<5-!ImXJ2&y)1G
zO??pc*}CI*Lpqyc=yA7l1$tqQGYMJ3t9>t&C&oy~=nHRa4O5EdG@bNxr1Y!Twga*l
zEtMbXUJ9GReL)QNLmUKP<m`!RNjYqLyrf)~){0k8(9PUYk$aIDBG40(l=HQZ;4}!8
zn#<1d7<)XnpPPmho4`69YI6JskfGU)<l)<I{CiVjiV{X;po?2HT4jQ0GF3ifhQuCV
z@f0&*l}O(MO18UhX+6%d0uvBzP5C|-<K7eJ_s(xxer(Upqw;=Kf?Lau*3Ad%d(QjL
zmSJ|04(=;=i1*tg)(GYEOi$oXdv|da|NT+iu0z{~kREF6cr7zmPX&pW;F`c*Y)iz$
zymClslThE1_%JpZWo&>-(6Q(?f?t|*^;X|Q>gO02+||qd%djl73J*V^rq$CmT4bvS
z6z0c%->`|aTipZBt##j|R7+yVg({$>epQ>+sX4tH&do1#*D#=`?JVsyM`#T9K*o6X
z3-xkkBdIQ&3HJn9egO_FEwD|>QfBYBQSA^vp5+Z#_d7WI9&}52E8T3?8k`&wSnD^r
z*|=`HT$vod(YnxiO~=qT2<^i*U08iP(g2>Chs{+}hpjy(Hpf^fhErz^XoY;&m}vF&
zZn}Rw7|TlhT8USxcXo1pl2`n+avgQQb<zDNg08RCgp2j=A+Em{zf`Z$GOIP&Za$W2
z(^s+Qe94gn#8aVpM4j#C2G4c8qoroC^&w%j!)5Z%L@w)1H~*gD-9GrNDe<3c<Y#WG
z<{oV0)PEYO4q+G)RtQgiz0L^A0$37&9{kg^>lnf$&<oKeAm3nxV~u8AeGZ@&Mc8RX
zpqv=}z(#=A#{&e8#8Td~*vu8qD@Bl=??0i@d{h`_@R{Ueer{2ufd@!bFF^Q8Z?Vv*
zlWaT=zc#uaC+e$OH#-QkW$Y$L$)Bo5B!I=GcJ!}rdYSCTGQm~J-8mL9LU&{7dQ5j6
zm2QEkzf6U+GMl9*!{ZJXAY>dX^t+^S{J1TqD=V<O>`>&$0?Ef#($4t0iIw!%wYKk{
z3h%*RwzEDQe*?iCVvKSDOKqVBy;F;%oGhYl*b;c#qoen5Cm}7aV)|3p`WtxVzul1p
z7K9=_Fgt7kzP?-sX2lAGtme!R_jfw4mivj1o3rAE-x+-C=+`69|9S_!*`T{3aX#FV
zS2+CM#CB!CBkObCG5q^xoZp~te~V!<nWHj6Qt>o7sNUi}vqQIN&;Sw_JQ|+a_^Nyj
zGUOxF4={i&sR(OAy;)Y7IiqnSVI=$~OAZCSQAq`NIWlf8x*1-6n}AEf$K?LNhm!v4
z9MSW<S^bI*gVA!yS^WLP6cG#UOnS<d9Y83L0#ii}ma`22z9@ir%M`M!`&u)U`SBt(
z@p;f90>mi2+2f2?;dXFPS|?ds6?+wd1i20{&XbNpfW3SWnJk0%It%5+meDtMf1YQY
zwpM`gi-|u(@c#Eba`%}Wlyv_5UR)q@emx2-<eWz>PphOX_h5$)%|wM%O`>=^^nfUB
zgWHuc3!)f(lt9-j5lgZIwgV|4{O}*v(_WTDN1XC!leKAJw`SI&^c#V1$dIaVeLL`c
z2DI$h^V-nxLI1T;;Iah0*u-m*Y(MZ>xZPSFmT~Z?sPjoGz5j-nia$Z1+W@>`eE_pR
zR++a)9k0L{y^o=W$C#>2ZE)Cbn-{Vz?9fSVWu;MHbz>oCKWYE3n&Q=Qt9{s*lr5M!
z?{B#y0lBvneoEM)g9b5Mv9>sWT#|1jo^|)Vow$6A7qVk|^KZ+;XMcXVa@F~R-I2sr
z-p|eEhr8!|MplbvZuOarvKK;*e0%xo=VHf5_ouj#Z?C`oToT{wMjf5|@I=?}>#;P+
zZ1%`^#?{w@kFt|Tuip4>=eD+byXNP~#_S)T=Ka1Y``ukzdbs`T`#079%pSS7`uFOp
z`@?<9vg~``KO9+G9ZFsfo!PgtG!pWKcWUjsCad^EN+rZX#Iv|gEJdSaY&=Wq!}1bf
zq-m5S7LvV0p^#aQi!c#~<>tV4LiVE&%=i*Z!HnZ1K-=U{&dMNzcqkMfl)`}0XDDX@
zNY_AYB!_&{#P0H?n8fRuNhrBYiV_*)<%lA(sF!)v-9)Ta9aWXZA+$&6&a!<4RDK-A
zAA8D9#F4E}mG5CW%%EaJ(#-K;n+su>z+H_(dzwH>OEeWREt(%Qq|WtRhF(w8oZBFq
zQGGornjQn?F2RO)eM3^Hp+_8djf}|RQ>ub#b>kfEFGxdCK)e}bp%pFX5&D}J{-7@<
z+cKOS7nctMLR_ln;=g^TCggzJG?X3zOJRUeJhpcn_9S9eS+OnxNR<R9j1pp`unHmA
zUW&*KMr;m&(Ngq}@l?lPx}=7ls(~1u#SBw2I_fe2gRiKWCU2JNayev45cy32HxRLn
z*q{gonD5IvJQ|V8L=0mYnjYxx<qTH=<SYs>5}!HJ&N&MhOfo{#3VT=t<jAarnFv`w
z6@cKaR*}nC#!ezziNNOK(y{x~veL4w+oKjb(w(tEeuT*RR<y3@kUbMh`W;yDxOcIc
z&T9h5PZVH6Vr~<qhUV}M#gKwFb|{AJp%tZOMGqs;=N&L#O!7;11an1D@^bDU#I#Cc
z-VN`(lh3pMTBZbefYdhl;y7$C0&E<@jhMX<oc~iR({_cwFO;oHLZyx)v+9sLTnh4*
z&sbQ|7qBrNgh;v{efI>YODkB3%Q`7{%0y0Ze1$z0oS`kGGK2z;Q6LG%pmX3K{MfTN
z^pTDLn}Ph;&`Zv<;R)lH7_5j(ArueO*rV++s$^t}2%hRFDqSh!;;=WIvo2}}RnHcf
zT4QZwu~Ga~j+mz_3-{7Q0vV74ymD)7gfzy1Ssc?DV7Ee3je|Vaa=<Y>M5ZG2aPbV&
zxERf7O)-t=5zWDuK9%Ef$*>$q_1m02?HKyth2WwS+|>p%JkGnMAu+3z6cDq93A(rx
zpW7a9;EUb{PN8T*dyqDd&a*iaWG*YmHy|u=6^5?NBQqG|;tG6v>Q3KcF98g7hElaE
zOlTAn77}F+MPG<dtGjwX^qlbo>&q-cRRnnmDWRfD-L9)f)<p+wlJ(|x9$u}Q(yWf$
zQGGNq$-B$Sx43$&y&C&_b->^`vN>);5hYnzey9y|v<PECy6AyHN628>YE{sn{jaOY
zaBJ*NVU_y~3i$yB;&8uyNUDMS&9%n;WqHP0O~lX603t4SX$2IF!w(kg6s;MhX_s6z
zuxxVOQYYOnvGxxW>_8DX7aG#$4LU5NhjT;h$jJEujJDX3(%x{rxSlStYW_&gnoSRO
z36~>bgmW1go2#n2f<47WXT^wbHQ|#p;ZlwIJqcCETqrRN0C$E@VM<wvSAmeC4L4dX
zL&36oH6r3{dSixpwJfM${#oevnMh#D;F7L?;?s1=2t-%RkHtvHit*-U=-bt(_cmEv
zk47ScdbGGv_6&r1hv++*B{*JhS`J+*N>dPV)UKE&Sc;~LDcaBB8xt9Fw(P?m8A`93
zeB@7Ql9*Ohc+ZDuiR1OvH51we(^v|jap&y-yTW>@zo^x_#WJB~z8bl{tHo}xFvGMo
zeJM83iYfWX*Tv<qa{vP$TRRg=Hf7$zw9L0+l8ezL*0J`-xqUQ*&p?yiDy;JgS@1Cq
zfcOz6h^<AU<RUd0+fz;2V-(sXe$n}hc}j%vp7b^~EVpv7<%ImHBvR-FN5Onh!qdy)
zh7-~At#GtI<<e~m2Vd_v9^oDgS2Wz}YY*@dL4}$~>xUFeX{{F%9nB9)nyXg65^0Ce
zw8#+__|)!y$UdET`}AO2t?eBpvpfCstW4dSfwOmp!fGzOyi>%x^W=8Q(~O|KxP-&~
zH8)pl{QA3x*EFl{EZ&JX51PcD3dUVHw0NE4TIaiX{R;E0XHCbx*@_=amH9)rIb>lN
zKHDn}x~ag(2o~ap>RlIM*%eA=8#Pf{mp6XTq3xcNck28<S*M71?dD(;nT3&%nj&q4
z35X<c@pWK=f+#{)5$G$1;<xm6xf;riUi*9QQg(cmAt~A-N9<HXYn-9g_=9R@(CO#;
zaw3fJWSZfE{<h3C8W9_E6fm&xRbR&Y;}OBw1S2WULI!1gK=3d<1A+^R^$6d_z7u<5
zd6*98w)*+qh^Br>0f$Z!-WQJ3M>N9!ctH(h0EtN^Q`mF;<GtgPeZ1gw4lDiB<-Ddf
z;%y_JzOWfox^^fBlmr5X!V*l*yfu#=px_5C(FYpp`Xe0gN0f-dT^`CdMSg9Abw`o1
zP0(opl-!ZW1wB{k2@RLCygtMPzQ{fLy|QN2!bAv{j$0;z{>PUiZScbn_L!Aaz!h`~
zeGk@;ev6br(Fma^h=PrB&P;wpt9T53_8lI%6X&NZkQE2@hQWjocq0zUvEgy>LUJR*
zW$5wJ%HzLFA`v=|9L7VBP0+?O2j?B4E!*Mk3a1o6#2dZGxH}_Wrox#LiOSi=rQ>(D
z<%Dg0c*ani$rd8DanWcg+nE)4q;||sJZ7Nugybe_U8ohy@p>2g&3@W4D*cMRd9eW^
z`d$VkVP@n$AKmaLTmJ`asQ*MwsX0%xWNtwsbAYRvkS;kSK~^S5cy=#gr{Kdqk8a>~
z=$ZG$XRM(@CrrBn89}ohMHZIs!Jdly@XU7!HW3|C2`!G6d+axrc5LfT-@Ri4o%zcb
zdioSX3pIO~()j$~;^>J^K6Ao(rPFy4etDaMO^@$xfDtb#yC>rL-ISk2<($&c3&ohZ
zjGz{`U;^#jKH>{sX1CWOvhifMyP)dr%+r=fDNRYQ{Qdj3FP^^p<CR!{vUl$!L4#uO
qci?>C<Y4#YFKvO3e@u?*Pd(W?_4MS_c+%8F>D0^asV(bp!1jN-9Lx;>

delta 4482
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
S)cU@6_ifJg9njJQ9RCkbSTJ}1

diff --git a/googleapiclient/__init__.py b/googleapiclient/__init__.py
index e80f4475d78..84d76870331 100644
--- a/googleapiclient/__init__.py
+++ b/googleapiclient/__init__.py
@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = "1.5.5"
+__version__ = "1.6.0"
 
 # Set default logging handler to avoid "No handler found" warnings.
 import logging